From 7b09fdd760655e6c6ecefdd610678503280fd2b6 Mon Sep 17 00:00:00 2001 From: "Vanilla I. Shu" Date: Sun, 16 Jul 2006 11:34:43 +0000 Subject: [PATCH] - fdp-primer/tools 100% completed PR: docs/100379 Submitted by: chinsan.tw at gmail.com --- .../books/fdp-primer/tools/chapter.sgml | 146 +++++++----------- 1 file changed, 60 insertions(+), 86 deletions(-) diff --git a/zh_TW.Big5/books/fdp-primer/tools/chapter.sgml b/zh_TW.Big5/books/fdp-primer/tools/chapter.sgml index 427c1ddc8c..566333757c 100644 --- a/zh_TW.Big5/books/fdp-primer/tools/chapter.sgml +++ b/zh_TW.Big5/books/fdp-primer/tools/chapter.sgml @@ -50,29 +50,26 @@ 裝了這個 port 之後，『應該』就會自動下載、安裝本章所會介紹到的工具了。 若要處理中文的話，建議再裝 chinese/docproj 會比較好。 - One of the packages that you might need is the JadeTeX macro set. - In turn, this macro set requires &tex; to be installed. &tex; is a large - package, and you only need it if you want to produce Postscript or PDF - output. + 在這些 packages 當中，你可能會需要使用 JadeTeX 這個 macro 設定， + 一旦選擇使用該 macro 的話，它會接著去裝 &tex;。由於 &tex; 算是個蠻大的套件， + 除非你需要輸出 Postscript 或 PDF 格式，否則就不必裝了。 - To save yourself time and space you must specify whether or not you - want JadeTeX (and therefore &tex;) installed when you install this port. - Either do: + 所以請考慮是否要節省編譯時間、硬碟空間，以判定要不要裝 JadeTeX (以及 &tex;) + 了。若要一併裝起來的話： &prompt.root; make JADETEX=yes install - or + 或是，不裝的話： &prompt.root; make JADETEX=no install - as necessary. Alternatively you may install textproc/docproj-jadetex or textproc/docproj-nojadetex. These slave ports - define the JADETEX variable for you, therefore they - will install the same suite of applications on your machine. - Note that you can produce only HTML or ASCII - text output if you do not install JadeTeX. - PostScript or PDF output require &tex;. + 或者，也可以選擇 textproc/docproj-jadetex 或是 textproc/docproj-nojadetex 這兩個之一來裝， + 它們都是已事先設定 JADETEX 變數的 slave ports， + 都一樣會裝 docproj 差別僅在於有沒有 JadeTeX 而已。 + 請注意：若只要輸出 HTML 或 ASCII 格式文件，那就不用裝 JadeTeX， + 而若要輸出 PostScript、PDF 格式，就需要裝 &tex; 才行。 @@ -81,10 +78,9 @@ 軟體 - These programs are required before you can usefully work with the - FreeBSD documentation, and they will allow you to convert the - documentation to HTML, plain text, and RTF formats. They are all - included in textproc/docproj. + 這些都是在進行 FreeeBSD 文件計劃時所會需要用上的工具程式， + 而且可以用來轉換文件為 HTML、plain text以及 RTF 格式。這些相關套件在 + textproc/docproj 都已經全部收錄了。 @@ -92,8 +88,7 @@ (textproc/jade) - A DSSSL implementation. Used for converting marked up - documents to other formats, including HTML and &tex;. + DSSSL 規格的實作程式，可用來把標記語言的文件(marked up)轉換為其他格式，像是：HTML 及 &tex;。 @@ -102,9 +97,7 @@ (www/tidy) - An HTML pretty printer, used to reformat some of the - automatically generated HTML so that it is easier to - follow. + HTML pretty printer，可用來把自動產生的 HTML 內容整理得更易閱讀、以便日後維護。 @@ -113,8 +106,7 @@ (www/links) - A text-mode WWW browser that can also convert - HTML files to plain text. + 文字操作模式的 WWW 瀏覽器(browser)可以把 HTML 檔轉為 plain text 格式。 @@ -123,27 +115,24 @@ (graphics/peps) - Some of the documentation includes images, some of which are - stored as EPS files. These must be converted to PNG before most - web browsers will display them. + 文件中有些圖是存成 EPS 格式的，這些必須要轉為 PNG 格式， + 才能讓一般瀏覽器可以正常觀看。 - DTDs 及 Entities + DTD 及 Entity - These are the DTDs and entity sets used by the FDP. They need to - be installed before you can work with any of the documentation. + 由於 FDP 有用到許多 DTD 跟 Entity，因此在開工前，要裝上這些才行。 HTML DTD (textproc/html) - HTML is the markup language of choice for the World Wide - Web, and is used throughout the FreeBSD web site. + HTML 是用於 WWW 的標記語言，且也是 FreeBSD 網頁所使用的格式。 @@ -151,8 +140,8 @@ DocBook DTD (textproc/docbook) - DocBook is designed for marking up technical documentation. - All the FreeBSD documentation is written in DocBook. + DocBook 是專門用來製作技術文件的標示語言版本， + FreeBSD 全部文件都是以 DocBook 所寫成的。 @@ -161,10 +150,8 @@ (textproc/iso8879) - 19 of the ISO 8879:1986 character entity sets used by many - DTDs. Includes named mathematical symbols, additional - characters in the Latin character set (accents, diacriticals, - and so on), and Greek symbols. + 在 ISO 8879:1986 之中有 19 個 entity 被許多 DTD 所大量使用， + 包括了數學符號、拉丁字母符號(尖重音等音節符號也是)以及希臘符號。 @@ -173,18 +160,16 @@ 樣式表(Stylesheets) - The stylesheets are used when converting and formatting the - documentation for display on screen, printing, and so on. + 這些樣式表都是用來轉換、重排文件的螢幕顯示、列印等效果處理 - Modular DocBook Stylesheets + Modular DocBook 樣式表 (textproc/dsssl-docbook-modular) - The Modular DocBook Stylesheets are used when converting - documentation marked up in DocBook to other formats, such as - HTML or RTF. + Modular DocBook 樣式表，是用來把 DocBook 的標記語言文件轉換為其他格式，像是： + HTML 或 RTF。 @@ -192,72 +177,61 @@ - Optional tools + 輔助工具 - You do not need to have any of the following installed. However, - you may find it easier to work with the documentation if you do, and - they may give you more flexibility in the output formats that can be - generated. + 不一定得裝下列的工具才行，但是，裝了之後會更容易進行各項工作， + 而且可輸出的格式也更具彈性。 - Software + 軟體 - JadeTeX and + JadeTeX 及 teTeX - (print/jadetex and + (print/jadetex 及 print/teTeX) - Jade and - teTeX are used to convert DocBook - documents to DVI, Postscript, and PDF formats. The - JadeTeX macros are needed in order to - do this. + Jade 與 + teTeX 可用來把 DocBook 格式文件轉為 + DVI, Postscript 及 PDF 格式。安裝時請記得加上 + JadeTeX 這個 macro，這樣才會順便裝上這兩個套件。 - If you do not intend to convert your documentation to one of - these formats (i.e., HTML, plain text, and RTF are sufficient) - then you do not need to install - JadeTeX and - teTeX. This can be a significant - space and time saver, as teTeX is - over 30MB in size. + 若無意把文件轉換更多格式的話(舉例：只要 HTML, plain text, RTF 這些格式就夠的話) + ，那麼就不用裝 + JadeTeX 與 + teTeX。 如此一來可省下一些的編譯時間、安裝空間， + 因為 teTeX 大約要至少 30MB 空間。 - If you decide to install - JadeTeX and - teTeX then you will need to - configure teTeX after - JadeTeX has been installed. - print/jadetex/pkg-message contains - detailed instructions explaining what you need to do. + 若決定要裝 + JadeTeX 以及 + teTeX 的話，那麼在裝完 JadeTeX 之後， + 要記得設定 teTeX 才行。 + print/jadetex/pkg-message 內有詳細介紹相關步驟。 - Emacs or + Emacs 或 XEmacs - (editors/emacs or + (editors/emacs 或 editors/xemacs) - Both these editors include a special mode for editing - documents marked up according to an SGML DTD. This mode - includes commands to reduce the amount of typing you need, and - help reduce the possibility of errors. + 這兩者編輯器都具有處理 SGML DTD 標記文件的特殊模式。 + 該模式提供一些指令，來簡化所需的打字次數，而且可以減少可能發生的錯誤。 - You do not need to use them; any text editor can be used to - edit marked up documents. You may find they make you more - efficient. + 不過，這些編輯器並不是必備的；任何文字編輯器都可以用來編輯標記語言文件。 + 不過，你可以透過類似上述這樣的編輯器，來讓這些繁瑣作業更輕鬆有效率些。 - If anyone has recommendations for other software that is useful - when manipulating SGML documents, please let &a.doceng; know, so they - can be added to this list. + 若有推薦其他好用的處理 SGML 文件程式，請來信讓 &a.doceng; 知道， + 如此一來，該軟體就會列入這裡介紹了。