diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2021-03-22 23:43:15 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2021-03-23 00:03:25 -0600 |
| commit | 719b57eb4152ee62d18337ac54ad12e797812900 (patch) | |
| tree | 3f4f9df96f1bb0c292445b9bdeebf92f9448047f /docs/modules/html-backend | |
| parent | b7ee533f385a5130cade5e8c2d20acf21dac7703 (diff) | |
revise note in docs about replacing the default stylesheet [skip ci]
Diffstat (limited to 'docs/modules/html-backend')
| -rw-r--r-- | docs/modules/html-backend/pages/default-stylesheet.adoc | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/docs/modules/html-backend/pages/default-stylesheet.adoc b/docs/modules/html-backend/pages/default-stylesheet.adoc index 95b9bfd4..a49a8fac 100644 --- a/docs/modules/html-backend/pages/default-stylesheet.adoc +++ b/docs/modules/html-backend/pages/default-stylesheet.adoc @@ -6,13 +6,14 @@ This, in turn, gets you up and running quickly by giving you a result to preview This page covers why the default is necessary, how to apply it, and how to build on it so you don't have to create a stylesheet from scratch. NOTE: The default stylesheet that Asciidoctor provides is just that, _a default_. -If you don't like its appearance, you can customize it or replace it with a different one, -though it's important to understand what purpose the stylesheet serves when doing so. +If you prefer a different style, you can customize it or replace it with a different one. +When replacing the default stylesheet, it's important to understand that it's providing support for numerous features in AsciiDoc, as covered in the next section. +You'll need to include these required styles when developing your own stylesheet if you want these features to continue to work. // TODO: we probably need a page to defines what styles any stylesheet must provide to be fully compatible with AsciiDoc == Why provide a default? -As previously stated, a default stylesheet is included to provide a nice out-of-the-box experience. +Asciidoctor includes a default stylesheet to provide a nice out-of-the-box experience when generating HTML from AsciiDoc. But there's more to it. There are elements of AsciiDoc that require stylesheet support. |
