Skip to main content

Minoo Theme is a Sphinx theme that supports right-to-left languages like Persian. It is available on PyPI and enables developers to create documentation websites with an elegant and functional design that works well with RTL languages.

https://badge.fury.io/py/sphinx_minoo_theme.svg

Features

  • Material Colors

  • RTL language support

  • Responsive design

  • Google Analytics integration

  • Social links and avatar

  • Free to use

Installation

Via package

You can install Minoo Theme from PyPI:

$ pip install sphinx_minoo_theme

To use the theme in your Sphinx project, edit your Sphinx configuration file conf.py as follows:

# At the top.
import sphinx_minoo_theme

# ...

extensions = ["sphinxcontrib.jquery"]
html_theme = "sphinx_minoo_theme"
html_theme_path = [sphinx_minoo_theme.get_html_theme_path()]

Via git or download

Alternatively, you can download the theme from the repository and copy sphinx_minoo_theme/sphinx_minoo_theme into your documentation at _templates folder. Then, add the following lines to your conf.py file:

extensions = ["sphinxcontrib.jquery"]
html_theme = "sphinx_minoo_theme"
html_theme_path = ["_templates"]

Customisation

To customize the Minoo Theme, follow these steps:

  1. Put your avatar image file into the static folder with the name avatar.jpg.

  2. Edit the theme configuration file theme.conf:

  • Change direction:

    direction = ltr

    For “right-to-left” languages, set it to rtl

  • Add your Google Analytics ID:

    analytics_id = UA-XXXXX-X
  • Add your website address and social links:

    website =
    facebook =
    googleplus =
    linkedin =
    twitter =
    github = https://github.com/saeiddrv/SphinxMinooTheme
    gitlab =
    bitbucket =

    Leave empty whichever you don’t want.

  1. Edit the glossary.html file to change the theme words.

License

Minoo Theme is licensed under the MIT License. For more information, see the LICENSE file.

Gratitude

I would like to thank sphinx_rtd_theme for helping me build this theme.

Metadata

Release files for sphinx_minoo_theme 1.2.0

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

Source distribution (sdist)

Source distribution for sphinx_minoo_theme 1.2.0
File Size Uploaded
sphinx_minoo_theme-1.2.0.tar.gz 1.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for sphinx_minoo_theme 1.2.0
File Interpreter ABI Platform
sphinx_minoo_theme-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.0 MB

Release files / sphinx_minoo_theme-1.2.0.tar.gz

Download URL sphinx_minoo_theme-1.2.0.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
751103f37718b37cc3be58463847864458f99da64a6a7ad7c56fd7cb1315b8bc
BLAKE2b-256 checksum
How to use checksums
f62cb3a51a66f14482ca70d5bf2a8adc80aa7efdba709f7b2e545a1c14f9e4de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.9.22 Linux/6.11.0-1014-azure

Release files / sphinx_minoo_theme-1.2.0-py3-none-any.whl

Download URL sphinx_minoo_theme-1.2.0-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
cee80780ddbec9b47a4c1806f2e722cdd7bcc23c480ff3c250c74862502c43f2
BLAKE2b-256 checksum
How to use checksums
7096baad6fa857446ad19c223a500efd5881b20334a2c257a505468e5da45a2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.9.22 Linux/6.11.0-1014-azure

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.0.1

2 release files

0.9.7

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