Man page - initex(1)

Packages contains this manual

Available languages:

en zh_TW zh_CN

Manual

TEX

NAME
SYNOPSIS 總 覽
DESCRIPTION 描 述
OPTIONS 選 項
ENVIRONMENT 環 境
FILES 檔 案
BUGS
SEE ALSO 參 見
TRIVIA 提 醒
AUTHORS 作 者
跋

NAME

tex, virtex, initex - 文 字 格 式 化 和 排 版

SYNOPSIS 總 覽

tex [ options ] [ commands ]

DESCRIPTION 描 述

這 份 手 冊 頁 並 不 全 面 。 此 版 本 的 TeX 完 整 的 文 件 可 以 從 info 檔 案 或 者 手 冊 Web2C: A TeX implementation 中 找 到 。

TeX 格 式 化 指 定 的 檔 案 中 包 含 著 命 令 的 文 字 ， 輸 出 一 個 裝 置 無 關 的 檔 案 (稱 為 DVI ， 即 “裝 置 無 關 ” DeVice Independent 的 縮 寫 )。 在 The TeXbook 中 講 述 了 TeX 的 功 能 和 語 言 。 TeX 通 常 與 一 個 大 型 的 預 編 譯 的 宏 包 同 時 使 用 ， 有 一 些 特 定 的 排 版 系 統 ， 例 如 LaTeX, 通 常 需 要 很 多 宏 包 的 支 援 。

這 個 版 本 的 TeX 透 過 檢 視 它 的 命 令 列 ， 查 詢 自 身 是 以 什 麼 名 稱 被 呼 叫 的 。 initex 和 virtex 都 是 到 可 執 行 檔 案 tex 的 符 號 連 結 。 當 作 為 initex 呼 叫 時 (或 者 使 用 了 --ini 選 項 時 )， 它 可 以 用 於 將 宏 預 編 譯 ， 輸 出 到 一 個 .fmt 檔 案 中 。 當 作 為 virtex 呼 叫 時 ， 它 將 使 用 plain 格 式 。 當 以 任 何 其 他 名 稱 呼 叫 時 ， TeX 將 使 用 那 個 名 稱 作 為 要 使 用 的 格 式 名 稱 。 例 如 ， 當 作 為 tex 呼 叫 時 ， 將 使 用 tex 格 式 ， 這 與 plain 格 式 是 相 同 的 。 plain 格 式 中 定 義 的 命 令 記 載 在 The TeXbook 中 。 其 他 常 用 的 格 式 包 括 latex 和 amstex 。

呼 叫 TeX 時 ， 命 令 列 給 出 的 commands 被 傳 遞 給 它 作 為 輸 入 的 第 一 行 。 (但 是 通 常 將 擴 充 套 件 的 引 數 作 為 輸 入 的 第 一 行 要 簡 單 許 多 ， 因 為 UNIX 命 令 直 譯 器 總 是 會 “吃 掉 ” 或 者 錯 誤 地 解 釋 TeX 的 符 號 ， 例 如 反 斜 槓 ， 除 非 你 引 用 它 們 。 ) 同 The TeXbook 書 中 描 述 的 一 致 ， 第 一 行 應 當 以 一 個 檔 名 開 始 ， 或 者 是 一 個 控 制 序 列 \controlsequence , 或 者 是 一 個 格 式 名 稱 &formatname .

通 常 的 用 法 是 輸 入

tex paper

來 處 理 paper.tex 。 名 稱 paper 將 作 為 任 務 名 (‘‘jobname’’)， 也 用 來 產 生 輸 出 檔 名 。 如 果 TeX 沒 有 在 第 一 行 獲 得 一 個 檔 名 ， jobname 將 是 texput 。 當 查 詢 一 個 檔 案 時 ， TeX 查 詢 帶 有 和 不 帶 預 設 副 檔 名 ( .tex ) 的 檔 案 ， 除 非 名 稱 中 已 包 含 了 此 副 檔 名 。 如 果 paper 是 任 務 名 (‘‘jobname’’)， 錯 誤 訊 息 的 日 誌 記 錄 ， 包 含 著 比 通 常 螢 幕 上 顯 示 的 內 容 更 加 詳 細 的 內 容 ， 將 儲 存 為 paper.log ， 輸 出 檔 案 將 儲 存 為 paper.dvi 。

這 個 版 本 的 TeX 可 以 檢 視 檔 案 paper.tex 的 第 一 行 ， 看 它 是 否 以 特 殊 序 列 %& 開 始 。 如 果 第 一 行 以 %& format --translate-file tcxname 開 始 ， 那 麼 TeX 將 使 用 指 定 的 格 式 和 轉 換 表 tcxname 來 處 理 原 始 檔 。 格 式 名 稱 和 --translate-file 轉 換 定 義 都 可 以 被 忽 略 ， 但 是 不 能 同 時 忽 略 。 這 個 設 定 超 越 了 基 於 可 執 行 檔 名 稱 的 格 式 選 擇 。 選 項 --parse-first-line 或 者 配 置 中 的 變 數 parse_first_line 控 制 了 是 否 允 許 這 樣 的 行 為 。

