Difference between revisions of "Command/typesetbuffer"

From Wiki
Jump to navigation Jump to search
(Created page with "Documentation for \typesetbuffer")
 
 
Line 19: Line 19:
 
<cd:description>With <code>\typesetbuffer[mybuffer]</code>, ConTeXt typesets the buffer <code>mybuffer</code> (previously defined by command {{cmd|startbuffer}}) as an independent file and it includes it in the document as an external image.
 
<cd:description>With <code>\typesetbuffer[mybuffer]</code>, ConTeXt typesets the buffer <code>mybuffer</code> (previously defined by command {{cmd|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 {{cmd|typebuffer}}.
+
To use the contents of the buffer as normal typeset material use the command {{cmd|getbuffer}}.
  
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.
+
To have the contents of the buffer typeset verbatim use the command {{cmd|typebuffer}}.
 +
 
 +
When you invoke {{cmd|typesetbuffer}} on a buffer that is already typeset, the buffer won’t be typeset again, but the requested page(s) will be included in the document as external figures.
 
</cd:description>
 
</cd:description>
 
<cd:examples><cd:example title=""><context source="yes">
 
<cd:examples><cd:example title=""><context source="yes">
Line 37: Line 39:
  
 
     two: \externalfigure[\lasttypesetbuffer][frame=on,page=2]
 
     two: \externalfigure[\lasttypesetbuffer][frame=on,page=2]
+
 
 
     three: \typesetbuffer[*][frame=on,page=3]
 
     three: \typesetbuffer[*][frame=on,page=3]
  
Line 53: Line 55:
 
<cd:commandref name="typebuffer"></cd:commandref>
 
<cd:commandref name="typebuffer"></cd:commandref>
 
<cd:wikipage page="Verbatim text"></cd:wikipage>
 
<cd:wikipage page="Verbatim text"></cd:wikipage>
<cd:commandref name="startbuffer"></cd:commandref></cd:seealso>
+
<cd:commandref name="startbuffer"></cd:commandref>
 +
<cd:commandref name="getbuffer"></cd:commandref></cd:seealso>
 
</cd:commandgroup>
 
</cd:commandgroup>

Latest revision as of 14:35, 3 December 2021


\typesetbuffer

Summary

The command \typesetbuffer typesets a buffer verbatim

Settings

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

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 use the contents of the buffer as normal typeset material use the command \getbuffer.

To have the contents of the buffer typeset verbatim use the command \typebuffer.

When you invoke \typesetbuffer on a buffer that is already typeset, the buffer won’t be typeset again, but the requested page(s) will be included in the document as external figures.

Examples

Example 1

\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


Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: