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

CHƯƠNG TRÌNH:

TÊN

PolyglotMan, rman - biên dịch ngược các trang người đàn ông từ dạng đã định dạng sang một số nguồn
định dạng: ASCII, roff, TkMan, Tk, Sections, HTML, SGML, MIME, LaTeX, LaTeX2e, RTF, POD.

SYNOPSIS

rman [ lựa chọn ] [ hồ sơ ]

MÔ TẢ

Hướng dẫn cập nhật có thể được tìm thấy tại http://polyglotman.sourceforge.net/rman.html

Đa NgữNgười Đàn Ông lấy các trang người đàn ông từ hầu hết các hương vị phổ biến của UNIX và biến đổi chúng
sang bất kỳ định dạng nguồn văn bản nào. PolyglotMan trước đây được gọi là RosettaMan.
Tên của nhị phân vẫn được gọi là rman, đối với các tập lệnh phụ thuộc vào tên đó;
về mặt nhớ kỹ, chỉ cần nghĩ "người đàn ông ngược". Trước đây Đa NgữNgười Đàn Ông các trang bắt buộc phải
được định dạng bởi ăn trộm(1) trước khi xử lý. Với phiên bản 3.0, nó thích [tn] roff
nguồn và thường tạo ra kết quả tốt hơn. Và xử lý nguồn là cách duy nhất
cách dịch bảng. Tuy nhiên, bản dịch định dạng nguồn không hoàn thiện như bản dịch đã định dạng,
vì vậy hãy thử bản dịch được định dạng làm bản sao lưu.

Trong phân tích cú pháp mã nguồn [tn] roff, người ta có thể triển khai một tập hợp con lớn tùy ý của [tn] roff,
mà tôi đã không làm và sẽ không làm, vì vậy kết quả có thể bị tắt. Tôi đã thực hiện một
Tuy nhiên, tập hợp con của những người được sử dụng trong các trang nam, bao gồm tbl (nhưng không phải eqn), nếu các bài kiểm tra, và
định nghĩa vĩ mô chung, vì vậy thường kết quả trông rất tuyệt. Nếu không, hãy định dạng
trang với nroff trước khi gửi nó đến PolyglotMan. Nếu PolyglotMan không nhận ra khóa
macro được nhiều trang sử dụng, tuy nhiên, hãy gửi e-mail cho tôi nguồn và một mã nroff chưa được mã hóa-
trang được định dạng và tôi sẽ xem những gì tôi có thể làm. Khi chạy PolyglotMan với nguồn trang người đàn ông
bao gồm hoặc chuyển hướng đến nguồn roff [tn] khác bằng cách sử dụng .so (nguồn hoặc bao gồm)
macro, bạn phải ở trong thư mục mẹ của trang, vì các trang được viết bằng
Giả định này. Ví dụ: nếu bạn đang dịch /usr/share/man/man1/ls.1, cd đầu tiên
thành / usr / share / man.

Đa NgữNgười Đàn Ông chấp nhận các trang nam từ: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T
Hệ thống V, OSF / 1 hay còn gọi là Digital UNIX, DEC Ultrix, SGI IRIX, Linux, FreeBSD, SCO. Nguồn
hoạt động xử lý cho: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T System V, OSF / 1 aka
UNIX kỹ thuật số, DEC Ultrix. Nó có thể tạo ra chỉ ASCII có thể in được (các ký tự điều khiển
tước), chỉ tiêu đề phần, Tk, TkMan, [tn] roff (nguồn trang man truyền thống), XML,
HTML, MIME, LaTeX, LaTeX2e, RTF, Perl 5 POD. Kiến trúc mô-đun cho phép bổ sung dễ dàng
định dạng đầu ra bổ sung.

Phiên bản mới nhất của PolyglotMan có sẵn từ http://polyglotman.sourceforge.net/ .

LỰA CHỌN

Không nên sử dụng các tùy chọn sau với bất kỳ tùy chọn nào khác và thoát khỏi PolyglotMan mà không có
xử lý bất kỳ đầu vào nào.

-h | --help Hiển thị danh sách các tùy chọn dòng lệnh và thoát.

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

Bạn nên chỉ định các lọc Đầu tiên, as điều này bộ a con số of thông số, và sau đó chỉ định
Khác tùy chọn.

-f | - bộ lọc
Đặt bộ lọc đầu ra. Mặc định là ASCII.

-S | --source PolyglotMan cố gắng tự động xác định xem đầu vào của nó là nguồn hay
đã định dạng; sử dụng tùy chọn này để khai báo đầu vào nguồn.

-F | - định dạng | - định dạng
PolyglotMan cố gắng tự động xác định xem đầu vào của nó là nguồn hay
đã định dạng; sử dụng tùy chọn này để khai báo đầu vào được định dạng.

-l | --title chuỗi printf
Trong chế độ HTML, điều này đặt của các trang người đàn ông, được cung cấp cùng một
các thông số như -r .

-r | - tham khảo | --manref chuỗi printf
Trong các chế độ HTML và XML, điều này đặt biểu mẫu URL để truy xuất người đàn ông khác
các trang. Chuỗi có thể sử dụng hai tham số được cung cấp: tên trang người đàn ông và
phần của nó. (Xem phần Ví dụ.) Nếu chuỗi rỗng (như thể được đặt
từ một trình bao bằng "-r ''"), `- 'hoặc` tắt', thì tham chiếu trang người đàn ông sẽ không
là HREF, chỉ cần đặt in nghiêng. Nếu printf của bạn hỗ trợ các vị trí XPG3
thông số kỹ thuật, điều này có thể khá linh hoạt.

-V | --volumes <được phân cách bằng dấu hai chấm danh sách>
Đặt danh sách các tập hợp lệ để kiểm tra khi tìm kiếm chéo
tham chiếu đến các trang người đàn ông khác. Mặc định là 1:2:3:4:5:6:7:8:9:o:l:n:p
(tên tập có thể là nhiều ký tự). Nếu một chuỗi không có khoảng trắng trong
ngay sau đó là dấu ngoặc đơn bên trái, sau đó là một trong các trang hợp lệ
khối lượng và kết thúc bằng các ký tự khác tùy chọn và sau đó là dấu phải
dấu ngoặc đơn - sau đó chuỗi đó được báo cáo như một tham chiếu đến một sổ tay hướng dẫn khác
trang. Nếu chuỗi -V này bắt đầu bằng dấu bằng thì không có tùy chọn
các ký tự được phép giữa trận đấu với danh sách giá trị và
ngoặc phải. (Tùy chọn này là cần thiết cho SCO UNIX.)

Các tùy chọn sau chỉ áp dụng khi các trang được định dạng được cung cấp làm đầu vào. Họ không
áp dụng cho hoặc luôn được xử lý chính xác với nguồn.

-b | - phần phụ
Cố gắng nhận ra tiêu đề tiểu mục ngoài tiêu đề mục. Cái này có thể
gây ra sự cố trên một số hương vị UNIX.

-K | --nobreak Cho biết các trang thủ công không có ngắt trang, vì vậy không tìm kiếm chân trang và
tiêu đề xung quanh chúng. (Các macro nroff -man cũ hơn luôn đặt trong các ngắt trang,
nhưng gần đây một số nhà cung cấp đã nhận ra rằng các bản in được thực hiện thông qua
troff(1), trong khi nroff -man được sử dụng để định dạng các trang để đọc trên màn hình,
và do đó đã loại bỏ các ngắt trang.) Đa NgữNgười Đàn Ông thường làm đúng
ngay cả khi không có lá cờ này.

-k | --keep Giữ đầu trang và chân trang, như một báo cáo chuẩn ở cuối trang.
changeleft Di chuyển các thanh thay đổi, chẳng hạn như những thanh thay đổi được tìm thấy trong các trang hướng dẫn sử dụng Tcl / Tk,
Qua bên trái. -> không vi phạm Vô hiệu hoá phân tích cú pháp trang người đàn ông tích cực.
Hướng dẫn tích cực, được bật theo mặc định, phân tích cú pháp trang làm rõ các tiêu đề và
cuối trang, xác định các phần và hơn thế nữa. ->

-n | - tên tên Đặt tên của trang người đàn ông (được sử dụng ở định dạng roff). Nếu tên tệp được cung cấp trong
mẫu đơn " tên . phần ", tên và phần được xác định tự động.
Nếu trang đang được phân tích cú pháp từ nguồn [tn] roff và có dòng .TH,
thông tin này được trích xuất từ ​​dòng đó.

-p | --chuyển đổi chế độ đoạn văn bản. Bộ lọc xác định xem các dòng có phải là
bị đứt đoạn như cũ bởi nroff, hoặc liệu các dòng có nên được chạy hay không
với nhau thành đoạn văn. Chủ yếu để sử dụng nội bộ.

phần -s | # Đặt khối lượng (hay còn gọi là phần) số lượng trang người (được sử dụng ở định dạng roff). những cái bàn
Bật phân tích cú pháp bảng linh hoạt. ->

-t | --tabstops #
Đối với những bộ macro sử dụng tab thay cho khoảng trắng nếu có thể
để giảm số lượng ký tự được sử dụng, hãy đặt tabstops mỗi #
cột. Mặc định là 8.

GHI CHÚ ON LỌC LOẠI

ROFF
Một số hương vị của UNIX ship man page mà không cần nguồn roff [tn], tạo ra một máy in laser
hơn một chút so với một bánh xe chạy bằng tia la-de. Bộ lọc này cố gắng đưa vào bản gốc
[tn] roff chỉ thị, sau đó có thể được biên dịch lại bởi [tn] roff.

TkMan
TkMan(1), một trình duyệt trang người đàn ông siêu văn bản, sử dụng Đa NgữNgười Đàn Ông để hiển thị các trang người đàn ông mà không có
(thường) đầu trang và chân trang vô dụng trên mỗi trang. Nó cũng thu thập phần và
(tùy chọn) các đầu tiểu mục để truy cập trực tiếp từ menu kéo xuống. TkMan và Tcl / Tk,
bộ công cụ mà nó được viết, có sẵn qua ftp ẩn danh từ
ftp://ftp.smli.com/pub/tcl/

Tk
Tùy chọn này xuất văn bản trong một loạt danh sách Tcl bao gồm các cặp thẻ văn bản, trong đó
tên thẻ gần như tương ứng với HTML. Đầu ra này có thể được chèn vào tiện ích văn bản Tk
bằng cách làm một đánh giá chèn cuối . Định dạng này tương đối dễ dàng
có thể phân tích cú pháp bởi các chương trình khác muốn cả văn bản và thẻ. Xem thêm ASCII.

ASCII
Khi được in trên máy in dòng, các trang nam cố gắng tạo ra các hiệu ứng văn bản đặc biệt bằng cách
viết quá nhiều ký tự với chính họ (để tạo ra chữ in đậm) và dấu gạch dưới (gạch dưới).
Các phần mềm xử lý văn bản khác, chẳng hạn như trình soạn thảo văn bản, trình tìm kiếm và lập chỉ mục, phải
chống lại điều này. Bộ lọc ASCII loại bỏ định dạng này. Đường ống đầu ra nroff thông qua
col -b cũng loại bỏ định dạng này, nhưng nó để lại các tiêu đề trang khó coi và
cuối trang. Cũng xem Tk.

Mục
Kết xuất phần và (tùy chọn) tiêu đề tiểu mục. Điều này có thể hữu ích cho một chương trình khác
xử lý các trang nam.

HTML
Với một phần mở rộng đơn giản cho một máy chủ HTTP cho Mosaic(1) hoặc trình duyệt World Wide Web khác,
Đa NgữNgười Đàn Ông có thể tạo HTML chất lượng cao một cách nhanh chóng. Một số phần mở rộng như vậy và
con trỏ đến một số người khác được bao gồm trong Đa NgữNgười Đàn Ông 's đóng góp thư mục.

XML
Điều này đang gắn vào Docbook DTD, nhưng tôi hy vọng rằng ai đó thực sự quan tâm đến
điều này sẽ đánh bóng các thẻ được tạo. Hãy thử nó để xem mức độ đóng của các thẻ bây giờ.

Kịch câm
MIME (Tiện ích mở rộng thư Internet đa năng) như được định nghĩa bởi RFC 1563, tốt để tiêu dùng
bởi các thư điện tử nhận biết MIME hoặc như Emacs (> = 19.29) tài liệu đã được bổ sung.

Mủ cao su và LaTeX2e
Tại sao không?

RTF
Sử dụng đầu ra trên Mac hoặc NeXT hoặc bất cứ thứ gì. Có thể lấy các trang người đàn ông ngẫu nhiên và tích hợp chúng
tốt hơn với hệ thống tài liệu của NeXT. Có thể NeXT có các macro trang người đàn ông của riêng nó làm
cái này.

PostScript và Khung sản xuất
Để tạo PostScript, hãy sử dụng sự lộn xộn or psroff . Để tạo FrameMaker MIF, hãy sử dụng FrameMaker's
bộ lọc nội trang. Trong cả hai trường hợp, bạn cần [tn] roff nguồn, vì vậy nếu bạn chỉ có một
phiên bản của trang hướng dẫn sử dụng Đa NgữNgười Đàn Ông đầu tiên là bộ lọc roff.

VÍ DỤ

Để chuyển đổi được định dạng trang người đàn ông có tên ls.1 trở lại dạng nguồn roff [tn]:

rman -f sự đùa giỡn /usr/local/man/cat1/ls.1 > /usr/local/man/man1/ls.1

Các trang dài thường được nén để tiết kiệm không gian (nén đặc biệt hiệu quả
trên các trang người được định dạng vì nhiều ký tự là khoảng trắng). Vì nó là một trang dài, nó
có thể có các phần phụ, mà chúng tôi cố gắng tách ra (một số bộ macro không phân biệt
phần phụ đủ tốt cho Đa NgữNgười Đàn Ông để phát hiện chúng). Hãy chuyển đổi cái này thành LaTeX
định dạng:

máy tính cá nhân /usr/catman/a_man/cat1/automount.z | rman -b -n tự động -s 1 -f mủ cao su >
automount.man

Ngoài ra, người đàn ông 1 tự động | rman -b -n tự động -s 1 -f mủ cao su > automount.man

Đối với người dùng HTML / Mosaic, Đa NgữNgười Đàn Ông có thể, không cần sửa đổi mã nguồn, tạo ra
Các liên kết HTML trỏ đến các trang HTML khác hoặc được tạo trước hoặc được tạo nhanh.
Trước tiên, hãy giả sử các phiên bản HTML được tạo trước của các trang người được lưu trữ trong / usr / share / man / html .
Tạo từng cái một với biểu mẫu sau:
rman -f html -r 'http: /usr/share/man/html/%s.%s.html' /usr/share/man/cat1/ls.1 >
/usr/share/man/html/ls.1.html

Nếu bạn đã mở rộng ứng dụng HTML của mình để tạo HTML nhanh chóng, bạn nên sử dụng thứ gì đó
như:
rman -f html -r 'http:~ / bin / man2html?%NS' /usr/share/man/cat1/ls.1
khi tạo HTML.

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