在 TeX 的 錯 誤 提 示 下 回 應 e 將 使 得 系 統 預 設 的 編 輯 器 被 啟 動 ， 修 改 當 前 檔 案 的 當 前 行 。 環 境 變 數 TEXEDIT 可 以 用 來 修 改 所 用 的 編 輯 器 。 它 可 以 包 含 一 個 字 串 "%s"， 指 定 檔 名 要 替 換 的 位 置 ， 以 及 字 串 "%d"， 指 定 行 號 (如 果 有 的 話 ) 要 替 換 的 位 置 。 例 如 ， 要 使 用 emacs ， 可 以 這 樣 設 定 TEXEDIT 字 串 ， 使 用 sh 命 令

TEXEDIT="emacs +%d %s"; export TEXEDIT

為 了 方 便 ， 庫 中 有 一 個 檔 案 null.tex ， 內 容 為 空 。 當 TeX 找 不 到 可 能 的 輸 入 時 ， 它 會 一 直 讓 使 用 者 輸 入 另 一 個 檔 名 ； 如 果 不 想 輸 入 任 何 東 西 ， 回 應 ‘null’ 可 以 跳 出 這 個 迴 圈 。 也 可 以 輸 入 EOF 字 元 (通 常 是 control-D)。

OPTIONS 選 項

這 個 版 本 的 TeX 可 以 解 釋 下 列 命 令 列 選 項 。
--file-line-error-style

列 印 錯 誤 訊 息 ， 以 file:line:error 的 形 式 ， 與 大 多 數 編 譯 器 格 式 化 訊 息 的 方 式 相 似 。

--fmt format

使 用 format 作 為 要 使 用 的 格 式 名 ， 而 不 是 呼 叫 TeX 的 名 稱 或 者 %& 一 行 指 定 的 內 容 。

--help

列 印 幫 助 資 訊 ， 然 後 退 出 。

--ini

成 為 initex ， 用 於 轉 儲 格 式 (dump formats)； 如 果 呼 叫 的 程 式 名 是 initex ， 那 麼 隱 含 這 個 選 項 。

--interaction mode

設 定 互 動 模 式 。 mode 可 以 是 batchmode , nonstopmode , scrollmode , 和 errorstopmode 其 中 之 一 。 這 些 模 式 的 含 義 與 相 應 的 \commands 相 同 。

--ipc

將 DVI 輸 出 傳 送 到 一 個 socket， 同 時 像 通 常 那 樣 輸 出 到 檔 案 。 這 個 選 項 是 否 可 用 取 決 於 安 裝 程 式 的 選 擇 。

--ipc-start

與 --ipc 類 似 ， 並 且 同 時 也 在 另 一 段 啟 動 伺 服 器 。 這 個 選 項 是 否 可 用 取 決 於 安 裝 程 式 的 選 擇 。

--jobname name

使 用 name 作 為 作 業 名 ， 而 不 是 從 輸 入 檔 名 獲 得 。

--kpathsea-debug bitmask

根 據 位 掩 碼 ， 設 定 路 徑 搜 尋 除 錯 標 誌 。 細 節 請 參 見 Kpathsea 手 冊 頁 。

--maketex fmt

啟 用 mktex fmt ， 這 裡 fmt 必 須 是 tex 或 者 tfm 之 一 。

--mltex

啟 用 MLTeX 擴 充 套 件 。

--no-maketex fmt

停 用 mktex fmt 這 裡 fmt 必 須 是 tex 或 者 tfm 之 一 。

--output-comment string

使 用 string 作 為 DVI 檔 案 的 註 釋 ， 而 不 是 時 間 。

--parse-first-line

如 果 主 輸 入 檔 案 的 第 一 行 以 %& 開 始 ， 就 解 釋 它 ， 從 中 查 詢 一 個 轉 儲 名 稱 或 者 一 個 --translate-file 選 項 。

--progname name

偽 裝 是 程 式 name 。 這 對 所 用 格 式 和 搜 尋 路 徑 都 有 影 響 。

--recorder

啟 用 檔 名 記 錄 。 這 將 在 一 個 副 檔 名 為 .fls 的 檔 案 中 記 錄 輸 入 和 輸 出 中 開 啟 的 所 有 檔 案 。

--shell-escape

啟 用 \write18{ command } 結 構 。 command 可 以 是 任 何 Bourne shell 命 令 。 出 於 安 全 原 因 ， 這 個 結 構 通 常 被 禁 止 。

--translate-file tcxname

使 用 tcxname 轉 換 表 。

--version

顯 示 版 本 資 訊 ， 然 後 退 出 。

ENVIRONMENT 環 境

參 見 Kpathsearch 庫 的 文 件 (手 冊 頁 的 ‘Path specifications’ 節 點 ) 來 檢 視 使 用 環 境 變 數 的 精 確 的 細 節 。 kpsewhich 實 用 工 具 可 以 用 來 查 詢 變 數 的 值 。

