NAME¶
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
文件,不管它多大
REPORTING BUGS 报告错误¶
将错误报告发送到
bug-texinfo@gnu.org,一般的问题和讨论则发送到
help-texinfo@gnu.org。 Texinfo
主页:http://www.gnu.org/software/texinfo/
COPYRIGHT¶
Copyright © 2003 Free Software Foundation, Inc. There is NO warranty. You
may redistribute this software under the terms of the GNU General Public
License. For more information about these matters, see the files named
COPYING.
SEE ALSO 参见¶
install-info 的全部文档以 Texinfo
手册页形式保存。如果你的主机上正确安装了
info 和
install-info
程序,命令
- info install-info
将使你可以读取完整的手册。