Difference between revisions of "Command/typesetbuffer"

From ConTeXt wiki
(Revert to Ousia’s version, because I changed things I should have left alone)
Line 25: Line 25:
  
 
== Example ==
 
== Example ==
 +
For technical reasons , the example below does not work perfectly on this wiki: instead of the PDFs of the typeset buffer, it shows placeholder images.
  
<texcode mode="mkiv">
+
<context mode="mkiv" source="yes" text="produces">
 
\starttext
 
\starttext
  
Line 37: Line 38:
 
     \stopbuffer
 
     \stopbuffer
  
     \typesetbuffer[sample][frame=on,page=1]
+
     one: \typesetbuffer[sample][frame=on,page=1]
     \typesetbuffer[sample][frame=on,page=2]
+
 
     \typesetbuffer[sample][frame=on,page=3]
+
     %% the following two commands are commented out to prevent errors:
 +
    %% they are newer than the wiki’s version of ConTeXt.
 +
    % two: \externalfigure[\lasttypesetbuffer][frame=on,page=2]
 +
     % three: \typesetbuffer[*][frame=on,page=3]
  
 
\stoptext
 
\stoptext
</texcode>
+
</context>
  
 
From version 2013.08.09, when you invoke {{cmd|typesetbuffer}} on a buffer already typeset, the buffer won’t be typeset again, but the requested page(s) will be included in the document as external figures. (Both commented commands from sample implement the same functionality.)
 
From version 2013.08.09, when you invoke {{cmd|typesetbuffer}} on a buffer already typeset, the buffer won’t be typeset again, but the requested page(s) will be included in the document as external figures. (Both commented commands from sample implement the same functionality.)

Revision as of 23:17, 10 August 2013

\typesetbuffer

Syntax

\typesetbuffer[buffer]
[buffer] name of the buffer (optionally * refers to the last typeset buffer)
[...,...=...,...]

Description

With \typesetbuffer[mybuffer], ConTeXt typesets the buffer mybuffer (previously defined by command \startbuffer) as an independent file and it includes it in the document as an external image.

To get back the verbatim content of the buffer use the command \typebuffer. And to get the buffer typeset as part of your document (no external processing and inclusion as external figure) use \getbuffer.

Example

For technical reasons , the example below does not work perfectly on this wiki: instead of the PDFs of the typeset buffer, it shows placeholder images.

\starttext

     \startbuffer [sample]
         \starttext
             \startTEXpage[offset=10pt] one   \stopTEXpage
             \startTEXpage[offset=10pt] two   \stopTEXpage
             \startTEXpage[offset=10pt] three \stopTEXpage
         \stoptext
     \stopbuffer

     one: \typesetbuffer[sample][frame=on,page=1]

     %% the following two commands are commented out to prevent errors:
     %% they are newer than the wiki’s version of ConTeXt.
     % two: \externalfigure[\lasttypesetbuffer][frame=on,page=2]
     % three: \typesetbuffer[*][frame=on,page=3]

\stoptext

produces

From version 2013.08.09, when you invoke \typesetbuffer on a buffer already typeset, the buffer won’t be typeset again, but the requested page(s) will be included in the document as external figures. (Both commented commands from sample implement the same functionality.)

See also

  • \input - Include the complete content of a text file.
  • \startbuffer - Define the content of a temporary buffer.
  • \typebuffer - Get back the content of a buffer as verbatim text.
  • \getbuffer - Get back the formatted content of a buffer.

Help from ConTeXt-Mailinglist/Forum

All issues with: