diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2023-04-09 15:46:58 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2023-04-09 15:46:58 -0600 |
| commit | 893fb2ef8b6917a5b7f6dbc04df7233855541b8c (patch) | |
| tree | 2ced49190bb954c617feb0229a0e28ad34931fec | |
| parent | 861a2aca8ec092a51eda2cebf306df26fae9d3fb (diff) | |
refer to YAML as a data format instead of configuration format
| -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 4d700665..e70af64b 100644 --- a/docs/modules/theme/pages/create-theme.adoc +++ b/docs/modules/theme/pages/create-theme.adoc @@ -2,7 +2,7 @@ :page-aliases: extend-theme.adoc :description: Create a PDF theme by extending a built-in theme or starting one from scratch. -Asciidoctor PDF allows you to create your own theme, which you define using a YAML configuration file. +Asciidoctor PDF allows you to create your own theme, which you define using a YAML data file. When creating a theme, you have the option to extend a built-in theme and gradually layer on your customizations or to develop a theme from scratch. This page explains both approaches and the advantages of each. @@ -11,7 +11,7 @@ Otherwise, Asciidoctor PDF will fall back to the built-in AFM fonts in PDF, whic == New theme basics -An Asciidoctor PDF theme is defined using a YAML configuration file that ends with `-theme.yml` (e.g., [.path]_my-theme.yml_). +An Asciidoctor PDF theme is defined using a YAML data file that ends with `-theme.yml` (e.g., [.path]_my-theme.yml_). No keys are actually required. Each key you specify will customize the styling in some way that differs from the intrinsic defaults. diff --git a/docs/modules/theme/pages/index.adoc b/docs/modules/theme/pages/index.adoc index 178f3c82..ee1898f9 100644 --- a/docs/modules/theme/pages/index.adoc +++ b/docs/modules/theme/pages/index.adoc @@ -11,7 +11,7 @@ If you want to customize the layout and styling of the PDF, you can extend one o == Theme configuration and language -The Asciidoctor PDF theming system is driven by a YAML configuration file. +The Asciidoctor PDF theming system is driven by a YAML data 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 is not actually CSS.* |