diff options
| author | Shulhan <ms@kilabit.info> | 2026-01-29 21:07:22 +0700 |
|---|---|---|
| committer | Shulhan <ms@kilabit.info> | 2026-02-02 16:40:16 +0700 |
| commit | f578b0ba7341f8bc97d13cd165070002596cb106 (patch) | |
| tree | 44771b43cdcd4e36f56ec6dda2d7b4baab75d71e /CHANGELOG.adoc | |
| parent | 1af4644cb401e64ac20ecb7f12e898096470eb61 (diff) | |
| download | ciigo-f578b0ba7341f8bc97d13cd165070002596cb106.tar.xz | |
all: allow combination of default and custom stylesheet
To combine default stylesheet with custom CSS, set the value to "default"
and the file name of custom CSS, separated by comma.
This is the recommended way to use custom stylesheet since it can be set
only on specific pages.
----
// In asciidoctor:
:stylesheet: default, custom.css
// In markdown:
stylesheet: default, custom.css
----
To disable default stylesheet and only using custom CSS, set the value only
to the file name of custom CSS.
Another way to use custom stylesheet is by creating your own template and
pass it to `serve` or `convert` command.
This method makes the stylesheet applied to all pages.
Diffstat (limited to 'CHANGELOG.adoc')
| -rw-r--r-- | CHANGELOG.adoc | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc index 3dc678f..e5d21fe 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -23,6 +23,53 @@ template, we need to restart the "ciigo serve" command. Using memfs make us easy to update and see the changes directly, without restarting the server. +**🌼 all: improve the default stylesheet and template** + +Add common styles for asciidoctor elements with dark theme. +Common styles including title, header, anchor, lists, table, and footer. + +The foreground color changes to conform with color-contrast +ratio threshold, with score AAA. [1] + +Add ARIA role to each section of pages: banner for topbar, +main for page, and contentinfo for footer. +This is to make the webpage more robust and functional no matter +what screen reader technology is used. [2] + +For touch devices, increase the line height on Table of Contents. +This is to help users who may have difficulty in confidently targeting or +operating small controls. [3] + +In the default template, instead of splitting the topbar into top-heading +and menu, breaking it down by class item. + +[1]: https://dequeuniversity.com/rules/axe/4.11/color-contrast + +[2]: https://dequeuniversity.com/rules/axe/4.11/landmark-one-main + +[3]: https://dequeuniversity.com/rules/axe/4.11/target-size + + +**🌱 all: allow combination of default and custom stylesheet** + +To combine default stylesheet with custom CSS, set the value to "default" +and the file name of custom CSS, separated by comma. +This is the recommended way to use custom stylesheet since it can be set +only on specific pages. + +---- +// In asciidoctor: +:stylesheet: default, custom.css + +// In markdown: +stylesheet: default, custom.css +---- + +To disable default stylesheet and only using custom CSS, set the value only +to the file name of custom CSS. + +Another way to use custom stylesheet is by creating your own template and +pass it to `serve` or `convert` command. +This method makes the stylesheet applied to all pages. + [#v0_15_3] == ciigo v0.15.3 (2025-12-27) |
