Skip to main content

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

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)

Contribute

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 files for sphinxtheme.plone 0.5.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinxtheme.plone 0.5.8
File Size Uploaded
sphinxtheme.plone-0.5.8.tar.gz 1.3 MB Details

Release files / sphinxtheme.plone-0.5.8.tar.gz

Download URL sphinxtheme.plone-0.5.8.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
9a88fc91b9012b67f0cf27f3052c64811a7b2ba98ac29772812ca9730506f14a
BLAKE2b-256 checksum
How to use checksums
14c2a324955c11708d1c8761baf9b549ac0ef7f0448c24eae73670bd0f5c2395
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

Release history Release notifications | RSS feed

This release

0.5.8 This release

1 release file

0.5.7

1 release file

0.5.6

1 release file

0.5.5

1 release file

0.5.4

1 release file

0.5.3

1 release file

0.5.2

1 release file

0.5.1

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page