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.
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:
Put your avatar image file into the static folder with the name avatar.jpg.
Edit the theme configuration file theme.conf:
Change direction:
direction = ltrFor “right-to-left” languages, set it to rtl
Add your Google Analytics ID:
analytics_id = UA-XXXXX-XAdd 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.
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)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinx_minoo_theme-1.2.0.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|