db2x_xsltproc - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

db2x_xsltproc - Trình bao bọc lời gọi bộ xử lý XSLT

SYNOPSIS

db2x_xsltproc [lựa chọn] tài liệu xml

MÔ TẢ

db2x_xsltproc gọi bộ xử lý XSLT 1.0 cho docbook2X.

Lệnh này áp dụng biểu định kiểu XSLT (thường được cung cấp bởi - bảng tính tùy chọn) đến
Tài liệu XML trong tệp tài liệu xml. Kết quả được ghi vào đầu ra tiêu chuẩn (trừ khi
thay đổi với - đầu ra).

Để đọc tài liệu XML nguồn từ đầu vào chuẩn, hãy chỉ định - làm tài liệu đầu vào.

LỰA CHỌN

--phiên bản
Hiển thị phiên bản docbook2X.

CHUYỂN ĐỔI OUTPUT LỰA CHỌN
- đầu ra hồ sơ, -o hồ sơ
Ghi đầu ra vào tệp đã cho (hoặc URI), thay vì đầu ra tiêu chuẩn.

SOURCE TÀI LIỆU LỰA CHỌN
--xbao gồm, -I
Quy trình XI Bao gồm các chỉ thị trong tài liệu nguồn.

--sgml, -S
Cho biết rằng tài liệu đầu vào là SGML thay vì XML. Bạn cần cái này đặt cái này
tùy chọn nếu tài liệu xml thực sự là một tệp SGML.

Phân tích cú pháp SGML được thực hiện bằng cách chuyển đổi sang XML qua sgml2xml(1) từ SP
gói (hoặc osx(1) từ gói OpenSP). Tất cả các tên thẻ trong tệp SGML sẽ là
được chuẩn hóa thành chữ thường (tức là -xlow tùy chọn sgml2xml(1) được sử dụng). TÔI
các thuộc tính có sẵn cho biểu định kiểu (tức là tùy chọn -xid). Ngoài ra, bất kỳ
Các thực thể ISO SDATA được sử dụng trong tài liệu SGML được tự động chuyển đổi thành
XML Unicode tương đương. (Điều này được thực hiện bởi một khát lọc.)

Mã hóa của tài liệu SGML, nếu nó không phải là us-ascii, phải được chỉ định bằng
các biến môi trường SP tiêu chuẩn: SP_CHARSET_FIXED = 1 SP_ENCODING =mã hóa.
(Lưu ý rằng các tệp XML chỉ định mã hóa của chúng bằng khai báo XML <?xml
phiên bản = "1.0" encoding = "mã hóa " ?> ở đầu tệp.)

Các tùy chọn chuyển đổi trên không thể thay đổi. Nếu bạn muốn chuyển đổi khác nhau
tùy chọn, bạn nên gọi sgml2xml(1) theo cách thủ công, và sau đó chuyển kết quả của
chuyển đổi sang chương trình này.

QUAY LẠI LỰA CHỌN
- catalogs danh mục-tệp, -C danh mục-tệp
Chỉ định các danh mục XML bổ sung để sử dụng cho việc phân giải Mã số nhận dạng công cộng chính thức hoặc
URI. Danh mục SGML không được hỗ trợ.

Những danh mục này là không được sử dụng để phân tích cú pháp một tài liệu SGML trong --sgml tùy chọn.
Sử dụng biến môi trường SGML_CATALOG_FILES thay vào đó để chỉ định các danh mục cho
phân tích cú pháp tài liệu SGML.

--mạng, -N
db2x_xsltproc thông thường sẽ từ chối tải các tài nguyên bên ngoài từ mạng, vì
lý do an ninh. Nếu bạn muốn tải từ mạng, hãy đặt tùy chọn này.

Thông thường, bạn muốn cài đặt cục bộ các DTD liên quan và các tệp khác, và
thiết lập danh mục cho chúng, thay vì tải chúng tự động từ mạng.

KIỂU DÁNG LỰA CHỌN
- bảng tính hồ sơ, -s hồ sơ
Chỉ định tên tệp (hoặc URI) của biểu định kiểu để sử dụng. Các giá trị đặc biệt của con người và
texi được chấp nhận là từ viết tắt, để xác định rằng tài liệu xml có trong DocBook và
nên được chuyển đổi thành trang người đàn ông hoặc Texinfo (tương ứng).

--param tên=thể hiện, -p tên=thể hiện
Thêm hoặc sửa đổi một tham số vào biểu định kiểu. tên là tên thông số XSLT và
thể hiện là một biểu thức XPath đánh giá giá trị mong muốn cho tham số.
(Điều này có nghĩa là các chuỗi phải được trích dẫn, in Ngoài ra theo cách trích dẫn thông thường của shell
tranh luận; sử dụng --string-param để tránh điều này.)

