Re: Page Numbering Hell (SOLVED)

["Bryant Eastham" <beastham@pewla.us.pewg.panasonic.com>]

[-- Attachment #1.1.1: Type: text/plain, Size: 5053 bytes --]

All-

 

I have attached a heavily commented MKII example that implements the
structure that I want. The notes identify several (IMHO) weak spots in
documentation, especially some consistency issues.

 

In order to implement this (some said "simple") format, I used:

*         http://www.pragma-ade.com/general/manuals/cont-enp.pdf (the
manual)

*         
http://www.opensubscriber.com/message/ntg-context@ntg.nl/9815615.html

*         http://wiki.contextgarden.net/Biochemistry_textbook

*         http://texshow.contextgarden.net

*         
http://wiki.contextgarden.net/Titles#Truly_empty_pagebreak_before_chapte
rs

 

I'm fine with that. For those (most, I imagine) who don't want to wade
through the notes, here is a summary of the most (again, IMHO) issues:

*         startsectionblockenvironment does not appear documented, and
appears to be critical for this style

*         setuppagenumbering documentation is hard to follow for options
'by\em{section}' and '\em{section}number'

o   The manual uses inconsistent italics

o   The texshow page doesn't use italics where it should

*         setupcombinedlist (through setuplist) has the same
inconsistent use of italics.

*         setuphead is not documented completely (no reference to
special 'page' formats)

*         definepagebreak not documented

 

Also, the solution for 'truly empty pagebreak before chapters' does not
appear to work for the last chapter in the document.

 

I would be more than happy to contribute to the texshow documentation
and wiki, assuming that I would be given an account... J

 

The list appears to be dead again, so I hope this makes it through.

 

Thanks,

-Bryant

 

From: ntg-context-bounces@ntg.nl [mailto:ntg-context-bounces@ntg.nl] On
Behalf Of Bryant Eastham
Sent: Wednesday, October 21, 2009 12:37 AM
To: ntg-context@ntg.nl
Subject: [NTG-context] Page Numbering Hell

 

All-

 

A few days ago when I first stumbled on ConTeXt I was very, very
excited. I have some 500 pages of technical documentation that could
benefit from this, particularly since I need Japanese font support. But
it has to be real.

 

I'm sorry if this sounds caustic, but after 12 hours of failed attempts
to even get a minimal document formatted I have some serious questions
for the list:

 

1.       Is Mark IV real? I am only somewhat joking here - after
spending hours searching for reasonable documentation on even the most
trivial options, I am left wondering whether this is something I want to
use...

2.       ConTeXt looks great. But what is current? Seriously, I like the
look and the support (particularly Unicode). But going over
documentation I cannot make heads or tails of what to do. Mark II? Mark
IV? TeTeX? LuaTeX? If I really want to use this, what should I use?

3.       Having answered #2, where in the world is a reference manual!!!
I mean one that actually *documents the options*.

4.       Having answered #3, are there any current examples that
actually work? The snippets from the mailing are great, but they are
just snippets. That doesn't help me.

 

Now, to resolve my immediate issue, and just because I will not be able
to sleep well until I figure this out (yes, I am fixated on this).

 

I want this document structure:

 

Contents

1.       Chapter                                   1-1

1.1 Section                             1-2

2.   Chapter 2                                  2-1

    2.1 Section                                 2-2

 

Table of contents on page "i".

Even/odd, each chapter starts on right page.

Page number (as in 2-2) in top margin.

Mark IV, Lua document.

 

I have tried hundreds of different combinations. If it cannot do this,
the I will (with sadness) move on. I'm sure that it would take someone
who understands this about 5 minutes to write (if that).

 

-Bryant

 

 

 

 

Panasonic Electric Works Laboratory of America - SLC Lab
4525 So. Wasatch Blvd., Suite 100, 84124
Salt Lake City, UT 84124



T 801.993.7124
F 801.993.7260
beastham@pewla.us.pewg.pansonic.com

Bryant Eastham
Chief Architect

 

 

***CONFIDENTIALITY NOTICE***: This e-mail and any attachments may
contain information which is confidential, proprietary, trade secret,
privileged or otherwise protected by law. The information is the
property of Panasonic Electric Works Laboratory of America, Inc., and is
solely intended for the named addressee (or a person responsible or
delivering it to the addressee). If you are not the intended recipient
of this message, you are not authorized to read, print, retain copy or
disseminate this message or any part of it. If you have received this
e-mail in error, please notify the sender and the Office of General
Counsel at generalcounsel@us.pewg.panasonic.com
<mailto:generalcounsel@us.pewg.panasonic.com>  immediately by return
e-mail and delete it from your computer.

 


