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

CHƯƠNG TRÌNH:

TÊN

db2x_manxml - Tạo trang người đàn ông từ Man-XML

SYNOPSIS

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

MÔ TẢ

db2x_manxml chuyển đổi tài liệu Man-XML thành một hoặc nhiều trang nam. Chúng được viết bằng
thư mục hiện tại.

If tài liệu xml không được đưa ra, thì tài liệu cần chuyển đổi sẽ được đọc từ đầu vào chuẩn.

LỰA CHỌN

--encoding =mã hóa
Chọn kiểu mã hóa ký tự được sử dụng cho các tệp đầu ra. Các bảng mã có sẵn
là của iconv(1). Mã hóa mặc định là us-ascii.

Nguồn XML có thể chứa các ký tự không thể đại diện được trong bảng mã
mà bạn chọn; trong trường hợp này, chương trình sẽ phát nổ trong quá trình xử lý và bạn
nên chọn một bảng mã khác. (Điều này được đảm bảo không xảy ra với bất kỳ Unicode nào
mã hóa chẳng hạn như UTF-8, nhưng tiếc là không phải ai cũng có thể xử lý Unicode
văn bản.)

Nếu bạn đang sử dụng phiên bản GNU của iconv(1), bạn có thể gắn // TRANSLIT vào cuối
tên mã hóa để cố gắng chuyển ngữ của bất kỳ ký tự không thể chuyển đổi nào trong
đầu ra. Tuy nhiên, hãy lưu ý rằng những nhân vật thực sự không thể thay đổi sẽ là
biến thành một dấu chấm hỏi chết tiệt khác. (Bạn không phát ngán với điều này chứ?)

Hậu tố // TRANSLIT được áp dụng cho bảng mã Unicode - cụ thể là
utf-8 // TRANSLIT - nghĩa là các tệp đầu ra vẫn ở dạng Unicode, nhưng đánh dấu-
bản dịch ký tự cấp độ bằng cách sử dụng utf8trans vẫn đang được thực hiện. Vì vậy, trong hầu hết
case, một tài liệu tiếng Anh, được chuyển đổi bằng cách sử dụng --encoding = utf-8 // DỊCH
thực sự sẽ kết thúc dưới dạng tài liệu US-ASCII, nhưng mọi ký tự không thể dịch được sẽ
vẫn là UTF-8 mà không có bất kỳ cảnh báo nào. (Lưu ý: nói một cách chính xác thì đây là
không phải "chuyển ngữ".) Phương pháp chuyển đổi này là một sự thỏa hiệp so với
--encoding = us-ascii đang xử lý, sẽ hủy bỏ nếu có bất kỳ ký tự không thể dịch được nào
đã gặp.

Lưu ý rằng các trang nam và tài liệu Texinfo ở dạng mã hóa không phải ASCII (bao gồm UTF-8)
có thể không di động đến các hệ thống cũ hơn (không được quốc tế hóa), đó là lý do tại sao
giá trị mặc định cho tùy chọn này là us-ascii.

Để ngăn chặn bất kỳ ánh xạ ký tự tự động hoặc chuyển đổi mã hóa nào, hãy chuyển
tùy chọn --encoding = utf-8.

- danh sách-tệp
Viết danh sách tất cả các tệp đầu ra thành đầu ra tiêu chuẩn, ngoài thông thường
Chế biến.

--output-dir =dir
Chỉ định thư mục nơi các tệp đầu ra được đặt. Mặc định là
thư mục làm việc hiện tại.

Tùy chọn này bị bỏ qua nếu đầu ra được ghi vào đầu ra tiêu chuẩn (được kích hoạt
theo tùy chọn --đến thiết bị xuất chuẩn).

--đến thiết bị xuất chuẩn
Ghi đầu ra vào đầu ra tiêu chuẩn thay vì vào các tệp riêng lẻ.

Nếu tùy chọn này được sử dụng ngay cả khi có nhiều đầu ra
tài liệu, sau đó mọi thứ được nối với đầu ra tiêu chuẩn. Nhưng hãy cẩn thận rằng
hầu hết các chương trình khác sẽ không chấp nhận đầu ra nối này.

Tùy chọn này không tương thích với - danh sách-tệp, chắc chắn.

--Cứu giúp Hiển thị thông tin sử dụng ngắn gọn và thoát.

--phiên bản
Hiển thị phiên bản và thoát.

Một số trang nam có thể được tham chiếu dưới hai hoặc nhiều tên, thay vì chỉ một. Vì
thí dụ, strcpy(3) strncpy(3) thường trỏ đến cùng một trang người mô tả hai
chức năng với nhau. Chọn một trong các tùy chọn sau để chọn cách các trang người đàn ông như vậy
được tạo:

--liên kết tượng trưng
Đối với mỗi tên thay thế cho một trang nam, hãy dựng các liên kết tượng trưng đến
tệp có chứa nội dung trang người đàn ông thực sự.

--solinks
Tạo các trang sơ khai (sử dụng các yêu cầu .so roff) cho các tên thay thế, trỏ
họ vào nội dung trang người đàn ông thực sự.

- không có liên kết
Không cung cấp bất kỳ tên thay thế nào. Trang người đàn ông chỉ có thể được tham chiếu
dưới tên chính của nó.

Chương trình này sử dụng một số chương trình khác cho hoạt động của nó. Nếu họ không ở trong
các vị trí được cài đặt mặc định, sau đó sử dụng các tùy chọn sau để đặt vị trí của chúng:

--utf8trans-program =con đường, --utf8trans-map =Charmap
Sử dụng bản đồ nhân vật Charmap với utf8trans(1) chương trình, bao gồm
docbook2X, được tìm thấy dưới con đường.

--iconv-program =con đường
Vị trí của iconv(1) chương trình, được sử dụng để mã hóa chuyển đổi.

GHI CHÚ

Các trang người được tạo ra phải tương thích với hầu hết các triển khai troff và các
các công cụ xử lý trang người. Một số tương thích ngược sự lộn xộn(1) phần mở rộng được sử dụng để
làm cho đầu ra trông đẹp hơn.

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