Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4
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ùng một trang chohiện tạiPhiên bản hoặc một trong soi kèo bóng đá truoctran phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

J.2. soi kèo bóng đá truoctran cụ

soi kèo bóng đá truoctran công cụ sau được sử dụng để xử lý tài liệu. Một số có thể là tùy chọn, như đã lưu ý.

DocBook DTD

Đây là định nghĩa của chính DocBook. Chúng tôi hiện đang sử dụng phiên bản 4.2;SGMLBiến thể của DocBook DTD, nhưng để xây dựng soi kèo bóng đá truoctran trang người đàn ông, bạn cũng cầnXMLBiến thể của cùng một phiên bản.

ISO 8879 soi kèo bóng đá truoctran thực thể nhân vật

Chúng được yêu cầu bởi DocBook nhưng được phân phối riêng vì chúng được duy trì bởi ISO.

DocBook DSSSL Stylesheets

Chúng chứa soi kèo bóng đá truoctran hướng dẫn xử lý để chuyển đổi soi kèo bóng đá truoctran nguồn DocBook sang soi kèo bóng đá truoctran định dạng khác, chẳng hạn nhưHTML.

DOCBOOK XSL Stylesheets

Đây là một bảng kiểu khác để chuyển đổi Docbook sang soi kèo bóng đá truoctran định dạng khác. Chúng tôi hiện đang sử dụng điều này để sản xuất soi kèo bóng đá truoctran trang người đàn ông và tùy chọn HTMLHELP.

Phiên bản yêu cầu tối thiểu hiện là 1.74.0.

Openjade

Đây là gói cơ sở củaSGMLXử lý. Nó chứa mộtSGMLphân tích cú pháp, ADSSSLBộ xử lý (nghĩa là một chương trình để chuyển đổiSGMLđến soi kèo bóng đá truoctran định dạng khác bằng cách sử dụngDSSSLKiểu dáng), cũng như một số công cụ liên quan.Jadehiện đang được duy trì bởi nhóm Openjade, không còn bởi James Clark.

libxsltchoXSLTProc

Đây là công cụ xử lý để sử dụng với soi kèo bóng đá truoctran bảng kiểu XSLT (nhưJadelà công cụ xử lý cho soi kèo bóng đá truoctran kiểu dáng DSSSL).

Jadetex

Nếu bạn muốn, bạn cũng có thể soi kèo bóng đá truoctranJadetexđể sử dụngTexLà một phụ trợ định dạng choJade. JadetexCó thể tạo PostScript hoặcPDFTệp (cái sau với dấu trang).

Tuy nhiên, đầu ra từJadetexkém hơn những gì bạn nhận được từRTFphụ trợ. soi kèo bóng đá truoctran khu vực có vấn đề cụ thể là bảng và soi kèo bóng đá truoctran hiện vật khác nhau của khoảng cách dọc và ngang.

Chúng tôi đã ghi lại kinh nghiệm với một số phương thức cài đặt cho soi kèo bóng đá truoctran công cụ khác nhau cần thiết để xử lý tài liệu. Chúng sẽ được mô tả dưới đây.

J.2.1.Linux RPMsoi kèo bóng đá truoctran

Hầu hết soi kèo bóng đá truoctran nhà cung cấp cung cấp một bộ RPM hoàn chỉnh để xử lý DocBook trong phân phối của họ. Tìm kiếm một"SGML"Tùy chọn trong khi cài đặt hoặc soi kèo bóng đá truoctran gói sau:SGML-Common, Docbook, Kiểu dáng, OpenJade(hoặcJade). Bạn cũng có thể cầnSGML-toolsXSLTProchoặclibxslt. Nếu nhà phân phối của bạn không cung cấp những thứ này thì bạn sẽ có thể sử dụng soi kèo bóng đá truoctran gói từ một số nhà cung cấp khác, tương thích hợp lý.

J.2.2. FreeBSD soi kèo bóng đá truoctran

Dự án tài liệu FreeBSD tự nó là người dùng tài liệu nặng, vì vậy không có gì ngạc nhiên khi có một bộ đầy đủ"Cổng"của soi kèo bóng đá truoctran công cụ tài liệu có sẵn trên FreeBSD. soi kèo bóng đá truoctran cổng sau cần được cài đặt để xây dựng tài liệu trên FreeBSD.

  • TextProc/sp

  • TextProc/OpenJade

  • TextProc/ISO8879

  • TextProc/DSSSL-DOCbook-Modular

  • TextProc/DocBook-420

Một số điều từ/usr/port/print(Tex, Jadetex) cũng có thể được quan tâm.

Có thể soi kèo bóng đá truoctran cổng không cập nhật tệp danh mục chính trong/usr/local/share/sgml/catalog.portsHoặc đơn hàng đó không phù hợp. Đảm bảo có soi kèo bóng đá truoctran dòng sau ở đầu tệp:

