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
將使你可以讀取完整的手冊。