Difference between revisions of "Enumerations"

From Wiki
Jump to navigation Jump to search
(First notes on itemgroups)
 
m (Ups -- that's an itemize in LaTeX)
Line 25: Line 25:
 
To change the general layout of enumerations, there is <tt>\setupitemize</tt>.  Itaccepts an integer as its first parameter to denote for which level of itemization the subsequent settings should apply.  There is an example below.
 
To change the general layout of enumerations, there is <tt>\setupitemize</tt>.  Itaccepts an integer as its first parameter to denote for which level of itemization the subsequent settings should apply.  There is an example below.
  
For finer control, it is advisable to create new types of itemization, using the command <tt>\defineitemgroup</tt> (which unfortunately seems undocumented).  For example, something similar to the LaTeX <tt>enumerate</tt> environment can be defined as follows:
+
For finer control, it is advisable to create new types of itemization, using the command <tt>\defineitemgroup</tt> (which unfortunately seems undocumented).  For example, something similar to the LaTeX <tt>itemize</tt> environment can be defined as follows:
  
   \defineitemgroup[enumerate][levels=5]
+
   \defineitemgroup[ltxitm][levels=5]
 
   %
 
   %
   \setupitemgroup[enumerate][1][1]
+
   \setupitemgroup[ltxitm][1][1]
   \setupitemgroup[enumerate][2][2]
+
   \setupitemgroup[ltxitm][2][2]
   \setupitemgroup[enumerate][3][3,packed]
+
   \setupitemgroup[ltxitm][3][3,packed]
   \setupitemgroup[enumerate][4][4,packed]
+
   \setupitemgroup[ltxitm][4][4,packed]
   \setupitemgroup[enumerate][5][5,packed]
+
   \setupitemgroup[ltxitm][5][5,packed]
 
   %
 
   %
 
   \starttext
 
   \starttext
 
   %
 
   %
   \startenumerate
+
   \startltxitm
 
     \item Consider
 
     \item Consider
       \startenumerate
+
       \startltxitm
 
       \item this part
 
       \item this part
 
       \item and also these subpoints:
 
       \item and also these subpoints:
         \startenumerate
+
         \startltxitm
 
         \item one
 
         \item one
 
         \item two
 
         \item two
 
         \item three
 
         \item three
           \startenumerate
+
           \startltxitm
 
             \item threeandahalf
 
             \item threeandahalf
           \stopenumerate
+
           \stopltxitm
 
         \item four
 
         \item four
         \stopenumerate
+
         \stopltxitm
       \stopenumerate
+
       \stopltxitm
   \stopenumerate
+
   \stopltxitm
 
   %
 
   %
 
   \stoptext
 
   \stoptext

Revision as of 11:45, 10 August 2004

The most basic form of using enumerations in ConTeXt is

\startitemize
\item here we list the points,
\item one after the other.
\stopitemize

The \startitemize command takes optional parameters (see the documentation of \startitemgroup for a complete list), for example a number conversion may be given, with the following predefined types:

nUsually the default: a numbered list
18Different kinds of bullets. All items get the same symbol.
aItems are numbered a., b., c., …
AItems are numbered A., B., C., …
AItems are numbered A., B., C., …, in small caps.
rItems are numbered in lowercase Roman numerals.
RItems are numbered in uppercase Roman numerals.
KRItems are numbered in uppercase Roman numerals, small caps style.

TODO: What is the difference between n and N?

Additional parameters include continue (start where the previous itemization was finished, to allow text injections), packed (less vertical space between items), and inmargin (place enumeration symbols into the margin).

To change the general layout of enumerations, there is \setupitemize. Itaccepts an integer as its first parameter to denote for which level of itemization the subsequent settings should apply. There is an example below.

For finer control, it is advisable to create new types of itemization, using the command \defineitemgroup (which unfortunately seems undocumented). For example, something similar to the LaTeX itemize environment can be defined as follows:

 \defineitemgroup[ltxitm][levels=5]
 %
 \setupitemgroup[ltxitm][1][1]
 \setupitemgroup[ltxitm][2][2]
 \setupitemgroup[ltxitm][3][3,packed]
 \setupitemgroup[ltxitm][4][4,packed]
 \setupitemgroup[ltxitm][5][5,packed]
 %
 \starttext
 %
 \startltxitm
   \item Consider
     \startltxitm
     \item this part
     \item and also these subpoints:
       \startltxitm
       \item one
       \item two
       \item three
         \startltxitm
           \item threeandahalf
         \stopltxitm
       \item four
       \stopltxitm
     \stopltxitm
 \stopltxitm
 %
 \stoptext