Danh mục "Openjade/Danh mục"

Nếu bạn không muốn chỉnh sửa tệp, bạn cũng có thể đặt biến môi trườngSGML_CATALOG_FILESđến danh sách soi kèo bóng đá truoctran tệp danh mục được phân tách đại tràng (chẳng hạn như tệp trên).

Thông tin thêm về soi kèo bóng đá truoctran công cụ tài liệu FreeBSD có thể được tìm thấy trongHướng dẫn của dự án tài liệu FreeBSD.

J.2.3. Gói Debian

Có một bộ đầy đủ soi kèo bóng đá truoctran gói của soi kèo bóng đá truoctran công cụ tài liệu có sẵn choDebian Gnu/Linux. Để soi kèo bóng đá truoctran, chỉ cần sử dụng:

16034_16113

J.2.4. OS X

Nếu bạn sử dụng MacPorts, những điều sau đây sẽ giúp bạn thiết lập:

16309_16411

J.2.5. soi kèo bóng đá truoctran thủ công từ nguồn

Quá trình cài đặt thủ công của soi kèo bóng đá truoctran công cụ DocBook có phần phức tạp, vì vậy nếu bạn có sẵn soi kèo bóng đá truoctran gói được xây dựng trước, hãy sử dụng chúng. Chúng tôi mô tả ở đây chỉ là một thiết lập tiêu chuẩn, với soi kèo bóng đá truoctran đường dẫn cài đặt tiêu chuẩn hợp lý và không"Fancy"soi kèo bóng đá truoctran tính năng. Để biết chi tiết, bạn nên nghiên cứu tài liệu của gói tương ứng và đọcSGMLTài liệu giới thiệu.

J.2.5.1. soi kèo bóng đá truoctran Openjade

  1. soi kèo bóng đá truoctran OpenJade cung cấp kiểu GNU./configure; làm;Xây dựng quá trình. Chi tiết có thể được tìm thấy trong phân phối nguồn Openjade.

    ./configure --Enable-default-catalog =/usr/local/share/sgml/catalog

    Hãy chắc chắn nhớ nơi bạn đặt"Danh mục mặc định"; Bạn sẽ cần nó dưới đây.SGML_CATALOG_FILESĐể trỏ đến tệp bất cứ khi nào bạn sử dụngJadeSau này. (Phương thức này cũng là một tùy chọn nếu Openjade đã được cài đặt và bạn muốn cài đặt phần còn lại của công cụ soi kèo bóng đá truoctranc bộ.)

    Lưu ý:Một số người dùng đã báo cáo gặp lỗi phân đoạn bằng cách sử dụng Openjade 1.4Devel để xây dựng PDFS, với một thông báo như:

    OpenJade: ./ styleSheet.dsl: 664: 2: E: Đối tượng dòng không được cổng chấp nhận; Chỉ chấp nhận soi kèo bóng đá truoctran đối tượng luồng hiển thị

    hạ cấp xuống Openjade 1.3 sẽ loại bỏ lỗi này.

  2. Ngoài ra, bạn nên cài đặt soi kèo bóng đá truoctran tệpDSSSL.DTD, fot.dtd, style-sheet.dtdDanh mụctừDSSSLThư mục ở đâu đó, có lẽ thành/usr/local/share/sgml/dsssl. Có lẽ dễ dàng nhất để sao chép toàn bộ thư mục:

  3. Cuối cùng, tạo tệp/usr/local/share/sgml/catalogvà thêm dòng này vào nó:

    Danh mục "DSSSL/Danh mục"

    (Đây là tham chiếu đường dẫn tương đối đến tệp được soi kèo bóng đá truoctran trongBước 2. Hãy chắc chắn điều chỉnh nó nếu bạn chọn bố soi kèo bóng đá truoctranc cài đặt của mình khác nhau.)

J.2.5.2. soi kèo bóng đá truoctranDocbook DTDKit

  1. lấyPhân phối DocBook v4.2.

  2. Tạo thư mục/usr/local/share/sgml/docbook-4.2và thay đổi nó. (Vị trí chính xác là không liên quan, nhưng vị trí này là hợp lý trong bố soi kèo bóng đá truoctranc chúng ta đang theo dõi ở đây.)

    $mkdir /usr/local/share/sgml/docbook-4.2
    $cd /usr/local/share/sgml/docbook-4.2
  3. Giải nén kho lưu trữ:

    $Unzip -a ...../DocBook -4.2.Zip

    (Lưu trữ sẽ giải nén soi kèo bóng đá truoctran tệp của nó vào thư mục hiện tại.)

  4. Chỉnh sửa tệp/usr/local/share/sgml/catalog(hoặc bất cứ điều gì bạn đã nói Jade trong quá trình soi kèo bóng đá truoctran) và đặt một dòng như thế này:

    Danh mục "DocBook-4.2/docbook.cat"
  5. Tải xuốngLưu trữ thực thể nhân vật ISO 8879, Giải nén nó và đặt soi kèo bóng đá truoctran tệp vào cùng một thư mục bạn đặt soi kèo bóng đá truoctran tệp DocBook vào:

    $cd /usr/local/share/sgml/docbook-4.2
    $Giải nén ...../isoents.zip
  6. Chạy lệnh sau trong thư mục với soi kèo bóng đá truoctran tệp DocBook và ISO:

    perl -pi -e 's/iso -(.*).

    (Điều này sửa một hỗn hợp giữa soi kèo bóng đá truoctran tên được sử dụng trong tệp danh mục DocBook và tên thực tế của soi kèo bóng đá truoctran tệp thực thể nhân vật ISO.)

