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 03:28:56 -0600 |
| commit | 218ef612d8c8da048a3ce1b0a1135be27a10feba (patch) | |
| tree | 2ca4b82a0eaba5b6d52965816fee39aad0e60380 /docs/modules | |
| parent | 049a301e19875b03aa16e93cc72d1dbbcfff671e (diff) | |
document the built-in themes
Diffstat (limited to 'docs/modules')
| -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. |