docbook-2-mif - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

sgml2x - Dễ dàng định dạng các tài liệu SGML / XML bằng cách sử dụng các biểu định kiểu DSSSL

SYNOPSIS

sgml2x [lựa chọn] [tập tin sgml | tập tin xml ]

lớp học tài liệu-2định dạng mục tiêu [lựa chọn] [tập tin sgml | tập tin xml ]

Mô tả

sgml2x cho phép dễ dàng định dạng tài liệu SGML hoặc XML bằng cách sử dụng các biểu định kiểu DSSSL, và
cung cấp các tính năng sau:

· Nhiều bảng định kiểu có thể có cho mỗi lớp tài liệu

· Đặc tả dễ dàng các style-sheet sử dụng bí danh, có hỗ trợ tham số
thừa kế

· Tích hợp dễ dàng các bảng định kiểu mới bằng cách thêm một tệp định nghĩa mới đơn giản trong một
thư mục cấu hình

· Người gọi có thể chỉ định danh sách thư mục cấu hình giống PATH, mặc định là
thư mục cấu hình trên toàn hệ thống, mỗi người dùng và mỗi dự án

· Tự động chọn một style-sheet mặc định sẽ được sử dụng, dựa trên chỉ định
ưu tiên

· Chuyển các tùy chọn tùy ý đến ngọc bích(1)

Lớp tài liệu được sử dụng để tìm kiếm các biểu định kiểu và định dạng đầu ra, bây giờ là
chỉ bắt nguồn từ tên mà chương trình được gọi, vì vậy bạn sẽ muốn gọi nó là
chương trình thông qua các liên kết tượng trưng như doc-2-pdf.

sgml2x được triển khai như một trình bao bọc xung quanh ngọc bích(1) (hoặc, tốt hơn, ngọc mở(1),
mặc dù chúng tôi sử dụng tên chung ngọc bích trong suốt tài liệu này), ngọc bích(1) và khác
công cụ hơn nữa.

Nếu không có Jadetex.cfg tệp gần tài liệu, tệp mặc định được sao chép, cho phép
sản xuất bookmark PDF.

Các lựa chọn

-c|--mục lục Danh mục hàng
Sử dụng danh mục SGML được chỉ định thay vì mặc định của hệ thống.

-C|--confdirs danh sách dir
Sử dụng danh sách thư mục cấu hình (được phân tách bằng khoảng trắng). Tùy chọn này là
tích lũy, tức là bạn có thể sử dụng một số -C các tùy chọn và danh sách sẽ
nối.

Các phần tử danh sách nên được sắp xếp theo thứ tự từ cấu hình chung nhất (ví dụ: toàn hệ thống)
cụ thể nhất (ví dụ: toàn dự án).

Nếu bất kỳ thư mục nào được cung cấp thông qua tùy chọn này, danh sách thư mục mặc định sẽ là
mặc kệ.

-D|--dssslproc bộ xử lý dsssl
Sử dụng bộ xử lý dsssl để áp dụng style-sheet, thay vì style-sheet mặc định. Cái này
bộ xử lý phải hỗ trợ ngọc bích-như tùy chọn, chẳng hạn như -V.

Khi không có tùy chọn này, tùy chọn đầu tiên được tìm thấy trong dssslproc các tập tin từ confdirs là
Lấy. Nhìn thấy "Các tập tin" để biết thêm chi tiết.

-h|--Cứu giúp Hiển thị thông báo trợ giúp và thoát.

-j|--ngọc bộ xử lý dsssl
Từ đồng nghĩa lỗi thời với --dssslproc.

--jadetexfilter bộ lọc perl
Xử lý hậu kỳ đầu ra jadetex bằng bộ lọc perl.

Điều này có thể hữu ích để buộc ngắt trang ở một số vị trí cụ thể để vượt qua biểu định kiểu
các vấn đề hoặc buộc phải có dấu gạch nối trong đó TeX không có đủ các mẫu hoặc làm bất kỳ
chuyển đổi thông minh khác mà bạn nghĩ đến.

Xem ví dụ / dòng lệnh tập tin cho các mục đích sử dụng có thể.

-n|- không hành động
In các lệnh thay vì chạy chúng. Hữu ích để tìm hiểu về cấp thấp hơn
và để gỡ lỗi dòng lệnh.

-o|--openjade
T tùy chọn is lỗi thời. ngọc mở bây giờ là mặc định khi có sẵn. Sử dụng
--dssslproc hoặc một dssslproc tệp cấu hình để buộc một bộ xử lý cụ thể.

Tùy chọn này được sử dụng để sử dụng ngọc mở(1) như một bộ xử lý DSSSL thay vì ngọc bích(1).

-O|--ngọc lựa chọn ngọc bích
Các tùy chọn bổ sung để chuyển đến ngọc bích(1). Tùy chọn này là tích lũy, bạn có thể
chỉ định một số trong số chúng, các tùy chọn được cung cấp sẽ được nối với nhau.

-q|--Yên lặng
Đặt độ dài thành yên tĩnh

-r|- dấu
Hiển thị nội dung của nhận xét tài liệu trong tài liệu (nhận xét các yếu tố trong
Tài liệu 4, bình luận phần tử trong DocBook 3), làm cho đầu ra được tạo ra
chỉ sử dụng nội bộ tài liệu, in cảnh báo đậm trên bìa.

Đây là một tính năng dành riêng cho docclass- và style-sheet-cụ thể và không phải tất cả các style-sheet đều sẽ sử dụng
cái này.

-s|--Phong cách phong cách
Chọn một kiểu đầu ra để ghi đè mặc định (cuối cùng có nguồn gốc từ tài liệu).

Các kiểu hiện có sẵn cho một lớp tài liệu cụ thể và cho mỗi định dạng đầu ra là
phụ thuộc vào nội dung của các thư mục cấu hình và có thể được hiển thị với
--Cứu giúp tùy chọn.

Lưu ý rằng bạn nên chỉ định tùy chọn này trong quy trình xây dựng, để bạn có được
kết quả có thể tái tạo bất kể các bảng định kiểu có sẵn.

-v|--dài dòng
Tăng độ dài. Tùy chọn này có thể được chỉ định nhiều lần.

--sự dài dòng N
Đặt độ dài thành N. Mức độ chi tiết được xác định như sau:

yên tĩnh Chỉ lỗi in

mặc định Chỉ lỗi in và cảnh báo

dài dòng Cũng in thông báo

theo dõi Đồng thời in các lệnh quan trọng khi chúng đang chạy (như - không hành động làm).

gỡ lỗi Cũng in thông báo gỡ lỗi

-V|--phiên bản
In phiên bản chương trình và thoát.

Cấu hình

sgml2x sử dụng cây thư mục cấu hình thay vì tệp cấu hình, để nó
dễ dàng để các gói khác cắm vào với nguy cơ phá vỡ thiết lập hiện có thấp.

Hệ thống phân cấp kiểu nằm trong các thư mục có tên phong cách trong mỗi cấu hình
danh mục. Các phiên bản cũ của chương trình này được sử dụng để đặt các cấu trúc phân cấp đó trực tiếp vào
thư mục cấu hình.

Thư mục cấu hình chứa một thư mục cho mỗi lớp tài liệu đã biết, được đặt tên bằng
biệt hiệu lớp tài liệu (ví dụ: sách giáo khoa). Các thư mục docclass đó chứa một con
thư mục cho mỗi lớp định dạng đầu ra (hiện tại, chỉ html và in được hỗ trợ).

Hiện tại, các vấn đề triển khai thực thi một giới hạn về biệt hiệu cho các lớp tài liệu
và style-sheet: chúng chỉ có thể chứa các ký tự chữ và số và gạch dưới. Cái này
giới hạn có thể bị loại bỏ trong một bản phát hành trong tương lai, nhưng điều đó sẽ không xảy ra trước điều này
script được viết lại bằng một ngôn ngữ khác.

Mỗi thư mục chứa một tệp cho mỗi kiểu có sẵn. Tên của những tệp này
chỉ có thể chứa các ký tự chữ và số và được sử dụng làm biệt hiệu cho các kiểu. Cái này
tệp chứa các dòng có Chìa khóa: giá trị mẫu, với các khóa sau hiện đang là
được hỗ trợ:

Id Giá trị nhận dạng công khai cho biểu định kiểu

Quyết định Mô tả ngắn gọn về các kiểu sẽ được hiển thị trong thông báo trợ giúp

ghi đè pdf, psGhi đè,
ghi đè rtf, mifGhi đè"10 Biểu tượng dsssl từ biểu định kiểu in sẽ được đặt
đến #t (hoặc một biểu tượng=giá trị ghép nối, thích hợp làm đối số ngọc bích's -V Lựa chọn),
được sử dụng cho định dạng in nhất định.

Chỉ cho phép một biểu tượng trên mỗi dòng ghi đè. Để xác định giá trị cho một số ký hiệu, hãy sử dụng
vài dòng.

Kế thừa Biệt hiệu của bảng định kiểu mà bảng này kế thừa, để tránh trường hợp không cần thiết
sự trùng lặp của các định nghĩa về phong cách.

Hiện tại, điều này chỉ gây ra sự kế thừa của *Ghi đè thông số.

Ưu tiên Một số nguyên dương để giúp chọn kiểu mặc định khi không thể
dẫn xuất từ ​​tài liệu. Giá trị càng cao thì cơ hội được coi là
vỡ nợ. Chú ý đến việc sử dụng mức độ ưu tiên thấp cho các kiểu siêu chuyên biệt để
loại tài liệu chung, để nó không bị lỗi khi sử dụng.

Ví dụ: chính sách được đề xuất hiện tại cho các trang tính kiểu DocBook bắt nguồn từ
Norman Walsh's như sau (và có thể thay đổi nếu kinh nghiệm chứng minh nó là không đủ).

10 Các bảng định kiểu cơ sở, thường phải được tùy chỉnh.

0 Bất kỳ biểu định kiểu nào được viết cho mục đích siêu chuyên dụng (ví dụ:
tờ sản phẩm tiếp thị).

1000 Một kiểu mặc định cho tất cả các tài liệu do một tổ chức tạo ra. Thường là một
tùy chỉnh ánh sáng, làm nổi bật các tùy chọn bố cục, của tổ chức
logo, hoặc những thứ như vậy.

10-100 Các tùy chỉnh chung chung khác của bảng định kiểu cơ sở.

Khi bạn viết phiên bản cải tiến của bảng định kiểu với mức độ ưu tiên n, Bạn
thường muốn chọn mức độ ưu tiên cao hơn.

Các tập tin

/ etc / sgml / sgml2x /

~ / .sgml2x /

./sgml2x/ Các thư mục cấu hình mặc định, trong đó các tệp cấu hình
tìm kiếm. Xem tài liệu cho --confdirs để biết thêm chi tiết.

tâm sự/Phong cách/
Hệ thống phân cấp xác định các kiểu có thể sử dụng. Nhìn thấy "Cấu hình" để biết thêm
chi tiết.

tâm sự/ dssslproc
Tệp chứa danh sách có thứ tự các bộ xử lý dsssl cần tìm, được phân tách bằng
dòng mới và / hoặc khoảng trắng. Các dòng bắt đầu bằng # nhân vật được coi là
bình luận. Các giá trị chung bao gồm ngọc mở và ngọc bích.

Bộ xử lý DSSSL được chỉ định ở đây phải chấp nhận -V và -D ngọc tương thích
các tùy chọn dòng lệnh.

Các thư mục cấu hình được tìm kiếm để bắt đầu bằng các thư mục cụ thể nhất
một, do đó, với cấu hình mặc định, cài đặt dự án có thể ghi đè người dùng
cài đặt này có thể ghi đè cài đặt hệ thống.

Giá trị đặc biệt sai có thể được sử dụng để dừng tìm kiếm và ngăn chặn việc tìm kiếm
nhiều thư mục chung. Ví dụ, nếu một dự án phải sử dụng
openjade-1.4devel và không có lệnh nào khác, nó có thể chỉ định openjade-1.4devel sai
trong nó dssslproc tập tin.

Hãy cẩn thận

Khi đang sử dụng openjade-1.4devel với tư cách là bộ xử lý DSSSL, bạn sẽ thấy khiếu nại về đầu-
luồng cấp-đối tượng được tạo bởi doctype.dslvà xác định tự động tài liệu-
loại sẽ bị lỗi. Lỗi này là vô hại. Ý tưởng về cách giải quyết vấn đề này, hoặc
xác nhận rằng openjade-1.4devel là quá nghiêm ngặt, sẽ được đánh giá cao :)

Sản phẩm tương lai

Các tính năng được lên kế hoạch cho các bản phát hành trong tương lai bao gồm:

· Tích hợp trình tạo chỉ mục

· Tích hợp một công cụ in ấn đẹp cho các ví dụ về mã

· Đặc điểm kỹ thuật của các phép biến đổi được xâu chuỗi

· Khai báo tập hợp con docclass để cho phép sử dụng với bất kỳ docclass nào có kiểu dáng-
trang tính áp dụng cho kính cường lực siêu cấp của nó.

· Làm việc ở một vị trí tạm thời để không làm ô nhiễm thư mục làm việc với
tập tin tạm thời. Điều này không dễ dàng như bạn nghĩ, vì nó làm hỏng tài liệu
đề cập đến các tệp hình ảnh sử dụng đường dẫn tương đối. Đó có thể được coi là một con bọ ngọc bích,
Tuy nhiên.

Duyệt qua danh sách CẦN LÀM đầy đủ và gửi thêm ý tưởng cho chúng tôi!

Bản quyền

Bản quyền © 2001-2003 Alcove & Yann Dirson.

sgml2x được cấp phép theo Giấy phép Công cộng GNU, phiên bản 2.

Tài liệu này được cấp phép theo Giấy phép Tài liệu Miễn phí GNU, phiên bản 1.

Liên hệ us

sgml2x Là một phần của AlcoveCuốn Sách dự án (liên kết đến URL http://www.alcove-
labs.org/en/software/alcovebook/) . Vui lòng sử dụng AlcoveCuốn Sách gửi thư danh sách (liên kết đến URL
https://savannah.gnu.org/mail/?group_id=533) để liên lạc với các nhà phát triển và người dùng.

Danh sách các lỗi và yêu cầu tính năng có sẵn thông qua a web giao diện (liên kết đến URL
https://savannah.gnu.org/support/?group_id=533) . Vui lòng sử dụng nó để gửi các vấn đề và
ý tưởng.

Xem Ngoài ra

ngọc mở(1), ngọc bích(1), ngọc bích(1), đối chiếuindex.pl(1).

sgml2x(1)

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