org-mode各种设定

13.2 Export Settings 输出设定

https://orgmode.org/org.html#Export-Settings

导出选项可以设置的是：全局使用变量；
对于单个文件，通过使用in-buffer设置使变量成为本地变量（请参见缓冲区内设置）；
通过设置单个关键字或使用“options”关键字以紧凑形式指定它们；
对于树，通过设置属性（请参见属性和列）。
在特定级别设置的选项会覆盖在更常规级别设置的选项。

in-buffer设置可以直接或间接地出现在文件中的任何位置
也可以通过使用‘#+SETUPFILE: filename or URL’包含的文件来实现
为特定后端定制的选项关键字集可以通过按#使用‘Insert template’ 命令从导出dispatcher 插入。
要单独插入关键字，确保关键字正确的一个好方法是键入“#+”，然后使用M-TAB完成（M-x pcomplete也可以）

导出关键字

每个后端可用的导出关键字及其等效全局变量包括

‘AUTHOR’
文档作者（用户名）。

‘CREATOR’
负责生成输出的实体 (org-export-creator-string).

‘DATE’
日期或时间戳

‘EMAIL’
The email 地址

‘LANGUAGE’
用于翻译某些字符串的语言 (org-export-default-language). 用‘#+LANGUAGE: fr’, 例如, Org 翻译‘Table of contents’ 成法语 ‘Table des matières’

‘SELECT_TAGS’
默认值为“（”export“）”。当树被标记为“export”（组织导出选择标记）时，org选择该树及其子树进行导出。Org排除带有“noexport”标记的树，见下文。当有选择地导出设置了“export”标记的文件时，Org不会导出出现在第一个标题之前的任何文本。

‘EXCLUDE_TAGS’
默认值为“（”noexport“）”。当树被标记为“noexport”（orgeexport排除标记）时，org将从导出中排除该树及其子树。即使它们被无条件地从“导出”标签中排除。即使没有导出子树，Org也会执行其中包含的任何代码块。

‘TITLE’
Org显示此标题。对于长标题，请使用多个“#+TITLE”行。

‘EXPORT_FILE_NAME’
要生成的输出文件的名称。否则，Org根据缓冲区名称生成文件名，根据后端格式生成扩展名。

“OPTIONS”关键字是一个紧凑格式。要配置多个选项，请使用多个 ‘OPTIONS’行。

“OPTIONS”参数

’
切换智能引号 (org-export-with-smart-quotes). 根据所使用的语言，当激活时，Org将双引号对视为主引号，将对单引号视为次引号，将单引号视为撇号。

