Re: [sphinx-users] How to create Sphinx base theme from scratch?

[Matt from Documatt]

Hi Nizar,

I was in the same situation months ago. Basic theme has many template files, but only usually only important is layout.html. layout.html template is used for all pages including search, index etc., page.html for pages from documents (rst files). To understand blocks in layout.html, you can use this https://documatt.gitlab.io/sphinx-themes/learn_basic_theme_project/.

For inspiration for creating modern themes with SASS/ES6 and Bulma, see themes in https://gitlab.com/documatt/sphinx-themes. I also wrote a few articles about Sphinx theming at https://techwriter.documatt.com/sphinx-theming/index.html that explain "missing bits".

Feel free to ask for more details!

Matt

https://techwriter.documatt.com

On Sat, Aug 29, 2020 at 10:47 PM Nizar DELLELI <nizar....@gmail.com> wrote:

hi all;

can anyone explain me the basic theme files/templates and its hierarchy ? i'm trying to develop my own from scratch. the basic theme's logic and its html markup seems to be old and i want to get stuck with html5boilerplate template.

i already asked a question on stackoverflow 

https://stackoverflow.com/questions/63117883/how-to-create-sphinx-base-theme-from-scratch

can you point me to some good tutorial about this particular topic ?

 

i appreciate your kind help

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/dbff0e42-77da-4be4-9d5b-ff51954b7246n%40googlegroups.com.

[Daniel Scott]