Difference between revisions of "Command/setuppapersize"

From ConTeXt wiki
m (See also)
m (describe startTEXpage and co.)
(14 intermediate revisions by 3 users not shown)
Line 21: Line 21:
  
 
== Description ==  
 
== Description ==  
<pre>
 
The first argument selects the area for typesetting and the second (optional)
 
argument the papersize for printing.
 
  
options:
+
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.
oversized        adds 1,5 cm on each side
 
doublesized      doubles the height
 
doubleoversized  doubles the height and adds 1,5 cm on each side
 
</pre>
 
== comment ==
 
The second argument is A4 by default (it would be better to use the same as the first argument for default value, but now it cannot be changed back for compatibility reasons). This means that you always have to provide the second argument if you want some othe paper size than A4.
 
 
 
For example if you want a landscape document, make sure to say landscape in both arguments:
 
  
 +
For example:
 
<texcode>
 
<texcode>
\setuppapersize[A4,landscape][A4,landscape]
+
\setuppapersize[letter,landscape][letter,landscape,oversized]
 
</texcode>
 
</texcode>
  
To define your own paper size see [[cmd:definepapersize]].
+
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> &ndash; <tt>A10</tt>, <tt>B0</tt> &ndash; <tt>B10</tt>, <tt>C0</tt> &ndash; <tt>C10</tt>
 +
| From the A, B, and C series of the ISO-216 standard.
 +
|- valign="top"
 +
| <tt>RA0</tt> &ndash; <tt>RA4</tt>, <tt>SRA0</tt> &ndash; <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> &ndash; <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> &ndash; <tt>S6</tt>, <tt>S8</tt>, <tt>SM</tt>, <tt>SW</tt>
 +
| For screen sizes. These sizes are useful for presentations. <tt>S3</tt> &ndash; <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 ==
 
== Example ==
<!-- Please fill in an example if you can -->
+
<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 ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* [[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.
 +
* {{cmd|startTEXpage}} — a page just large enough to fit its TeX contents
 +
* {{cmd|startpagefigure}} — a page just large enough to fit its figure, possibly with some text underneath
 +
* {{cmd|startMPpage}} — a page just large enough to fit its MetaPost contents
  
[[PaperSetup]]
+
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Reference/en|setuppapersize]]
+
[[Category:Command/Layout|setuppapersize]]

Revision as of 11:46, 14 September 2017

\setuppapersize

Syntax

\setuppapersize[...,...,...][...,...,...]
[...,...,...] A3 A4 A5 A6 letter ... CD name landscape mirrored rotated 90 180 270
[...,...,...] A3 A4 A5 A6 letter ... name landscape mirrored rotated negative 90 180 270


Description

The first argument of \setuppapersize is the dimension a page will have. The second argument is the size of the paper the pages will be printed on; see \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:

\setuppapersize[letter,landscape][letter,landscape,oversized]

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. letter is a pre-defined papersize; one can define one's own papersizes using \definepapersize.

There are several options one can use to modify a predefined paper size:

  • portrait: the default paper sizes are 'standing up', taller than they are wide.
  • landscape: turn the paper 90 degrees so it is lying down
  • samesized: same size as the first argument
  • oversized: adds 1.5 cm to each edge
  • undersized: subtracts 1.5 cm from each edge
  • doublesized: doubles the width
  • doubleoversized: doubles the width and adds 1.5 cm to each edge

There are quite a few pre-defined paper sizes:

Size Remarks
letter, ledger, tabloid, legal, folio, executive Sizes from the North American paper standard.
A0A10, B0B10, C0C10 From the A, B, and C series of the ISO-216 standard.
RA0RA4, SRA0SRA4 From the RA and SRA series of ISO-217 paper standard.
C6/C5, DL, E4 From the ISO-269 standard envelope sizes.
envelope 9envelope 14 Sizes from the American postal standard.
G5 and E5 From the Swedish SIS-014711 standard. These are used for Swedish theses.
CD (12x12cm) for CD covers.
S3S6, S8, SM, SW For screen sizes. These sizes are useful for presentations. S3S6 and S8 have an aspect ratio of 4:3. S3 is 300pt wide, S4 is 400pt wide, and so on. S6 is almost as wide as a A4 paper. SM and SW are for medium and wide screens; they have the same height as S6.

page-lay.mkii
page-lay.mkiv

A few more paper sizes, which are not mention here. (Scroll down to the end.)

Example

% 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


See also

Help from ConTeXt-Mailinglist/Forum

All issues with: