makeinfo - 翻译 Texinfo 文档

SYNOPSIS 总览

makeinfo [OPTION]... TEXINFO-FILE...

DESCRIPTION 描述

将 Texinfo 源文档翻译为各种其他格式，默认是可以用 Emacs 或者独立的 GNU Info 查看的，适于在线阅读的 Info 文件。

通用选项：

--error-limit=NUM

在遇到 NUM 个错误后退出。默认是 100。

--force

即使发生错误也保留输出内容。

--help

显示这份帮助，然后退出。

--no-validate

不进行节点交叉引用的验证。

--no-warn

阻止提示警告 (但是不阻止提示错误)。

--reference-limit=NUM

警告达到了引用的最大数量 NUM (默认是 1000)。

-v, --verbose

解释正在做什么。

--version

显示版本信息，然后退出。

输出格式选择 (默认产生 Info)：

--docbook

输出 DocBook XML 而不是 Info。

--html

输出 HTML 而不是 Info。

--xml

输出 Texinfo XML 而不是 Info。

通用输出选项：

-E, --macro-expand FILE

输出扩展了宏的源文件，保存到 FILE。忽略任何 @setfilename。

--no-headers

从 Info 输出中去除节点分隔符，Node:lines 和菜单 (以产生普通文本)，或者从 HTML 输出中去除它们 (以产生短一些的文本)；同时，默认输出到标准输出。

--no-split

阻止拆分 Info 或 HTML 输出，只产生单一的输出文件。

--number-sections

输出章节和段落号。

-o, --output=FILE

输出到文件 FILE (如果拆分 HTML 的话，就表示目录 FILE)。

用于 Info 和普通文本的选项：

--enable-encoding

根据 @documentencoding，在 Info 输出中输出着重符号和特殊字符。

--fill-column=NUM

输出 NUM 个字符之后分行。默认是 72。

--footnote-style=STYLE

根据 STYLE，在 Info 中输出脚注： `separate' 将把它们放在它们自己的节点中； `end' 将把它们放在定义它们的节点

的末尾。

--paragraph-indent=VAL

缩进 Info 段落 VAL 个空格，默认是 3。如果 VAL 是 `none'，不进行缩进；如果 VAL 是 `asis'，将维持已有的缩进。

--split-size=NUM

输出 NUM 个字符后拆分新的文件。默认是 300000。

用于 HTML 的选项：

--css-include=FILE

在输出的 HTML <style> 标签中包含 FILE 的内容；如果 FILE 是 `-' 就从标准输入读取。

输入文件选项：

--commands-in-node-names

允许在节点名称中出现 @ 命令。

-D VAR

定义变量 VAR，如同使用了 @set。

-I DIR

将 DIR 添加到 @include 搜索路径中。

-P DIR

将 DIR 添加到 @include 搜索路径之前。

-U VAR

取消变量 VAR 的定义，如同使用了 @clear。

在输入中使用条件处理：

--ifhtml

处理 @ifhtml 和 @html，即使不是在生成 HTML。

--ifinfo

处理 @ifinfo，即使不是在生成 Info。

--ifplaintext

处理 @ifplaintext，即使不是在生成普通文本。

--iftex

处理 @iftex 和 @tex；隐含了 --no-split。

--ifxml

处理 @ifxml 和 @xml。

--no-ifhtml

不处理 @ifhtml 和 ＠html 文本。

--no-ifinfo

不处理 @ifinfo 文本。

--no-ifplaintext

不处理 @ifplaintext 文本。

--no-iftex

不处理 @iftex 和 @tex 文本。

--no-ifxml

不处理 @ifxml 和 @xml 文本。

@if... 条件语句的默认处理方法取决于输出格式：如果在生成 HTML，--ifhtml 就是打开的，其他的是关闭的；如果在生成 Info，--ifinfo 就是打开的，其他的是关闭的；如果在生成普通文本，--ifplaintext 就是打开的，其他的是关闭的；如果在生成 XML，--ifxml 就是打开的，其他的是关闭的。

EXAMPLES 范例

makeinfo foo.texi

输出 Info，保存为 foo 的 @setfilename 指定的文件

makeinfo --html foo.texi

输出 HTML，保存为 @setfilename

makeinfo --xml foo.texi

输出 XML，保存为 @setfilename

makeinfo --docbook foo.texi

输出 DocBook XML，保存为 @setfilename

makeinfo --no-headers foo.texi

输出普通文本，显示在标准输出上。

makeinfo --html --no-headers foo.texi 输出没有 node lines 和菜单的 html makeinfo --number-sections foo.texi 输出 Info 并且为段落编号 makeinfo --no-split foo.texi 输出单一的 Info 文件，不管它多大