diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2022-09-20 23:44:40 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2022-09-21 04:17:00 -0600 |
| commit | f87a464b71b0ad72b0eed7e9e6c32695f9ed28ab (patch) | |
| tree | 05ce5fe46e22f0724752c26b14bf578f7f2bc0bd | |
| parent | 215336ad1fc9288c5f2e080b1b780d541c58832d (diff) | |
document the built-in themes
| -rw-r--r-- | docs/modules/theme/pages/index.adoc | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/modules/theme/pages/index.adoc b/docs/modules/theme/pages/index.adoc index d107f69d..2d47e6b9 100644 --- a/docs/modules/theme/pages/index.adoc +++ b/docs/modules/theme/pages/index.adoc @@ -27,6 +27,24 @@ If your theming requirements demand more than what this theming system can accom //This document describes how the theming system works, how to define a custom theme in YAML, and how to activate the theme when running Asciidoctor PDF. //To learn how the theming system works and how to create and apply custom themes, refer to the <<docs/theming-guide.adoc#,Asciidoctor PDF Theming Guide>>. +== Built-in themes + +Asciidoctor PDF provides the following built-in themes: + +base:: A barebones theme that provides rudimentary styling to support AsciiDoc content. +Useful as a starting point when developing a custom theme. +default:: Used if no theme is specified. +Optimized for screen. +Uses a serif base font. +default-with-font-fallbacks:: A variation of the `default` theme that includes fallback fonts to provide extended Unicode character support, including emoji and commonly used CJK characters. +default-for-print:: A variation of the `default` theme that is optimized for print. +Used if no theme is specified and `media=print` or `media=prepress`. +default-for-print-with-font-fallbacks:: A combination of the `default` and `default-with-font-fallback` themes. +default-sans:: A variation of the `default` theme that uses a sans base font. +default-sans-with-font-fallbacks:: A variation of the `default-sans` theme that includes fallback fonts to provide extended Unicode character support, including emoji and commonly used CJK characters. + +Refer to xref:apply-theme.adoc[] to learn how to apply a theme. + == Syntax highlighter style If you've enabled a source highlighter, you can control the style (aka theme) it applies to source blocks using the `coderay-style`, `pygments-style`, and `rouge-style` attributes, respectively. |