diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2022-09-21 23:47:14 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2022-09-21 23:47:14 -0600 |
| commit | f6dffc8cf236437db2bda07979cee5260a01c9e3 (patch) | |
| tree | 3852ef72552a72360b4e62299d1942ec6852ec89 | |
| parent | 00d4aefeb7ea075a5dc062c8d988cafd5095af1b (diff) | |
minor revisions to theming system descriptions
| -rw-r--r-- | docs/modules/theme/pages/create-theme.adoc | 4 | ||||
| -rw-r--r-- | docs/modules/theme/pages/index.adoc | 2 |
2 files changed, 3 insertions, 3 deletions
diff --git a/docs/modules/theme/pages/create-theme.adoc b/docs/modules/theme/pages/create-theme.adoc index 0f4aa76a..823fc3f8 100644 --- a/docs/modules/theme/pages/create-theme.adoc +++ b/docs/modules/theme/pages/create-theme.adoc @@ -3,7 +3,7 @@ :description: Create a PDF theme by extending a built-in theme or starting one from scratch. There are two ways to create a PDF theme. -One way is to extend one of the built-in themes and gradually layer your customizations onto it. +One way is to extend one of the built-in themes and gradually layer your customizations over it. The other way is to develop a theme from scratch. There are advantages to both approaches. @@ -11,7 +11,7 @@ There are advantages to both approaches. == Extend the default theme One theme can extend another theme using the `extends` key at the top of the theme file. -When extending a theme, you only have to define the keys you want to override from the theme you are extending, which is loaded prior to loading the keys in your theme. +When extending a theme, you only have to define the keys you want to override from the theme you're extending, which is loaded prior to loading the keys in your theme. Thus, the quickest and simplest way to create a theme is to extend the default theme. Let's try this out by drastically modifying the base font color. diff --git a/docs/modules/theme/pages/index.adoc b/docs/modules/theme/pages/index.adoc index f0cf2a29..178f3c82 100644 --- a/docs/modules/theme/pages/index.adoc +++ b/docs/modules/theme/pages/index.adoc @@ -14,7 +14,7 @@ If you want to customize the layout and styling of the PDF, you can extend one o The Asciidoctor PDF theming system is driven by a YAML configuration file. The Asciidoctor PDF theme language is described using https://en.wikipedia.org/wiki/YAML[YAML] and incorporates many _concepts_ from CSS and SASS, such as selectors, properties, and inheritance. Therefore, if you have a background in web design, the terminology should be immediately familiar to you. -*Note, however, that the theming system isn't actually CSS.* +*Note, however, that the theming system is not actually CSS.* When a theme file is loaded, it gets converted to a flat theme map. The converter uses the information stored in the keys of the theme map to help construct the PDF. |