?
このドキュメントでは、 php中國語ネットマニュアル リリース
一旦把所有的東西都設(shè)置好了,進入目錄 doc/src/sgml 然后運行下面其中一條命令(記得要用 GNU make)。
制作 HTML 版本的文檔:
doc/src/sgml$ gmake html
這也是缺省目標。輸出結(jié)果出現(xiàn)在子目錄html。
To create a proper index, the build might process several identical stages. If you do not care about the index, and just want to proof-read the output, use draft:
doc/src/sgml$ gmake draft
制作單頁的HTML文檔,使用:
doc/src/sgml$ gmake postgres.html
我們使用DocBook XSL樣式表
把 DocBook 的 refentry
頁面轉(zhuǎn)換成適于
做手冊頁的 *roff 輸出。
這些手冊頁也是以 tar 歸檔的形式發(fā)布的,與 HTML 版本類似。
要創(chuàng)建手冊頁包,用命令:
cd doc/src/sgml gmake man
如果你想用 JadeTex 生成一個可打印 的文檔,可以用下面的命令:
通過 DVI 生成 PostScript A4 格式:
doc/src/sgml$ gmake postgres-A4.ps
In U.S. letter format:
doc/src/sgml$ gmake postgres-US.ps
制作一個 PDF:
doc/src/sgml$ gmake postgres-A4.pdf
或:
doc/src/sgml$ gmake postgres-US.pdf
(當然你也可以從PostScript制作個PDF版本,但是如果你直接生成PDF,這將有超鏈接和其它增強功能。)
當使用JadeTeX構(gòu)建PostgreSQL文檔,你可能會需要增加一些TeX的內(nèi)部參數(shù)。這些可以在texmf.cnf文件設(shè)置。 在這里所寫是下面設(shè)置的工作:
hash_extra.jadetex = 200000 hash_extra.pdfjadetex = 200000 pool_size.jadetex = 2000000 pool_size.pdfjadetex = 2000000 string_vacancies.jadetex = 150000 string_vacancies.pdfjadetex = 150000 max_strings.jadetex = 300000 max_strings.pdfjadetex = 300000 save_size.jadetex = 15000 save_size.pdfjadetex = 15000
偶爾對于打印邊距,文本太寬,在極端的情況下,對于打印頁太寬, 比如文本不換行,寬表。過寬文本在TeX日志輸出文件中生成"溢出盒子" 消息, 比如postgres-US.log或 postgres-A4.log。 這有72像素/英寸,所以會報告任何那些超過72像素,太寬而不適合在打印頁上的文本。(假定為1英寸) 要找到導(dǎo)致溢出的SGML文本,找到第一個有上述溢出消息的頁號,比如[50 ###] (頁 50),查看在PDF文件的其后面那一頁(如 頁 51),將看到溢出文本并相應(yīng)的調(diào)整SGML。
你也可以通過把它轉(zhuǎn)換成 RTF 并且用一個辦公套件 進行格式微調(diào)的辦法把 PostgreSQL 文檔 轉(zhuǎn)換成 RTF 格式的辦法來創(chuàng)建一個可打印的版本。根據(jù)你使用的不同的 辦公套件,然后你就可以分別把文檔轉(zhuǎn)換成 Postscript 或者 PDF 。下面的步驟演示了使用 Applixware 實現(xiàn)的過程。
Note: 目前看來 PostgreSQL 的當前版本的文檔 碰到了 OpenJade 的大小限制的一些毛病。如果制作 RTF 版本的時候停住了好長時間,而輸出文件還是 0 ,那么你很有可能碰到了 這個毛病。不過,正常的制作要花 5 到 10 分鐘,因此不要太快退出。
Applixware RTF 清理
OpenJade 忽略了指定文本主體的缺省風格。 以前,這個未經(jīng)查明的問題導(dǎo)致目錄生成的長時間處理。不過,在 Applixware 的工作人員的全力幫助下, 診斷出這個病癥并且找到了繞開的可用辦法。
鍵入下面命令生成 RTF 版本:
doc/src/sgml$ gmake postgres.rtf
修復(fù) RTF 文件,以正確指定所有風格,尤其是缺省風格。如果文檔
包含 refentry
段,那么還必須把和前面的段落
與當前段落綁定的格式化暗示替換為當前的段落和后面的段落綁定。
在 doc/src/sgml 里有一個 fixrtf
用于完成這樣的修復(fù):
doc/src/sgml$ ./fixrtf --refentry postgres.rtf
該腳本增加 {\s0 Normal;}為文檔的零級風格。
根據(jù) Applixware ,RTF 標準會禁止增加
一種隱含的零級風格,盡管 Microsoft Word 碰巧可以處理這種情況。
為了修復(fù) refentry
段落,該腳本把
\keepn 標記替換為\keep
在 Applixware Words 里打開新的文檔, 然后輸入該 RTF 文件。
用 Applixware 生成一個新的目錄(ToC)。
選擇現(xiàn)有的 ToC 行,從第一行的第一個字符到最后一行的最后一個字符。
用Tools->Book 制作一個新的 ToC 。選擇頭包含在 ToC 里三層頭。這將用本地的Applixware代替從 RTF 里輸入進來的行。
使用 Format->Style, 調(diào)整 ToC 格式,選擇每三種 ToC 風格,然后為 First 和 Left 調(diào)整邊距。使用下面的值:
風格 | 第一邊距(英寸) | 左邊距(英寸) |
---|---|---|
TOC-Heading 1 | 0.4 | 0.4 |
TOC-Heading 2 | 0.8 | 0.8 |
TOC-Heading 3 | 1.2 | 1.2 |
對文檔進行加工:
調(diào)整分頁符。
調(diào)整表列寬。
在該例子中右對齊頁號和ToC圖片部分的正確的值。這些只需要花幾分鐘。
如果索引是空的,那么從文檔中刪除它。
重新生成并調(diào)整目錄。
選擇 ToC 字段
Select Tools->Book Building->Create Table of Contents. 選擇Tools->Book 制作->Create Table of Contents。
通過選擇 Tools->Field Editing->Unprotect. 解除 ToC
刪除 ToC 中的第一行,它是指向 ToC 本身的一條記錄。
把該文檔保存為Applixware Words 本地文檔格式以便于最后的編輯。
把該文檔以 Postscript 格式"Print" 到一個文件。
有好幾個文件是以純文本的模式發(fā)布的,主要是為了在安裝過程中閱讀。 INSTALL 文件對應(yīng)章節(jié)Chapter 15 ,只有一點用于不同環(huán)境的修改。要創(chuàng)建這個文件,進入目錄 doc/src/sgml 然后敲入 gmake INSTALL 。這樣就會創(chuàng)建一個叫 INSTALL.html 的文件,你可以用 Netscape Navigator 把它另存為一個文本文件, 然后把它拷到現(xiàn)存文件的位置。好像 Netscape 提供了最高的HTML 到文本的轉(zhuǎn)換質(zhì)量 (比 lynx 和 w3m 好)。
文件HISTORY 可以用類似方法創(chuàng)建,用的命令 是 gmake HISTORY 。對于 src/test/regress/README 文件,命令是 gmake regress_README。
制作文檔可能需要很長時間。但是有一個方法用于只檢查文檔文件的 語法正確性,只要花幾秒鐘:
doc/src/sgml$ gmake check