Package: themata
themataSet of Highly customizable sphinx themes.OverviewThis package contains different sphinx theme that can be easily customized to look like
a complete website or just a documentation webpage.To use one of the theme install the themata package from python index.pipinstallthemataor equivalent (addthematato any appropriate requirements files).The following themes are implemented in the project. Follow the link for detail documentation for
each of the themes.hackishmilkishfandangoclearfluidgarriwatersugarTo use one of the them install the themata package, and specify the theme to use in theconf.pyfile.ExampleTo use the milkish theme, set the following option in yourconf.pyfile.importosimportthemataproject='First Doc'copyright='2020, Adewale Azeez'author='Adewale Azeez'html_favicon='favicon.png'html_theme='milkish'Each of the themes has theme options to customize the look of the generated pages. The options for
each of the themes can be view on their documentation page (links above).DocumentationThe full documentation is athttps://thecarisma.github.io/themata.
To read the documentation offline run thegendoc.batcommand in the docs/ folder to generate adistfolder.How it worksIn each of the theme folder, thetheme.confis used to declare the the defult theme options, thelayout.htmlfile is the template for all the generated pages in the theme. The__init__.pyfile is where the theme and it version is added to sphinx.static*.css_tis the cascaded style
sheet template for the theme.ContributingFork the project clone thetestbranch
to view the static test folder which is used as template for the main theme module in
themata. Copy one of the static folder change the css to suite your need, then make a copy of one
of the theme inthematafolder then add your static css file ending with .css_t. Write a
documentation for the new theme in thedocfolder. Send in a PR if it OK it will be merged
into the main project.If you have any feature request or issue, open a new issuehere.Useful LinksPythonSphinxSphinx TemplatingLicenseCreative Commons Zero v1.0 Universal License. Copyright (c) 2020 Adewale AzeezChange Log1.13makes left sidebar and header of water theme fixedhttps://github.com/Thecarisma/themata/issues/118346703addd colapsible sidebar theme option to water themecb95e5fnavbar links now accept relative and absolute links instead of absolute onlyhttps://github.com/Thecarisma/themata/issues/15f1acf57update the layout.html to add proper source suffix for edit page0cd48d61.11reduce margin and spacing the code blockd942fdbadd theme options to customize note, warning, seealso and topic background and borderhttps://github.com/Thecarisma/themata/issues/6befd80aadd the documentation for theme option cutomize the table row backgroundba46635fix table overflow, table customization should be done by user with custom csshttps://github.com/Thecarisma/themata/issues/8a02e558add support for metadata and twitter_metadatahttps://github.com/Thecarisma/themata/issues/979d50a9add support for metadata and twitter_metadatahttps://github.com/Thecarisma/themata/issues/921393b4add support for metadata and twitter_metadatahttps://github.com/Thecarisma/themata/issues/9b59ae69make the title bold and reduce the monstrous padding in code block.https://github.com/Thecarisma/themata/issues/1223e5336make the title bold and reduce the monstrous padding in code blockac160e9modify the table css to make it look more clean and stylish36a71d4change the style of the code renderinge78e1c71.1Remove <no title> from pages with no title. If no title set title to page or project name731e51dAdd theme option to set the document font-sizeaefa7acAdd theme option document font-size to each theme documentationa474591Put note on top of each theme page that link back to themata8b3bc8dMake the document occupy 100% in sugar theme if left and right sidebar is disabled439fd97Add optional ‘edit this page’ button to webpages e.g. edit on githubdf0987cAdd source_root option for the edit on link and source_root_edit_text for the text to display to theme optiondf0987cDocument the source_root and source_root_edit_text theme optionse9ea268# TODOUse a script to generate pymodule from the test folder