Difference between revisions of "Command/head"

From Wiki
Jump to navigation Jump to search
Line 10: Line 10:
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
   <tr>
 
   <tr>
     <td colspan="2" class="cmd">\head<span class="first" style="color:red;">[ref,ref,...]</span></td>
+
     <td colspan="2" class="cmd">\head ... \par</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
Line 22: Line 22:
 
== Description ==  
 
== Description ==  
  
Used in itemizations. Prints the first paragraph of an item in the <code>headstyle</code> specified in {{cmd|startitemize}}, and prevents a pagebreak from occurring between the head and the next item. By default, the <code>headstyle</code> is simply the normal style. An empty line or a {{cmd|par}} after a <code>\head</code> is required, so that ConTeXt may distinguish between the header line and the rest of the head item.
+
Used in itemizations. Prints the first paragraph of an item in the <code>headstyle</code> specified in {{cmd|startitemize}}, and prevents a pagebreak from occurring between the head and the next item. By default, the <code>headstyle</code> is simply the normal style. A {{cmd|par}} after a <code>\head</code> is required, so that ConTeXt may distinguish between the header line and the rest of the head item.
  
 
Because the occasional bold item in a list still does not look very much like a head, the items under the head are often printed in a nested {{cmd|startitemize}}.  
 
Because the occasional bold item in a list still does not look very much like a head, the items under the head are often printed in a nested {{cmd|startitemize}}.  
Line 28: Line 28:
 
=== Referring to the head ===
 
=== Referring to the head ===
  
The syntax \head[ref] probably do not work - it is necessary to use \starthead[ref] ... \stophead
+
The syntax \head[ref] does not work - it is necessary to use \starthead[ref] ... \stophead
([https://mailman.ntg.nl/pipermail/ntg-context/2018/091593.html])
 
  
 
== Example ==
 
== Example ==
Line 35: Line 34:
 
<context source=yes>
 
<context source=yes>
 
\startitemize[packed][headstyle=bold]
 
\startitemize[packed][headstyle=bold]
     \head Birds % empty line is required between first par and rest of head
+
     \head Birds \par
                % item, or one will get a very long header
 
 
 
 
         What is water? This is a difficult question to answer,  
 
         What is water? This is a difficult question to answer,  
 
         because water is impossible to define. One could ask  
 
         because water is impossible to define. One could ask  
Line 48: Line 45:
 
         \stopitemize
 
         \stopitemize
  
     \head Mammals \par % The \par has the same function as the empty line
+
     \head Mammals \par  
 
         \startitemize[continue]
 
         \startitemize[continue]
 
             \item Anteater
 
             \item Anteater

Revision as of 10:51, 19 November 2021

\head

Syntax (autogenerated)


Syntax

\head ... \par
\starthead[ref,ref,...]{Title} ... \stophead
[ref,ref,...]

Description

Used in itemizations. Prints the first paragraph of an item in the headstyle specified in \startitemize, and prevents a pagebreak from occurring between the head and the next item. By default, the headstyle is simply the normal style. A \par after a \head is required, so that ConTeXt may distinguish between the header line and the rest of the head item.

Because the occasional bold item in a list still does not look very much like a head, the items under the head are often printed in a nested \startitemize.

Referring to the head

The syntax \head[ref] does not work - it is necessary to use \starthead[ref] ... \stophead

Example

\startitemize[packed][headstyle=bold]
    \head Birds \par
        What is water? This is a difficult question to answer, 
        because water is impossible to define. One could ask 
        the same question about birds. What {\em are} birds? 
        We just don't know.
        \startitemize[a]
            \item Toucan
            \item Quetzal
            \item Cassowary
        \stopitemize

    \head Mammals \par 
        \startitemize[continue]
            \item Anteater
            \item Sloth
            \item Capybara
        \stopitemize
\stopitemize

Example of a reference

  \startitemize[i][stopper=),headstyle=bold]
    \item[TheItem] Item

    \starthead[TheHead]{Head}

      Some text

    \stophead
  \stopitemize

  See point \in[TheItem] or \in[TheHead].

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: