I am still trying to understand the logic. In our case, here is part of
conf.py:
latex_documents = [
('documentation', 'MapServer.tex', ur'MapServer Documentation',
ur'The MapServer Team', 'manual', False),
]
latex_elements = {
'preamble': '\setcounter{tocdepth}{3}'
}
So I assume that the new :maxdepth: values are to be set in our
"documentation.txt" file. Problem is that we set :maxdepth: there for
various sections, to a value of 2 (we want a maxdepth of 2 for html, and a
maxdepth of 3 for latex/pdf).
Here is how our documentation.txt (the master document) looks:
Introduction
----------------
.. toctree::
:maxdepth: 2
Tutorial
----------
.. toctree::
:maxdepth: 2
Installation
---------------
.. toctree::
:maxdepth: 2
So how do we configure this so that we have a maxdepth of 3 for latex
output, and keep maxdepth of 2 for regular html output?
For previous versions <1.3.5 we would just set the preamble in conf.py for
latex output's tocdepth.
Very confusing :)
-jeff
On Monday, February 29, 2016 at 1:50:16 PM UTC-4, Jeff McKenna wrote:
>
> Hi Takeshi-san,
>
> I am a little confused. What I/we've always done to set the TOC depth
> for the latex (PDF) builds was to use the preamble, set in conf.py, so
> it applies all throughout. Are you saying that in conf.py we should
> set :maxdepth: now?
>
> We already set :maxdepth: throughout our many rst files, yet no matter
> where we set this, the resulting .tex file always states
> "\setcounter{tocdepth}{1}". However, what we need is a "master" setting
> in the conf.py file, to set the "tocdepth" counter for latex.
>
> Can you please explain how to set the tocdepth in the conf.py file?
>
> Sorry for my questions.
>
> Thanks,
>
> -jeff
>
>
>
>
>
> On 2016-02-29 11:32 AM, Komiya Takeshi wrote:
> > Hi,
> >
> > Sorry for inconvinience.
> >
> > Since 1.3.5, LaTeX writer supports :maxdepth: option for toctree
> directive.
> > It sets up `tocdepth` counter if :maxdepth: found.
> > So please set up your :maxdepth: option.
> >
> > BTW, it seems worse that the `tocdepth` counter is defined after
> > latex_elements['preamble'].
> > I'll fix it in next version.
> >
> > Thanks,
> >
> > 2016年2月27日土曜日 7時32分35秒 UTC+9 Jeff McKenna:
> >
> > Hi everyone,
> >
> > Using 1.3.5 it seems that when generating latex the resulting
> > tocdepth is always set to a "1". Here is part of my conf.py:
> >
> > latex_elements = {
> > 'preamble': '\setcounter{tocdepth}{3}'
> > }
> >
> > And the resulting *.tex file seems to set that value, and also a
> > value after the title:
> >
> > \setcounter{tocdepth}{3}
> >
> > \title{MapServer Documentation}
> > \date{February 26, 2016}
> > \release{7.0.1}
> > \author{The MapServer Team}
> > \newcommand{\sphinxlogo}{\includegraphics{banner-large.png}\par}
> > \renewcommand{\releasename}{Release}
> > \setcounter{tocdepth}{1}
> > \makeindex
> >
> > Is anyone else hitting this problem?
> >
> > Thanks,
> >
> > -jeff
> > mapserver.org <http://mapserver.org>
> >
> >
> > --
> > 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]
> > <mailto:[email protected]>.
> > To post to this group, send email to [email protected]
> > <mailto:[email protected]>.
> > Visit this group at https://groups.google.com/group/sphinx-users.
> > For more options, visit https://groups.google.com/d/optout.
>
>
--
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 post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
