Difference between revisions of "Command/version"

From Wiki
Jump to navigation Jump to search
(Create reference page)
 
m (stray linebreak)
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- please remove this and the following line if you have checked this page -->
 
{{Reference_Cleanup}}
 
 
{{Reference
 
{{Reference
 
|name=version
 
|name=version
Line 17: Line 15:
 
</table>
 
</table>
  
 +
== Description ==
  
== Description ==
+
* By default the <code>final</code> version is produced, with no extra markup.
== comment ==
 
<pre>
 
temporary: add slugs (overfull rules in margins)
 
</pre>
 
  
By default the definitive version is produced. In case a preliminary version is produced the
+
* If a <code>concept</code> is produced the word 'concept' and the date are placed at the bottom of each page.  
word concept is placed at the bottom of each page.  
 
  
The keyword <b>temporary</b> shows some
+
* <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.
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.
 
  
 +
== Example ==
 +
{| class=wikitable
 +
|<texcode>
 +
\setuppapersize[A9, landscape]
 +
\version[concept]
 +
 +
A word or two
 +
</texcode>
 +
|<context>
 +
\setuppapersize[A9, landscape]
 +
\version[concept]
 +
 +
A word or two
 +
</context>
 +
|}
 +
 +
An example showing most of the features of <code>\version[temporary]</code>.
 +
<context source=yes>
 +
\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]
 +
}
  
== Example ==
+
\startcolumns[n=3]
<!-- Please fill in an example if you can -->
+
    % Overfull lines will have slugs in colum margins.
 +
    \input linden
 +
   
 +
    % Underfull hboxes get no warning
 +
    x
 +
\stopcolumns
 +
</context>
  
== See also ==
+
== Help from ConTeXt-Mailinglist/Forum ==
<!-- something like [[cmd:goto|\goto]] -->
+
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Reference/en|version]]
+
[[Category:Command/Miscellaneous|version]]
 +
[[Category:Command/Debugging|version]]

Revision as of 14:38, 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: