rman — online w chmurze

PROGRAM:

IMIĘ

PolyglotMan, rman - odwrotna kompilacja stron podręcznika ze sformatowanej postaci do wielu źródeł
formaty: ASCII, roff, TkMan, Tk, sekcje, HTML, SGML, MIME, LaTeX, LaTeX2e, RTF, POD.

STRESZCZENIE

człowiek [ Opcje ] [ filet ]

OPIS

Aktualne instrukcje można znaleźć pod adresem http://polyglotman.sourceforge.net/rman.html

PoliglotaMężczyzna pobiera strony podręcznika z większości popularnych odmian systemu UNIX i przekształca je
do dowolnego z wielu formatów źródła tekstu. PolyglotMan był wcześniej znany jako RosettaMan.
Nazwa pliku binarnego jest nadal wywoływana rman, dla skryptów zależnych od tej nazwy;
mnemonicznie, po prostu pomyśl „odwróć człowieka”. Poprzednio PoliglotaMężczyzna wymagane strony
sformatowane przez nroff(1) przed jego przetwarzaniem. W wersji 3.0 to woli [tn]roff
źródło i zwykle daje wyniki, które są jeszcze lepsze. A przetwarzanie źródłowe jest jedyne
sposób tłumaczenia tabel. Tłumaczenie formatu źródłowego nie jest jednak tak dojrzałe jak sformatowane,
więc spróbuj sformatowanego tłumaczenia jako kopii zapasowej.

Analizując źródło [tn]roff, można zaimplementować dowolnie duży podzbiór [tn]roff,
czego nie zrobiłem i nie zrobię, więc wyniki mogą być złe. Zaimplementowałem znaczące
podzbiór tych używanych na stronach podręcznika, w tym tbl (ale nie eqn), testy if i
ogólne definicje makr, więc zwykle wyniki wyglądają świetnie. Jeśli nie, sformatuj plik
page z nroff przed wysłaniem go do PolyglotMan. Jeśli PolyglotMan nie rozpoznaje klucza
makro używane przez dużą klasę stron, jednak wyślij mi e-mailem źródło i uuencoded nroff-
sformatowaną stronę i zobaczę, co da się zrobić. Podczas uruchamiania PolyglotMan ze źródłem strony podręcznika
który zawiera lub przekierowuje do innego źródła [tn]roff przy użyciu .so (źródło lub włączenie)
makro, powinieneś znajdować się w katalogu nadrzędnym strony, ponieważ strony są zapisywane za pomocą
to założenie. Na przykład, jeśli tłumaczysz /usr/share/man/man1/ls.1, najpierw
do /usr/share/man.

PoliglotaMężczyzna akceptuje strony man z: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T
System V, OSF/1 aka Digital UNIX, DEC Ultrix, SGI IRIX, Linux, FreeBSD, SCO. Źródło
przetwarzanie działa dla: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T System V, OSF/1 aka
Cyfrowy UNIX, DEC Ultrix. Może generować drukowane tylko znaki ASCII (znaki kontrolne
pozbawiony), tylko nagłówki sekcji, Tk, TkMan, [tn]roff (tradycyjne źródło strony podręcznika), XML,
HTML, MIME, LaTeX, LaTeX2e, RTF, Perl 5 POD. Modułowa architektura umożliwia łatwe dodawanie
dodatkowych formatów wyjściowych.

Najnowsza wersja PolyglotMan jest dostępna pod adresem http://polyglotman.sourceforge.net/ .

OPCJE

Następujących opcji nie należy używać z żadnymi innymi i wyjść z PolyglotMan bez
przetwarzanie dowolnych danych wejściowych.

-h|--help Pokaż listę opcji wiersza poleceń i wyjdź.

-v|--version Pokaż numer wersji i wyjdź.

You powinien sprecyzować dotychczasowy filtrować pierwszy, as to zestawy a numer of parametry, oraz następnie sprecyzować
Inne opcje.

-f|--filtr
Ustaw filtr wyjściowy. Domyślnie ASCII.

-S|--source PolyglotMan próbuje automatycznie określić, czy jego wejście jest źródłem, czy też
sformatowany; użyj tej opcji, aby zadeklarować wejście źródłowe.

-F|--formatowanie|--formatowanie
PolyglotMan próbuje automatycznie określić, czy dane wejściowe są źródłowe, czy też
sformatowany; użyj tej opcji, aby zadeklarować sformatowane wejście.

-l|--tytuł printf-string
W trybie HTML ustawia to stron podręcznika, biorąc pod uwagę to samo
parametry jak -r .

-r|--odnośnik|--odnośnik printf-string
W trybach HTML i XML ustawia to formularz adresu URL, za pomocą którego można pobrać innego człowieka
strony. Łańcuch może wykorzystywać dwa dostarczone parametry: nazwę strony man i
jego sekcja. (Zobacz sekcję Przykłady). Jeśli łańcuch ma wartość null (tak jakby był ustawiony
z powłoki przez "-r ''"), `-' lub `off', wówczas odniesienia do stron podręcznika nie będą
być HREF-ami, po prostu pisanymi kursywą. Jeśli twój printf obsługuje pozycje XPG3
specyfikator, może to być dość elastyczne.

-V|--woluminy <oddzielone dwukropkami lista>
Ustaw listę prawidłowych woluminów do sprawdzania podczas wyszukiwania
odnośniki do innych stron podręcznika. Domyślnie do 1:2:3:4:5:6:7:8:9:o:l:n:p
(nazwy woluminów mogą być wieloznakowe). Jeśli ciąg znaków inny niż odstępy w
bezpośrednio po stronie następuje lewy nawias, a następnie jeden z prawidłowych
tomy i kończy się opcjonalnymi innymi znakami, a następnie prawym
nawiasy — wtedy ten ciąg jest zgłaszany jako odniesienie do innego podręcznika
strona. Jeśli ten łańcuch -V zaczyna się od znaku równości, to nie jest opcjonalny
znaki są dozwolone między dopasowaniem do listy poprawnych i
prawy nawias. (Ta opcja jest wymagana dla SCO UNIX.)

Poniższe opcje mają zastosowanie tylko wtedy, gdy jako dane wejściowe podano sformatowane strony. Oni nie
dotyczą lub są zawsze obsługiwane prawidłowo ze źródłem.

-b|--podsekcje
Spróbuj rozpoznać tytuły podsekcji oprócz tytułów sekcji. To może
powodować problemy w niektórych odmianach systemu UNIX.

-K|--nobreak Wskazuje, że strony podręcznika nie mają podziałów stron, więc nie szukaj stopek i
wokół nich nagłówki. (Starsze makra nroff -man zawsze umieszczają podziały stron,
ale ostatnio niektórzy dostawcy zdali sobie sprawę, że wydruki są wykonywane przez
troff(1), podczas gdy nroff -man służy do formatowania stron do czytania na ekranie,
i w ten sposób wyeliminowaliśmy podziały stron.) PoliglotaMężczyzna zwykle robi to dobrze
nawet bez tej flagi.

-k|--keep Zachowaj nagłówki i stopki jako kanoniczny raport na końcu strony.
changeleft Przenieś paski zmian, takie jak te, które można znaleźć na stronach podręcznika Tcl/Tk,
w lewo. --> nieagresywny Wyłącz agresywne parsowanie strony podręcznika.
Agresywna ręczna, która jest domyślnie włączona, parsowanie strony pomija nagłówki i
stopki, identyfikuje sekcje i nie tylko. -->

-n|--imię Nazwa Ustaw nazwę strony man (używanej w formacie roff). Jeśli nazwa pliku jest podana w
Formularz " Nazwa . Sekcja ", nazwa i sekcja są określane automatycznie.
Jeśli strona jest analizowana ze źródła [tn]roff i zawiera linię .TH,
ta informacja jest pobierana z tej linii.

-p|--przełączanie trybu akapitowego akapitu. Filtr określa, czy linie powinny być
linebroken, tak jak były przez nroff, lub czy linie powinny płynąć
razem w akapity. Głównie do użytku wewnętrznego.

-s|przekrój # Ustaw numer woluminu (inaczej sekcji) strony podręcznika (używany w formacie roff). stoły
Włącz agresywne analizowanie tabeli. -->

-t|--tabulacje #
Dla tych zestawów makr, które używają tabulatorów zamiast spacji tam, gdzie to możliwe w
aby zmniejszyć liczbę używanych znaków, ustaw tabulatory co #
kolumny. Domyślnie 8.

UWAGI ON FILTER TYPY

WYŁ
Niektóre wersje systemu UNIX dostarczają stronę podręcznika bez źródła [tn]roff, tworząc własną drukarkę laserową
niewiele więcej niż napędzany laserem stokrotka. Ten filtr próbuje wyczuć oryginał
Dyrektywy [tn]roff, które następnie mogą być rekompilowane przez [tn]roff.

TkMan
TkMan(1), używa hipertekstowej przeglądarki stron podręcznika PoliglotaMężczyzna aby pokazać strony man bez
(zwykle) bezużyteczne nagłówki i stopki na każdej stronie. Gromadzi również sekcję i
(opcjonalnie) nagłówki podsekcji umożliwiające bezpośredni dostęp z menu rozwijanego. TkMan i Tcl/Tk,
zestaw narzędzi, w którym jest napisany, są dostępne za pośrednictwem anonimowego ftp
ftp://ftp.smli.com/pub/tcl/

Tk
Ta opcja wyświetla tekst w postaci serii list Tcl składających się z par tekst-znaczniki, gdzie
nazwy znaczników z grubsza odpowiadają kodowi HTML. To wyjście można wstawić do widżetu tekstowego Tk
robiąc eval wstawić zakończenia . Ten format powinien być stosunkowo łatwy
parsible przez inne programy, które potrzebują zarówno tekstu, jak i tagów. Zobacz także ASCII.

ASCII
Podczas drukowania na drukarce wierszowej strony podręcznika próbują uzyskać specjalne efekty tekstowe
nakładanie znaków na siebie (aby uzyskać pogrubienie) i podkreślenia (podkreślenie).
Wymagane jest inne oprogramowanie do przetwarzania tekstu, takie jak edytory tekstu, wyszukiwarki i indeksatory
temu przeciwdziałać. Filtr ASCII usuwa to formatowanie. Wyjście nroff przez rurociąg
col -b usuwa również to formatowanie, ale pozostawia brzydkie nagłówki stron i
stopki. Zobacz też Tk.

sekcje
Zrzuca sekcje i (opcjonalnie) tytuły podsekcji. Może to być przydatne w innym programie
który przetwarza strony man.

HTML
Dzięki prostemu rozszerzeniu do serwera HTTP dla mozaika(1) lub inną przeglądarkę WWW,
PoliglotaMężczyzna może generować wysokiej jakości kod HTML w locie. Kilka takich rozszerzeń i
wskaźniki do kilku innych są zawarte w PoliglotaMężczyzna 's contrib katalogiem.

XML
To zbliża się do Docbook DTD, ale mam nadzieję, że ktoś z prawdziwym zainteresowaniem
spowoduje to wypolerowanie wygenerowanych tagów. Wypróbuj, aby zobaczyć, jak blisko są teraz tagi.

MIM
MIME (Multipurpose Internet Mail Extensions) zgodnie z definicją zawartą w RFC 1563, dobre do użytku
przez e-mailerów obsługujących MIME lub jako dokumenty wzbogacone Emacsem (>=19.29).

Lateks oraz LaTeX2e
Czemu nie?

RTF
Użyj danych wyjściowych na Macu, NeXT lub czymkolwiek innym. Może weź losowe strony podręcznika i zintegruj je
lepiej z systemem dokumentacji NeXT. Może NeXT ma własne makra strony podręcznika, które to robią
to.

PostScript oraz Kreator ramek
Aby utworzyć PostScript, użyj groff or psroff . Aby wytworzyć FrameMaker MIF, użyj programu FrameMaker
wbudowany filtr. W obu przypadkach potrzebujesz [tn]roff source, więc jeśli masz tylko sformatowany plik
wersja strony podręcznika, użyj PoliglotaMężczyzna Najpierw filtr roff.

PRZYKŁADY

Aby przekonwertować sformatowany strona podręcznika o nazwie lz.1 z powrotem do formy źródłowej [tn]roff:

rman -f roff /usr/local/man/cat1/ls.1 > /usr/local/man/man1/ls.1

Długie strony podręcznika są często kompresowane w celu zaoszczędzenia miejsca (kompresja jest szczególnie skuteczna
na sformatowanych stronach podręcznika, ponieważ wiele znaków to spacje). Ponieważ jest to długa strona podręcznika, it
prawdopodobnie ma podsekcje, które staramy się oddzielić (niektóre zestawy makr nie rozróżniają
podrozdziały wystarczająco dobrze dla PoliglotaMężczyzna ich wykryć). Przekonwertujmy to na LaTeX
format:

szt /usr/catman/a_man/cat1/automount.z | rman -b -n automount -s 1 -f lateks >
automount.man

Alternatywnie mężczyzna 1 automount | rman -b -n automount -s 1 -f lateks > automount.man

Dla użytkowników HTML/Mozaiki, PoliglotaMężczyzna może, bez modyfikacji kodu źródłowego, produkować
Łącza HTML wskazujące na inne strony podręcznika HTML, które zostały wstępnie wygenerowane lub wygenerowane w locie.
Najpierw załóżmy, że przechowywane są wstępnie wygenerowane wersje HTML stron podręcznika /usr/share/man/html .
Wygeneruj je jeden po drugim za pomocą następującego formularza:
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

Jeśli rozszerzyłeś swojego klienta HTML, aby generował HTML w locie, powinieneś czegoś użyć
lubić:
rman -f html -r „http:~/bin/man2html?%SS' /usr/share/man/cat1/ls.1
podczas generowania kodu HTML.

Korzystaj z rman online za pomocą usług onworks.net