Thanks for the example, though I think my preamble settings are not at fault here.
One of my motivations for using hidden toctrees was to define the sequence for "previous" and "next" links in the HTML documentation. Is there another way to specify that sequence? My motivation was to support sequential reading for files that I have pulled out into separate freestanding documents (rather than creating giant unwieldy HTML pages. That is, something like this: Overview of Owl Maintenance Be careful of their talons and beaks! Also, make sure the feathers are clean and shiny. - Read more about talons (link to talon_maintenance.html) - Read more about beaks (link to beak_maintenance.html) - Read more about feathers (link to feather_maintenance.html) For the previous/next links I want the overview to lead to talon_maintenance and that to beak_maintenance, etc. (This is not quite working exactly as I wanted now, but it's close enough.) (Also, for Jeff - how do you get that local TOC in the sidebar for your HTML docs?) On Tuesday, September 13, 2016 at 10:53:42 AM UTC-4, Jeff McKenna wrote: > > To learn settings for latex/pdf output, I suggest you follow other > project's implementations and look at their settings used - for example, > I champion sphinx/pdf output for the MapServer community, and it > automatically generates an 839 page PDF with proper toctrees/bookmarks. > Take a look at the Latex output section of my conf.py at > https://github.com/mapserver/docs/blob/branch-7-0/conf.py#L170 which > generates http://www.mapserver.org/pdf/MapServer.pdf > > The preamble settings are very important. > > -jeff > > > > On 2016-09-12 6:37 PM, 'EMK' via sphinx-users wrote: > > I've been focusing on HTML for several months and now I'm trying to > > build PDF (via latexpdf) from the same files. > > > > I have one main toctree and several hidden toctrees. > > > > I'm having these problems: > > 1) All my contents go in one chapter, everything from all the toctrees > > ends up as Chapter 1 for some reason. > > 2) Even though I have set maxdepth to 3 in the main toc, I only see one > > level of headers in the table of contents > > 3) Documents in the hidden toctrees are listed in the table of > > contents. For example, I have a set of copyright statements and such in > > a hidden toctree to prevent warnings when I build, and it shows up in > > the PDF document table of contents > > > > Note: We haven't updated from Sphinx 1.3 yet, so if that makes a > > difference we can upgrade. > > > > Here's an example of how my index.rst file looks: > > > > .. toctree:: > > :maxdepth: 3 > > :name: main > > > > intro > > common_tasks > > settings > > support > > > > :ref:`genindex` > > :ref:`search` > > > > appendix_1 > > appendix_2 > > > > .. toctree:: > > :hidden: > > :maxdepth: 1 > > :name: common_tasks_toc > > > > task_1_overview > > task_2_overview > > > > .. toctree:: > > :hidden: > > :maxdepth: 1 > > :name: settings_toc > > > > settings_topic_1 > > settings_topic_2 > > settings_topic_3 > > > > .. toctree:: > > :hidden: > > :name: hidden files > > > > frontmatter > > doc_warnings > > license_info > > > > Here is what I am getting in my PDF table of contents: > > > > CONTENTS > > > > 1. Contents > > > > 1.1 About MyProduct > > 1.2 Common Tasks for MyProduct > > 1.3 MyProduct Settings > > 1.4 Contacting Support > > 1.5 Appendix 1: Something Not Very Important > > 1.6 Appendix 2: Something Else Of Limited Interest > > 1.7 Task 1 Overview > > 1.8 Task 2 Overview > > 1.9 How To Set Item1 > > 1.10 How To Set Item2 > > 1.11 How To Set Item3 > > 1.12 Index and Search > > 1.13 Copyright Information > > 1.14 Warnings Used in This Document > > 1.15 License Information > > > > What am I doing wrong here? > > > > -- 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+unsubscr...@googlegroups.com. To post to this group, send email to sphinx-users@googlegroups.com. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
