Skip to content

Commit 2ab3112

Browse files
authored
Merge pull request #30 from CourtBouillon/furo
Use Furo theme for documentation
2 parents e404d82 + 1a03c74 commit 2ab3112

File tree

3 files changed

+21
-6
lines changed

3 files changed

+21
-6
lines changed

docs/conf.py

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,25 @@
4040

4141
# The theme to use for HTML and HTML Help pages. See the documentation for
4242
# a list of builtin themes.
43-
html_theme = 'sphinx_rtd_theme'
43+
html_theme = 'furo'
4444

4545
html_theme_options = {
46-
'collapse_navigation': False,
46+
'light_css_variables': {
47+
'color-brand-primary': 'var(--red)',
48+
'color-brand-content': 'var(--red)',
49+
'color-brand-visited': 'var(--red)',
50+
'font-stack': 'ClarityCity, sans-serif',
51+
'font-stack--monospace': 'Inconsolata, monospace',
52+
'font-stack--headings': 'Inconsolata, monospace',
53+
},
54+
'dark_css_variables': {
55+
'color-brand-primary': 'var(--red)',
56+
'color-brand-content': 'var(--red)',
57+
'color-brand-visited': 'var(--red)',
58+
},
59+
'top_of_page_buttons': ['edit'],
60+
'source_edit_link':
61+
'https://github.com/CourtBouillon/pydyf/edit/main/docs/{filename}',
4762
}
4863

4964
# Favicon URL
@@ -57,7 +72,7 @@
5772
# These paths are either relative to html_static_path
5873
# or fully qualified paths (eg. https://...)
5974
html_css_files = [
60-
'https://www.courtbouillon.org/static/docs.css',
75+
'https://www.courtbouillon.org/static/docs-furo.css',
6176
]
6277

6378
# Output file base name for HTML help builder.

docs/index.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ pydyf
77

88
.. toctree::
99
:caption: Documentation
10-
:maxdepth: 3
10+
:maxdepth: 2
1111

1212
first_steps
1313
common_use_cases
@@ -16,7 +16,7 @@ pydyf
1616

1717
.. toctree::
1818
:caption: Extra Information
19-
:maxdepth: 3
19+
:maxdepth: 2
2020

2121
changelog
2222
contribute

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Changelog = 'https://github.com/CourtBouillon/pydyf/releases'
3838
Donation = 'https://opencollective.com/courtbouillon'
3939

4040
[project.optional-dependencies]
41-
doc = ['sphinx', 'sphinx_rtd_theme']
41+
doc = ['sphinx', 'furo']
4242
test = ['pytest', 'ruff', 'pillow']
4343

4444
[tool.flit.sdist]

0 commit comments

Comments
 (0)