How to add the custom root page feature?

[sandrokeil]

@pmjones I want to add the custom root page feature. What is the best way?

1. Simply allow index as content page and if set, create a toc.html file
2. Add a new bookdown.json entry rootPage and use it as index.html and create a toc.html file

[pmjones]

Yes, this one could be handled a lot of different ways.

What I had in mind what that if there is an "index" content page, either put the TOC above it on the same page, with the rest of the "index" page content. (What happens in Docbook is that the TOC goes at the top of the page, and that TOC includes the contents of that page.) However, there might be better variations of that.

Hope that makes sense.

[sandrokeil]

I think if someone want to use an index page, he/she don't want to have the TOC on this page. In my use case, I want a custom start page with an individual overview or description.

So No. 1 is good for me. It's also possible to create an own template with individual layout. I think this is the easiest way for the user.