groff - Online w chmurze

PROGRAM:

IMIĘ

groff - front-end dla systemu formatowania dokumentów groff

STRESZCZENIE

groff [-abcegijklpstzCEGNRSUVXZ] [-d cs] [-D arg] [-f fam] [-F reż] [-I reż] [-K arg]
[-L arg] [-m Nazwa] [-M reż] [-n num] [-o podstęp] [-P arg] [-r cn] [-T dev] [-w Nazwa]
[-W Nazwa] [filet ...]
groff -h | --help
groff -v | --wersja [opcja ...]

OPIS

Ten dokument opisuje groff program, główny front-end dla groff dokument
system formatowania. ten groff program i pakiet makr to implementacja roff(7)
system w ramach kolekcji wolnego oprogramowania GNU ⟨http://www.gnu.org. ten groff system ma
wszystkie cechy klasyki roff, ale dodaje wiele rozszerzeń.

Połączenia groff program pozwala kontrolować całość groff system za pomocą opcji wiersza poleceń. Ten
to duże uproszczenie w porównaniu z klasycznym przypadkiem (w którym używa się tylko rurek).

OPCJE

Linia poleceń jest parsowana zgodnie ze zwykłą konwencją GNU. Spacja między
opcja wiersza poleceń, a jej argument jest opcjonalny. Opcje można pogrupować za
pojedynczy „-” (znak minus). Nazwa pliku - (minus znak) oznacza standard
wkład.

As groff to owijający program dla troff oba programy mają wspólny zestaw opcji. Ale
groff program ma kilka dodatkowych, natywnych opcji i niektórym nadaje nowe znaczenie troff
opcje. Z drugiej strony nie wszystkie troff opcje mogą być wprowadzane do groff.

Tubylec groff Opcje
Następujące opcje albo nie istnieją dla troff lub są różnie interpretowane przez
groff.

-D arg Ustaw domyślne kodowanie wejściowe używane przez przedkonw do arg. Implikuje -k.

-e Przetwarzaj wstępnie za pomocą równo.

-g Przetwarzaj wstępnie za pomocą grn.

-G Przetwarzaj wstępnie za pomocą grap. Implikuje -p.

-h
--help Wydrukuj wiadomość pomocy.

-I reż Ta opcja może być użyta do określenia katalogu do wyszukania plików (zarówno tych włączonych
wiersz poleceń i te wymienione w .psbb i .so prośby i \X'ps: import' i
\X'ps: plik' ucieka). Bieżący katalog jest zawsze przeszukiwany jako pierwszy. Ten
opcja może być podana więcej niż raz; katalogi są przeszukiwane w kolejności
określony. Żadne przeszukiwanie katalogu nie jest wykonywane dla plików określonych za pomocą wartości bezwzględnej
ścieżka. Ta opcja oznacza -s opcja.

-j Przetwarzaj wstępnie za pomocą chem. Implikuje -p.

-k Przetwarzaj wstępnie za pomocą przedkonw. Jest to uruchamiane przed jakimkolwiek innym preprocesorem. Proszę odnieś się
do przedkonwstronę podręcznika użytkownika dotyczącą jego zachowania, jeśli nie -K (lub -D) określono opcję.

-K arg Ustaw kodowanie wejściowe używane przez przedkonw do arg. Implikuje -k.

-l Wyślij dane wyjściowe do programu buforującego w celu wydrukowania. Polecenie, którego należy użyć
ponieważ jest to określone przez polecenie w pliku opisu urządzenia, zobacz
groff_font(5). Jeśli to polecenie nie jest obecne, dane wyjściowe są przesyłane do Lpr(1)
program domyślnie. Zobacz opcje -L i -X.

-L arg Przechodzić arg do programu buforowania. Kilka argumentów należy przekazać z
oddzielna opcja -L każda. Zauważ, że groff nie dodaje „-” (znak minus) do
arg przed przekazaniem go do programu buforującego.

-N Nie zezwalaj na nowe linie w ciągu równo ograniczniki. To jest to samo co -N opcja w
równo.

-p Przetwarzaj wstępnie za pomocą kawałek.

-P -Opcja
-P -Opcja -P arg
Przechodzić -Opcja or -Opcja arg do postprocesora. Opcja musi być określona
z niezbędnymi poprzedzającymi znakami minus '-' lub '--', ponieważ groff nie
poprzedzaj wszelkie myślniki przed przekazaniem ich do postprocesora. Na przykład, aby przekazać a
tytuł do gxditview postprocesor, polecenie powłoki

groff -X -P -title -P 'groff to' bla

odpowiada

groff -X -Z bla | gxditview -tytuł 'groff to' -

-R Przetwarzaj wstępnie za pomocą odnosić się. Nie przewidziano mechanizmu przekazywania argumentów do odnosić się
ponieważ większość odnosić się opcje mają równoważne elementy językowe, które można określić
w dokumencie. Widzieć odnosić się(1) po więcej szczegółów.

-s Przetwarzaj wstępnie za pomocą soelim.

-S Bezpieczniejszy tryb. Przekaż -S opcja do kawałek i wyłącz następujące troff upraszanie:
.otwarty, .Otwórz, pso, .sy, .Liczba Pi. Ze względów bezpieczeństwa bezpieczniejszy tryb jest włączany przez
domyślna.

-t Przetwarzaj wstępnie za pomocą tabl.

-T dev Ustaw urządzenie wyjściowe na dev. W przypadku tego urządzenia troff generuje pośredni
wydajność; widzieć groff_out(5). Następnie groff wzywa postprocesor do konwersji troff's
pośredni wydajność do ostatecznego formatu. Prawdziwe urządzenia w groff jest

dvi TeX w formacie DVI (postprocesor to grodwi).

html
xhtml Wyjście HTML i XHTML (preprocesory są soelim i przed grohtml,
postprocesor to post-grohtml).

drukarki lbp Canon CAPSL (drukarki laserowe z serii LBP-4 i LBP-8;
postprocesor to grolbp).

lj4 Drukarki zgodne z HP LaserJet4 (lub inne zgodne z PCL5)
(postprocesor to grolj4).

ps PostScript wyjście (postprocesor to macać).

pdf Wyjście w formacie Portable Document Format (PDF) (postprocesor to gropdf).

Dla następujących urządzeń wyjściowych TTY (postprocesor jest zawsze ponury), -T wybiera
kodowanie wyjściowe:

ascii 7-bitowy ASCII.

cp1047 Zestaw znaków Latin-1 dla hostów EBCDIC.

łacina1 ISO 8859-1.

utf8 zestaw znaków Unicode w kodowaniu UTF-8. Ten tryb ma najwięcej
przydatne czcionki dla trybu TTY, więc jest to najlepszy tryb dla wyjścia TTY.

Wybierz następujące argumenty gxditview jako 'postprocesor' (jest to raczej
oglądanie programu):

X75 Rozdzielczość 75 dpi, czcionka podstawowa dokumentu 10 punktów.

X75-12 Rozdzielczość 75 dpi, czcionka podstawowa dokumentu 12 punktów.

X100 Rozdzielczość 100 dpi, czcionka podstawowa dokumentu 10 punktów.

X100-12
Rozdzielczość 100 dpi, czcionka podstawowa dokumentu 12 punktów.

Domyślnym urządzeniem jest ps.

-U Tryb niebezpieczny. Powraca do (starego) niebezpiecznego zachowania; zobacz opcję -S.

-v
--wersja
Informacje o wersji wyjściowej groff i wszystkich programów, które są przez niego uruchamiane; że
oznacza to, że podana linia poleceń jest przetwarzana w zwykły sposób, przekazując -v dla wszystkich
podprogramy.

-V Wyprowadź potok, który będzie obsługiwany przez groff (jako program owijający) na
standardowe wyjście, ale nie wykonuj go. Polecenia wydane więcej niż raz:
oba wydrukowane na standardowym błędzie i uruchom.

-X Zastosowanie gxditview zamiast używać zwykłego postprocesora do (wstępnego) przeglądania dokumentu.
Zachowanie bufora drukowania zgodnie z opisem w opcjach -l i -L jest przenoszony do
gxditview(1) poprzez określenie argumentu dla -printPolecenie opcja
gxditview(1). To ustawia wartość domyślną akcja i odpowiedni wpis w menu
do tej wartości. -X daje dobre wyniki tylko z -Tps, -TX75, -TX75-12, -TX100,
i -TX100-12. Domyślna rozdzielczość podglądu -Tps wyjście to 75dpi; ten
można zmienić, przekazując -rozkład opcja do gxditview, Na przykład

groff -X -P-rozdzielczość -P100 -man foo.1

-z Pomiń wyjście generowane przez troff. Drukowane są tylko komunikaty o błędach.

-Z Nie przetwarzaj automatycznie groff pośredni wydajność w zwykły sposób.
Spowoduje to, że troff wydajność pojawiać się na standardowym wyjściu, zastępując zwykłe
wyjście postprocesora; zobaczyć groff_out(5).

Przezroczysty Opcje
Następujące opcje są w przejrzysty sposób przekazywane do programu formatującego troff to jest
nazywany przez groff następnie. Te opcje są opisane bardziej szczegółowo w troff(1).

-a Aproksymacja ASCII wyjścia.

-b Ślad po błędzie lub ostrzeżeniu.

-c Wyłącz drukowanie w kolorze. Proszę zapoznać się z ponury(1) strona podręcznika, aby uzyskać więcej informacji.

-C Włącz tryb zgodności.

-d cs
-d Nazwa=s
Zdefiniuj ciąg.

-E Wyłącz troff komunikaty o błędach.

-f fam Ustaw domyślną rodzinę czcionek.

-F reż Ustaw ścieżkę dla plików czcionek DESC.

-i Przetwarzaj standardowe dane wejściowe po określonych plikach wejściowych.

-m Nazwa
Dołącz plik makr Nazwa.tmac (lub tmac.Nazwa); Zobacz też groff_tmac(5).

-M reż Ścieżka do plików makr.

-n num Ponumeruj pierwszą stronę num.

-o podstęp
Drukuj tylko strony w podstęp.

-r cn
-r Nazwa=n
Ustaw rejestr numerów.

-w Nazwa
Włącz ostrzeżenie Nazwa. Zobaczyć troff(1) dla nazwisk.

-W Nazwa
wyłącz ostrzeżenie Nazwa. Zobaczyć troff(1) dla nazwisk.

ZA POMOCĄ GROFF

Połączenia groff system wdraża infrastrukturę klasycznego roffa; zobaczyć roff(7) na ankietę
w jaki sposób roff system działa ogólnie. Ze względu na programy front-end dostępne w ramach
groff system, używanie groff jest o wiele łatwiejsze niż klasyczny roff. Ta sekcja zawiera
przegląd części składających się na groff system. Uzupełnia roff(7) z
groff-specyficzne cechy. Ten rozdział można traktować jako przewodnik po dokumentacji
wokół groff pomimo napiętego harmonogramu

Papier Rozmiar
Połączenia faktyczny rozmiar papieru używany przez troff aby sformatować wejście jest kontrolowane globalnie za pomocą
wywołań .po, .pl, .NS. Zobaczyć groff_tmac(5) dla pakietu makr „rozmiar papieru”, który:
zapewnia wygodny interfejs.

Połączenia fizyczny kontrolowana jest wielkość papieru, podająca rzeczywiste wymiary kartek papieru,
według urządzeń wyjściowych, takich jak macać z opcjami wiersza poleceń -p i -l. Zobaczyć groff_font(5)
oraz strony podręcznika urządzeń wyjściowych, aby uzyskać więcej informacji. groff używa wiersza poleceń
opcja -P przekazać opcje do urządzeń wyjściowych; na przykład poniższe wybiera papier A4
w orientacji poziomej dla urządzenia PS:

groff -Tps -P-pa4 -Pl ...

Początek końca
Połączenia groff program jest opakowaniem wokół troff(1) program. Pozwala określić
preprocesory za pomocą opcji wiersza poleceń i automatycznie uruchamia postprocesor, który jest
odpowiednie dla wybranego urządzenia. Czyniąc to, czasami żmudny mechanizm orurowania
klasyczny roff(7) można uniknąć.

Połączenia grog(1) program może być użyty do odgadnięcia poprawnego groff wiersz poleceń do sformatowania a
plik.

Połączenia grofer(1) program jest wszechstronną przeglądarką dla groff pliki i strony podręcznika.

