Command/typesetbuffer

From ConTeXt wiki
Jump to navigationJump to search

\typesetbuffer

Syntax (autogenerated)

\typesetbuffer[...][...=...,...]
[...]* buffer
...=...,...inherits from \setupexternalfigure


Syntax

\typesetbuffer[buffer][...,...=...,...]
[buffer] name of the buffer (optionally * refers to the last typeset buffer)
page number
frame on off none overlay

Other options of \framed (see \setupframed) should also work.

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

\startTEXpage

     \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]

     two: \externalfigure[\lasttypesetbuffer][frame=on,page=2]
 
    three: \typesetbuffer[*][frame=on,page=3]

\stopTEXpage

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.

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: