此处的源代码指以人类可读编程语言编写的纯文本计算机指令集合,可包含注释。只要源代码用起止标记标识,Org 即可在文档中对其进行管理。 使用源代码的第一步是定义代码块,代码块可放置在 Org 文档几乎任意位置,无需局限于前言或文末。 但如果代码块位于 Org 注释或等宽区域内,Org 将无法对其进行管理。
以下是一段 Emacs Lisp 代码块示例:
#+BEGIN_SRC emacs-lisp
(defun org-xor (a b)
"Exclusive or."
(if a (not b) b))
#+END_SRC
代码块是 Org 多种块类型之一,其他还包括 “居中块(center)”、“注释块(comment)”、“动态块(dynamic)”、“示例块(example)”、“导出块(export)”、“引用块(quote)”、“特殊块(special)”与“诗歌块(verse)”。本节仅针对 ‘#+BEGIN_SRC’ 与 ‘#+END_SRC’ 包裹的代码块。
后续章节将详细介绍 Org 处理源代码的各项功能。