--string-param tên=chuỗi, -g tên=chuỗi
Thêm hoặc sửa đổi tham số có giá trị chuỗi vào biểu định kiểu.

Chuỗi phải được mã hóa bằng UTF-8 (bất kể mã hóa ký tự ngôn ngữ).

NỢ VÀ SƠ LƯỢC
--gỡ lỗi, -d
Hiển thị, theo lỗi tiêu chuẩn, nhật ký về những gì đang xảy ra trong XSL
chuyển đổi.

- giới hạn n, -D n
Thay đổi số lượng lệnh gọi lồng nhau tối đa thành các mẫu XSL, được sử dụng để phát hiện
các vòng lặp vô hạn tiềm năng. Nếu không được chỉ định, giới hạn là 500 (mặc định của libxslt).

--Hồ sơ, -P
Hiển thị thông tin hồ sơ: tổng số cuộc gọi đến từng mẫu trong
biểu định kiểu và thời gian thực hiện cho mỗi. Thông tin này được xuất thành tiêu chuẩn
lỗi.

--xslt-bộ xử lý bộ vi xử lý, -X bộ vi xử lý
Chọn bộ xử lý XSLT cơ bản được sử dụng. Các lựa chọn khả thi cho bộ vi xử lý là:
libxslt, saxon, xalan-j.

Bộ xử lý mặc định là bất cứ thứ gì được đặt khi docbook2X được tạo. libxslt là
được khuyến nghị (vì nó mỏng và nhanh), nhưng SAXON mạnh mẽ hơn nhiều và sẽ
hữu ích hơn khi gỡ lỗi các bảng định kiểu.

Tất cả các bộ xử lý đều được kích hoạt hỗ trợ danh mục XML. (docbook2X yêu cầu nó.)
Nhưng lưu ý rằng không phải tất cả các tùy chọn ở trên đều hoạt động với các bộ xử lý khác ngoài libxslt
một.

MÔI TRƯỜNG

XML_CATALOG_FILES
Chỉ định Danh mục XML. Nếu không được chỉ định, danh mục tiêu chuẩn (/ etc / xml / catalog) là
đã tải, nếu có.

DB2X_XSLT_PROCESSOR
Chỉ định bộ xử lý XSLT để sử dụng. Hiệu ứng giống như --xslt-bộ xử lý
Lựa chọn. Công dụng chính của biến này là cho phép bạn nhanh chóng kiểm tra các
Bộ xử lý XSLT mà không cần phải thêm --xslt-bộ xử lý cho mọi tập lệnh hoặc tạo tệp
trong hệ thống xây dựng tài liệu của bạn.

CẤU TẠO ĐẾN

Ngôn ngữ biểu định kiểu XML - Chuyển đổi (XSLT), phiên bản 1.0 ⟨http://www.w3.org/TR/xslt⟩
, một Khuyến nghị của W3C.

GHI CHÚ

Trong các phiên bản trước đó (<0.8.4), docbook2X yêu cầu các phần mở rộng XSLT để chạy và
db2x_xsltproc là một bộ xử lý dựa trên libxslt đặc biệt có các phần mở rộng này được biên dịch sẵn.
Khi yêu cầu đối với tiện ích mở rộng XSLT bị loại bỏ, db2x_xsltproc đã trở thành một tập lệnh Perl
dịch các tùy chọn thành db2x_xsltproc để phù hợp với định dạng được chấp nhận bởi
cổ phần xsltproc(1) đi kèm với libxslt.

Lý do chính cho sự tồn tại của tập lệnh này là khả năng tương thích ngược với bất kỳ
tập lệnh hoặc tạo tệp gọi docbook2X. Tuy nhiên, nó cũng trở nên dễ dàng để thêm vào
hỗ trợ gọi các bộ xử lý XSLT khác với giao diện dòng lệnh thống nhất. Thực vậy,
không có gì đặc biệt trong tập lệnh này đối với docbook2X hoặc thậm chí đối với DocBook, và nó có thể
được sử dụng để chạy các loại bảng định kiểu khác nếu bạn muốn. Chắc chắn tác giả thích
bằng cách sử dụng lệnh này, vì định dạng lệnh gọi của nó là lành mạnh và dễ sử dụng. (ví dụ: không
gõ tên lớp dài cho bộ xử lý dựa trên Java!)

Sử dụng db2x_xsltproc trực tuyến bằng các dịch vụ onworks.net