skip to navigation
skip to content

Not Logged In

sphinxjp.themecore 0.2.0

A sphinx theme plugin support extension. #sphinxjp

A sphinx theme plugin extension.


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


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 There is a example of change to support both before and after Sphinx-1.2:

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:


  • provide theme template collection by using setuptools plugin mechanism.


Make environment with easy_install:

$ easy_install sphinxjp.themecore

Make your plugins


If you want to integrate new theme, write sphinx_themes entry_points in your

entry_points = """
    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.


If you want to integrate new directive, write sphinx_directives entry_points in your

entry_points = """
    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.


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


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


Sphinx template plugin extension

  • Takayuki SHIMIZUKAWA <shimizukawa AT>


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 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
File Type Py Version Uploaded on Size
sphinxjp.themecore-0.2.0.tar.gz (md5) Source 2013-12-09 7KB
  • Downloads (All Versions):
  • 24 downloads in the last day
  • 147 downloads in the last week
  • 612 downloads in the last month