Preprocesory
Połączenia groff preprocesory są reimplementacjami klasycznych preprocesorów z umiarkowaną
rozszerzenia. Standardowe preprocesory dystrybuowane z groff pakiet są

równo(1) dla wzorów matematycznych,

grn(1) za włączenie zły duch(1) zdjęcia,

kawałek(1) do rysowania schematów,

chem(1)
do schematów budowy chemicznej,

odnosić się(1)
w przypadku odniesień bibliograficznych,

soelim(1)
do dołączania plików makr ze standardowych lokalizacji,

i

tabl(1) dla tabel.

Nowy preprocesor niedostępny w wersji klasycznej troff is przedkonw(1) który konwertuje różne
kodowanie wejściowe do czegoś groff móc zrozumieć. Jest zawsze uruchamiany jako pierwszy przed jakimkolwiek
inny preprocesor.

Poza tym istnieje kilka wewnętrznych preprocesorów, które są automatycznie uruchamiane z niektórymi
urządzenia. Nie są one widoczne dla użytkownika.

Macro pakiety
Pakiety makr mogą być dołączone opcjonalnie -m, groff system wdraża i rozszerza wszystko
klasyczne pakiety makr w sposób zgodny i dodaje kilka własnych pakietów. Tak właściwie,
następujące pakiety makr są dostarczane z groff:

mężczyzna Tradycyjny format strony podręcznika; zobaczyć groff_man(7). Można to określić na
wiersz poleceń jako -człowiek or -m mężczyzna.

mandocja Ogólny pakiet dla stron podręcznika; automatycznie rozpoznaje, czy
dokumenty używają mężczyzna albo mdoc format i rozgałęzienia do odpowiedniego makra
pakiet. Można go określić w wierszu poleceń jako -mandoc or -m mandocja.

mdoc Format strony podręcznika w stylu BSD; zobaczyć groff_mdoc(7). Można to określić na
wiersz poleceń jako -mdoc or -m mdoc.

me Klasyczny me format dokumentu; zobaczyć groff_mnie(7). Można to określić na
wiersz poleceń jako Ja or -m me.

mm Klasyczny mm format dokumentu; zobaczyć groff_mm(7). Można to określić na
wiersz poleceń jako -mm or -m mm.

ms Klasyczny ms format dokumentu; zobaczyć groff_ms(7). Można to określić na
wiersz poleceń jako -ms or -m ms.

www Makra podobne do HTML do włączenia w dowolne groff dokumenty; zobaczyć groff_www(7).

Szczegóły dotyczące nazewnictwa plików makr i ich rozmieszczenia znajdziesz w groff_tmac(5);
ta strona podręcznika opisuje również kilka innych, pomniejszych pomocniczych pakietów makr, o których nie wspomniano
tutaj.

Programowanie Wybierz język
Ogólne pojęcia wspólne dla wszystkich roff języki programowania są opisane w roff(7).

Połączenia groff rozszerzenia do klasyki troff język są udokumentowane w groff_diff(7).

Połączenia groff język jako całość jest opisany w (wciąż niekompletnym) groff Informacje filet; Aby
krótkie (ale kompletne) odniesienie można znaleźć w groff(7).

Formatery
Centralny roff formater w ramach groff System jest troff(1). Zapewnia funkcje
zarówno klasycznych troff i nroff, Jak również groff rozszerzenia. Linia poleceń
opcja -C przełączniki troff najnowszych zgodność tryb który próbuje naśladować klasykę roff as
jak najwięcej.

Jest skrypt powłoki nroff(1) który naśladuje zachowanie klasycznego nroff. Próbuje
aby automatycznie wybrać właściwe kodowanie wyjściowe, zgodnie z aktualnymi ustawieniami regionalnymi.

Program formatujący generuje pośredni wydajność; widzieć groff_out(7).

urządzenia
In roff, cele wyjściowe są nazywane urządzenia. Urządzenie może być sprzętem,
np. drukarka lub format pliku oprogramowania. Urządzenie jest określone przez opcję -T,
groff urządzenia są następujące.

Ascii Wyprowadzanie tekstu za pomocą Ascii(7) zestaw znaków.

cp1047 Wyjście tekstowe przy użyciu strony kodowej EBCDIC IBM cp1047 (np. OS/390 Unix).

Dvi Format TeX DVI.

html Wyjście HTML.

łaciński1 Wyprowadzanie tekstu przy użyciu zestawu znaków ISO Latin-1 (ISO 8859-1); zobaczyć iso_8859_1(7).

funty Wydruk dla drukarek Canon CAPSL (drukarki laserowe serii LBP-4 i LBP-8).

lj4 Drukarki zgodne z HP LaserJet4 (lub inne zgodne z PCL5).

ps wyjście PostScript; nadaje się do drukarek i przeglądarek, takich jak gv(1).

pdf pliki PDF; nadaje się do oglądania za pomocą narzędzi takich jak przejawiać(1) i okular(1).

utf8 Wyprowadzanie tekstu przy użyciu zestawu znaków Unicode (ISO 10646) z kodowaniem UTF-8; zobaczyć
unicode(7).

xhtml Wyjście XHTML.

X75 Wyjście 75dpi X Window System odpowiednie dla przeglądarek xditview(1x) i
gxditview(1). Wariantem dla 12-punktowej czcionki bazowej dokumentu jest X75-12.

X100 Wyjście 100dpi X Window System odpowiednie dla przeglądarek xditview(1x) i
gxditview(1). Wariantem dla 12-punktowej czcionki bazowej dokumentu jest X100-12.

Postprocesor, który ma być używany dla urządzenia, jest określony przez postpro polecenie w
plik opisu urządzenia; zobaczyć groff_font(5). Można to obejść za pomocą -X opcja.

Domyślnym urządzeniem jest ps.

Postprocesory
groff udostępnia 3 postprocesory sprzętowe:

grolbp(1)
dla niektórych drukarek Canon,

grolj4(1)
dla drukarek kompatybilnych z HP LaserJet 4 i PCL5,

ponury(1)
do wyświetlania tekstu przy użyciu różnych kodowań, np. na terminalach tekstowych lub
Drukarki.

Obecnie większość sprzętu do drukowania lub rysowania jest obsługiwana przez system operacyjny według urządzenia
sterowniki lub interfejsy oprogramowania, zwykle akceptujące PostScript. W związku z tym nie
nie jest pilną potrzebą większej liczby postprocesorów urządzeń sprzętowych.

Połączenia groff urządzenia programowe do konwersji na inne formaty plików dokumentów to

grodwi(1)
dla formatu DVI,

grohtml(1)
dla formatów HTML i XHTML,

macać(1)
dla PostScriptu.

gropdf(1)
dla PDF.

W połączeniu z wieloma istniejącymi bezpłatnymi narzędziami do konwersji powinno to wystarczyć do konwersji
a troff dokument do praktycznie dowolnego istniejącego formatu danych.

Użytkowe
Następujące programy narzędziowe wokół groff są dostępne.

informacje o dodatku(1)
Dodaj informacje do troff pliki opisu czcionek do użytku z groff.

afmtodit(1)
Utwórz pliki opisu czcionek dla urządzenia PostScript.

równanie2wykres(1)
Konwertuj i równo obraz w przycięty obraz.

gdiffmk(1)
Zaznacz różnice między groff, nrofflub troff akta.

grap2graf(1)
Konwertuj grap diagram do przyciętego obrazu bitmapowego.

grofer(1)
Ogólny program przeglądarki dla groff pliki i strony podręcznika.

gxditview(1)
Połączenia groff X viewer, wersja GNU xditview.

hpftdit(1)
Utwórz pliki opisu czcionek dla urządzenia lj4.

indxbib(1)
Stwórz odwrócony indeks dla bibliograficznych baz danych.

lkbib(1)
Przeszukuj bazy bibliograficzne.

patrz bib(1)
Interaktywnie przeszukuj bibliograficzne bazy danych.

pdfroff(1)
Twórz dokumenty PDF za pomocą groff.

pfbtops(1)
Przetłumacz czcionkę PostScript w formacie .pfb na ASCII.

pic2wykres(1)
Konwertuj kawałek diagram w przycięty obraz.

tfmtodit(1)
Utwórz pliki opisu czcionek dla urządzenia TeX DVI.

xditview(1x)
roff przeglądarka dystrybuowana z X Window.

xtotroff(1)
Konwertuj metryki czcionek X na GNU troff metryki czcionek.

ŚRODOWISKO

Zwykle separatorem ścieżki w następujących zmiennych środowiskowych jest dwukropek; tego maja
różnią się w zależności od systemu operacyjnego. Na przykład DOS i Windows używają średnika
zamiast.

GROFF_BIN_PATH
Ta ścieżka wyszukiwania, po której następuje $ PATH, jest używany do poleceń wykonywanych przez
groff. Jeśli nie jest ustawiony, to katalog, w którym groff binaria zostały zainstalowane
jest dodany do PATH.

GROFF_COMMAND_PREFIX
Kiedy trzeba biegać inaczej roff wdrożeń w tym samym czasie groff
zapewnia możliwość dołączania przedrostka do większości swoich programów, które mogą:
prowokuj konflikty nazw w czasie wykonywania (domyślnie nie ma żadnych). Historycznie to
prefiks był znakiem g, ale może to być wszystko. Na przykład, groff znaczy
groff's troff, gtbl dla groff wersja tabl. Przez ustawienie GROFF_COMMAND_PREFIX
do różnych wartości, różne roff instalacje mogą być adresowane. Jeszcze
dokładnie, jeśli jest ustawiony na prefiks xxx następnie groff jako program owijający wewnętrznie
Połączenia xxxtroff zamiast troff. Dotyczy to również preprocesorów równo, grn,
kawałek, odnosić się, tabl, soelimi do mediów indxbib i patrz bib. Ta cecha
nie dotyczy programów innych niż wymienione powyżej (przede wszystkim groff
się), ponieważ są unikalne dla groff pakiet.

GROFF_KODOWANIE
Wartość tej wartości środowiskowej jest przekazywana do przedkonw preprocesor do wyboru
kodowanie plików wejściowych. Ustawienie tej opcji implikuje groffwiersz poleceń
opcja -k (to jest, groff właściwie zawsze dzwoni przedkonw). Jeśli ustawiono bez wartości,
groff Połączenia przedkonw bez argumentów. Wyraźny -K opcja wiersza poleceń
nadpisuje wartość GROFF_KODOWANIE. Zobaczyć przedkonw(1) szczegóły.

GROFF_FONT_PATH
Lista katalogów, w których należy szukać devNazwa katalog oprócz
te domyślne. Widzieć troff(1) i groff_font(5) po więcej szczegółów.

GROFF_TMAC_PATH
Lista katalogów, w których szukać plików makr oprócz domyślnych
katalogi. Widzieć troff(1) i groff_tmac(5) po więcej szczegółów.

GROFF_TMPDIR
Katalog, w którym tworzone są pliki tymczasowe. Jeśli to nie jest ustawione, ale
zmienna środowiskowa TMPDIR zamiast tego w katalogu tworzone są pliki tymczasowe
$ TMPDIR. Na platformach MS-DOS i Windows 32 zmienne środowiskowe TMP i
TEMP (w tej kolejności) są przeszukiwane również po GROFF_TMPDIR i TMPDIR. W przeciwnym razie,
pliki tymczasowe są tworzone w / Tmp, odnosić się(1) grofer(1) grohtml(1), a
macać(1) polecenia używają plików tymczasowych.

GROFF_TYPESETTER
Ustaw domyślne urządzenie. Jeśli to nie jest ustawione, ps urządzenie jest używane domyślnie.
Ta nazwa urządzenia jest zastępowana przez opcję -T.

PRZYKŁADY

Poniższy przykład ilustruje siłę groff program jako wrapper wokół
troff.

Aby przetworzyć roff plik za pomocą preprocesorów tabl i kawałek oraz me zestaw makro, klasyczny
troff musiał zostać wezwany przez

pic foo.me | tbl | troff-me-Tlatin1 | ponury

Korzystanie z groff, ten potok można skrócić do równoważnego polecenia

groff -p -t -me -T latin1 foo.me

Jeszcze łatwiejszym sposobem na wywołanie tego jest użycie grog(1) odgadnąć preprocesor i makro
opcji i wykonaj wygenerowane polecenie (używając odwrotnych cudzysłowów do określenia polecenia powłoki
podstawienie)

`grog -Tlatin1 foo.me`

Najprostszym sposobem jest przeglądanie treści w sposób zautomatyzowany, dzwoniąc

groffer foo.me

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