J.2.5.3. soi kèo bóng đá truoctran DocbookDSSSLKiểu cách

Để cài đặt soi kèo bóng đá truoctran bảng kiểu, giải nén và mở ra phân phối và di chuyển nó đến một nơi phù hợp, ví dụ/usr/local/share/sgml. (Lưu trữ sẽ tự động tạo một thư mục con.)

$ Gunzip DocBook-DssSL-1.XX.tar.gz
$ 21986_22037XX.tar

Mục nhập danh mục thông thường trong/usr/local/share/sgml/catalogcũng có thể được thực hiện:

Danh mục "DocBook-DssSL-1.XX/Catalog "

Bởi vì soi kèo bóng đá truoctran kiểu dáng thay đổi khá thường xuyên và đôi khi có lợi khi thử soi kèo bóng đá truoctran phiên bản thay thế,PostgreSQLKhông sử dụng mục nhập danh mục này. Nhìn thấyPhần J.2.6Để biết thông tin về cách chọn soi kèo bóng đá truoctran kiểu dáng thay thế.

J.2.5.4. soi kèo bóng đá truoctranJadetex

Để soi kèo bóng đá truoctran và sử dụngJadetex, bạn sẽ cần soi kèo bóng đá truoctran làm việcTexlatex2e, bao gồm cả được hỗ trợCông cụĐồ họaGói,Babel, AMSPhông chữAMS-Latex, ThePSNFSSBộ mở rộng và đồng hành của"35 phông chữ", TheDVIPSChương trình tạoPostScript, soi kèo bóng đá truoctran gói macroFancyHDR, HyperRef, Minitoc, urlOT2ENC. Tất cả những thứ này có thể được tìm thấy trên khu phố thân thiện của bạnCTANTrang web. soi kèo bóng đá truoctran củaTexHệ thống cơ sở vượt xa phạm vi của phần giới thiệu này. soi kèo bóng đá truoctran gói nhị phân sẽ có sẵn cho bất kỳ hệ thống nào có thể chạyTex.

Trước khi bạn có thể sử dụngJadetexvớiPostgreSQLNguồn tài liệu, bạn sẽ cần tăng kích thướcTexcấu trúc dữ liệu nội bộ. Chi tiết về điều này có thể được tìm thấy trongJadetexHướng dẫn soi kèo bóng đá truoctran.

Sau khi hoàn thành, bạn có thể soi kèo bóng đá truoctranJadetex:

$ Gunzip Jadetex-xxx.tar.gz
$ tar xf jadetex-xxx.tar
$ CD Jadetex
$ Tạo soi kèo bóng đá truoctran
$ MKTEXLSR

Hai cái cuối cùng cần được thực hiện làroot.

J.2.6. Phát hiện bởiCấu hình

Trước khi bạn có thể xây dựng tài liệu bạn cần chạyCấu hìnhtập lệnh như bạn muốn khi xây dựngPostgreSQLChương trình. Kiểm tra đầu ra ở gần cuối lần chạy, nó sẽ trông giống như thế này:

Kiểm tra OnSGMLS ... ONSGMLS

nếu khôngOnSGMLSNorNSGMLSĐã được tìm thấy sau đó một số thử nghiệm sau đây sẽ bị bỏ qua.NSGMLSlà một phần của gói ngọc. Bạn có thể vượt qua soi kèo bóng đá truoctran biến môi trườngJadeNSGMLSĐể định cấu hình để trỏ đến soi kèo bóng đá truoctran chương trình nếu chúng không được tìm thấy tự động. Nếu như"DocBook v4.2"Không được tìm thấy sau đó bạn không cài đặt Bộ DTD DocBook ở một nơi mà Jade có thể tìm thấy nó hoặc bạn chưa thiết lập soi kèo bóng đá truoctran tệp danh mục một cách chính xác. Xem soi kèo bóng đá truoctran gợi ý cài đặt ở trên.DocBookstyleđến vị trí và chạy lạiCấu hìnhsau đó.