1,964
edits
Changes
Add example etc.
{{Reference
|name=adaptpapersize
|attributes=
}}
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
<tr>
<td colspan="2" class="cmd">\adaptpapersize<span class="first" >[...,...,...]</span><span class="second" style="color:red;">[...,...,...]</span></td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[...,...,...]</td>
<td>A3 <strong>A4</strong> A5 A6 letter ... CD ''name'': predefined sizes for page<br />
landscape: swap height and width of page<br />
mirrored: mirror page on sheet<br />
rotated: rotate page 90 degrees counterclockwise w.r.t. sheet<br />
negative: FIXME<br />
90 180 270: rotate page 90/180/270 degrees CCW with respect to sheet </td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[...,...,...]</td>
<td>A3 <strong>A4</strong> A5 A6 letter ... CD ''name'': predefined paper sizes<br />
Other options
</tr>
</table>
== Description ==
The first argument of {{cmd|setuppapersize}} is the dimension a page will have. The second argument is the size of the paper the pages will be printed on; see {{cmd|setuparranging}} for placing multiple pages on a sheet. If the second argument is omitted, the paper size is assumed to equal the page size.
For example:
<texcode>
\setuppapersize[letter,landscape][letter,landscape,oversized]
</texcode>
sets the size of the pages to letter size (landscape), and the size of the paper (before cutting) to oversized letter size, which has edges that are 1.5 cm longer. <tt>letter</tt> is a pre-defined papersize; one can define one's own papersizes using {{cmd|definepapersize}}.
There are several options one can use to modify a predefined paper size:
* <tt>portrait</tt>: the default paper sizes are 'standing up', taller than they are wide.
* <tt>landscape</tt>: turn the paper 90 degrees so it is lying down
* <tt>samesized</tt>: same size as the first argument
* <tt>oversized</tt>: adds 1.5 cm to each edge
* <tt>undersized</tt>: subtracts 1.5 cm from each edge
* <tt>doublesized</tt>: doubles the width
* <tt>doubleoversized</tt>: doubles the width and adds 1.5 cm to each edge
There are quite a few pre-defined paper sizes:
{| class="wikitable"
|- valign="top"
! style="width: 200px" | '''Size'''
! '''Remarks'''
|- valign="top"
| <tt>letter</tt>, <tt>ledger</tt>, <tt>tabloid</tt>, <tt>legal</tt>, <tt>folio</tt>, <tt>executive</tt>
| Sizes from the North American paper standard.
|- valign="top"
| <tt>A0</tt> – <tt>A10</tt>, <tt>B0</tt> – <tt>B10</tt>, <tt>C0</tt> – <tt>C10</tt>
| From the A, B, and C series of the ISO-216 standard.
|- valign="top"
| <tt>RA0</tt> – <tt>RA4</tt>, <tt>SRA0</tt> – <tt>SRA4</tt>
| From the RA and SRA series of ISO-217 paper standard.
|- valign="top"
| <tt>C6/C5</tt>, <tt>DL</tt>, <tt>E4</tt>
| From the ISO-269 standard envelope sizes.
|- valign="top"
| <tt>envelope 9</tt> – <tt>envelope 14</tt>
| Sizes from the American postal standard.
|- valign="top"
| <tt>G5</tt> and <tt>E5</tt>
| From the Swedish SIS-014711 standard. These are used for Swedish theses.
|- valign="top"
| <tt>CD</tt> (12x12cm)
| for CD covers.
|- valign="top"
| <tt>S3</tt> – <tt>S6</tt>, <tt>S8</tt>, <tt>SM</tt>, <tt>SW</tt>
| For screen sizes. These sizes are useful for presentations. <tt>S3</tt> – <tt>S6</tt> and <tt>S8</tt> have an aspect ratio of 4:3. <tt>S3</tt> is 300pt wide, <tt>S4</tt> is 400pt wide, and so on. <tt>S6</tt> is almost as wide as a <tt>A4</tt> paper. <tt>SM</tt> and <tt>SW</tt> are for medium and wide screens; they have the same height as <tt>S6</tt>.
|-
|
[http://source.contextgarden.net/tex/context/base/page-lay.mkiv <tt>page-lay.mkii</tt>] <br />
[http://source.contextgarden.net/tex/context/base/page-lay.mkiv <tt>page-lay.mkiv</tt>]
| A few more paper sizes, which are not mention here. (Scroll down to the end.)
|-
|}
== Example ==
<context source=yes>
% Create a paper that can accomodate 2x4 squares of 52x52mm
% (A9 is 37x52mm, and we're placing it both portrait and landscape)
\definepapersize[sheet][width=104mm,height=156mm]
% We want 2x3 pages on a sheet. \setuppaper must come *before* \setuparranging!
\setuppaper[nx=2, ny=3, dx=0mm, dy=0mm]
\setuparranging[XY]
% Define two papersizes in terms of A9 and sheet
\definepapersize[standing][A9] [sheet]
\definepapersize[lying] [A9,landscape][sheet]
% Show the pages.
\showframe
\starttext
\setuppapersize[standing]
Page 1: standing pages from here on. \page
Page 2. \page
\setuppapersize[lying]
Page 3: lying pages from here on. \page
Page 4. \page
\adaptpapersize[standing]
Page 5: adapted to standing \page
Page 6: automatically back to lying \page
\stoptext
</context>
== See also ==
* [[PaperSetup]]
* {{cmd|definepapersize}} to define a new paper size for use with {{cmd|setuppapersize}}
* {{cmd|adaptpapersize}} to change the paper size for one page only.
* {{cmd|setuparranging}} to place multiple pages on a sheet.
== Help from ConTeXt-Mailinglist/Forum ==
All issues with:
{{Forum|{{SUBPAGENAME}}}}
[[Category:Command/Layout|setuppapersize]]
|name=adaptpapersize
|attributes=
}}
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
<tr>
<td colspan="2" class="cmd">\adaptpapersize<span class="first" >[...,...,...]</span><span class="second" style="color:red;">[...,...,...]</span></td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[...,...,...]</td>
<td>A3 <strong>A4</strong> A5 A6 letter ... CD ''name'': predefined sizes for page<br />
landscape: swap height and width of page<br />
mirrored: mirror page on sheet<br />
rotated: rotate page 90 degrees counterclockwise w.r.t. sheet<br />
negative: FIXME<br />
90 180 270: rotate page 90/180/270 degrees CCW with respect to sheet </td>
</tr>
<tr valign="top" class="second">
<td class="cmd">[...,...,...]</td>
<td>A3 <strong>A4</strong> A5 A6 letter ... CD ''name'': predefined paper sizes<br />
Other options
</tr>
</table>
== Description ==
The first argument of {{cmd|setuppapersize}} is the dimension a page will have. The second argument is the size of the paper the pages will be printed on; see {{cmd|setuparranging}} for placing multiple pages on a sheet. If the second argument is omitted, the paper size is assumed to equal the page size.
For example:
<texcode>
\setuppapersize[letter,landscape][letter,landscape,oversized]
</texcode>
sets the size of the pages to letter size (landscape), and the size of the paper (before cutting) to oversized letter size, which has edges that are 1.5 cm longer. <tt>letter</tt> is a pre-defined papersize; one can define one's own papersizes using {{cmd|definepapersize}}.
There are several options one can use to modify a predefined paper size:
* <tt>portrait</tt>: the default paper sizes are 'standing up', taller than they are wide.
* <tt>landscape</tt>: turn the paper 90 degrees so it is lying down
* <tt>samesized</tt>: same size as the first argument
* <tt>oversized</tt>: adds 1.5 cm to each edge
* <tt>undersized</tt>: subtracts 1.5 cm from each edge
* <tt>doublesized</tt>: doubles the width
* <tt>doubleoversized</tt>: doubles the width and adds 1.5 cm to each edge
There are quite a few pre-defined paper sizes:
{| class="wikitable"
|- valign="top"
! style="width: 200px" | '''Size'''
! '''Remarks'''
|- valign="top"
| <tt>letter</tt>, <tt>ledger</tt>, <tt>tabloid</tt>, <tt>legal</tt>, <tt>folio</tt>, <tt>executive</tt>
| Sizes from the North American paper standard.
|- valign="top"
| <tt>A0</tt> – <tt>A10</tt>, <tt>B0</tt> – <tt>B10</tt>, <tt>C0</tt> – <tt>C10</tt>
| From the A, B, and C series of the ISO-216 standard.
|- valign="top"
| <tt>RA0</tt> – <tt>RA4</tt>, <tt>SRA0</tt> – <tt>SRA4</tt>
| From the RA and SRA series of ISO-217 paper standard.
|- valign="top"
| <tt>C6/C5</tt>, <tt>DL</tt>, <tt>E4</tt>
| From the ISO-269 standard envelope sizes.
|- valign="top"
| <tt>envelope 9</tt> – <tt>envelope 14</tt>
| Sizes from the American postal standard.
|- valign="top"
| <tt>G5</tt> and <tt>E5</tt>
| From the Swedish SIS-014711 standard. These are used for Swedish theses.
|- valign="top"
| <tt>CD</tt> (12x12cm)
| for CD covers.
|- valign="top"
| <tt>S3</tt> – <tt>S6</tt>, <tt>S8</tt>, <tt>SM</tt>, <tt>SW</tt>
| For screen sizes. These sizes are useful for presentations. <tt>S3</tt> – <tt>S6</tt> and <tt>S8</tt> have an aspect ratio of 4:3. <tt>S3</tt> is 300pt wide, <tt>S4</tt> is 400pt wide, and so on. <tt>S6</tt> is almost as wide as a <tt>A4</tt> paper. <tt>SM</tt> and <tt>SW</tt> are for medium and wide screens; they have the same height as <tt>S6</tt>.
|-
|
[http://source.contextgarden.net/tex/context/base/page-lay.mkiv <tt>page-lay.mkii</tt>] <br />
[http://source.contextgarden.net/tex/context/base/page-lay.mkiv <tt>page-lay.mkiv</tt>]
| A few more paper sizes, which are not mention here. (Scroll down to the end.)
|-
|}
== Example ==
<context source=yes>
% Create a paper that can accomodate 2x4 squares of 52x52mm
% (A9 is 37x52mm, and we're placing it both portrait and landscape)
\definepapersize[sheet][width=104mm,height=156mm]
% We want 2x3 pages on a sheet. \setuppaper must come *before* \setuparranging!
\setuppaper[nx=2, ny=3, dx=0mm, dy=0mm]
\setuparranging[XY]
% Define two papersizes in terms of A9 and sheet
\definepapersize[standing][A9] [sheet]
\definepapersize[lying] [A9,landscape][sheet]
% Show the pages.
\showframe
\starttext
\setuppapersize[standing]
Page 1: standing pages from here on. \page
Page 2. \page
\setuppapersize[lying]
Page 3: lying pages from here on. \page
Page 4. \page
\adaptpapersize[standing]
Page 5: adapted to standing \page
Page 6: automatically back to lying \page
\stoptext
</context>
== See also ==
* [[PaperSetup]]
* {{cmd|definepapersize}} to define a new paper size for use with {{cmd|setuppapersize}}
* {{cmd|adaptpapersize}} to change the paper size for one page only.
* {{cmd|setuparranging}} to place multiple pages on a sheet.
== Help from ConTeXt-Mailinglist/Forum ==
All issues with:
{{Forum|{{SUBPAGENAME}}}}
[[Category:Command/Layout|setuppapersize]]