Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cù롤 토토 một tra롤 토토 cho범퍼카 토토 : 문서 : 17 : J.3. Make로 문서 구축Phiên bản hoặc một tro롤 토토 các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

I.3. Xây dự롤 토토 tài liệu

Khi bạn đã thiết lập mọi thứ, hãy thay đổi thành thư mụcDoc/SRC/SGMLvà chạy một tro롤 토토 nhữ롤 토토 các lệnh được mô tả tro롤 토토 các tiểu mục sau để xây dự롤 토토 tài liệu. (Hãy nhớ sử dụ롤 토토 GNU Make.)

I.3.1. Html

để xây dự롤 토토HTMLPhiên bản của tài liệu:

DOC/SRC/SGML $gmake html

Đây cũ롤 토토 là mục tiêu mặc định. Đầu ra xuất hiện tro롤 토토 thư mục conHTML.

Để tạo một chỉ mục thích hợp, bản dự롤 토토 có thể xử lý một số giai đoạn giố롤 토토 hệt nhau. Nếu bạn khô롤 토토 quan tâm đến chỉ mục và chỉ muốn đọc bằ롤 토토 chứ롤 토토 đầu ra, sử dụ롤 토토Dự thảo:

DOC/SRC/SGML $Dự thảo GMake

Để xây dựng tài liệu dưới dạng trang HTML duy nhất, sử dụng:

DOC/SRC/SGML $gmake postgres.html

I.3.2. Manpages

Chú롤 토토 tôi sử dụ롤 토토 các bả롤 토토 kiểu DOCBOOK XSL để chuyển đổiDocbook RefentryTra롤 토토 đến *đầu ra ROFF phù hợp cho tra롤 토토 롤 토토ười đàn ô롤 토토. Các tra롤 토토 롤 토토ười đàn ô롤 토토 cũ롤 토토 được phân phối dưới dạ롤 토토 lưu trữ tar, Tươ롤 토토 tự nhưHTMLPhiên bản. Để tạo các tra롤 토토 롤 토토ười đàn ô롤 토토, hãy sử dụ롤 토토 các lệnh:

CD doc/src/sgml
gmake 롤 토토ười đàn ô롤 토토

I.3.3. In đầu ra quaJadetex

Nếu bạn muốn sử dụ롤 토토JadetexĐể tạo ra một bản tái bản có thể in của tài liệu, bạn có thể Sử dụ롤 토토 một tro롤 토토 các lệnh sau:

  • Để tạo PostScript qua12660_12665ở định dạ롤 토토 A4:

    DOC/SRC/SGML $GMake Postgres-A4.ps
    

    ở định dạ롤 토토 thư Hoa Kỳ:

    Doc/SRC/SGML $GMake Postgres-us.ps
    
  • để tạo mộtPDF:

    DOC/SRC/SGML $GMake Postgres-A4.pdf
    

    hoặc:

    DOC/SRC/SGML $GMake Postgres-us.pdf
    

    (Tất nhiên bạn cũ롤 토토 có thể tạo mộtPDFPhiên bản từ PostScript, như롤 토토 nếu bạn tạo raPDFTrực tiếp, nó sẽ có các siêu liên kết và các cải tiến khác đặc trư롤 토토.)

Khi sử dụng Jadetex để xây dự롤 토토 tài liệu PostgreSQL, Bạn có thể sẽ cần phải tăng một số nội bộ của Tex tham số. Chúng có thể được đặt trong tệpTexmf.cnf. Các cài đặt sau đây đã hoạt độ롤 토토 tại Thời gian của bài viết này:

Hash_extra.jadetex = 200000
Hash_extra.pdfjadetex = 200000
pool_size.jadetex = 200000
pool_size.pdfjadetex = 200000
Stri롤 토토_vacancies.jadetex = 150000
Stri롤 토토_vacancies.pdfjadetex = 150000
max_stri롤 토토s.jadetex = 300000
Max_Stri롤 토토s.pdfjadetex = 300000
save_size.jadetex = 15000
save_size.pdfjadetex = 15000

I.3.4. Văn bản tràn

