[NTG-context] Preventing double title pages for nested content

[Kate F]

On 21 May 2015 at 23:06, Wolfgang Schuster <schuster.wolfgang at gmail.com> wrote:
>
>> Am 21.05.2015 um 23:44 schrieb Kate F <kate at elide.org>:
>>
>> On 21 May 2015 at 22:09, Wolfgang Schuster <schuster.wolfgang at gmail.com> wrote:
>>>
>>> Am 21.05.2015 um 14:33 schrieb Kate F <kate at elide.org>:
>>>
>>> On 21 May 2015 at 09:06, Wolfgang Schuster <schuster.wolfgang at gmail.com>
>>> wrote:
>>>
>>>
>>> Am 21.05.2015 um 00:36 schrieb Kate F <kate at elide.org>:
>>>
>>> Hi,
>>>
>>> There's been a misunderstanding here.
>>>
>>> You're showing a structure which is a two-deep hierarchy (Libraries
>>> containing Manpages). That's not what the structure in my example is,
>>> and you're showing something which I think is different to what I'm
>>> asking for. (Or I just can't see how to apply the technique you're
>>> illustrating)
>>>
>>>
>>> You have to add just another level to my example, nothing more.
>>>
>>> The structure for my example is Volumes which contain either Libraries
>>> *or* Manpages, and a Library contains Manpages. I'll draw out the tree
>>> from my example again:
>>> (this is the same as in my first email for this thread, but I'm
>>> repeating it here for clarity)
>>>
>>> \starttext
>>>  \placecontent[list={Volume,Library,Manpage}]
>>>
>>>  \startVolume[title=Section 1: Programs]
>>>      \dorecurse{3}{\startManpage[title=progxyz(1)] \input lorem
>>> \stopManpage}
>>>  \stopVolume
>>>
>>>  \startVolume[title=Section 2: Syscalls]
>>>      \dorecurse{3}{\startManpage[title=syscallxyz(1)] \input lorem
>>> \stopManpage}
>>>  \stopVolume
>>>
>>>  \startVolume[title=Section 3: Libraries]
>>>      \startLibrary[title=libjpeg]
>>>          \dorecurse{3}{\startManpage[title=jpegapi_a(3)] \input
>>> lorem \stopManpage}
>>>      \stopLibrary
>>>      \startLibrary[title=libpng]
>>>          \dorecurse{3}{\startManpage[title=pngapi_a(3)] \input
>>> lorem \stopManpage}
>>>      \stopLibrary
>>>      \startLibrary[title=libbmp]
>>>          \dorecurse{3}{\startManpage[title=bmpapi_a(3)] \input
>>> lorem \stopManpage}
>>>      \stopLibrary
>>>  \stopVolume
>>>
>>>  \startVolume[title=Section 4: Drivers]
>>>      \dorecurse{3}{\startManpage[title=drvxyz(1)] \input lorem
>>> \stopManpage}
>>>  \stopVolume
>>>
>>>  \startVolume[title=Section 7mk: Makefiles]
>>>      \dorecurse{3}{\startManpage[title=xyz.mk(1)] \input lorem
>>> \stopManpage}
>>>  \stopVolume
>>> \stoptext
>>>
>>> Please look at Volume 3; you can see it contains some Libraries
>>> (libjpeg, libpng, libbmp). The other Volumes do not contain Libraries;
>>> they just contain Manpages directly. So the ToC is:
>>>
>>> Volume 1: "Programs"       <-- I want a title page for this
>>>  ... manpages for (1)
>>> Volume 2: "Syscalls"       <-- I want a title page for this
>>>  ... manpages for (2)
>>> Volume 3: "Libraries"   <-- no title page for this!! Because this
>>> Volume contains Libraries
>>>  Library "libjpeg"       <-- I want a title page for this
>>>      ... manpages for (3) libjpeg
>>>  Library "libpng"       <-- I want a title page for this
>>>      ... manpages for (3) libpng
>>> Library "libbmp"       <-- I want a title page for this
>>>      ... manpages for (3) libbmp
>>> Volume 4: "Drivers"       <-- I want a title page for this
>>>  ... manpages for (4)
>>> Volume 7: "Makefiles"       <-- I want a title page for this
>>>  ... manpages for (7)
>>>
>>> As I said in my original email, this grouping into libraries only
>>> applies to Volume 3.
>>>
>>> The effect I'm trying to achieve is to have a single title page before
>>> each set of manpages. So I want a title page for "Programs",
>>> "Syscalls", "libjpeg", "libpng", "libbmp", "Drivers", and "Makefiles".
>>> But I do not want a title page for Volume 3 itself, "Libraries"
>>> because that would be immediately followed by the title page for
>>> libjpeg, and my aim is to avoid having two consecutive title pages. I
>>> have indicated these with arrows above.
>>>
>>> I hope that's clear. Sorry for repeating myself…
>>>
>>>
>>>
>>> Sorry for resending nearly the same example for another time but it still
>>> does what you asked for.
>>>
>>>
>>> But it doesn't...
>>>
>>> You have a page for Volume 3 (which is made blank due to your
>>> \ifnum\structurelistsize=0):
>>>
>>>
>>> You’re wrong, the test for \structurelistsize has nothing to do with the
>>> empty page.
>>>
>>> Volume 3: "Libraries"   <-- no title page for this!!
>>>
>>>
>>> Instead, I'm trying to find how to not have this produce a page (or
>>> some other way to achieve the same effect).
>>>
>>> And you have no title pages for these:
>>>
>>> Volume contains Libraries
>>>  Library "libjpeg"       <-- I want a title page for this
>>>      ... manpages for (3) libjpeg
>>>  Library "libpng"       <-- I want a title page for this
>>>      ... manpages for (3) libpng
>>> Library "libbmp"       <-- I want a title page for this
>>>
>>>
>>> These weren’t needed for the example
>>
>> They were the whole point of what I was asking for help with.
>
>
> \definehead [Volume]  [part]
> \definehead [Library] [chapter]
> \definehead [Manpage] [section]
>
> \setuphead
>   [Volume]
>   [placehead=empty,
>        after=\directsetup{libraryentries}]
>
> \setuphead
>   [Library]
>   [  page=,
>   placehead=empty,
>    before=\directsetup{Library:before},
>     after=\directsetup{Library:after}]
>
> \startsetups[Library:before]
>         \ifconditional\libraryentries
>                 \page
>         \else
>                 \settrue\libraryentries
>         \fi
> \stopsetups
>
> \startsetups[Library:after]
>         \startframed[frame=off,width=\textwidth,height=\dimexpr\textheight-\strutdp\relax,align={middle,lohi}]
>                 \placeheadtext[Library]
>         \stopframed
>         \page
> \stopsetups
>
> \newconditional\libraryentries \settrue\libraryentries
>
> \startsetups[libraryentries]
>         \determinelistcharacteristics[Library]
>         \ifnum\structurelistsize=0
>                 \startframed[frame=off,width=\textwidth,height=\dimexpr\textheight-\strutdp\relax,align={middle,lohi}]
>                         \placeheadtext[Volume]
>                 \stopframed
>         \else
>                 \setfalse\libraryentries
>         \fi
> \stopsetups
>
> %\showframe[text][text]
>
> \starttext
>
> \placelist[Volume,Library,Manpage]
>
> \startVolume[title=Section 1: Programs]
>   \dorecurse{3}{\startManpage[title=progxyz(1)] \input lorem \stopManpage}
> \stopVolume
>
> \startVolume[title=Section 2: Syscalls]
>   \dorecurse{3}
>     {\startManpage[title=syscallxyz(1)]
>      \input lorem
>      \stopManpage}
> \stopVolume
>
> \startVolume[title=Section 3: Libraries]
>   \startLibrary[title=libjpeg]
>     \dorecurse{3}
>       {\startManpage[title=jpegapi_a(3)]
>        \input lorem
>        \stopManpage}
>   \stopLibrary
>   \startLibrary[title=libpng]
>     \dorecurse{3}
>       {\startManpage[title=pngapi_a(3)]
>            \input lorem
>        \stopManpage}
>   \stopLibrary
>   \startLibrary[title=libbmp]
>     \dorecurse{3}
>       {\startManpage[title=bmpapi_a(3)]
>        \input lorem
>        \stopManpage}
>   \stopLibrary
> \stopVolume
>
> \startVolume[title=Section 4: Drivers]
>   \dorecurse{3}{\startManpage[title=drvxyz(1)] \input lorem \stopManpage}
> \stopVolume
>
> \startVolume[title=Section 7mk: Makefiles]
>   \dorecurse{3}{\startManpage[title=xyz.mk(1)] \input lorem \stopManpage}
> \stopVolume
>
> \stoptext
>
> Wolfgang

Yes! That's exactly what I was trying to achieve. Thank you.

Your code there is full of things I didn't know about, or didn't think
to use, but having just added some things to see what's going on, I
think I understand how it works. It's a very different implementation
than I had imagined!

-- 
Kate