Manpages

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 [AT] gnu.org, 一 般 的 问 题 和 讨 论 则 发 送 到 help-texinfo [AT] 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 手 册 页 形 式 保 存 。 如 果 你 的 主 机 上 正 确 安 装 了 infoinstall-info 程 序 , 命 令

info install-info 将 使 你 可 以 读 取 完 整 的 手 册 。

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh