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

Kate F kate at elide.org
Wed May 20 01:26:46 CEST 2015


On 19 May 2015 at 23:51, Wolfgang Schuster <schuster.wolfgang at gmail.com> wrote:
>
>> Am 20.05.2015 um 00:34 schrieb Kate F <kate at elide.org>:
>>
>> Hello!
>>
>> I'm collating some UNIX-like manpages into a PDF.
>> I'm structuring the content like so:
>>
>>  \setupcolors[state=start]
>>
>>  \definehead[Volume] [part] % red colour: man(1) section
>>  \definehead[Library][part] % blue colour: library within section 3
>>  \definehead[Manpage][chapter]
>>
>>  \setuphead[Volume,Library,Manpage][page=yes,number=no,placehead=yes]
>>  \setuphead[Volume][color=red]
>>  \setuphead[Library][color=blue]
>>
>>  \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
>>
>> There I have grouped Volume 3 manpages into libraries. This grouping only
>> applies to Volume 3.
>>
>> I'd like a single "title" page for each Volume (which I show in red),
>> except for section 3, where I'd like a title page for each Library
>> (which I show in blue). So the pagination should look like:
>>
>>  toc S1 ... S2 ... libjpeg ...  libpng ... libbmp ... S4 ...
>>
>> Where S* there is a red title page, S3 is absent, and lib* are blue title pages.
>> I'm trying to work out how best to do this.
>>
>> Would you recommend I hide Volume 3's title page?
>> I think that must be the simplest way, but I don't know how to do it
>> using a setup.
>>
>> My data is coming from XML, and I'd like to avoid having a special
>> \startVolume for Volume 3, if I can. Although perhaps that could help.
>>
>> Are there any other ways which might be more sensible?
>>
>> I wondered about using \setuphead[something][continue=yes] to fold the
>> first blue title pages onto the red title pages, but even if I can do that,
>> I think it would make things more difficult for getting the text right on
>> those pages.
>
> Change your manpage headings to \chapter and test at the begin of each
> new volume for the number of chapters (you can use the list mechanism
> for this) in each volume.
>
> %\setuphead[part][placehead=yes,after=\directsetup{chapterentries}]
> \setuphead[part][placehead=empty,after=\directsetup{chapterentries}]
>
> \startsetups[chapterentries]
>   \determinelistcharacteristics[chapter]
>   \ifcase\structurelistsize
>     No chapter in this part.
>   \or
>     One chapter in this part.
>   \else
>     Two or more chapters in this part.
>   \fi
> \stopsetups
>
> \starttext
>
> \dorecurse{4}
>   {\startpart[title=Part #1]
>    \dorecurse{\ifcase#1\or 0\or 3\else 1\fi}
>      {\startchapter[title=Chapter ##1]
>           \stopchapter}
>    \stoppart}
>
> \stoptext
>
> Wolfgang

Very interesting!

I don't want to use \chapter because I'm dealing with several types of
document, and so I'm trying to keep different things separate, so that
I don't confuse myself with all the setups. But I just converted your
example to use \definehead[Manpage] instead, and that seems to have
the same effect for \determinelistcharacteristics[Manpage].

Maybe I'm being unimaginative, but I don't see how you're suggesting I
use this technique to achieve the effect I'm after. Did you mean to
count Libraries rather than Manpages? Even then I'm not sure how to
apply the idea. (Especially as your example doesn't have the same
structure as mine.)

Sorry if my original description was unclear.

Thanks,

-- 
Kate


More information about the ntg-context mailing list