Hello Ken and Komia,
a little bit late to the party... I use exactly what you want to achieve on
my recently launched blog https://blog.documatt.com (it's regular Sphinx
project). Front page (index.rst) uses index.html template thanks to

html_additional_pages = {    'index': 'index.html',}

The rest of the blog uses layout.html. I've just created a repo showing it.
It includes output index.html under _build/html/.

Matt
https://blog.documatt.com

On Thu, May 21, 2020 at 4:58 PM Ken <[email protected]> wrote:

> Any suggestions for how to add a custom template for the first/top page
> (index.html) for html output?
>
> It looks like by default, Sphinx uses page.html (which in turn references
> layout.html), but it's not clear to me how to customize just one page (in
> this case the "home" page).
>
> I've got html_additional_pages = {'index': 'index.html'} and
> html_theme_path is set to a local folder with my index.html template;
> however, my index.html template never seems to be used. BTW my custom
> layout.html template file in the same folder IS being used for all the
> pages, so I know Sphinx is at least finding my files.
>
> Thanks!
>
>
> --
> 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 [email protected].
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/sphinx-users/c4b43c97-e534-45bc-ac23-7b1c7f9a9d7f%40googlegroups.com
> <https://groups.google.com/d/msgid/sphinx-users/c4b43c97-e534-45bc-ac23-7b1c7f9a9d7f%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>

-- 
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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/CAOGNDW8kesKQpOOGW6O_TMKLYmti7df01GWaZzc%3D3NAR%2BckEpQ%40mail.gmail.com.

Reply via email to