gardener, Interface administrators, Administrators
1,546
edits
Changes
Jump to navigation
Jump to search
Command/setuppagenumbering (view source)
Revision as of 21:20, 28 October 2023
, 21:20, 28 October 2023renewed from non-template page
<cd:commandgroup name="setuppagenumbering" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The command <tt>\setuppagenumbering</tt> is used to configure the pagination (style and location).
</cd:shortdesc>
<cd:variants>
<cd:command category="counter" file="strc-pag.mkiv" interfacedate="2021-03-02T11:08" interfacefile="i-pagenumber.xml" keywords="structure" level="style" name="setuppagenumbering" variantnumber="1">
<cd:arguments>
<cd:assignments list="yes" ordinal="1">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="alternative">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="singlesided">all pages look like configured in {{cmd|setuplayout}}</cd:constant>
<cd:constant type="doublesided">“left” pages are mirrored from the setup</cd:constant>
</cd:parameter>
<cd:parameter name="page">
<cd:paramdoc></cd:paramdoc>
<cd:inherit name="page"></cd:inherit>
</cd:parameter>
<cd:parameter name="strut">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="yes"></cd:constant>
<cd:constant type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="command">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:oneargument"></cd:constant>
</cd:parameter>
<cd:parameter name="left">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="right">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="state">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="start"></cd:constant>
<cd:constant type="stop"></cd:constant>
</cd:parameter>
<cd:parameter name="width">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="location">
<cd:paramdoc>placement of the pagina; set to empty to hide it</cd:paramdoc>
<cd:constant default="yes" type="header"></cd:constant>
<cd:constant type="footer"></cd:constant>
<cd:constant type="left"></cd:constant>
<cd:constant default="yes" type="middle"></cd:constant>
<cd:constant type="right"></cd:constant>
<cd:constant type="inleft"></cd:constant>
<cd:constant type="inright"></cd:constant>
<cd:constant type="margin"></cd:constant>
<cd:constant type="inmargin"></cd:constant>
<cd:constant type="atmargin"></cd:constant>
<cd:constant type="marginedge"></cd:constant>
<cd:constant type="none"></cd:constant>
</cd:parameter>
<cd:parameter name="style">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:style"></cd:constant>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="color">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:color"></cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>To remove page numbering entirely, set an empty <tt>location</tt>: <code>\setuppagenumbering[location=]</code>
'''Note:''' Configure page number conversion (Roman or other numbers) in {{cmd|setupuserpagenumber}}.
</cd:description>
<cd:examples><cd:example title="Pagina in brackets"><context source="yes">
\setuppapersize[A10]
\setuppagenumbering[left={[},right={]}]
\showframe[edge]
\starttext
Default page number location and style.
\stoptext
</context>
</cd:example><cd:example title="Custom location and style"><context source="yes">
\setuppapersize[A10]
\setuppagenumbering[location={footer,middle},style=\bfc,color=red]
\showframe[edge]
\starttext
Custom page number location and style.
\stoptext
</context></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="page" originator="system"></cd:commandref>
<cd:source file="strc-pag.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Counter"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="setupuserpagenumber">e.g. number conversion</cd:commandref>
<cd:commandref name="setuppagenumber">scope (by section, by text) and construction (section number)</cd:commandref>
<cd:commandref name="setupheader"></cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc><!-- a short command summary goes here -->
The command <tt>\setuppagenumbering</tt> is used to configure the pagination (style and location).
</cd:shortdesc>
<cd:variants>
<cd:command category="counter" file="strc-pag.mkiv" interfacedate="2021-03-02T11:08" interfacefile="i-pagenumber.xml" keywords="structure" level="style" name="setuppagenumbering" variantnumber="1">
<cd:arguments>
<cd:assignments list="yes" ordinal="1">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="alternative">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="singlesided">all pages look like configured in {{cmd|setuplayout}}</cd:constant>
<cd:constant type="doublesided">“left” pages are mirrored from the setup</cd:constant>
</cd:parameter>
<cd:parameter name="page">
<cd:paramdoc></cd:paramdoc>
<cd:inherit name="page"></cd:inherit>
</cd:parameter>
<cd:parameter name="strut">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="yes"></cd:constant>
<cd:constant type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="command">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:oneargument"></cd:constant>
</cd:parameter>
<cd:parameter name="left">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="right">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="state">
<cd:paramdoc></cd:paramdoc>
<cd:constant default="yes" type="start"></cd:constant>
<cd:constant type="stop"></cd:constant>
</cd:parameter>
<cd:parameter name="width">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="location">
<cd:paramdoc>placement of the pagina; set to empty to hide it</cd:paramdoc>
<cd:constant default="yes" type="header"></cd:constant>
<cd:constant type="footer"></cd:constant>
<cd:constant type="left"></cd:constant>
<cd:constant default="yes" type="middle"></cd:constant>
<cd:constant type="right"></cd:constant>
<cd:constant type="inleft"></cd:constant>
<cd:constant type="inright"></cd:constant>
<cd:constant type="margin"></cd:constant>
<cd:constant type="inmargin"></cd:constant>
<cd:constant type="atmargin"></cd:constant>
<cd:constant type="marginedge"></cd:constant>
<cd:constant type="none"></cd:constant>
</cd:parameter>
<cd:parameter name="style">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:style"></cd:constant>
<cd:constant type="cd:command"></cd:constant>
</cd:parameter>
<cd:parameter name="color">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:color"></cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>To remove page numbering entirely, set an empty <tt>location</tt>: <code>\setuppagenumbering[location=]</code>
'''Note:''' Configure page number conversion (Roman or other numbers) in {{cmd|setupuserpagenumber}}.
</cd:description>
<cd:examples><cd:example title="Pagina in brackets"><context source="yes">
\setuppapersize[A10]
\setuppagenumbering[left={[},right={]}]
\showframe[edge]
\starttext
Default page number location and style.
\stoptext
</context>
</cd:example><cd:example title="Custom location and style"><context source="yes">
\setuppapersize[A10]
\setuppagenumbering[location={footer,middle},style=\bfc,color=red]
\showframe[edge]
\starttext
Custom page number location and style.
\stoptext
</context></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="page" originator="system"></cd:commandref>
<cd:source file="strc-pag.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Counter"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="setupuserpagenumber">e.g. number conversion</cd:commandref>
<cd:commandref name="setuppagenumber">scope (by section, by text) and construction (section number)</cd:commandref>
<cd:commandref name="setupheader"></cd:commandref></cd:seealso>
</cd:commandgroup>
