This is the official manual for the latest Org-mode release.
Creating pure source code files by extracting code from source blocks is
referred to as “tangling”—a term adopted from the literate programming
community. During “tangling” of code blocks their bodies are expanded
using org-babel-expand-src-block
which can expand both variable and
“noweb” style references (see Noweb reference syntax).
:tangle no
:tangle yes
:tangle filename
org-babel-tangle
With prefix argument only tangle the current code block.
org-babel-tangle-file
org-babel-post-tangle-hook
org-babel-tangle
.
Example applications could include post-processing, compilation or evaluation
of tangled code files.
When tangling code from an Org-mode buffer to a source code file, you'll frequently find yourself viewing the file of tangled source code (e.g., many debuggers point to lines of the source code file). It is useful to be able to navigate from the tangled source to the Org-mode buffer from which the code originated.
The org-babel-tangle-jump-to-org
function provides this jumping from
code to Org-mode functionality. Two header arguments are required for
jumping to work, first the padline
(padline) option must be set
to true (the default setting), second the comments
(comments)
header argument must be set to links
, which will insert comments into
the source code buffer which point back to the original Org-mode file.