GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
Already on GitHub? Sign in to your account
The homepage (http://readthedocs.org/docs/metlog-py/en/latest/) links to:
which seem like they could be top-level pages, but they're buried within paragraphs of other text on the homepage.
Sphinx doesn't seem to make it as easy as I'd like to replace the page-specific ToC w/ a docs-wide ToC on just the home page. I've added a "contents" section after the intro text, hopefully this will suffice.
Thanks! I remember tables of contents being pretty easy using the :toctree and :glob when I used to write docs. Did something change?
No, generating the table of contents is easy enough. What's weird to me is that there's a prominent ToC in the sidebar which is an auto-generated ToC for that page. I'd like to see that replaced by the docs-wide ToC, but only on the home page. Or maybe have it pushed down so that the docs-wide ToC and the page overview section is on each page. The latter wouldn't be hard, just some template customization, I'll probably end up doing that.