Difference between revisions of "Command/setuppagenumber"

From ConTeXt wiki
Jump to navigationJump to search
(Create reference page)
 
 
(14 intermediate revisions by 5 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=setuppagenumber
 
|name=setuppagenumber
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setuppagenumber</syntax>
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
Line 12: Line 13:
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:number|number]]</td>
+
     <td class="cmd">way</td>
     <td>[[Reference/en/value:number|number]] </td>
+
    <td>'''bytext''' byblock bychapter ... — ''reset the counter to one at the start of the text / every block/chapter/section/...</td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">prefix</td>
 +
    <td>'''no''' yes — ''add the current [prefixset] number as a prefix</td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">prefixset</td>
 +
    <td>'''part''' chapter section ... — ''write the part/chapter/... number as a prefix to the page number''</td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
     <td class="cmd">prefixconnector</td>
 +
    <td>'''\endash''' — ''mark to separate the prefix from the page number''</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:state|state]]</td>
+
     <td class="cmd">state</td>
     <td>[[Reference/en/value:start|start]] [[Reference/en/value:stop|stop]] [[Reference/en/value:keep|keep]] </td>
+
     <td>
 +
{| class=wikitable
 +
|- style="vertical-align: top"
 +
| '''start''' || start/resume page numbering on this page, at the last counter value
 +
|- style="vertical-align: top"
 +
| stop       || stop placing page numbers, and stop incrementing the counter.
 +
|}
 +
    </td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">number</td>
 +
    <td>1 2 3 ... — ''Set the page number. Mkii only.''</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
  
 +
== Description ==
  
== Description ==
+
Setup the way the pages are numbered.
  
 +
In mkii, this command can be used to manually set the page number: {{cmd|setuppagenumber|2=[number=4]}}.
  
 +
To manually set the pagenumber in mkiv: {{cmd|setcounter|[userpage][4]}}.
  
 
== Example ==
 
== Example ==
<!-- Please fill in an example if you can -->
+
<texcode>
 +
% mode=mkiv
 +
\setuppagenumber
 +
  [way=bytext,
 +
  prefix=yes,
 +
  prefixset=section,
 +
  prefixconnector=\endash,
 +
  state=start]
 +
 
 +
\setuppapersize[A7]
 +
\showframe[]
 +
 
 +
\starttext
 +
\section{One by one (fragment)}
 +
 
 +
\startlines
 +
one by one
 +
our friends
 +
filled with joy and quest
 +
begin to arrive
 +
 
 +
one by one our friends
 +
the worshipers of ecstasy
 +
begin to arrive
 +
 
 +
more friends and sweethearts
 +
filling you with love
 +
are on their way
 +
\stoplines
 +
 
 +
\rightaligned{---Rumi, {\it trans.} Nader Khalili}
 +
\stoptext
 +
 
 +
</texcode>
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{cmd|setupsubpagenumber}}
 +
* {{cmd|setuppagenumbering}}
 +
* {{cmd|setcounter}}
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Reference/en|setuppagenumber]]
+
[[Category:Command/Numbers|setuppagenumber]]

Latest revision as of 13:52, 18 November 2019

\setuppagenumber

Syntax (autogenerated)

\setuppagenumber[...=...,...]
...=...,...inherits from \setupuserpagenumber


Syntax

\setuppagenumber[...,...=...,...]
way bytext byblock bychapter ... — reset the counter to one at the start of the text / every block/chapter/section/...
prefix no yes — add the current [prefixset] number as a prefix
prefixset part chapter section ... — write the part/chapter/... number as a prefix to the page number
prefixconnector \endashmark to separate the prefix from the page number
state
start start/resume page numbering on this page, at the last counter value
stop stop placing page numbers, and stop incrementing the counter.
number 1 2 3 ... — Set the page number. Mkii only.

Description

Setup the way the pages are numbered.

In mkii, this command can be used to manually set the page number: \setuppagenumber[number=4].

To manually set the pagenumber in mkiv: \setcounter[userpage][4].

Example

% mode=mkiv
\setuppagenumber
  [way=bytext,
   prefix=yes,
   prefixset=section,
   prefixconnector=\endash,
   state=start]

\setuppapersize[A7]
\showframe[]

\starttext
\section{One by one (fragment)}

\startlines
one by one
our friends
filled with joy and quest
begin to arrive

one by one our friends
the worshipers of ecstasy
begin to arrive

more friends and sweethearts
filling you with love
are on their way
\stoplines

\rightaligned{---Rumi, {\it trans.} Nader Khalili}
\stoptext

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: