Skip to main content
Help us improve Python packaging – donate today!

Collection of Sphinx Themes for Plone Documentations

Project Description

sphinx.themes.plone is a collection of Sphinx themes for the Plone documentation project.

The different themes are used on docs.plone.org, but are not limited for this purpose. It might be used for all Plone Package Documentations, or even private use case but than without the Plone Logo and Footer (respect the License).

Features

  • sphinxtheme.plone comes with own themes for
    • Plone Classic (Plone 2.0-3.3 Design)
    • Plone Sunburst (Plone 4 Design)
    • Plone Barceloneta (Plone 5 Design)
    • Plone Org 4 (Generation of Plone 4)
    • Plone Org 5 (Generation of Plone 5)

Installation

buildout

Install sphinxtheme.plone with buildout:

[buildout]
parts=
    sphinx

[sphinx]
recipe=zc.recipe.egg
eggs=
    Sphinx
    sphinxtheme.plone

pip install

Install sphinxtheme.plone with pip:

pip install Sphinx sphinxtheme.plone

or add it to a requirements.txt and run

pip install -r requirements.txt

Caution!

You should never use a checkout of the theme package for applying a theme to your documentations. Never touch this package to adjust configuration or customize parts, there is no need for that. Read the documentation please: http://docs.plone.org/

Configuration

Edit the “conf.py” configuration file to point to the plone themes:

# At the top.
import sphinxtheme.plone

# ...

# Activate the theme path:
html_theme_path = sphinxtheme.plone.get_html_theme_path()

# Activate the theme like this:
html_theme = 'plone_org_4'

Additional switches for the theme, see detailed documentation. For the current docs.plone.org, always set the following (this should be done in the conf.py of the related papyrus branch):

always_show_version_switcher = True always_show_language_switcher = True selected_version = the version of the docs that should come preselected in the dropdown, so 5, 4 or 3

Available Themes

  • plone_classic
  • plone_org_4
  • plone_org_5 (TODO: to be finalized)
  • plone_sunburst (TODO: to be finalized)
  • plone_barceloneta (TODO: to be implemented)

License

  • The technical parts of this project is licensed under the GPLv2 license.
  • The text and illustrations in this package / generated pages are licensed by the Plone Foundation under a Creative Commons Attribution 4.0 International license.
  • Plone and the Plone ® logo are registered trademarks of the Plone Foundation, registered in the United States and other countries.
  • For guidelines on the permitted uses of the Plone trademarks, see https://plone.org/foundation/logo
  • All other trademarks are owned by their respective owners.

Release history Release notifications

This version
History Node

0.5.7

History Node

0.5.6

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.1

History Node

0.3.1.dev0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
sphinxtheme.plone-0.5.7.tar.gz (1.3 MB) Copy SHA256 hash SHA256 Source None Oct 21, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page