Difference between revisions of "Command/setupmakeup"

From Wiki
Jump to navigation Jump to search
(Add information and example)
(Added an example with pagestate=start to increment page numbers)
 
(5 intermediate revisions by 4 users not shown)
Line 5: Line 5:
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
+
<syntax>setupmakeup</syntax>
  <tr>
 
    <td colspan="2" class="cmd">\setupmakeup<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td>
 
  </tr>
 
  <tr valign="top" class="first">
 
    <td class="cmd">[...]</td>
 
    <td>name </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:width|width]]</td>
 
    <td>[[Command/value:dimension|dimension]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:height|height]]</td>
 
    <td>[[Command/value:dimension|dimension]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:voffset|voffset]]</td>
 
    <td>[[Command/value:dimension|dimension]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:hoffset|hoffset]]</td>
 
    <td>[[Command/value:dimension|dimension]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:page|page]]</td>
 
    <td>[[Command/value:left|left]] [[Command/value:yes|yes]] [[Command/value:right|right]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:commands|commands]]</td>
 
    <td>[[Command/value:command|command]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:doublesided|doublesided]]</td>
 
    <td>[[Command/value:yes|yes]] [[Command/value:no|no]] [[Command/value:empty|empty]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:headerstate|headerstate]]</td>
 
    <td>[[Command/value:normal|normal]] [[Command/value:stop|stop]] [[Command/value:start|start]] [[Command/value:empty|empty]] [[Command/value:none|none]] [[Command/value:nomarking|nomarking]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:footerstate|footerstate]]</td>
 
    <td>[[Command/value:normal|normal]] [[Command/value:stop|stop]] [[Command/value:start|start]] [[Command/value:empty|empty]] [[Command/value:none|none]] [[Command/value:nomarking|nomarking]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:textstate|textstate]]</td>
 
    <td>[[Command/value:normal|normal]] [[Command/value:stop|stop]] [[Command/value:start|start]] [[Command/value:empty|empty]] [[Command/value:none|none]] [[Command/value:nomarking|nomarking]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:topstate|topstate]]</td>
 
    <td>[[Command/value:stop|stop]] [[Command/value:start|start]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:bottomstate|bottomstate]]</td>
 
    <td>[[Command/value:stop|stop]] [[Command/value:start|start]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:pagestate|pagestate]]</td>
 
    <td>[[Command/value:stop|stop]] [[Command/value:start|start]] </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[[Command/keyword:color|color]]</td>
 
    <td>[[Command/value:name|name]] </td>
 
  </tr>
 
</table>
 
 
 
  
 
== Description ==
 
== Description ==
Line 79: Line 14:
 
It is a page type with a special layout / header & footer sections that last only temporarily. The key point is that such a page does not (have to) rely on the current page layout style, which is especially useful for title pages.
 
It is a page type with a special layout / header & footer sections that last only temporarily. The key point is that such a page does not (have to) rely on the current page layout style, which is especially useful for title pages.
  
By default the page layout set up with <code>\setuplayout</code> is being reused. However, a custom page layout can be used as well. <code>\definemakeup</code> automatically uses a layout defined with <code>definelayout</code> with the same name as the makeup.
+
By default the page layout set up with {{cmd|setuplayout}} is being reused. However, a custom page layout can be used as well. {{cmd|definemakeup}} automatically uses a layout defined with {{cmd|definelayout}} with the same name as the makeup.
  
 
There are two different ways to switch to the defined makeups:
 
There are two different ways to switch to the defined makeups:
Line 98: Line 33:
  
 
== Example ==
 
== Example ==
 
+
=== Example 1 ===
 
<texcode>
 
<texcode>
 
% this layout is automatically used by the “custom” makeup
 
% this layout is automatically used by the “custom” makeup
Line 122: Line 57:
 
\stoptext
 
\stoptext
 
</texcode>
 
</texcode>
 +
=== Example 2 ===
 +
Set the bodyfont on just the makeup page
 +
<texcode>
 +
 +
\definemakeup [custom] [style={\switchtobodyfont[heros,14pt]}]
 +
</texcode>
 +
 +
=== Example 3 ===
 +
Make sure page numbering is incremented using `pagestate=start`
 +
 +
<texcode>
 +
\definemakeup [title] [doublesided=empty, pagestate=start]
  
 +
\starttext
 +
\input knuth
 +
\starttitlemakeup
 +
Title
 +
\stoptitlemakeup
 +
\input knuth
 +
\stoptext
 +
</texcode>
  
 
== See also ==
 
== See also ==
* [[Makeup]],
+
* [[Makeup]]
* [[source:page-mak.mkiv|source]].
+
* [[Layout]]
 +
* [[Standardmakeup background]] (2013)
 +
* {{src|page-mak.mkiv}}
 +
* {{cmd|setuplayout}}
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 132: Line 90:
 
{{Forum|{{SUBPAGENAME}}}}
 
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|setupmakeup]]
+
[[Category:Command/Layout|setupmakeup]]
 +
 
 +
[[Category:Layout]]

Latest revision as of 11:41, 15 February 2023

\setupmakeup

Syntax

\setupmakeup[...,...][...=...,...]
[...,...]name
pagesee \page
commandcommand
widthdimension
heightdimension
alignsee \setupalign
setupsname
topcommand
bottomcommand
beforecommand
aftercommand
locationtop
referencereference
pagestatestart stop
headerstatestart stop high empty none normal
footerstatestart stop high empty none normal
topstatestart stop high empty none normal
bottomstatestart stop high empty none normal
textstatestart stop high empty none normal
doublesidedyes no empty
stylestyle command
colorcolor


Description

from a mail by Taco:

A makeup is a separate page, like a title page or colofon. There is one standard makeup page, but you can define more if needed.

It is a page type with a special layout / header & footer sections that last only temporarily. The key point is that such a page does not (have to) rely on the current page layout style, which is especially useful for title pages.

By default the page layout set up with \setuplayout is being reused. However, a custom page layout can be used as well. \definemakeup automatically uses a layout defined with \definelayout with the same name as the makeup.

There are two different ways to switch to the defined makeups:

\startmakeup [custom]
 … some content …
\stopmakeup

and

\startcustommakeup
 … some content …
\stopcustommakeup

Example

Example 1

% this layout is automatically used by the “custom” makeup
\definelayout
  [custom]
  [backspace=5mm]

\definemakeup
  [custom]

\starttext

  \startmakeup [custom]
    \input ward
  \stopmakeup

  \input knuth

  \startcustommakeup
    \input ward
  \stopcustommakeup

\stoptext

Example 2

Set the bodyfont on just the makeup page


\definemakeup [custom] [style={\switchtobodyfont[heros,14pt]}]

Example 3

Make sure page numbering is incremented using pagestate=start

\definemakeup [title] [doublesided=empty, pagestate=start]

\starttext
\input knuth
\starttitlemakeup
Title
\stoptitlemakeup
\input knuth
\stoptext

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: