Skip to content

saeiddrv/SphinxMinooTheme

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

Minoo


Minoo is a simple Sphinx theme with supports right-to-left languages such as Persian.

Features

  • Material Colors
  • RTL language
  • Responsive
  • Google Analytics id
  • Social Links and Avatar
  • Free

Installation

Via package

  1. Installing from PyPI:

    $ pip install sphinx_minoo_theme
    
  2. Edit the Sphinx configuration file conf.py

    # At the top.
    import sphinx_minoo_theme
    
    # ...
    
    html_theme = "sphinx_minoo_theme"
    
    html_theme_path = [sphinx_minoo_theme.get_html_theme_path()]
    

Via git or download

  1. Copy sphinx_minoo_theme/sphinx_minoo_theme from repository into your documentation at _templates folder.

  2. Edit the Sphinx configuration file conf.py

    # ...
    
    html_theme = "sphinx_minoo_theme"
    
    html_theme_path = ["_templates"]
    

Customisation

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

Edit the theme configuration file theme.conf

  1. Change direction:

    direction = ltr
    
for "right-to-left" languages set on rtl
  1. Add your Google Analytics id:

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

    website =
    facebook =
    googleplus =
    linkedin =
    twitter =
    github = https://github.com/saeiddrv/SphinxMinooTheme
    gitlab =
    bitbucket =
    
Whichever you don't want, left empty!

Edit the glossary.html file

  1. In this way, you can change the theme words!

License

The MIT License (MIT)

Gratitude

sphinx_rtd_theme helped me build this theme.

About

A simple Sphinx theme with RTL support.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published