Skip to content

Commit

Permalink
Use Furo theme for documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
liZe committed Nov 15, 2024
1 parent c35b34e commit 42446e1
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 6 deletions.
21 changes: 18 additions & 3 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,25 @@

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

html_theme_options = {
'collapse_navigation': False,
'light_css_variables': {
'color-brand-primary': 'var(--red)',
'color-brand-content': 'var(--red)',
'color-brand-visited': 'var(--red)',
'font-stack': 'ClarityCity, sans-serif',
'font-stack--monospace': 'Inconsolata, monospace',
'font-stack--headings': 'Inconsolata, monospace',
},
'dark_css_variables': {
'color-brand-primary': 'var(--red)',
'color-brand-content': 'var(--red)',
'color-brand-visited': 'var(--red)',
},
'top_of_page_buttons': ['edit'],
'source_edit_link':
'https://github.com/CourtBouillon/pydyf/edit/main/docs/{filename}',
}

# Favicon URL
Expand All @@ -63,7 +78,7 @@
# These paths are either relative to html_static_path
# or fully qualified paths (eg. https://...)
html_css_files = [
'https://www.courtbouillon.org/static/docs.css',
'https://www.courtbouillon.org/static/docs-furo.css',
]

# Output file base name for HTML help builder.
Expand Down
4 changes: 2 additions & 2 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tinycss2

.. toctree::
:caption: Documentation
:maxdepth: 3
:maxdepth: 2

first_steps
common_use_cases
Expand All @@ -16,7 +16,7 @@ tinycss2

.. toctree::
:caption: Extra Information
:maxdepth: 3
:maxdepth: 2

changelog
contribute
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Changelog = 'https://github.com/Kozea/tinycss2/releases'
Donation = 'https://opencollective.com/courtbouillon'

[project.optional-dependencies]
doc = ['sphinx', 'sphinx_rtd_theme']
doc = ['sphinx', 'furo']
test = ['pytest', 'ruff']

[tool.flit.sdist]
Expand Down

0 comments on commit 42446e1

Please sign in to comment.