Difference between revisions of "Command/setupheadnumber"

From Wiki
Jump to navigation Jump to search
(→‎Example: added example)
(→‎Description: behaviour wrt arguments)
Line 20: Line 20:
  
  
== Description ==  
+
== Description ==
 
+
Allows manipulation of the current heading counters.
 +
The first argument determines which heading is to
 +
be changed, e.g. <tt>section</tt>, <tt>chapter</tt>.
 +
The second argument takes an integer; if unsigned, the
 +
section number will be <em>set</em> to this value.
 +
Nota bene: with the next call to the heading the number
 +
will be incremented again.
 +
Thus, in order for the next heading to carry a specific
 +
number <em>n</em> it would be necessary to set its
 +
number to <em>n-1</em>.
  
 +
If the second argument is signed, the heading’s number
 +
will be <em>increased</em> or <em>decreased</em> by
 +
the specified amount instead.
  
 
== Example ==
 
== Example ==

Revision as of 18:53, 1 November 2010

\setupheadnumber

Syntax

\setupheadnumber[...][...]
[...] section
[...] number +number -number


Description

Allows manipulation of the current heading counters. The first argument determines which heading is to be changed, e.g. section, chapter. The second argument takes an integer; if unsigned, the section number will be set to this value. Nota bene: with the next call to the heading the number will be incremented again. Thus, in order for the next heading to carry a specific number n it would be necessary to set its number to n-1.

If the second argument is signed, the heading’s number will be increased or decreased by the specified amount instead.

Example

\starttext
\section{First}

\setupheadnumber[section][+4]
\section{Second?}

\setupheadnumber[section][-5]
\section{Second!}

\setupheadnumber[section][41]
\section{Fourty-second}
\stoptext

See also