Skip to content

Commit

Permalink
be more clear where pygments stylesheet is written (as it relates to …
Browse files Browse the repository at this point in the history
…stylesdir)
  • Loading branch information
mojavelinux committed Nov 6, 2023
1 parent f725823 commit b087e2f
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1251,6 +1251,15 @@ This plugin will automatically generate a stylesheet for Pygments into the sourc
* `pygments-stylesheet` is not unset (if set, it can have any value)

By default, the stylesheet is written to `stylesdir` + `pygments-stylesheet`.
If you want the stylesheet to be written to the [.path]_css_ directory, add the following configuration to your site's `_config.yml` file:

[source,yaml]
----
asciidoctor:
attributes:
stylesdir: css
----

If the `pygments-stylesheet` attribute is not specified, the value defaults to `asciidoc-pygments.css`.
You can customize this value to your liking.

Expand All @@ -1260,7 +1269,7 @@ If this attribute is not set, it defaults to `vs`.
The stylesheet file will be created if it does not yet exist or the theme has been changed.
Jekyll will handle copying the file to the output directory.

You'll need to add a line to your template to link to this stylesheet, such as:
You'll need to add a line to your template to link to this stylesheet (assuming `stylesdir=css`), such as:

[source,html]
----
Expand Down

0 comments on commit b087e2f

Please sign in to comment.