Các công cụ sau được sử dụng để xử lý kèo bóng đá pháp. Một số có thể là tùy chọn, như đã lưu ý.
Đâ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;SGMLvàXMLBiến thể của DocBook DTD của cùng một phiên bản. Chúng thường sẽ nằm trong kèo bóng đá pháp gói riêng biệt.
Chúng được yêu cầu bởi DocBook SGML nhưng được phân phối riêng biệt vì chúng được duy trì bởi ISO.
Chúng chứa kèo bóng đá pháp hướng dẫn xử lý để chuyển đổi kèo bóng đá pháp nguồn DocBook sang kèo bóng đá pháp định dạng khác, chẳng hạn nhưHTML.
Phiên bản yêu cầu tối thiểu hiện là 1.77.0, nhưng nên sử dụng phiên bản có sẵn mới nhất để có kết quả tốt nhất.
Đây là gói cơ sở củaSGMLXử lý. Lưu ý rằng chúng ta không còn cần Openjade,DSSSLBộ xử lý, chỉ có gói OpenSp để chuyển đổi SGML thành XML.
xmllintThư viện này vàxmllintCông cụ mà nó chứa được sử dụng để xử lý XML. Nhiều nhà phát triển đã cólibxml2Đã cài đặt, vì nó cũng được sử dụng khi xây dựng mã PostgreSQL. Tuy nhiên, lưu ý rằngxmllintCó thể cần phải được cài đặt từ một gói con riêng biệt.
XSLTProcXSLTPROClà bộ xử lý XSLT, nghĩa là một chương trình chuyển đổi XML sang kèo bóng đá pháp định dạng khác bằng cách sử dụng kèo bóng đá pháp kiểu dáng XSLT.
Đây là một chương trình để chuyển đổi, trong số những thứ khác, XML sang PDF.
Chúng tôi đã ghi lại kinh nghiệm với một số phương thức cài đặt cho các công cụ khác nhau cần thiết để xử lý kèo bóng đá pháp. Chúng sẽ được mô tả dưới đây.
Bạn có thể thoát khỏi việc không cài đặt DocBook XML và các bảng kiểu DOCBOOK XSLT tại địa phương, vì các tệp cần thiết sẽ được tải xuống từ Internet và được lưu trong bộ nhớ cache kèo bóng đá phápc bộ. Trên thực tế, đây có thể là giải pháp ưa thích nếu các gói hệ điều hành của bạn chỉ cung cấp một phiên bản cũ của các kiểu dáng đặc biệt hoặc nếu không có gói nào có sẵn.--nonetTùy chọn choxmllintvàXSLTProcĐể biết thêm thông tin.
Để cài đặt kèo bóng đá pháp gói yêu cầu, sử dụng:
14620_14683
Dự án kèo bóng đá pháp FreeBSD tự nó là người dùng kèo bóng đá pháp nặng, vì vậy không có gì ngạc nhiên khi có một bộ đầy đủCổngxôngcủa các công cụ kèo bóng đá pháp có sẵn trên FreeBSD. Các cổng sau cần được cài đặt để xây dựng kèo bóng đá pháp trên FreeBSD.
TextProc/DocBook-SGML
TextProc/DocBook-XML
TextProc/DocBook-XSL
TextProc/DSSSL-DOCbook-Modular
TextProc/libxslt
TextProc/FOP
TextProc/OpenSp
Để cài đặt kèo bóng đá pháp gói yêu cầu vớiPKG, Sử dụng:
15977_16046
Khi xây dựng kèo bóng đá pháp từdocThư mục bạn sẽ cần sử dụnggmake, vì Makefile được cung cấp không phù hợp với FreeBSD'slàm.
Thông tin thêm về các công cụ kèo bóng đá pháp FreeBSD có thể được tìm thấy trongHướng dẫn của dự án kèo bóng đá pháp FreeBSD.
Có một bộ đầy đủ các gói của các công cụ kèo bóng đá pháp có sẵn choDebian Gnu/Linux. Để cài đặt, chỉ cần sử dụng:
16872_16955
Nếu bạn sử dụng MacPorts, những người sau đây sẽ giúp bạn thiết lập:
17195_17278
Quá trình cài đặt thủ công của kèo bóng đá pháp công cụ DocBook có phần phức tạp, vì vậy nếu bạn có sẵn kèo bóng đá pháp 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 kèo bóng đá pháp đường dẫn cài đặt tiêu chuẩn hợp lý và khôngFancyCác tính năng. Để biết chi tiết, bạn nên nghiên cứu kèo bóng đá pháp của gói tương ứng và đọcSGMLkèo bóng đá pháp giới thiệu.
Việc cài đặt OpenSp 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 OpenSP.
./configure --Enable-default-catalog =/usr/local/etc/sgml/catalog
Hãy chắc chắn nhớ nơi bạn đặtHồiDanh mục mặc địnhHồi; 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ụng bất kỳ chương trình nào từ OpenSp sau này. .
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ố kèo bóng đá phápc chúng ta đang theo dõi ở đây.)
$mkdir /usr/local/share/sgml/docbook-4.2$cd /usr/local/share/sgml/docbook-4.2
Giải nén kho lưu trữ:
$unzip -a ...../docbook -4.2.zip
(Lưu trữ sẽ giải nén kèo bóng đá pháp tệp của nó vào thư mục hiện tại.)
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 cài đặt) và đặt một dòng như thế này:
Danh mục "DocBook-4.2/docbook.cat"
Tải xuốngLưu trữ thực thể nhân vật ISO 8879, Giải nén nó và đặt kèo bóng đá pháp tệp vào cùng một thư mục bạn đặt kèo bóng đá pháp tệp DocBook vào:
$cd /usr/local/share/sgml/docbook-4.2$Giải nén ...../isoents.zip
Chạy lệnh sau trong thư mục với kèo bóng đá pháp tệp DocBook và ISO:
perl -pi -e 's/iso -(.*). Gml/iso \ 1/g' docbook.cat
(Điều này sửa một hỗn hợp giữa kèo bóng đá pháp tên được sử dụng trong tệp danh mục DocBook và tên thực tế của kèo bóng đá pháp tệp thực thể nhân vật ISO.)
Cấu hìnhTrước khi bạn có thể xây dựng kèo bóng đá pháp bạn cần chạyCấu hìnhtập lệnh như bạn muốn khi xây dựngPostgreSQLchính kèo bóng đá pháp chươ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 ... ONSGMLSNế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 Opensp. Bạn có thể vượt qua biến môi trườngNSGMLSĐể định cấu hình để trỏ đến kèo bóng đá pháp chương trình nếu chúng không được tìm thấy tự động. Nếu nhưDocbook v4.2HồiKhông được tìm thấy sau đó bạn không cài đặt Bộ DTD DOCBOOK ở một nơi mà Opensp có thể tìm thấy hoặc bạn chưa thiết lập kèo bóng đá pháp tệp danh mục một cách chính xác. Xem kèo bóng đá pháp gợi ý cài đặt ở trên.