Sphinx Github Integration and Github Dark Theme Pygments Style
Project description
GitHub source code links and syntax highlighting for Sphinx docs
About
sphinx-github-style is a Sphinx extension that makes your docs look like and link to GitHub
…
GitHub Source Code Links
Using sphinx.ext.linkcode, a View on GitHub link is added to the documentation of every class, method and function:
They link to and highlight the corresponding code block in your GitHub repo:
📝 Note |
---|
These links can be used with/instead of the links added by sphinx.ext.viewcode
|
Syntax Highlighting
sphinx-github-style also contains a Pygments style to highlight code in your documentation similar to GitHub:
Installation
To install using pip:
pip install sphinx-github-style
Configuration
Add the extension to your conf.py
extensions = [
"sphinx_github_style",
]
…
Optional Configuration Variables
Add any (or none) of the following configuration variables to your conf.py
top_level
top_level: str
The name of the package’s top-level module. For this repo, it would be sphinx_github_style
…
linkcode_blob
linkcode_blob: str = "head"
The blob to link to on GitHub - any of "head", "last_tag", or "{blob}"
head (default): links to the most recent commit hash; if this commit is tagged, uses the tag instead
last_tag: links to the most recent commit tag on the currently checked out branch
blob: links to any blob you want, for example "master" or "v2.0.1"
…
linkcode_url
linkcode_url: str = f"https://github.com/{html_context['github_user']}/{html_context['github_repo']}/{html_context['github_version']}"
The link to your GitHub repository formatted as https://github.com/user/repo
If not provided, will attempt to create the link from the html_context dict
…
linkcode_link_text
linkcode_link_text: str = "View on GitHub"
The text to use for the linkcode link
…
linkcode_resolve
linkcode_resolve: Callable
A linkcode_resolve() function to use for resolving the link target
Uses default function from get_linkcode_resolve() if not specified (recommended)
Noteworthy Components
TDKStyle - Pygments Style for syntax highlighting similar to Github Pretty Lights Dark Theme
TDKMethLexer - Pygments Lexor to add syntax highlighting to methods
get_linkcode_resolve() - to link to GitHub source code using sphinx.ext.linkcode
add_linkcode_node_class() - adds a new linkcode-link class, allowing for CSS styling separately from viewcode links
github_style.css - CSS styling for linkcode links (icon + text)
Documentation
Full documentation can be found on ReadTheDocs
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx-github-style-1.0.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | be898b5a9bfab6a63be74ba8cc3233165c09adc98d52155149db97ee0bcb3274 |
|
MD5 | 125999759dfcc05b438e9b8fbaa26e11 |
|
BLAKE2b-256 | 6dc07e2bc3e4b3cce08d7fc3c74e6edf3e983de9d9e366d4fb8d99143ec06f88 |
Hashes for sphinx_github_style-1.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2e7b5bc04be16692e2f9bcd062e3d09d4d1ac28a8d7b63fe1d306a416ac8efe5 |
|
MD5 | 7e3f574dacbbbfaa8bd7923bf26c6bef |
|
BLAKE2b-256 | 163bdf2805fc7718541910fc47d5b24dd5b49b2055cae9cf0e970bf7edd8bef0 |