Skip to main content

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 = True

alagitpull_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

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

alagitpull-0.0.22.tar.gz (6.3 kB view details)

Uploaded Source

File details

Details for the file alagitpull-0.0.22.tar.gz.

File metadata

  • Download URL: alagitpull-0.0.22.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2

File hashes

Hashes for alagitpull-0.0.22.tar.gz
Algorithm Hash digest
SHA256 aacd8904bedfdac5277597759e31db9041d7ef3f11fb0697bc85697d962ff537
MD5 1bf31e2016b99cdff4dafd21948bdd82
BLAKE2b-256 9ef5ca1de163b4d186e4d20d0f86bbc58f35e599c62b79beef449a95886548cd

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page