From 5c397277c949d63fd53dd25fd6bcf6bc21b4428e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cyrille=20M=C3=A9dard=20de=20Chardon?= Date: Thu, 24 Jul 2025 10:01:46 +0200 Subject: [PATCH 1/3] Update callouts.qmd Added the 'caution' callout example for completeness and explained the heading behaviour --- docs/authoring/callouts.qmd | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/authoring/callouts.qmd b/docs/authoring/callouts.qmd index df85a910d3..4470ee4ecd 100644 --- a/docs/authoring/callouts.qmd +++ b/docs/authoring/callouts.qmd @@ -31,6 +31,12 @@ Callouts provide a simple way to attract attention, for example, to this warning Danger, callouts will really improve your writing. ::: +::: callout-caution +## Headings are not necessary + +Providing a heading is optional and the keyword (Note, Warning, Important, Tip, or Caution) will be used instead. +::: + ::: callout-tip ## Tip With Title From 3ec5ff75f16baaef7df7704f3f5d5121ef8ce4e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cyrille=20M=C3=A9dard=20de=20Chardon?= Date: Tue, 12 Aug 2025 23:30:46 +0200 Subject: [PATCH 2/3] Update callouts.qmd Removed the duplicate caution, clarified default behaviour. --- docs/authoring/callouts.qmd | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/docs/authoring/callouts.qmd b/docs/authoring/callouts.qmd index 4470ee4ecd..18fbc837a4 100644 --- a/docs/authoring/callouts.qmd +++ b/docs/authoring/callouts.qmd @@ -26,25 +26,19 @@ Callouts provide a simple way to attract attention, for example, to this warning ::: ::: callout-important -## This is Important - Danger, callouts will really improve your writing. ::: -::: callout-caution -## Headings are not necessary - -Providing a heading is optional and the keyword (Note, Warning, Important, Tip, or Caution) will be used instead. -::: - ::: callout-tip ## Tip With Title -This is an example of a callout with a title. +This is an example of a callout with a title. Providing a heading is optional. + +When no heading is provided the callout type will determine the expected heading (i.e., Note, Warning, Important, Tip, or Caution). ::: ::: {.callout-caution collapse="true"} -## Expand To Learn About Collapse +## Caution: Expand To Learn About Collapse This is an example of a 'collapsed' caution callout that can be expanded by the user. You can use `collapse="true"` to collapse it by default or `collapse="false"` to make a collapsible callout that is expanded by default. ::: From f2f263cf444d44567514dfbfcdbae0db73a0fd1a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cyrille=20M=C3=A9dard=20de=20Chardon?= Date: Wed, 13 Aug 2025 07:48:50 +0200 Subject: [PATCH 3/3] Simplified and clarified callout examples --- docs/authoring/callouts.qmd | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/authoring/callouts.qmd b/docs/authoring/callouts.qmd index 18fbc837a4..ae5eb97ff2 100644 --- a/docs/authoring/callouts.qmd +++ b/docs/authoring/callouts.qmd @@ -26,15 +26,13 @@ Callouts provide a simple way to attract attention, for example, to this warning ::: ::: callout-important -Danger, callouts will really improve your writing. +The callout heading is provided by the callout type, with the expected heading (i.e., Note, Warning, Important, Tip, or Caution). ::: ::: callout-tip ## Tip With Title -This is an example of a callout with a title. Providing a heading is optional. - -When no heading is provided the callout type will determine the expected heading (i.e., Note, Warning, Important, Tip, or Caution). +This is an example of a callout with a title. Providing a callout heading is optional. ::: ::: {.callout-caution collapse="true"}