Customizing the theme

Version (1) This page describes how to add customizations to the theme used on this project.

This project uses this basicstrap (Bootstrap based) theme as base theme. See documentation of basicstrap here . This theme uses jinja 2 as a template engine.

Theme files are located at _theme folder. Inside _theme folder, we have the _static folder that contains the static files like css files, js and images. To call a resource from _theme/_static you must to use {{ pathto('_static/pathtoyourfile/file.extension', 1) }}" (needs to explict the number 1 or 0 as a parameter to enable or disable this resource) inside href or src attribute.

To enable your custom css as main css to theme you need to change theme.conf and set your css in stylesheet variable.

Is possible set some layout things inside config.py e.g:

html_theme_options = { 'header_inverse': True, 'relbar_inverse': True, } this command change the header color to the inverse color (Boostrap navbar-inverse) see html_theme_options reference.

Project name, Copyright and Author are manipulated by config.py. To get a full width of page you must to use {{class_row}} inside the class attribute.

After you made any change, you need to run make html or sh build.sh to see your new changes.