Manpages

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 的 名 稱 或 者 %& 一 行 指 定 的 內 容 。

initex ， 用 於 轉 儲 格 式 (dump formats)； 如 果 調 用 的 程 序 名 是 initex ， 那 麼 隱 含 這 個 選 項 。
--interaction mode 設 置 交 互 模 式 。 mode 可 以 是 batchmode, nonstopmode, scrollmode, 和 errorstopmode 其 中 之 一 。 這 些 模 式 的 含 義 與 相 應 的 \commands 相 同 。

是 否 可 用 取 決 於 安 裝 程 序 的 選 擇 。

--ipc-start 與 --ipc 類 似 ， 並 且 同 時 也 在 另 一 段 啓 動 服 務 器 。 這 個 選 項 是 否 可 用 取 決 於 安 裝 程 序 的 選 擇 。
--jobname name 使 用 name 作 爲 作 業 名 ， 而 不 是 從 輸 入 文 件 名 獲 得 。
--kpathsea-debug bitmask 根 據 位 掩 碼 ， 設 置 路 徑 搜 索 調 試 標 誌 。 細 節 請 參 見 Kpathsea 手 冊 頁 。
--maketex fmt 啓 用 mktexfmt ， 這 裏 fmt 必 須 是 tex 或 者 tfm 之 一 。
--mltex 啓 用 MLTeX 擴 展 。
--no-maketex fmt 禁 用 mktexfmt 這 裏 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 文 件 名 映 射 定 義 。