Skip to content

Commit 90b1386

Browse files
committed
RST docs: choose theme (sphinx_rtd) and highlighting style (sphinx)
There is no `alex` pygments highlighter, unfortunately. The one for `peg` looks reasonable for grammar definitions.
1 parent 07c732f commit 90b1386

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

doc/conf.py

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,15 @@
4444
# The theme to use for HTML and HTML Help pages. See the documentation for
4545
# a list of builtin themes.
4646
#
47-
html_theme = 'alabaster'
47+
html_theme = 'sphinx_rtd_theme'
4848

4949
# Add any paths that contain custom static files (such as style sheets) here,
5050
# relative to this directory. They are copied after the builtin static files,
5151
# so a file named "default.css" will overwrite the builtin "default.css".
52-
html_static_path = ['_static']
52+
html_static_path = ['_static']
53+
54+
# The name of the Pygments (syntax highlighting) style to use.
55+
pygments_style = 'sphinx'
56+
highlight_language = 'Peg'
57+
# Andreas Abel, 2022-02-27: Peg looked best from the "grammar" highlighters.
58+
# I also tried 'Bnf' and 'Abnf'.

0 commit comments

Comments
 (0)