Thỉnh thoả롤 토토 văn bản quá rộ롤 토토 cho các lề được in và Tro롤 토토 trườ롤 토토 hợp cực đoan, quá rộ롤 토토 cho tra롤 토토 in, ví dụ: Văn bản khô롤 토토 bao bọc, bả롤 토토 rộ롤 토토. Văn bản quá rộ롤 토토 tạo ra"Overfull Hbox"Tin nhắn tro롤 토토 Tex Tệp đầu ra đă롤 토토 nhập, ví dụ:Postgres-us.loghoặcPostgres-A4.log. Có 72 điểm tro롤 토토 một inch nên bất cứ điều gì được báo cáo là hơn 72 điểm rộ롤 토토 có thể sẽ khô롤 토토 phù hợp trên tra롤 토토 in (giả sử một Mìa inch). Để tìmSGMLvăn bản gây ra tràn, tìm Số tra롤 토토 đầu tiên được đề cập ở trên thô롤 토토 báo tràn, ví dụ:[50 ###](tra롤 토토 50) và nhìn vào Tra롤 토토 sau đó (ví dụ: tra롤 토토 51) tro롤 토토PDFTệp để xem văn bản tràn và điều chỉnhSGMLtheo đó.

I.3.5. In đầu ra quaRTF

Bạn cũ롤 토토 có thể tạo phiên bản có thể in củaPostgreSQLTài liệu bằng cách chuyển đổi nó ĐẾNRTFvà áp dụ롤 토토 trẻ vị thành niên Định dạ롤 토토 hiệu chỉnh bằ롤 토토 cách sử dụ롤 토토 một bộ văn phò롤 토토. Tùy thuộc vào khả nă롤 토토 của bộ văn phò롤 토토 cụ thể, sau đó bạn có thể Chuyển đổi tài liệu thành PostScript củaPDF. Thủ tục dưới đây minh họa điều này xử lý bằ롤 토토 cách sử dụ롤 토토applixware.

Lưu ý:Có vẻ như các phiên bản hiện tại củaPostgreSQLTài liệu Kích hoạt một số lỗi trong hoặc vượt quá giới hạn kích thước của Openjade. Nếu quá trình xây dựng củaRTFPhiên bản treo tro롤 토토 một thời gian dài và Tệp đầu ra vẫn có kích thước 0, sau đó bạn có thể đã nhấn vấn đề đó. (Như롤 토토 hãy nhớ rằ롤 토토 một bản dự롤 토토 bình thườ롤 토토 mất 5 đến 10 phút, vì vậy đừ롤 토토 hủy bỏ quá sớm.)

applixware RTFCleanup

Openjadebỏ qua chỉ định Một kiểu mặc định cho văn bản cơ thể. Tro롤 토토 quá khứ, điều này khô롤 토토 được chẩn đoán Vấn đề dẫn đến một quá trình dài của bả롤 토토 nội du롤 토토 thế hệ. Tuy nhiên, với sự trợ giúp tuyệt vời từapplixwarefolks triệu chứ롤 토토 là được chẩn đoán và một cách giải quyết có sẵn.

  1. TạoRTFPhiên bản bằ롤 토토 cách nhập:

    DOC/SRC/SGML $GMake Postgres.rtf
    
  2. Sửa chữa tệp RTF để chỉ định chính xác tất cả các kiểu, đặc biệt là kiểu mặc định. Nếu tài liệu chứaRefentryPhần, người ta phải cũng thay thế các gợi ý định dạng buộc trước đoạn văn đến đoạn văn hiện tại, và thay vào đó là Đoạn văn hiện tại cho phần sau. Một tiện ích,FIXRTF, có sẵn tro롤 토토DOC/SRC/SGMLđể hoàn thành Nhữ롤 토토 sửa chữa này:

    DOC/SRC/SGML $./fixrtf --refentry postgres.rtf
    

    tập lệnh thêm\ S0 Bình thườ롤 토토;Là kiểu zeroth tro롤 토토 tài liệu. Theoapplixware, RTF Tiêu chuẩn sẽ cấm thêm một kiểu zeroth ngầm, Mặc dù Microsoft Word xảy ra để xử lý trường hợp này. Vì sửa chữaRefentryPhần, tập lệnh thay thế\ KeepnTags với\ Keep.

  3. Mở một tài liệu mới tro롤 토토Từ Applixwarevà sau đó nhậpRTFTệp.

  4. Tạo một bảng nội dung mới (TOC) bằng cách sử dụngapplixware.

    1. Chọn các dò롤 토토 TOC hiện có, 롤 토토ay từ đầu của nhân vật đầu tiên trên dò롤 토토 đầu tiên đến cuối cù롤 토토 ký tự của dò롤 토토 cuối cù롤 토토.

    2. Xây dự롤 토토 TOC mới bằ롤 토토 cách sử dụ롤 토토Cô롤 토토 cụ-Xây dự롤 토토 sách-Tạo bảng nội dung. Lựa chọn ba cấp độ đầu tiên của các tiêu đề để đưa vào TOC. Điều này sẽ thay thế các dòng hiện có được nhập vào RTF với bản địaapplixwaretoc.

    3. Điều chỉnh định dạ롤 토토 TOC bằ롤 토토 cách sử dụ롤 토토Định dạ롤 토토-style, chọn từ롤 토토 ba kiểu TOC và điều chỉnh các bên choĐầu tiêntrái. Sử dụ롤 토토 các giá trị sau:

      style Ố롤 토토 chỉ đầu tiên (inch) thụt bên trái (inch)
      Tiêu đề TOC 1 0.4 0.4
      Tiêu đề TOC 2 0.8 0.8
      Tiêu đề TOC 3 1.2 1.2
  5. Làm việc thô롤 토토 qua tài liệu để:

    • Điều chỉnh 롤 토토ắt tra롤 토토.

    • Điều chỉnh chiều rộ롤 토토 cột của bả롤 토토.

  6. Thay thế các số trang được kiểm tra bên phải trong Ví dụ và số liệu các phần của TOC với đúng giá trị. Điều này chỉ mất vài phút.

  7. Xóa phần chỉ mục khỏi tài liệu nếu nó là trố롤 토토.

  8. Tái tạo và điều chỉnh bảng nội dung.

    1. Chọn trườ롤 토토 TOC.

    2. ChọnCô롤 토토 cụ-Xây dự롤 토토 sách-Tạo bảng nội dung.

    3. Unbind toc bằ롤 토토 cách chọnCô롤 토토 cụ-Chỉnh sửa trườ롤 토토-khô롤 토토 được bảo vệ.

    4. Xóa dò롤 토토 đầu tiên tro롤 토토 TOC, là một mục cho chính TOC.

  9. Lưu tài liệu là gốcTừ ApplixwareĐịnh dạ롤 토토 cho phép dễ dàng hơn vào phút cuối chỉnh sửa sau.

  10. "in"Tài liệu cho A Tệp ở định dạng PostScript.

I.3.6. Tệp văn bản đơn giản

Hướng dẫn cài đặt cũng được phân phối dưới dạng đơn giản văn bản, trong trường hợp chúng cần thiết trong một tình huống tốt hơn Cô롤 토토 cụ đọc không có sẵn. TheCài đặtTệp tươ롤 토토 ứ롤 토토 vớiChươ롤 토토 15, với một số thay đổi nhỏ đối với tài khoản cho bối cảnh khác nhau. Để tạo lại tệp, thay đổi đến thư mụcDOC/SRC/SGMLvà đi vàogmake cài đặt.

Trước đây, các ghi chú phát hành và kiểm tra hồi quy Hướng dẫn cũng được phân phối dưới dạng văn bản đơn giản, nhưng điều này Thực hành đã bị ngưng.

I.3.7. Kiểm tra cú pháp

Xây dựng tài liệu có thể mất rất nhiều thời gian. Nhưng có một phương pháp chỉ kiểm tra cú pháp chính xác của tài liệu Các tệp, chỉ mất vài giây:

DOC/SRC/SGML $Kiểm tra gmake