Cleverly-named alabaster sub-theme for git-pull projects
Project description
Sphinx sub-theme of Alabaster, for use on git-pull projects.
What alagitpull adds to Alabaster
See the theme live on https://www.git-pull.com, https://tmuxp.git-pull.com, etc.
Table CSS tweaks
<pre> and code-block css tweaks
Additional theming tweaks for admonitions like ..note.
New sidebar template with links to projects
Automatic unlinking of project if its the current docs
Support for subprojects (put into parenthesis)
Sidebar CSS tweaks
Config options
(Inside conf.py)
html_theme_options example:
html_theme_options = { 'logo': 'img/logo.svg', 'github_user': 'git-pull', 'github_repo': 'alagitpull', 'github_type': 'star', 'github_banner': True, 'projects': {}, 'project_name': 'my project name', }
For an example of html_theme_options['projects'] see the alagitpull/__init__.py file.
Variables:
alagitpull_external_hosts_new_window (boolean, default: False): check if link is external domain/IP. If so, open in new window.
alagitpull_external_hosts_new_window = Truealagitpull_internal_hosts (list) - whitelist of domains to open in same tab, without target="_blank". Only used if alagitpull_external_hosts_new_window enabled.
Example:
alagitpull_internal_hosts = [
'libtmux.git-pull.com',
'0.0.0.0',
]Theme options
html_theme_options of sphinx’s conf.py:
projects (dict) - Sidebar links.
project_name (string) - Name of your project (helps with unlinking
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.
