A Sphinx theme using Bulma
Project description
Currently updating major changes and updates from AccentDesign/karma_sphinx_theme
Check todo list for planned features to be included on release version v0.1.0 (cur: v0.0.11)
A simple responsive theme for sphinx using Bulma featuring:
- Has built-in dark/light color themes using native CSS and JavaScript
- Sphinx built-in text search engine
- Extended Sass rulesets from bulma
- Support for user-defined favicon and logo from sphinx config
- Custom icon font made with Fontello
- Theme user-defined documentation repository reference
Yet to be done a.k.a todo
- Support user-defined colors(at least primary)
Enable custom Sass rules on docs build(can be done but requires user to build theme again) - Examples of use with breathe for C++ docs
Installing
Using pip to install from this repository:
pip install sphinx-bulma
Configuration
The theme's project-wide options are defined in the src/sphinx-bulma/theme.conf
file, and can be defined in your project's conf.py
via
html_theme_options
. For example:
html_theme_options = {
'navigation_depth': 2, # maximum depth of tree
'includehidden': True, # if true sidebar may include toctrees marked with hidden option
'titles_only': False, # if true removes headers within a page from the sidebar
'display_git': False, # if true options below must be set
'git_host': 'github.com', # git host url
'git_user': 'gh-user', # your git host username
'git_repo': 'doc-repo', # doc repository
'git_blob': 'blob', # default for github
'git_version': 'master/docs/', # docs folder
'git_icon': 'github', # icon to show on docs
'git_desc': 'Check the sources', # link description
'default_palette': 'dark', # default color palette (dark or light)
'sidebar': True # if true sidebar will be rendered
}
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sphinx-bulma-0.0.11.tar.gz
(985.2 kB
view hashes)
Built Distribution
sphinx_bulma-0.0.11-py3-none-any.whl
(982.9 kB
view hashes)
Close
Hashes for sphinx_bulma-0.0.11-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c8eb824ecbd81106db81599ffd8cbf8b9b7eebea9e562309d24533b16a9108d5 |
|
MD5 | f953a5f6a603f1b81be732cf3b18e034 |
|
BLAKE2b-256 | 34a1162ad80669c73a70191a06f49006ad87c089afb67e8e5d11e6a0e17571eb |