diff --git a/docs/authoring/brand.qmd b/docs/authoring/brand.qmd index d11b93aaab..ae46865f86 100644 --- a/docs/authoring/brand.qmd +++ b/docs/authoring/brand.qmd @@ -1,5 +1,28 @@ --- title: Multiformat branding with `_brand.yml` +title-block-banner: true +include-in-header: + - text: | + --- ## Overview diff --git a/docs/authoring/images/brand-logo.png b/docs/authoring/images/brand-logo.png new file mode 100644 index 0000000000..1c9507dfc4 Binary files /dev/null and b/docs/authoring/images/brand-logo.png differ diff --git a/docs/output-formats/html-themes.qmd b/docs/output-formats/html-themes.qmd index 7d440cbe27..abe6bd17ef 100644 --- a/docs/output-formats/html-themes.qmd +++ b/docs/output-formats/html-themes.qmd @@ -31,7 +31,11 @@ You can also customize these themes or create your own new themes. Learn how to ## Basic Options -If you are using a Bootstrap theme or the Pandoc theme, there are a set of options you can provide in document metadata to customize its appearance. These include: +::: {.callout-tip} +These settings only apply to the `html` output format; more basic options can be set across all formats with a [brand file](/docs/reference/metadata/brand.qmd) +::: + +If you are using a Bootstrap theme or the Pandoc theme, there are a set of options you can provide in `_quarto.yml` or document metadata to customize its appearance. These include: +--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Option | Description | @@ -57,10 +61,22 @@ If you are using a Bootstrap theme or the Pandoc theme, there are a set of optio | `margin-left`, `margin-right`, `margin-top`, `margin-bottom` | Sets the CSS [`margin`](https://developer.mozilla.org/en-US/docs/Web/CSS/margin) properties for the document body. | +--------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ -For example. here we set the font-size a bit larger and specify that we want a bit more space between lines of text: +For example. here we set the font-size a bit larger and specify that we want a bit more space between lines of text in a specific document: ``` yaml +--- title: "My Document" +format: + html: + theme: cosmo + fontsize: 1.1em + linestretch: 1.7 +--- +``` + +Alternatively, adding this to `_quarto.yml` will apply that setting to all pages: + +``` yaml format: html: theme: cosmo