getzola / book

Gitbook theme for Zola
MIT License
57 stars 19 forks source link

Add content to homepage #2

Closed codesections closed 6 years ago

codesections commented 6 years ago

The current index.html template does not provide any content for the homepage—it leaves the body of the page blank. This does not seem to be consistent with how other book-style themes work; they typically either display the first section or, more rarely, display custom content.

This change would allow either behaviour: if any content is provided in _index.md, it would display that content. Otherwise, it would default to displaying the first section.

Compare the existing functionality at the demo site I put together (which displays a blank homepage) with the Rust Book (which displays the first section on the homepage).

Keats commented 6 years ago

Maybe the index should just redirect to the first section? With your fix, it won't highlight the right section in the sidebar no?

Keats commented 6 years ago

Actually the index page already redirects in this repo, maybe it can just be added as a note in the README instead?

codesections commented 6 years ago

As I noted in #1, I followed your suggestion of adding a note. I put it in that pull request to avoid a merge conflict with other changes I suggested to the README.