26


吳聰敏 (2011.8)


本文件說明如何安裝 cwTeX 系統。

以下步驟是以 cwTeX34 及 MiKTeX 2.9 為例, 作業系統是 Windows 7 (32位元)。 若使用其他版本, 安裝步驟類似。

  1. 關閉 「使用者帳戶控制」

    安裝之前請先關閉 「使用者帳戶控制」 (UAC)。 以 Windows 7 系統 為例, 關閉 UAC, 請由

    控制台 > 使用者帳戶與家庭安全 > 使用者帳戶 > 變更使用者帳戶控制設定

    選擇 「不要通知」; 請重新開機讓設定生效。

    Image UAC-close

  2. 移除舊版
    若以往曾安裝 cwTeX 舊版, 請由 Windows 之 「新增/移除」 功能, 移除下列軟體:
    • cwtex-basic,
    • MiKTeX 2.7 (或更早版本),
    • Ghostscript (8.60 或更早版本),
    • GSview (4.80 或更早版本),
    • Active Perl (5.8.8 或更早版本),
    • WinEdt (5.5版) 可繼續使用, 不須移除,
    • Total commander (7.02 或更早版本) 也可繼續使用, 不須移除

  3. 下載
    請上台大電算中心置放 cwTeX 之位址 cwtex34, 下載 cwtex_2011xx.exe; 下載後, 直接執行即可解壓。 建議將檔案解壓於 d:\cwtex34 檔案夾之下,

  4. 安裝
    解壓後之檔案中有 cwtex.exe, 直接執行即開始安裝。

    Image cwtex-basic

    安裝程式首先會安裝 MiKTeX 2.9。 請依內定選項, 將系統安裝於硬碟 C:, 若選擇於其他硬碟, 某些工具程式可能無法執行。

    Image basic-miktex

    以下的幾個畫面會出現選項, 請選用內定值; 亦即, 只要按 [Enter] 即可。

    MiKTeX 安裝完成之後, 會自動安裝 cwTeX 系統。

    Image install-cwtex

    cwTeX 安裝之後, 下一步是安裝文字編輯軟體 (editor)。

    安裝程式會依序安裝/設定兩個文字編輯軟體, Winedt 與 TeXworks。 前者是 shareware, 可免費使用31天; 後者是免費軟體。

    Image install-editor

    安裝程式會先安裝 WinEdt 軟體。

    Image install-WinEdt

    安裝完成後, 會要求啟動 WinEdt; 請讓程式啟動之後, 再按 WinEdt 視窗右上方之 X 鍵, 關閉之。

    Image install-WinEdt-launch

    安裝程式會接著設定 WinEdt 之功能, 以方便排版。

    Image install-WinEdt-setup

    接下來是安裝 TeXworks 軟體, 其過程與上面相同。

    Image install-TeXworks

    不過, 第一個畫面是語文界面之選擇。 若無特別偏好, 可選用英文 (English)。

    Image install-TeXworks-English

    安裝完成之後, 請讓軟體啟動 (Launch); 之後, 再關閉。

    Image install-TeXworks-Launch

    接下來, 安裝程式會對 TeXworks 作一些基本設定, 以方便排版。

    Image install-TeXworks-setup

    若一切順利, 下一個步驟是安裝 Ghostscript, 這是一個很有用的工具程式。

    Image install-Ghostscript

    下一步是安裝 SumatraPDF, 這主要用於預覽排版結果。

    Image install-Sumatra

    下一步是安裝另一個工具程式, Perl。 此一程式有幾種版本, 我們選用的是 ActivePerl。

    Image install-Perl

    最後, 我們會安裝 Total Commander。 這是一個類似 Windows 檔案總管的軟體, 但功能甚強, 而且, 使用者界面絕佳。 同樣的, 一開始可選用 English 語言界面。

    Image install-TC

    Total Commander 安裝之後, 程式會作一些設定。 最後一個畫面是要求重新啟動, 預設值是 「稍後啟動」; 請改選擇立即重新啟動。

    Image install-restart

  5. 測試安裝是否正確
    重新啟動後, 請測試排版程式是否正確安裝? 請直接執行 c:\Program Files\cwtex\util 內之 testcwinstall.bat。

    測試程式首先會檢查 「環境變數」 (environment variable) 中之程式路徑 (path) 是否設定正確。 若無問題, 會排版出一份簡短的英文文件。

    Image install-test-English

    接下來, 關閉右邊的預覽畫面; 回到左邊黑底白字的 DOS 視窗 (DOS box)。 按 [Enter], 即排版出一份簡短的中文文件。

    Image install-test-Chinese

    若以上兩份文件都能排版出來, 即表示安裝正確。

  6. 更新為較新版本

  7. 排版 (以 WinEdt 為例)
    啟動 WinEdt, 由工作列上 File > Recent File List, 可開啟 test.ctx 排版文稿。 點選工作列上的 cwpdf 圖標, 即可排版出結果。 若不使用 cwpdf 圖標, 你也可以按 [Ctrl]+T, 其功能相同。

    Image install-test

    你若在 WinEdt 視窗內的 test.ctx 文稿內加入一些文字或指令; 儲存後, 再按 [Ctrl]+T, 即可排版出修正後的文稿。

    請注意, 你加入的文字與指令必須在 \end{document} 之前。 亦即, 在此指令之後的文字與指令, 排版程式不會處理。

    同樣的, 開啟 examp2.ctx 測試檔, 按 [Ctrl]+T 即開始排版。 不過, 馬上會出現下列畫面。

    Image install-examp2

    中間的 Package Installation 視窗提示, MiKTeX 要透過網路下載巨集套件 titlesec.sty, 原因是 examp2.ctx 例子文稿所使用的這一個此巨集套件, 尚未安裝在你的電腦內。 若電腦接上網路, MiKTeX 可以透過網路, 即時安裝此一套件。

    在 Package Installation 視窗內, 中間的 <Random package repository> 表示, MiKTeX 會任意選擇一個地理位置較近的網站下載。 下方打勾的選項表示, 下載任何巨集套件前, 都會徵求同意。 點選 「Install」 後即進行下載, 並完成排版。

    Image install-texsync

    以上畫面中, 左邊的原始文稿檔案上有一行字變成反白, 原因是我們在右邊預覽畫面上以滑鼠點選了排版版面上第1節的第3行; 這對應原始文稿的反白文字的這一行。 此一功能稱為 texsync, 點選排版結果的任一行, 即可回到原始檔案的對應文字, 這對於校對寫作原稿很有幫助。

    反過來, 如果你在左邊原始文稿的任何一行按 [Ctrl-[F8], 則右邊預覽畫面上的對應行會以顏色標示。

    以上排版的例子檔案 examp2.ctx 存放於 c:\Program Files\cwtex\tex\examples 之內。 排版後, 檔案夾內會新增 examp2.pdf 以及 examp2.synctex.gz 兩個檔案, 後者是一個輔助案, 用於 texsync 之功能。

  8. 排版 (以 TeXworks 為例)
    第一次啟動 TeXworks 後, 請先確定以下之設定。 點選工作列上之 Edit, 在下拉選項中選取 Preferences。 接下來, 在 Editor 的畫面中, 請確定 Encoding 是選用 System。 若選用其他設定, 會出現錯誤的排版結果。

    Image install-TeXworks-init

    此外, 我建議選用 fixedsys 字型, 大小選 11 pt。

    接下來, 在同一個畫面上, 點選 Typesetting, 在下拉畫面中, 請確定 Processing tools 下之 Default 是選用 cwpdf; 此設定使用 cwpdf 批次檔之設定來排版。

    經過以上設定, 回到 TeXworks 視窗, 開啟例子檔案 examp2.ctx, 排版結果立刻出現在右邊視窗內。 原因是, 上一輪的排版結果 examp2.pdf 仍存放於檔案夾。

    Image install-TeXworks-examp2

    請試在第一段文字末端 「... 再講一遍而已。」 之後, 空一行, 輸入一句: 「排版測試。」 儲存之後, 在 TeXworks 視窗內, 按 [Ctrl]-T 重新排版, 結果如下。

    Image install-TeXworks-test

    你也可以用滑鼠點選左上方的向右三角形, 其功能與 [Ctrl]-T 鍵相同。

    TeXworks 也有 texsync 的功能。 在任何一邊的視窗內, 按下 [Ctrl] 鍵, 再點滑鼠左鍵, 另一邊視窗的對應一行即以顏色標示出來。

  9. 錯誤訊息
    回到 test.ctx 之測試檔, 我們在文稿中新增一些指令與文字, 排版結果如下:

    Image install-error

    現若輸入數學式指令時, 不小心少了最右邊的大括號, 亦即, x=\sqrt{x^2} 變成 x=\sqrt{x^2。 排版結果如下:

    Image install-error-message

    DOS 視窗內顯示的是排版訊息。 其中, 倒數第2行的 ``l.11'' 說明, 錯誤發生在原稿的第11行。 但此例中, 真正的錯誤是第10行右邊少了大括號。

    在 DOS 視窗內連按幾次 [Enter], 我們仍然得到正確的結果。 排版時, LaTeX 會猜測錯誤的原因, 並嘗試補救。 不過, 如果錯誤太複雜, LaTeX 無法補救, 最後不會出現正確的結果。

    以上例子檔案 test.ctx 是置放於 c:\Program Files\cwtex\tex\examples, 排版時會產生一些輔助檔案, 全部存放於 c:\xtemp 檔案夾內。 其中一個輔助檔案名為 test.log, 以文字編輯軟體開啟, 在檔案內看到所有的排版訊息, 而檔案末端即記錄上述之錯誤訊息。

    因此, 除錯的第一步的開啟 c:\xtemp 內的 .log 檔案。


tmwu 2011-08-15