/*
切换强调文本 (org-export-with-emphasize).

/-
切换特殊字符串的转换 (org-export-with-special-strings).

:
切换固定宽度部分 (org-export-with-fixed-width).

<
切换包含时间/日期活动/非活动标记 (org-export-with-timestamps).

\n
切换是否保留换行符(org-export-preserve-breaks).

^
切换子和上标的类似TeX的语法。如果您编写“^:{}”，则会解释“a{b}”，但简单的“a_b”保留原样(org-export-with-sub-superscripts).

arch
配置如何导出存档的树。当设置为headline时，导出过程跳过内容，只处理标题(org-export-with-archived-trees).

author
切换将作者名称包含到导出文件中(org-export-with-author).

broken-links
切换组织是否应在发现断开的内部链接后继续导出。当设置为mark时，Org在输出中清楚地标记问题链接 (org-export-with-broken-links).

c
切换包含 ‘CLOCK’关键字(org-export-with-clocks).

creator
切换导出文件中是否包含创建者信息 (org-export-with-creator).

d
切换抽屉的包含、要包含的抽屉列表或要排除的抽屉列表(org-export-with-drawers).

date
切换将日期包含到导出的文件中 (org-export-with-date).

e
切换包含实体(org-export-with-entities).

email
切换将作者的电子邮件包含到导出的文件中(org-export-with-email).

f
切换包含脚注(org-export-with-footnotes).。

H
设置导出的标题级别数 (org-export-headline-levels). 。在这个水平之下，标题的处理方式不同。在大多数后端，它们成为列表项。

inline
切换包含inlinetasks(org-export-with-inlinetasks).

num
切换部门编号 (org-export-with-section-numbers).当设置为数字N时，Org只对N级或更高级别的标题进行编号。将“UNNUMBERED”属性设置为non nil可完全禁用标题和子标题的编号。此外，当值为“notoc”时，标题及其所有子项也不会出现在目录中（参见 Table of Contents).）。

p
切换计划信息导出 (org-export-with-planning)。“计划信息”来自标题后面的行，包含这些cookie的任意组合：‘SCHEDULED’, ‘DEADLINE’, 或 ‘CLOSED’.

pri
切换包含优先级cookies (org-export-with-priority).

prop
切换属性抽屉的包含，或列出要包含的属性 (org-export-with-properties).

stat
切换包含统计信息cookie (org-export-with-statistics-cookies).

tags
切换包含标记，也可能不在toc(org-export-with-tags)中。

tasks
切换包含任务（TODO项）；或nil删除所有任务；或TODO删除已完成任务；或列出要保留的关键字 (org-export-with-tasks).

tex
nil不导出；t导出；verbatim将所有内容保持原样 (org-export-with-latex).

timestamp
切换在导出文件 (org-export-time-stamp-file).中包含创建时间。

title
切换包含标题(org-export-with-title)

toc
切换目录的包含，或设置级别限制(org-export-with-toc).

todo
切换将TODO关键字包含到导出的文本中(org-export-with-todo-keywords).

|
切换表的包含(org-export-with-tables).

导出子树时，特殊的节点属性可以覆盖上述关键字。这些属性具有 ‘EXPORT_’ 前缀。例如，当用于特定子树时，“DATE”变为“EXPORT_DATE”。除了“SETUPFILE”，上面列出的所有其他关键字都有一个 ‘EXPORT_’ 等价词。

如果org-export-allow-bind-keywords为非nil，则Emacs变量可以在导出期间使用 ‘BIND’关键字成为缓冲区本地变量。它的语法是 ‘#+BIND: variable value’.这对于无法使用关键字更改的缓冲区内设置特别有用。

16.7 In-Buffer Settings总结

缓冲区设置以“#+”开头，后跟关键字、冒号，然后是每个设置的单词。组织在同一行接受多个设置。Org还接受关键字的多行。本手册全程介绍这些设置。总结如下。

C-C C-C激活对缓冲区内设置的任何更改。在Emacs中关闭和重新打开Org文件也会激活更改。

‘#+ARCHIVE: %s_done’

设置agenda 文件的archive存档位置。对应的变量是org-archive-location

‘#+CATEGORY’

设置应用于整个文档的agenda文件的类别。

‘#+COLUMNS: %25ITEM …’

设置列视图的默认格式。当在不应用“columns”属性的位置调用columns视图时，将应用此格式。

‘#+CONSTANTS: name1=value1 …’

为表公式可以使用的常量设置文件本地值。此行设置局部变量org-table-formula-constants-local.此变量的全局版本是组织表公式常量。

‘#+FILETAGS: :tag1:tag2:tag3:’

设置文件中所有条目（包括顶级条目）继承的标记。

‘#+LINK: linkword replace’

每行指定一个链接的缩写。使用多个“链接”关键字了解更多信息，请参见链接缩写。对应的变量是org-link-abbrev-alist.

‘#+PRIORITIES: highest lowest default’

这行设置优先级的限制和默认值。这三个字母必须是字母A-Z或数字0-9。最高优先级的ASCII数字必须低于最低优先级。

‘#+PROPERTY: Property_Name Value’

这一行为当前缓冲区中的项设置默认继承值，这对于指定属性的允许值非常有用。

‘#+SETUPFILE: file’

安装文件或指向该文件的URL用于其他缓冲区设置。只有当Org打开主文件时，Org才会加载这个文件并解析其中的任何设置。如果指定了URL，则下载内容并将其存储在临时文件缓存中。设置行上的C-C C-C解析并加载文件，还重置临时文件缓存。在正常的导出过程中，Org还解析并加载文档。Org分析此文档的内容，就像它包含在缓冲区中一样。它可以是另一个组织文件。要访问文件而不是URL，请使用C-C’，而point在文件名的行上。

‘#+TAGS: TAG1(c1) TAG2(c2)’

这些行（允许多行）指定该文件中的有效标记，以及（可能）相应的快速标记选择键。对应的变量是 org-tag-alist.

‘#+TODO:’
‘#+SEQ_TODO:’
‘#+TYP_TODO:’
这些行设置了TODO关键字及其在当前文件中的解释。对应的变量是org-todo关键字。

‘#+STARTUP:’

Org首次访问文件时使用的启动选项。

第一组选项处理大纲树的初始可见性。全局默认设置对应的变量是 org-startup-folded，默认值为t，与overview相同

‘overview’ 只是顶级标题。
‘content’ 所有标题。
“showall”禁止折叠任何入口。
“showeverything”显示抽屉中的内容。
动态虚拟缩进由变量org-startup-indented控制。

‘indent’ 以打开组织缩进模式开始。
“noindent”在组织缩进模式关闭的情况下启动。
在访问文件时一致地对齐表。对应的变量是 org-startup-align-all-tables ，默认值为nil。

“align”对齐所有表。
“noalign”在启动时不对齐表。
使用宽度cookie收缩表列。对应的变量是org-startup-shrink-all-tables ，默认值为nil。

访问文件时，可以自动显示内嵌图像。对应的变量是 org-startup-with-inline-images，默认值为nil，以避免访问文件时出现延迟。

“inlineimages”显示内联图像。

“noinlineimages”在启动时不显示内联图像。

记录待办事项的关闭和重新打开以及时钟间隔可以使用这些选项进行配置（请参见变量org log done、org log note clock out和org log repeat）。

“logdone”记录项目标记为完成时的时间戳。

“lognotedone”记录时间戳，完成后记录一条注释。

‘nologdone’ 当项目标记为完成时，不记录。

“logrepeat”记录恢复重复项时的时间。

“lognoterepeat”在恢复重复项时记录注释。

“nologrepeat”在恢复重复项时不记录。

“lognoteclock out”在打卡时记录一条记录。

“nolognoteclock out”打卡时不录制便笺。

“logreschedule”记录调度时间更改时的时间戳。

“lognotereschedule”在计划时间更改时记录注释。

“nologreschedule”不记录计划日期更改的时间。

“logredeadline”记录截止日期更改时的时间戳。

“lognoteredeadline”在截止日期更改时记录注释。

“nologredeadline”不记录截止日期更改的时间。

“logrefile”记录重新填充时的时间戳。

“lognoterefile”在重新填充时记录注释。

“nologrefile”在重新填充时不记录。

下面是在大纲标题中隐藏主星和缩进大纲的选项。相应的变量是org-hide-leading-stars 和 org-odd-levels-only, ，两者都有默认设置nil（意思是“showstars”和“odddeven”）。

‘hidestars’ 除了标星的headline都不可见
‘showstars’ 展示所有标星headline
‘indent’ 根据大纲级别“缩进”虚拟缩进。
‘noindent’ 根据大纲级别没有虚拟缩进。
‘odd’ 只允许奇数大纲级别（1，3，…）
‘oddeven’ 允许所有大纲级别。

要在时间戳上启用自定义格式覆盖（变量org-put-time-stamp-overlays 和 org-time-stamp-overlay-formats），请使用：

“customtime”覆盖自定义时间格式。

以下选项会影响表格电子表格（可变常数单位制）。

“constcgs”常量.el’应该使用c-g-s单位制。

“constSI”常量.el’应该使用国际单位制。

要影响脚注设置，请使用以下关键字。

对应的变量是 org-footnote-define-inline, org-footnote-auto-label, 和org-footnote-auto-adjust.

“finline”内联定义脚注。
“fnnoinline”在单独的部分定义脚注。
“fnlocal”在第一个引用附近定义脚注，但不定义内联。
“fnprompt”提示输入脚注标签。
‘fnauto’创建’[fn:1]’-自动类似标签（默认）。
“fnconfirm”提供自动标签以供编辑或确认。
“fnadjust”自动对脚注重新编号和排序。
“nofnadjust”不会自动重新编号和排序。

要在启动时隐藏块，请使用以下关键字。对应的变量是org-hide-block-startup.

“hideblocks”在启动时隐藏所有开始/结束块。

“nohideblocks”在启动时不隐藏块。

将实体显示为UTF-8字符是由变量org-pretty-entities和关键字控制的

“entitiespretty”尽可能将实体显示为UTF-8字符。

“entitiesplain”将实体保留为纯文本。

其他杂项

#+STARTUP: shrink
设置选项org-startup-shrink-all-tables可在访问文件时收缩文件中包含宽度cookie的所有列。在每个文件的基础上设置此选项

#+STARTUP: beamer
Org Beamer模式是一种特殊的minor模式，用于更快地编辑Beamer文档。

#+STARTUP: latexpreview ，#+STARTUP: nolatexpreview
预览latex

#+STARTUP: noptag
如果您有一组您想在每个文件中使用的首选标记，除了那些由“tags”关键字在每个文件基础上定义的标记之外，那么您可以使用变量org-tag-persistent-alist指定一个标记列表。您可以通过在每个文件中添加“STARTUP”关键字来关闭此功能