Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A sphinx theme plugin support extension. #sphinxjp

Project Description

A sphinx theme plugin extension.

Warning

For users: sphinxjp.themecore will be deprecated. Please use theme plugins with Sphinx-1.2.

Warning

For theme developers: sphinxjp.themecore’s ‘sphinx_themes’ entry point feature is provided on the Sphinx from 1.2(b3) release. However ‘sphinx_directives’ feature is not provided by the Sphinx.

If your theme plugin provides only ‘sphinx_themes’ entry point, you need remove extensions = ['sphinxjp.themecore'] line from your documentation and remove sphinxjp.themecore dependency from install_requires in the setup.py. There is a example of change to support both before and after Sphinx-1.2: https://bitbucket.org/shimizukawa/sphinxjp.themes.sphinxjp/commits/c66313e

If your theme plugin provides ‘sphinx_directives’ entry point too, additionaly you need write your setup() function in your extension root package instead of such as setup_directive() and need change your documentation’s installation section with like: “set extensions=["sphinxjp.themes.s6"] instead of ‘sphinx.themecore’”. There is a example of change to support both before and after Sphinx-1.2: https://bitbucket.org/shimizukawa/sphinxjp.themes.s6/commits/ed91ae537

Features

  • provide theme template collection by using setuptools plugin mechanism.

Setup

Make environment with easy_install:

$ easy_install sphinxjp.themecore

Make your plugins

themes

If you want to integrate new theme, write sphinx_themes entry_points in your setup.py:

entry_points = """
    [sphinx_themes]
    path = sphinxjp.themes.s6:get_path
"""

and write get_path function that return path of Sphinx themes. Sphinx themes directory include one or more theme directories.

directives

If you want to integrate new directive, write sphinx_directives entry_points in your setup.py:

entry_points = """
    [sphinx_directives]
    setup = sphinxjp.themes.s6:setup_directives
"""

and write setup_directives function that receive app argument and return None. setup_directives is same as sphinx extension’s setup function. See Sphinx extension document for more information.

Requirements

  • Python 2.4 or later (not support 3.x)
  • sphinx 1.0.x

License

Licensed under the MIT license . See the LICENSE file for specific terms.

AUTHORS

Sphinx template plugin extension

  • Takayuki SHIMIZUKAWA <shimizukawa AT gmail.com> sphinx-users.jp

History

0.2.0 (2013/12/10)

  • A part of sphinxjp.themecore feature is merged into Sphinx-1.2(b3).

0.1.3 (2011/7/9)

  • fix fatal bug on version 0.1.2. sorry.

0.1.2 (2011/7/9)

  • fixed issue #1: html_theme_path definition in conf.py discard all sphinxjp.themes.* paths.

0.1.1 (2011/7/6)

  • fixed namespace package declaration missing, thank you togakushi!

0.1.0 (2011/2/6)

  • first release
Release History

Release History

This version
History Node

0.2.0

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sphinxjp.themecore-0.2.0.tar.gz (7.6 kB) Copy SHA256 Checksum SHA256 Source Dec 9, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting