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 搜 索 路 径 之 前 。 变 量 VAR 的 定 义 , 如 同 使 用 了 @clear。 在 输 入 中 使 用 条 件 处 理 : --ifhtml 处
理 @ifhtml 和 @html, 即 使
不 是 在 生 成 HTML。
@if... 条 件 语 句 的 默 认 处 理 方 法 取 决 于 输 出 格 式 : 如 果 在 生 成 HTML, --ifhtml 就 是 打 开 的 , 其 他 的 是 关 闭 的 ; 如 果 在 生 成 Info, --ifinfo 就 是 打 开 的 , 其 他 的 是 关 闭 的 ; 如 果 在 生 成 普 通 文 本 , --ifplaintext 就 是 打 开 的 , 其 他 的 是 关 闭 的 ; 如 果 在 生 成 XML, --ifxml 就 是 打 开 的 , 其 他 的 是 关 闭 的 。 EXAMPLES 范 例makeinfo
foo.texi 输 出 Info, 保 存
为 foo 的 @setfilename 指 定
的 文 件 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 [AT] gnu.org, 一 般 的 问 题 和 讨 论 则 发 送 到 help-texinfo [AT] gnu.org。 Texinfo 主 页 : http://www.gnu.org/software/texinfo/ COPYRIGHTCopyright © 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 将 使 你 可 以 读 取 完 整 的 手 册 。 跋本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh |