linuxdoc - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

linuxdoc - LinuxDoc DTD SGML chuyển đổi sang định dạng đầu ra khác

SYNOPSIS

linuxdoc --backend =định dạng
--papersize =kích thước --language =lang --charset =xe tăng --style =hồ sơ --gỡ lỗi
--định nghĩa thuộc tính = giá trị --bao gồm thực thể [tùy chọn phụ trợ ...] tệp (.sgml)

hoặc (Cách sử dụng cũ, lỗi thời)
sgmlxxxx [tùy chọn chung ...] [tùy chọn phụ trợ ...] tệp (.sgml)

MÔ TẢ

Sản phẩm linuxdoc suite là một tập hợp các bộ định dạng văn bản hiểu một DTD LinuxDoc
Tệp nguồn SGML. Mỗi trình định dạng (hoặc "back-end") kết xuất tệp nguồn thành nhiều loại
các định dạng đầu ra, bao gồm HTML, TeX, DVI, PostScript, văn bản thuần túy và sự lộn xộn(1) nguồn trong
định dạng trang thủ công. Bộ linuxdoc được cung cấp để tương thích ngược, bởi vì
vẫn còn nhiều tài liệu hữu ích được viết bằng mã nguồn sgml LinuxDoc DTD.

(Các) ngôn ngữ đánh dấu được các bộ định dạng này chấp nhận được mô tả trong Linuxdoc-Công cụ
Của người dùng Hướng dẫn. Chúng là các biến thể của định nghĩa kiểu tài liệu SGML được thiết kế ban đầu
của Matt Welsh cho tài liệu Linux.

TÙY CHỌN THẾ HỆ

Hầu hết các tùy chọn dòng lệnh đều được tất cả các back-end chấp nhận. Một số mặt sau có thêm
các tùy chọn cụ thể để kiểm soát kết xuất đối với định dạng đầu ra cụ thể của chúng. Sau đây là
các tùy chọn chung:

--backend =định dạng, -NS
Đặt phần phụ trợ cho định dạng được chỉ định. Mặc định không phải là định dạng thực tế, nhưng
chỉ cần xuất việc sử dụng bộ này. Các định dạng có sẵn là: html, thông tin, cao su,
lyx, rtf, txt, kiểm tra.

--papersize =kích thước, -P
Đặt kích thước giấy. Mặc định là `` a4 '' (giấy 297x210mm của Châu Âu). Bạn cũng có thể
chỉ định kích thước `` chữ cái ''.

--language =lang, -l
Chỉ định ngôn ngữ của tài liệu (điều này có thể thay đổi tệp kiểu được sử dụng
để định dạng bởi một kết thúc phía sau). Ngôn ngữ mặc định là tiếng Anh. Chạy một LinuxDoc-
lệnh công cụ không có đối số để xem danh sách mã ngôn ngữ hợp lệ.

--charset =xe tăng, -NS
Chỉ định mã hóa ký tự đầu ra. Mặc định là `` ascii '' chọn ASCII
bộ; bạn có thể chỉ định "latin" để chỉ định bộ ký tự ISO 8859-1 (Latinh-1).
Ngoài ra, cần có `` nippon '' và `` euc-kr '' để xử lý mã hóa euc-jp và euc-kr
tệp sgml.

--style =hồ sơ, -NS
Bao gồm một DTD phụ trợ (Định nghĩa loại tài liệu) từ / usr / share / linuxdoc-
công cụ / dtd.

--tabsize =n, -NS
Đặt khoảng cách tab giả định để tạo tài liệu đầu ra. Tab mặc định
khoảng cách là 8.

--gỡ lỗi, -d
Không xóa các tệp trung gian (chẳng hạn như tệp .TeX được tạo trên đường tới .dvi,
hoặc các tệp .man bị xóa trên đường chuyển sang văn bản thuần túy).

- xác định, -D
Chuyển các cặp thuộc tính / giá trị được so khớp với các điều kiện "nếu" và "trừ khi".
Xem Hướng dẫn sử dụng để thảo luận mở rộng về tính năng này. Cái này
điều kiện hóa được xử lý bởi lệnh sgmlpre. Nhìn thấy sgmlpre(1) cũng như
Hướng dẫn sử dụng.

--bao gồm, -i
Chuyển tùy chọn a -i đến nsgml(1). Điều này có thể được sử dụng để bao gồm có điều kiện. Nhìn thấy
các nsgml(1) trang hướng dẫn sử dụng để biết thêm chi tiết.

--vượt qua, -P
Chuyển một chuỗi tùy chọn đến phần cuối phía sau. Ngữ nghĩa chính xác của tùy chọn này là
phụ thuộc vào phần cuối và nên được giải thích trong các trang hướng dẫn riêng lẻ
cho mỗi.

tệp Tệp nguồn SGML, được đặt tên là hồ sơ or tập tin.sgml.

Chạy một back-end không có đối số sẽ khiến nó liệt kê tất cả các tùy chọn của nó (Thông báo lỗi
về "không có tên tệp nào được cung cấp" có thể được bỏ qua một cách an toàn trong trường hợp này). Các kết thúc có sẵn trở lại
bao gồm (các tên trong ngoặc là dạng cũ và bị mờ):

linuxdoc -B html (sgml2html)
dịch sang HTML

Thông tin linuxdoc -B (sgml2info)
dịch sang thông tin GNU

linuxdoc -B lyx (sgml2lyx)
dịch sang macro Lyx

linuxdoc -B mủ cao su (sgml2latex)
dịch sang LaTeX 2e

linuxdoc -B rtf (sgml2rtf)
dịch sang Định dạng Văn bản Đa dạng thức của Microsoft

linuxdoc -B txt (sgml2txt)
dịch sang văn bản thuần túy hoặc đánh dấu trang thủ công Unix

Ngoài ra còn có một công cụ linuxdoc-Bkiểm tra
(sgmlcheck) có sẵn để kiểm tra cú pháp Linuxdoc DTD SGML của các nguồn tài liệu
mà không thực sự tạo ra một phiên bản đã dịch.

NGƯỜI LÁI XE LẠI

Dưới đây là mô tả cho từng trình điều khiển phụ trợ:

************************************************** **

linuxdoc -B html (sgml2html) chuyển đổi tệp nguồn LinuxDoc DTD SGML thành đầu ra HTML.
Đầu ra sẽ xuất hiện trong tệp cấp cao nhất tệp.html và tệp-n.html cho mỗi phần
(hành động mặc định, nhưng có thể được thay đổi theo tùy chọn), nơi hồ sơ là tên của nguồn SGML
tập tin và n là tên phần.

Cặp thuộc tính / giá trị "output = html" được đặt cho các điều kiện.

linuxdoc -B html chấp nhận các tùy chọn sau: [--tách ra 0 | 1 | 2 ] [--dosnames]
[--nút hình ảnh] [--toc 0 | 1 | 2 ]

Ý nghĩa của chúng là:

--chia, -s
Mức độ nào để chia tài liệu nguồn. 0 = không chia, 1 = chia theo chuyên ngành
phần, 2 = chia theo phần phụ.

--toc, -T
Mức độ nào để tạo toc.
0 = hoàn toàn không tạo ra toc,
1 = bao gồm các phần chính (/ chương / phần),
2 = bao gồm các phần phụ.

- tên, -h
Sử dụng ".htm" thay vì ".html" làm phần mở rộng của

--magebuttons, -tôi
Sử dụng các biểu tượng hình ảnh mũi tên "tiếp theo", "trước đó" và "nội dung" có trong
/ usr / share / linuxdoc-tools làm nút điều hướng.

--chân trang, -F
Sử dụng tệp được chỉ định làm chân trang trong mỗi tệp html kết quả. Chân trang mặc định là
chỉ đơn giản

\n \n

--tiêu đề, -H
Sử dụng tệp được chỉ định làm phần trên cùng của tiêu đề trong mỗi tệp html kết quả.
Lưu ý rằng đây không phải là phần đầy đủ của tiêu đề. (tức là tiêu đề và các liên kết
(tiếp theo, trước đó, nội dung) trong tiêu đề mặc định được giữ lại. Mặc định là

\n
\n \n

************************************************** **

linuxdoc -B Thông tin (sgml2info) chuyển đổi tệp nguồn LinuxDoc DTD SGML sang định dạng thông tin GNU.
Đầu ra sẽ xuất hiện trong nộp thông tin Ở đâu hồ sơ là tên của tệp nguồn SGML.

Cặp thuộc tính / giá trị "output = info" được đặt cho các điều kiện.

linuxdoc -B Thông tin không có tùy chọn cụ thể phụ trợ.

************************************************** **

linuxdoc -B mủ cao su (sgml2latex) chuyển đổi tệp nguồn LinuxDoc DTD SGML thành đầu ra LaTeX,
bằng cách sử dụng nsgml(1) hoặc sự khởi đầu(1) phân tích cú pháp và sgmlssp(1) người phiên dịch. Sử dụng LaTeX
đầu ra, và mủ cao su(1) định dạng văn bản, sau đó bạn có thể tạo đầu ra DVI và PostScript
đầu ra bằng cách sử dụng dvip(1) bộ chuyển đổi. Đầu ra sẽ xuất hiện trong tập tin.tex cho đầu ra LaTeX,
tập tin.dvi cho đầu ra DVI, hoặc tập tin.ps cho đầu ra PostScript, trong đó hồ sơ là tên của
Tệp nguồn SGML.

Sử dụng đầu ra LaTeX và pdflatex(1) định dạng văn bản, sau đó bạn có thể tạo
Đầu ra PDF, thích hợp để xem với người xem PDF dưới dạng xpdf(1) acroread(1) hoặc chế độ xem ma(1).

Cặp thuộc tính / giá trị "output = latex2e" được đặt cho các điều kiện.

linuxdoc -B mủ cao su chấp nhận các tùy chọn phụ trợ cụ thể sau: [--output =tex|dvi|ps|pdf]
[--bibtex] [--makeindex] [--pagenumber =n] --nhanh chóng [--latex =mủ cao su|hlatex|tấmx|jlatex]
[--dvips =dvip|dvi2ps]

Ý nghĩa của chúng là:

--output =fmt, -o
Chỉ định định dạng đầu ra mong muốn. Người chỉ định fmt có thể là `` tex '', `` dvi '',
`` ps '' hoặc `` pdf ''.

Lưu ý: Phiên bản này không ghi đè / xóa các tệp trung gian: tệp tex cho dvi
đầu ra hoặc tệp tex / dvi cho đầu ra ps. Đây là hành vi khác với hành vi ban đầu
SGML-Tools 1.0.9, vì vậy bạn được cảnh báo ở đây.

--bibtex, -b
Xử lý TeX được tạo bằng cái yếm(1).

--makeindex, -m
Tạo tệp chỉ mục TeX phù hợp để xử lý với lập chỉ mục(1) từ và
và các thẻ hiện diện trong nguồn SGML.

--số trang, -n
Đặt số trang bắt đầu trong tệp DVI hoặc PS đầu ra.

--nhanh, -q
Chỉ thực hiện một lần định dạng LaTeX. Điều này thường không đủ để sản xuất
đầu ra cuối cùng (vì tài liệu tham khảo, v.v.) nhưng hữu ích để phát hiện lỗi TeX
và các vấn đề biện minh.

--vượt qua, -P
Đối số của tùy chọn vượt qua được chèn ngay sau khi phần mở đầu LaTeX được tạo
bởi thẻ loại tài liệu. Chỉ định định dạng đầu ra mong muốn. Người chỉ định fmt
có thể là `` tex '', `` dvi '', `` ps '' hoặc `` pdf ''.

--latex =Alternate_latex_command, -NS
Tùy chọn này hiện dành cho tiếng Hàn và tiếng Nhật. Các Alternate_latex_command có thể
là `` latex '' (mặc định), `` hlatexp '' (đối với tiếng Hàn), `` platex '' hoặc `` jlatex '' (đối với
Tiếng Nhật). Tùy chọn này có thể được sử dụng để hiển thị tài liệu tiếng Hàn bằng HLaTeXp hoặc
kết xuất tài liệu tiếng Nhật bằng pLaTeX / jLaTeX. Nếu không, HLaTeX nên được cài đặt
để hiển thị tài liệu tiếng Hàn. Mặt khác, tài liệu tiếng Nhật có thể được kết xuất
với jLaTeX
(là mặc định khi chỉ định `` -c nippon ''), vì vậy nếu bạn đã có
jLaTeX, bạn có thể không cần cài đặt pLaTeX.

--dvips =Alternate_dvips_command, -NS
Tùy chọn này hiện dành cho tiếng Nhật. Các Alternate_dvips_command có thể
`` dvips '' hoặc `` dvi2ps ''. Nếu bạn không biết điều này, thì bạn có thể không cần điều này.

************************************************** **

linuxdoc -B sang trọng (sgml2lyx) chuyển đổi tệp nguồn LinuxDoc DTD SGML thành đầu ra LyX.
Đầu ra sẽ xuất hiện trong tập tin.lyx Ở đâu hồ sơ là tên của tệp nguồn SGML.

Cặp thuộc tính / giá trị "output = lyx" được đặt cho các điều kiện.

linuxdoc -B sang trọng không có tùy chọn cụ thể phụ trợ.

************************************************** **

linuxdoc -B rtf (sgml2rtf) chuyển đổi tệp nguồn LinuxDoc DTD SGML thành RTF, Văn bản Đa dạng thức
Định dạng được sử dụng bởi hệ thống trợ giúp Microsoft Windows. Đầu ra sẽ xuất hiện trong tệp cấp cao nhất
tập tin.rtf và tập tin-n.rtf cho mỗi phần, ở đâu hồ sơ là tên của tệp nguồn SGML.
Đầu ra RTF được điều chỉnh để biên dịch bởi Windows Help Compiler (hc31.exe).

Cặp thuộc tính / giá trị "output = rtf" được đặt cho các điều kiện.

linuxdoc -B rtf chấp nhận [--hai chia] như một tùy chọn cụ thể về phụ trợ. Sau đây là
ý nghĩa của tùy chọn này:

--haisplit, -2
Tách cả hai tệp tại n. phần và phần phụ nm

************************************************** **

linuxdoc -B txt (sgml2txt) chuyển đổi tệp nguồn LinuxDoc DTD SGML thành ASCII, ISO-8859-1,
hoặc đầu ra EUC-JP. Đầu ra sẽ xuất hiện trong tập tin.txt Ở đâu hồ sơ là tên của nguồn SGML
tập tin.

Cặp thuộc tính / giá trị "output = txt" được đặt cho các điều kiện.

linuxdoc -B txt chấp nhận các tùy chọn phụ trợ sau: [--manpage] [--lọc] [--blanks =n]

Ý nghĩa của các tùy chọn này là:

--trang chủ, -m
Xuất ra một tệp nguồn phức tạp, thích hợp để định dạng với sự lộn xộn -Đàn ông cho trang nam

- bộ lọc, -f
Xóa backspace-overstrikes khỏi biểu mẫu trung gian được tạo bởi sự lộn xộn(1).

--vượt qua, -P
Đối số của tùy chọn vượt qua được thêm vào các tùy chọn dòng lệnh được chuyển đến
sự lộn xộn(1).

--blanks =n, -NS
Đặt giới hạn các dòng trống liên tục để tạo tài liệu đầu ra. Các
giới hạn mặc định là 3. nếu 0 (không) được chỉ định, kết quả có nhiều ô trống liên tục
Đường dây.

************************************************** **

linuxdoc -B kiểm tra (sgmlcheck) chạy phân tích cú pháp SGML trên nguồn tài liệu được chỉ định. Không tí nào
lỗi được báo cáo với đầu ra tiêu chuẩn. Không có phiên bản định dạng nào của nguồn được tạo ra.

Lưu ý rằng linuxdoc -B kiểm tra tiền xử lý nguồn LinuxDoc DTD SGML, thực hiện
điều kiện hóa được mô tả bởi bất kỳ <#if> nào và <#unless> các thẻ. Tài liệu
các nguồn chứa các thẻ này sẽ gây nhầm lẫn với trình phân tích cú pháp SGML độc lập. linuxdoc -B kiểm tra
không có tùy chọn phụ trợ cụ thể.
************************************************** **

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