警 告 ： 在 大 多 數 TeX 格 式 中 ， 不 能 直 接 傳 給 TeX 帶 有 ˜ 的 檔 名 ， 因 為 ˜ 是 一 個 有 特 殊 意 義 的 字 元 ， 它 將 被 擴 充 套 件 ， 不 會 作 為 檔 名 的 一 部 分 。 其 他 程 式 ， 例 如 Metafont， 沒 有 這 個 問 題 。
TEXMFOUTPUT

通 常 ， TeX 將 輸 出 檔 案 放 在 當 前 目 錄 。 如 果 不 能 在 那 裡 建 立 任 何 輸 出 檔 案 ， 它 試 著 在 環 境 變 數 TEXMFOUTPUT 指 定 的 目 錄 中 建 立 它 。 這 個 引 數 沒 有 預 設 值 。 例 如 ， 假 設 命 令 是 tex paper 並 且 當 前 目 錄 不 可 寫 ， 如 果 TEXMFOUTPUT 設 定 為 /tmp ， TeX 試 圖 建 立 /tmp/paper.log (還 有 /tmp/paper.dvi ， 如 果 產 生 了 任 何 輸 出 。 )

TEXINPUTS

\input 和 \openin 檔 案 的 搜 尋 路 徑 。 它 們 一 般 應 當 以 ‘‘.’’ 開 始 ， 使 得 使 用 者 檔 案 可 以 先 於 系 統 檔 案 被 找 到 。 空 路 徑 成 分 將 被 替 換 為 texmf.cnf 檔 案 中 定 義 的 路 徑 。 例 如 ， 設 定 TEXINPUTS 為 ".:/home/usr/tex:" 來 將 當 前 目 錄 和 ‘‘/home/user/tex’’ 新 增 到 標 準 的 搜 尋 路 徑 之 前 。

TEXEDIT

切 換 為 編 輯 器 的 命 令 模 板 。 預 設 值 通 常 是 vi ， 在 TeX 編 譯 時 進 行 設 定 。

FILES 檔 案

下 面 提 到 的 檔 案 的 位 置 在 各 個 系 統 中 是 不 相 同 的 。 使 用 kpsewhich 實 用 工 具 來 找 到 它 們 的 位 置 。
texmf.cnf

配 置 檔 案 。 它 包 含 著 搜 尋 路 徑 的 定 義 ， 還 有 其 他 配 置 引 數 ， 例 如 parse_first_line .

tex.pool

編 碼 的 文 字 ， 是 TeX 的 提 示 訊 息 。

texfonts.map

檔 名 對 映 定 義 。

*.tfm

TeX 字 型 的 度 量 的 檔 案 。

*.fmt

簡 寫 的 TeX 格 式 (.fmt) 檔 案 。

$TEXMFMAIN/tex/plain/base/plain.tex

基 本 的 宏 包 ， 在 TeXbook 中 有 詳 細 描 述 。

BUGS

這 個 版 本 的 TeX 實 現 了 大 量 的 可 選 的 擴 充 套 件 。 實 際 上 ， 其 中 大 部 分 與 TeX 的 定 義 有 或 多 或 少 的 衝 突 。 當 啟 用 這 樣 的 擴 充 套 件 時 ， TeX 啟 動 時 列 印 的 提 示 資 訊 將 是 TeXk 而 不 是 TeX 。

這 個 版 本 的 TeX 在 面 積 增 加 或 減 少 時 不 能 捕 獲 算 術 下 溢 錯 誤 。 這 種 情 況 很 少 見 ， 但 是 一 旦 出 現 ， 產 生 的 DVI 檔 案 將 是 無 效 的 。

SEE ALSO 參 見

mf (1),
Donald E. Knuth, The TeXbook , Addison-Wesley, 1986, ISBN 0-201-13447-0.
Leslie Lamport, LaTeX - A Document Preparation System , Addison-Wesley, 1985, ISBN 0-201-15790-X.
K. Berry, Eplain: Expanded plain TeX , ftp://ftp.cs.umb.edu/pub/tex/eplain/doc.
Michael Spivak, The Joy of TeX , 2nd edition, Addison-Wesley, 1990, ISBN 0-8218-2997-1.
TUGboat (the journal of the TeX Users Group).

TRIVIA 提 醒

TeX， 如 果 發 音 正 確 的 話 ， 與 ‘‘blecchhh’’ 押 韻 (rhymes)。 使 用 typewriter 字 型 時 ， 正 確 的 拼 寫 是 ‘‘TeX’’ 而 不 是 ‘‘TEX’’ 或 者 ‘‘tex’’。

AUTHORS 作 者

TeX 的 設 計 者 是 by Donald E. Knuth， 他 用 他 的 Web 系 統 實 現 了 它 。 後 來 ， 它 分 別 被 Stanford 的 Howard Tricky 和 Cornell 的 Pavel Curtis 移 植 到 了 Unix。 當 前 隨 Unix TeX 發 行 的 這 個 版 本 使 用 了 Web 到 C 的 翻 譯 系 統 ( web2c ) 來 產 生 ， ( web2c ) 最 初 由 Tomas Rokicki 和 Tim Morgan 實 現 。

跋

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。
中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh