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

20 May 2015

      On 20 May 2015 at 22:19, Wolfgang Schuster  wrote:
...
...
Am 20.05.2015 um 01:26 schrieb Kate F :
On 19 May 2015 at 23:51, Wolfgang Schuster  wrote:
...
...
Am 20.05.2015 um 00:34 schrieb Kate F :
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.
It doesn’t matter which name you use for the sections.
\definehead [Library] [part]
\definehead [Manpage] [chapter]
\setuphead
  [Library]
  [placehead=empty,
   before={\startmakeup[standard][align=middle,style=\ssd]},
   after={\directsetup{chapterentries}\stopmakeup}]
\startsetups[chapterentries]
        \determinelistcharacteristics[Manpage]
        \ifcase\structurelistsize
                No manpages for this libary.
        \or
                One manpage for this Library
        \else
                Two or more manpages for this library.
        \fi
\stopsetups
\starttext
\startLibrary[title=First Library]
        \startManpage[title=Manpage 1]
        \stopManpage
\stopLibrary
\startLibrary[title=First Library]
\stopLibrary
\startLibrary[title=First Library]
        \startManpage[title=Manpage 1]
        \stopManpage
        \startManpage[title=Manpage 2]
        \stopManpage
        \startManpage[title=Manpage 3]
        \stopManpage
\stopLibrary
\stoptext
Wolfgang
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)

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...

Thank you!

-- 
Kate