- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

14.3 Exporting code blocks

It is possible to export the contents of code blocks, the results of code block evaluation, neither, or both. For most languages, the default exports the contents of code blocks. However, for some languages (e.g. ditaa) the default exports the results of code block evaluation. For information on exporting code block bodies, see section 11.3 Literal examples.

The :exports header argument can be used to specify export behavior:

Header arguments:

:exports code
The default in most languages. The body of the code block is exported, as described in section 11.3 Literal examples.
:exports results
The code block will be evaluated and the results will be placed in the Org-mode buffer for export, either updating previous results of the code block located anywhere in the buffer or, if no previous results exist, placing the results immediately after the code block. The body of the code block will not be exported.
:exports both
Both the code block and its results will be exported.
:exports none
Neither the code block nor its results will be exported.

It is possible to inhibit the evaluation of code blocks during export. Setting the org-export-babel-evaluate variable to nil will ensure that no code blocks are evaluated as part of the export process. This can be useful in situations where potentially untrusted Org-mode files are exported in an automated fashion, for example when Org-mode is used as the markup language for a wiki.

ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition