Re: A proposal for the sectioning commangs

[Hans Hagen <pragma@wxs.nl>]

At 03:46 PM 6/21/2002 +0200, Giuseppe Bilotta wrote:

>one of the main features of both ConTeXt and LaTeX over plain TeX
>is their heavily "object-oriented" approach to source writing,
>giving a large set of useful tools to build well-structured
>documents.
>
>There is though one aspect which has not been addressed in either:
>structuring of the sections. One still uses \chapter, \section,
>\subsection etc to denote the start of any of these, while
>structured writing would call for \startchapter ... \stopchapter,
>\startsection ... \stopsection etc.
>
>My proposal is to switch to such a method, while still retaining
>compatibility with the old-style sectioning (maybe we can use some
>flag like the one used to left left/right alignment use the
>_correct_ term --what was the switch name?).

actually, this is on my to do list, for most of the project that we run 
currently we use this approach since it gives you the options

(1) to skip a chapter / section
(2) to attach hooks to the end-of-some-section

>How should it work:
>
>\startchapter[optional reference name]
>
>Possible stuff before the title (e.g. an epigraph)
>
>\title{Title of the chapter}
>Optional commands to set alternative forms of the title (see
>below)

no, just \startchapter[ref]{title} is ok, since i don't want to pick up the 
title separately (imagine that you want \startchapter to trigger a complex 
title page

also, we currently test (play with) some mechanism to have section (or 
whatever) dependent variables, thereby introducing more convenient ways to 
tune typo behaviour.

* easy way to set different titles for ToCs, running heads, (PDF)
>bookmarks etc. Consider the following hierarchy of titles:
>
>title listtitle markingtitle bmtitle

that's for variables (since here we also have things like several graphics 
to be used in typesetting the chapter page)

>write anything to the .tuo file; this ought to be done by the
>\stop<section-name> command, which would save all of them together
>with the appropriate counter values and beginning/ending page.

hm, i'm not sure if i like that

>* easy way to put things before the title (e.g. an epigraph) while
>still within the structure of the section.
>
>* also comes from the above: currently, when using the /XYZ method
>for PDF references, link targets end out-of-the-window because the
>TeX cohordinate used is that of the baseline. This means that the
>visible part of the page does not include the target reference
>(which is rather uncomfortable). Instead, with the new approach
>the mark could be set "right before everything else, but still
>within the correct structure", with optimal PDF navigation.

that is a whole different matter, (1) output format/driver dependent and 
(2) can handled now by moving things around and (3) we don't want those 
funny nodes to screw up the spacing [actually, since i never use that xyz 
way of viewing docs [too inconstent auto scaling in viewers] i never felt 
the need to look into it; maybe something for a cold winter night]

>Hans, do you think you can implement this easily?

the \start-\stop thing will certainly be there

Hans
-------------------------------------------------------------------------
                                   Hans Hagen | PRAGMA ADE | pragma@wxs.nl
                       Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
  tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
                        information: http://www.pragma-ade.com/roadmap.pdf
                     documentation: http://www.pragma-ade.com/showcase.pdf
-------------------------------------------------------------------------