Difference between revisions of "Command/version"

From Wiki
Jump to navigation Jump to search
m (Move to Miscellaneous)
(Better example, better description)
Line 15: Line 15:
 
</table>
 
</table>
  
 +
== Description ==
 +
 +
* By default the <code>final</code> version is produced, with no extra markup.
 +
 +
* If a <code>concept</code> is produced the
 +
word 'concept' and the date are placed at the bottom of each page.
 +
 +
* <code>temporary</code> prints information related to what one might call 'document and layout debugging': slugs behind overfull lines, and mentions of succesful and failed references, float placement, and index entries.  Most messages are placed in the margin. In some cases these messages refer to the next pages, because TeX is processing in advance.
 +
 +
== Example ==
 +
{| class=wikitable
 +
|<texcode>
 +
\setuppapersize[A9, landscape]
 +
\version[concept]
  
== Description ==
+
A word or two
 +
</texcode>
 +
|<context>
 +
\setuppapersize[A9, landscape]
 +
\version[concept]
  
== Comment ==
+
A word or two
<tt>temporary</tt>: add slugs (overfull rules in margins)
+
</context>
 +
|}
  
By default the definitive version is produced. In case a preliminary version is produced the
+
An example showing most of the features of <code>\version[temporary]</code>.
word concept is placed at the bottom of each page.
+
<context source=yes>
 +
\setuppapersize[A6]
 +
% Tell ConTeXt where the windmill picture is
 +
\setupexternalfigures[location={default}]
 +
\version[temporary]
  
The keyword <tt>temporary</tt> shows some
+
\section{Slithy toves}
information on for instance overfull lines, references, figure placement, and index entries.  Most messages are placed in the margin. In some cases these messages refer to the next pages
 
because TEX is processing in advance.
 
  
 +
% Top right of page will show successful reference '< fig2'
 +
% Left margin will mention unsuccessful reference 'figNothing->'
 +
See \in{Figure}[fig2] and \in{Figure}[figNothing].
  
== Example ==
+
% Top right of page will show new-created anchors '> fig1' and '> fig2'
<!-- Please fill in an example if you can -->
+
% Top right of page will show successfully placed floats
 +
\placefigure[here][fig1]{First windmill}{
 +
    \externalfigure[mill][width=1cm]
 +
}
 +
\placefigure[here][fig2]{Second windmill}{
 +
    \externalfigure[mill][width=1cm]
 +
}
  
== See also ==
+
\startcolumns[n=3]
<!-- something like {{cmd|goto}} -->
+
    % Overfull lines will have slugs in colum margins.
 +
    \input linden
 +
   
 +
    % Underfull hboxes get no warning
 +
    x
 +
\stopcolumns
 +
</context>
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 40: Line 76:
  
 
[[Category:Command/Miscellaneous|version]]
 
[[Category:Command/Miscellaneous|version]]
 +
[[Category:Command/Debugging|version]]

Revision as of 14:37, 7 June 2012

\version

Syntax

\version[...]
[...] final concept temporary

Description

  • By default the final version is produced, with no extra markup.
  • If a concept is produced the

word 'concept' and the date are placed at the bottom of each page.

  • temporary prints information related to what one might call 'document and layout debugging': slugs behind overfull lines, and mentions of succesful and failed references, float placement, and index entries. Most messages are placed in the margin. In some cases these messages refer to the next pages, because TeX is processing in advance.

Example

\setuppapersize[A9, landscape]
\version[concept]

A word or two

An example showing most of the features of \version[temporary].

\setuppapersize[A6]
% Tell ConTeXt where the windmill picture is
\setupexternalfigures[location={default}]
\version[temporary]

\section{Slithy toves}

% Top right of page will show successful reference '< fig2'
% Left margin will mention unsuccessful reference 'figNothing->'
See \in{Figure}[fig2] and \in{Figure}[figNothing].

% Top right of page will show new-created anchors '> fig1' and '> fig2'
% Top right of page will show successfully placed floats
\placefigure[here][fig1]{First windmill}{
    \externalfigure[mill][width=1cm]
}
\placefigure[here][fig2]{Second windmill}{
    \externalfigure[mill][width=1cm]
}

\startcolumns[n=3]
    % Overfull lines will have slugs in colum margins.
    \input linden 
    
    % Underfull hboxes get no warning
    x
\stopcolumns

Help from ConTeXt-Mailinglist/Forum

All issues with: