Skip to main content

Editorial Sphinx Theme

Build Status Download per month Package version Python License Supported Python versions Dependency npm Status Dependency PyPi Status

Editorial is a theme for Sphinx, focused to facilitate the reading of the documentation to allow to use the entire width of the screen, your design is responsive and adapts to any device

Live example of this theme can be seen on:

This template is based on Editorial by HTML5 UP (html5up.net), just made the changes needed to use it at the Sphinx.

Features

  • Easy installation, does not make any extra settings

  • Clean and simple design

  • Responsive, adaptable from mobile devices to PC

  • Hide sidebar with one click

  • Integrated and optional support for Google Analytics

Installation

Via package

Download the package or add it to your requirements.txt file:

$ pip install editorial_sphinx_theme

In your conf.py file:

import editorial_sphinx_theme

html_theme = "editorial_sphinx_theme"

html_theme_path = [editorial_sphinx_theme.get_html_theme_path()]

Via git or download

You can install it directly from the Git repository, keep in mind that this will download the last changes made that may not be stable and lead to failures. For sites in production try to use the version available in PyPi.

There are two main branches ‘master’ with stable code and ‘develop’ with the latest modifications made.

Symlink or subtree the editorial_sphinx_theme/editorial_sphinx_theme repository into your documentation at docs/_themes/editorial_sphinx_theme then add the following two settings to your Sphinx conf.py file:

Branch master

pip install -e git+https://gitlab.com/opb/editorial-sphinx-theme.git@master#egg=editorial_sphinx_theme

Branch develop

pip install -e git+https://gitlab.com/opb/editorial-sphinx-theme.git@develop#egg=editorial_sphinx_theme
html_theme = "editorial_sphinx_theme"
html_theme_path = ["_themes", ]

Options

Basic

Basic tools or functions

scroll_to_top

Include a button in the lower right corner to return to the top of the page.

prev_next_buttons_bottom

Navigation buttons at the end of the page, to go to the previous and next page.

prev_next_buttons_sidebar

Navigation buttons at the end of the sidebar, to go to the previous and next page.

Repo info

Information related to the used repository

repo_name

Name of the repository service, for example GitLab. This name will be displayed in some parts of the page.

repo_url

Repository address, for example: https://gitlab.com/opb/editorial-sphinx-theme

Google Analytics [Optional]

analytics_id

This indicates the Google Analytics ID used by this service, if you do not pass any value the javascript script will not load on the page. The value must have the format “UA-XXXXX-Y”.

analytics_async

This option indicates which version of the Google Analytics script to use, for more information in your website https://developers.google.com/analytics/devguides/collection/analyticsjs/#alternative_async_tracking_snippet

Fork Me Ribbon [Optional]

You can enable the use of a ribbon in a corner of the page, with the legend “Fork me on <repo_name>” and the destination url is the repository specified in the ‘repo_url’

The options that you can use are as follows:

forkme_ribbon

It enables the use, only loaded if it is equal to ‘True’.

forkme_alignment

Where shown, take the following locations: left-top, right-top, left-bottom, right-bottom

forkme_fixed

If you pass ‘True’ to this option, the ribbon will be shown with the CSS property fixed, and as we scroll on the page will continue showing in the same corner.

How To Contribute

  • Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.

  • Fork the repository on GitHub to start making your changes, preferably create a branch to dump these changes.

  • Run or write tests to make sure everything works correctly.

  • Send a pull request when you have finished

License

This template is distributed under the GNU General Public License v3 (GPLv3) license, for more information see the file LICENSE.

Metadata

Release files for editorial-sphinx-theme 1.0.1

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

Source distribution (sdist)

Source distribution for editorial-sphinx-theme 1.0.1
File Size Uploaded Provenance Actions
editorial_sphinx_theme-1.0.1.tar.gz 707.7 kB Without provenance Details for editorial_sphinx_theme-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for editorial-sphinx-theme 1.0.1
File Interpreter ABI Platform Actions
editorial_sphinx_theme-1.0.1-py2.py3-none-any.whl Python 2, Python 3 none any Details for editorial_sphinx_theme-1.0.1-py2.py3-none-any.whl

Total release size: 726.8 kB

Release files / editorial_sphinx_theme-1.0.1.tar.gz

Download URL editorial_sphinx_theme-1.0.1.tar.gz
Size 707.7 kB
Tags Source
SHA-256 checksum
How to use checksums
9276a74503d000d384afe8fb6e51f335346a559a53811f16673bc584d13bc667
BLAKE2b-256 checksum
How to use checksums
eec3b080d8f9c1893abf70de62803667ef8caf77840a8160f0994db84cf3af6f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / editorial_sphinx_theme-1.0.1-py2.py3-none-any.whl

Download URL editorial_sphinx_theme-1.0.1-py2.py3-none-any.whl
Size 19.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
9659beb20fb4e74467427b0a579fee59bf5219c896775a4e5ce692105df3d1d3
BLAKE2b-256 checksum
How to use checksums
f2533311279c39e90e3130a63940b3011b21f2b3874fe0a2d6c76b65dd3d6833
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for editorial-sphinx-theme 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

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