[-- Attachment #1.1.2: Type: text/html, Size: 23286 bytes --]

[-- Attachment #1.2: image001.gif --]
[-- Type: image/gif, Size: 3779 bytes --]

[-- Attachment #1.3: image002.png --]
[-- Type: image/png, Size: 168 bytes --]

[-- Attachment #1.4: image004.png --]
[-- Type: image/png, Size: 168 bytes --]

[-- Attachment #1.5: image005.gif --]
[-- Type: image/gif, Size: 2360 bytes --]

[-- Attachment #2: evaluate.docb.tex --]
[-- Type: application/octet-stream, Size: 3592 bytes --]

% Paper dimensions (http://www.pragma-ade.com/general/manuals/cont-enp.pdf, 3.2)
\setuppapersize[A4][A4] % defaults, likely redundant

% Page layout/margins, doublesided, header/footer
% (http://www.pragma-ade.com/general/manuals/cont-enp.pdf, 3.3)
\setuplayout[
  backspace=1in,
  leftmargin=.5in,
  leftmargindistance=0in,
  width=fit,
  rightmargindistance=0in,
  rightmargin=.5in,
  cutspace=.5in,
  topspace=.5in,
  header=.2in,
  height=fit,
  footer=.2in,
  bottomspace=.5in,
  ]
\setupheadertexts [alfa][beta][gamma][delta]
\setuppagenumbering[alternative=doublesided]

% Enable hyperlinking (wiki)
\setupinteraction[state=start]


% The use of startsectionblockenvironment appears critical, yet not documented.
% The following links were helpful, the rest took guessing.
% http://www.opensubscriber.com/message/ntg-context@ntg.nl/9815615.html
% http://wiki.contextgarden.net/Biochemistry_textbook
\startsectionblockenvironment[frontpart]
\setuppagenumbering[location={header,right}]
\setuppagenumbering[conversion=romannumerals]
\stopsectionblockenvironment

\startsectionblockenvironment[bodypart]
\setuppagenumbering[location={header,right}]
% (http://www.pragma-ade.com/general/manuals/cont-enp.pdf, page 76)
% This was *not obvious*. The fact that 'bytext' and 'bypart' are listed, and
% that 'by\em{section}' implies them both *in addition* to other things like
% chapter took a bit undertand.
\setuppagenumbering[way=bychapter]
% (http://www.pragma-ade.com/general/manuals/cont-enp.pdf, page 76)
% This was also *not obvious*. I believe it is an error to list it as
% \em{sectionnumber}. Rather, for consistency it should be \em{section}number.
% However, the description on http://texshow.contextgarden.net clarifies it.
\setuppagenumbering[chapternumber=yes]
\stopsectionblockenvironment

%\startsectionblockenvironment[backpart]
%\setuppagenumbering[location=]
%\setupheadertexts[][][][]
%\stopsectionblockenvironment

%\startsectionblockenvironment[appendix]
%\setuppagenumbering[location=]
%\setupheadertexts[][][][]
%\stopsectionblockenvironment

%\setupsectionblock[backpart][page=no]
%\setupsectionblock[appendix][page=no]

% This was not clear. http://texshow.contextgarden.net does not have italics,
% and so 'chapternumber' isn't obvious as an option. The same issue mentioned
% above with \em{sectionnumber} exists on 
% (http://www.pragma-ade.com/general/manuals/cont-enp.pdf, page 150)
\setupcombinedlist[content][chapternumber=yes,interaction=all]

% Getting rid of the 'blank' but 'headered' pages at the end of sections was
% not obvious. The (partial) answer is at
% http://www.opensubscriber.com/message/ntg-context@ntg.nl/4154001.html, once
% the typo is fixed (Mychapterpagebreak vs. mychapterpagebreak). There is also
% http://wiki.contextgarden.net/Titles#Truly_empty_pagebreak_before_chapters, which
% fixes the typo. However, 'definepagebreak' is not documented. Neither is the
% particular use of 'setuphead'.
% Also note that this does not appear to work for the last chapter (which still
% gets a non-empty last page with no text. 
\definepagebreak 
   [mychapterpagebreak] 
   [yes,header,right] 

\setuphead 
  [chapter] 
  [page=mychapterpagebreak] 


% DEBUGGING
\showframe

\starttext

\startfrontmatter
\completecontent[criterium=all]
\stopfrontmatter

\startbodymatter
\dorecurse{4}
{\chapter{Chapter}
\dorecurse{12}
{\section{Section}
  \input knuth \endgraf}}
\stopbodymatter

% This is required to avoid a strange page number on the last page. I remember
% a mail posting on this, but cannot find the reference now.
\page[empty]
\stoptext

[-- Attachment #3: Type: text/plain, Size: 486 bytes --]

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________