diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2021-07-30 23:57:39 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2021-07-31 01:42:47 -0600 |
| commit | a7b90a8d7373018b0576fdd2c202644f4580e769 (patch) | |
| tree | fa2920fd6f143ceaccf38122643a42578d137465 /docs/modules | |
| parent | fd12f8b44a87f4ad48ceafbac46a453cb0a989c0 (diff) | |
clarify on AsciiDoc.py migration page that only the font size and color roles are deprecated
Diffstat (limited to 'docs/modules')
| -rw-r--r-- | docs/modules/migrate/pages/asciidoc-py.adoc | 27 |
1 files changed, 12 insertions, 15 deletions
diff --git a/docs/modules/migrate/pages/asciidoc-py.adoc b/docs/modules/migrate/pages/asciidoc-py.adoc index 6a9abf52..3a1cb4e1 100644 --- a/docs/modules/migrate/pages/asciidoc-py.adoc +++ b/docs/modules/migrate/pages/asciidoc-py.adoc @@ -100,26 +100,23 @@ Reverts to AsciiDoc.py syntax when `compat-mode` is enabled. |See xref:asciidoc:text:quotation-marks-and-apostrophes.adoc[]. + Reverts to AsciiDoc.py syntax when `compat-mode` is enabled. -|Inline role +|Inline role(s) |pass:[[role\]#text#] or pass:[[role1 role2\]#text#] |pass:[[.role\]#text#] or pass:[[.role1.role2\]#text#] |See xref:asciidoc:text:text-span-built-in-roles.adoc[]. + While Asciidoctor still recognizes the bare, space-separated syntax for inline roles, the shorthand-style with the leading dot is preferred. -|Sizes and overline -|`big`, `small`, `overline` -|user-specified `+[.<role-name>]+` and associated formatting in stylesheet -|See xref:asciidoc:text:custom-inline-styles.adoc[]. - -|Underline and line-through -|`underline`, `line-through` -|`+[.underline]+`, `+[.line-through]+` -|See xref:asciidoc:text:custom-inline-styles.adoc[]. - -|Colors -|Name of color -|user-specified `+[.<role-name>]+` and associated formatting in stylesheet -|See xref:asciidoc:text:custom-inline-styles.adoc[]. +|Font size roles +|`big`, `small` +|user-specified role (e.g., `+[.details]+`) with corresponding CSS rules provided by stylesheet +|See xref:asciidoc:text:custom-inline-styles.adoc[]. + +The default stylesheet in Asciidoctor still provides CSS for these built-in roles, but they are considered deprecated. + +|Color roles +|`aqua`, `aqua-background`, etc. +|user-specified role `+[.brand-primary]+` with corresponding CSS rules provided by stylesheet +|See xref:asciidoc:text:custom-inline-styles.adoc[]. + +The default stylesheet in Asciidoctor still provides CSS for these built-in roles, but they are considered deprecated. |=== === Table of contents |