3,899
edits
Changes
Jump to navigation
Jump to search
Created page with "Documentation for \copypages"
<cd:commandgroup name="copypages" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc>The command <tt>\copypages</tt> is used to insert pages from another PDF
</cd:shortdesc>
<cd:variants>
<cd:command category="graphics" file="page-sel.mkvi" interfacedate="2020-07-14T09:24" interfacefile="i-pageselection.xml" keywords="structure" level="document" name="copypages" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="marking">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="on"></cd:constant>
<cd:constant default="yes" type="off"></cd:constant>
</cd:parameter>
<cd:parameter name="offset">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension">this influences the scale of the included pages...</cd:constant>
</cd:parameter>
<cd:parameter name="n">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number">Number of pages to include. If not specified, then all pages are included.</cd:constant>
</cd:parameter>
</cd:assignments>
<cd:assignments list="yes" optional="yes" ordinal="3">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupexternalfigure"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Insert pages from another PDF file as pages in the current document. This command differs from {{cmd|filterpages}} because one cannot pick and choose, and from {{cmd|insertpages}} because one cannot insert extra blank pages.
Please note that the inserted pages will be placed on your ConTeXt pages like a new "layer", or floating object. This means that your existing headers, footers, crop marks will still be printed on top of or behind the inserted pages.
If you want to insert pages as completely independent pages between your existing ConTeXt pages, use {{cmd|startpagefigure}}.
</cd:description>
<cd:examples><cd:example title=""><texcode>
\copypages[file.pdf][n=30][scale=950]
</texcode>
Insert the first 30 pages of file.pdf, scaled down to 95%.</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="defineexternalfigure" originator="system"></cd:commandref>
<cd:commandref name="setupexternalfigure" originator="system"></cd:commandref>
<cd:source file="page-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="filterpages">to pick and choose PDF pages to insert</cd:commandref>
<cd:commandref name="insertpages">to insert pages from 1 to 'n' from another PDF, with extra blank pages at specific locations</cd:commandref>
<cd:commandref name="startpagefigure">to insert a figure as a separate page</cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc>The command <tt>\copypages</tt> is used to insert pages from another PDF
</cd:shortdesc>
<cd:variants>
<cd:command category="graphics" file="page-sel.mkvi" interfacedate="2020-07-14T09:24" interfacefile="i-pageselection.xml" keywords="structure" level="document" name="copypages" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="marking">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="on"></cd:constant>
<cd:constant default="yes" type="off"></cd:constant>
</cd:parameter>
<cd:parameter name="offset">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension">this influences the scale of the included pages...</cd:constant>
</cd:parameter>
<cd:parameter name="n">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number">Number of pages to include. If not specified, then all pages are included.</cd:constant>
</cd:parameter>
</cd:assignments>
<cd:assignments list="yes" optional="yes" ordinal="3">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupexternalfigure"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Insert pages from another PDF file as pages in the current document. This command differs from {{cmd|filterpages}} because one cannot pick and choose, and from {{cmd|insertpages}} because one cannot insert extra blank pages.
Please note that the inserted pages will be placed on your ConTeXt pages like a new "layer", or floating object. This means that your existing headers, footers, crop marks will still be printed on top of or behind the inserted pages.
If you want to insert pages as completely independent pages between your existing ConTeXt pages, use {{cmd|startpagefigure}}.
</cd:description>
<cd:examples><cd:example title=""><texcode>
\copypages[file.pdf][n=30][scale=950]
</texcode>
Insert the first 30 pages of file.pdf, scaled down to 95%.</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="defineexternalfigure" originator="system"></cd:commandref>
<cd:commandref name="setupexternalfigure" originator="system"></cd:commandref>
<cd:source file="page-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="filterpages">to pick and choose PDF pages to insert</cd:commandref>
<cd:commandref name="insertpages">to insert pages from 1 to 'n' from another PDF, with extra blank pages at specific locations</cd:commandref>
<cd:commandref name="startpagefigure">to insert a figure as a separate page</cd:commandref></cd:seealso>
</cd:commandgroup>
