Difference between revisions of "Command/head"

From Wiki
Jump to navigation Jump to search
(Additional behavioural notes.)
(4 intermediate revisions by one other user not shown)
Line 3: Line 3:
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>head</syntax>
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
Line 8: Line 11:
 
   <tr>
 
   <tr>
 
     <td colspan="2" class="cmd">\head<span class="first" style="color:red;">[ref,ref,...]</span></td>
 
     <td colspan="2" class="cmd">\head<span class="first" style="color:red;">[ref,ref,...]</span></td>
 +
  </tr>
 +
  <tr>
 +
    <td colspan="2" class="cmd">\starthead<span class="first" style="color:red;">[ref,ref,...]</span><span class="second">{Title}</span> ... \stophead</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
Line 19: Line 25:
  
 
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}}.  
 +
 +
=== Referring to the head ===
 +
 +
The syntax \head[ref] probably do not work - it is necessary to use \starthead[ref] ... \stophead
 +
([https://mailman.ntg.nl/pipermail/ntg-context/2018/091593.html])
  
 
== Example ==
 
== Example ==
Line 44: Line 55:
 
         \stopitemize
 
         \stopitemize
 
\stopitemize
 
\stopitemize
 +
</context>
 +
 +
=== Example of a reference ===
 +
 +
<context source=yes>
 +
  \startitemize[i][stopper=),headstyle=bold]
 +
    \item[TheItem] Item
 +
 +
    \starthead[TheHead]{Head}
 +
 +
      Some text
 +
 +
    \stophead
 +
  \stopitemize
 +
 +
  See point \in[TheItem] or \in[TheHead].
 
</context>
 
</context>
  

Revision as of 16:34, 11 November 2019

\head

Syntax (autogenerated)


Syntax

\head[ref,ref,...]
\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. An empty line or 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] probably do not work - it is necessary to use \starthead[ref] ... \stophead ([1])

Example

\startitemize[packed][headstyle=bold]
    \head Birds % empty line is required between first par and rest of head 
                % item, or one will get a very long header

        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 % The \par has the same function as the empty line
        \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

  • \startitemize
  • \item to print ordinary items
  • \sym to print an item with a custom symbol
  • \mar to print an item with margin text
  • \sub to print an item with a continuation mark
  • \its to print an item with a row of marks (for response ranges)
  • \ran to print a range for the \its row
  • \head to print a head within the list
  • \but to print an item whose mark is an interactive button

Help from ConTeXt-Mailinglist/Forum

All issues with: