groff - Online în cloud

PROGRAM:

NUME

groff - front-end pentru sistemul de formatare a documentelor groff

REZUMAT

groff [-abcegijklpstzCEGNRSUVXZ] [-d cs] [-D arg] [-f Fam] [-F dir] [-I dir] [-K arg]
[-L arg] [-m nume] [-M dir] [-n o] [-o listă] [-P arg] [-r cn] [-T dev] [-w nume]
[-W nume] [fişier ...]
groff -h | --Ajutor
groff -v | --versiune [opțiune ...]

DESCRIERE

Acest document descrie groff program, principalul front-end pentru groff document
sistem de formatare. The groff program și macro suite este implementarea unui roff(7)
sistem din colecția de software liber GNU ⟨http://www.gnu.org⟩. The groff sistemul are
toate trăsăturile clasicului roff, dar adaugă multe extensii.

groff programul permite controlul întregului groff opțiuni de sistem prin linia de comandă. Acest
este o mare simplificare în comparație cu cazul clasic (care folosește doar țevi).

OPŢIUNI

Linia de comandă este analizată conform convenției obișnuite GNU. Spațiul alb dintre
o opțiune de linie de comandă și argumentul său este opțional. Opțiunile pot fi grupate în spatele unui
un singur „-” (caracter minus). Un nume de fișier al - (caracterul minus) desemnează standardul
intrare.

As groff este un program wrapper pentru troff ambele programe partajează un set de opțiuni. Cu exceptia
groff programul are câteva opțiuni suplimentare, native și oferă un nou sens unora troff
Opțiuni. Pe de altă parte, nu toate troff pot fi introduse opțiuni groff.

Nativ groff Opţiuni
Următoarele opțiuni fie nu există pentru troff sau sunt interpretate diferit de
groff.

-D arg Setați codificarea implicită de intrare utilizată de preconv la arg. implică -k.

-e Preprocesează cu ec.

-g Preprocesează cu GRN.

-G Preprocesează cu glumă. implică -p.

-h
--Ajutor Imprimați un mesaj de ajutor.

-I dir Această opțiune poate fi utilizată pentru a specifica un director pentru a căuta fișiere (ambele cele din
linia de comandă și cele numite în .psbb si .asa de cereri, și \X'ps: import' si
\X'ps: fişier' evadări). Directorul curent este întotdeauna căutat primul. Acest
opțiunea poate fi specificată de mai multe ori; directoarele sunt căutate în ordine
specificat. Nu se efectuează nicio căutare în director pentru fișierele specificate folosind un absolut
cale. Această opțiune implică -s opțiune.

-j Preprocesează cu chim. implică -p.

-k Preprocesează cu preconv. Acesta este rulat înaintea oricărui alt preprocesor. Vă rugăm să consultați
la preconvpagina de manual a lui pentru comportamentul său dacă nu -K (Sau -D) este specificată opțiunea.

-K arg Setați codificarea de intrare utilizată de preconv la arg. implică -k.

-l Trimiteți rezultatul la un program de spool pentru imprimare. Comanda care ar trebui folosită
pentru acest lucru este specificat de către imprima comanda în fișierul de descriere a dispozitivului, vezi
groff_font(5). Dacă această comandă nu este prezentă, ieșirea este transmisă în lpr(1)
program implicit. Vezi opțiuni -L si -X.

-L arg Trece arg la programul spooler. Mai multe argumente ar trebui trecute cu a
opțiune separată -L fiecare. Rețineți că groff nu pune înainte „-” (un semn minus) la
arg înainte de a-l trece în programul spooler.

-N Nu permiteți linii noi înăuntru ec delimitatori. Acesta este la fel ca -N opțiune în
ec.

-p Preprocesează cu pic.

-P -opțiune
-P -opțiune -P arg
Trece -opțiune or -opțiune arg la postprocesor. Opțiunea trebuie specificată
cu semnul (semnele) minus anterior necesar „-” sau „--” deoarece groff nu
adaugă orice liniuță înainte de a le transmite postprocesorului. De exemplu, pentru a trece a
titlu la gxditview postprocesor, comanda shell

groff -X -P -title -P "groff it" foo

este echivalent cu

groff -X -Z foo | gxditview -titlu „groff it” -

-R Preprocesează cu trimite. Nu este prevăzut niciun mecanism pentru transmiterea argumentelor către trimite
pentru că majoritatea trimite opțiunile au elemente de limbaj echivalente care pot fi specificate
în cadrul documentului. Vedea trimite(1) pentru mai multe detalii.

-s Preprocesează cu soelim.

-S Modul mai sigur. Treceți -S opțiunea pentru pic și dezactivați următoarele troff cereri:
.deschis, .deschis, .pso, .sy și .pi. Din motive de securitate, modul mai sigur este activat de
Mod implicit.

-t Preprocesează cu tbl.

-T dev Setați dispozitivul de ieșire la dev. Pentru acest dispozitiv, troff generează intermediar
producție; vedea groff_out(5). Atunci groff apelează un postprocesor pentru a converti troff's
intermediar producție la formatul final. Dispozitive reale în groff sunt

dvi TeX DVI format (postprocesorul este grodvi).

html
Ieșire xhtml HTML și XHTML (preprocesoarele sunt soelim si pre-grohtml,
postprocesorul este post-grohtml).

lbp Imprimante Canon CAPSL (imprimante laser din seria LBP-4 și LBP-8;
postprocesorul este grolbp).

Imprimante compatibile lj4 HP LaserJet4 (sau alte compatibile PCL5).
(postprocesorul este grolj4).

ps Ieșire PostScript (postprocesorul este bâjâie).

Ieșire pdf Portable Document Format (PDF) (postprocesor este gropdf).

Pentru următoarele dispozitive de ieșire TTY (postprocesor este întotdeauna groaznic), -T selectează
codificarea de ieșire:

ascii pe 7 biți ASCII.

cp1047 Setul de caractere Latin-1 pentru gazdele EBCDIC.

latin1 ISO 8859-1.

utf8 set de caractere Unicode în codificare UTF-8. Acest mod are cel mai mult
fonturi utile pentru modul TTY, deci este cel mai bun mod pentru ieșirea TTY.

Următoarele argumente selectează gxditview ca „postprocesor” (este mai degrabă un
program de vizionare):

Rezoluție X75 75 dpi, font de bază pentru documente 10 pt.

X75-12 Rezoluție de 75 dpi, font de bază pentru documente de 12 pt.

Rezoluție X100 100 dpi, font de bază pentru documente 10 pt.

X100-12
Rezoluție de 100 dpi, font de bază pentru documente de 12 pt.

Dispozitivul implicit este ps.

-U Modul nesigur. Revine la (vechiul) comportament nesigur; vezi optiunea -S.

-v
--versiune
Informații despre versiunea de ieșire a groff și a tuturor programelor care sunt rulate de acesta; acea
este, linia de comandă dată este analizată în mod obișnuit, trecând -v tuturor
subprograme.

-V Ieșiți conducta de care ar fi condusă groff (ca program wrapper) pe
ieșire standard, dar nu o executați. Dacă sunt date de mai multe ori, comenzile sunt
ambele tipărite pe eroarea standard și rulează.

-X Utilizare gxditview în loc să folosiți postprocesorul obișnuit pentru a (pre)vizualiza un document.
Comportamentul spoolerului de imprimare, așa cum este subliniat cu opțiuni -l si -L este reportat la
gxditview(1) prin determinarea unui argument pentru -printCommand opțiunea de a
gxditview(1). Aceasta setează valoarea implicită acțiunea și intrarea corespunzătoare din meniu
la acea valoare. -X produce numai rezultate bune cu -Tps, -TX75, -TX75-12, -TX100,
si -TX100-12. Rezoluția implicită pentru previzualizare -Tps ieșirea este de 75 dpi; acest
poate fi schimbat prin trecerea -rezoluţie opțiunea pentru gxditview, De exemplu,

groff -X -P-rezolutie -P100 -man foo.1

-z Suprimați ieșirea generată de troff. Sunt tipărite doar mesajele de eroare.

-Z Nu postprocesați automat groff intermediar producție în maniera obișnuită.
Acest lucru va cauza troff producție să apară pe ieșirea standard, înlocuind cea obișnuită
ieșire postprocesor; vedea groff_out(5).

Transparent Opţiuni
Următoarele opțiuni sunt transmise în mod transparent programului de formatare troff acesta este
chemat de groff ulterior. Aceste opțiuni sunt descrise mai detaliat în troff(1).

-a aproximarea ASCII a ieșirii.

-b Înapoi la eroare sau avertisment.

-c Dezactivați ieșirea color. Vă rugăm să consultați groaznic(1) pagina de manual pentru mai multe detalii.

-C Activați modul de compatibilitate.

-d cs
-d nume=s
Definiți șirul.

-E Dezactivați troff mesaje de eroare.

-f Fam Setați familia de fonturi implicită.

-F dir Setați calea pentru fișierele DESC cu font.

-i Procesați intrarea standard după fișierele de intrare specificate.

-m nume
Includeți fișierul macro nume.tmac (Sau tmac.nume); Vezi si groff_tmac(5).

-M dir Calea pentru fișierele macro.

-n o Numerotează prima pagină o.

-o listă
Ieșiți numai pagini în listă.

-r cn
-r nume=n
Setați registrul de numere.

-w nume
Activați avertismentul nume. Vedea troff(1) pentru nume.

-W nume
dezactivați avertismentul nume. Vedea troff(1) pentru nume.

UTILIZAREA GROFF

groff sistem implementează infrastructura roff-ului clasic; vedea roff(7) pentru un sondaj
despre cum a roff sistemul funcționează în general. Datorită programelor front-end disponibile în cadrul
groff sistem, folosind groff este mult mai ușor decât clasic roff. Această secțiune oferă o
privire de ansamblu asupra părților care constituie groff sistem. Se completează roff(7) cu
groff- caracteristici specifice. Această secțiune poate fi privită ca un ghid pentru documentație
în jurul valorii de groff sistemului.

Hârtie Mărimea
virtual dimensiunea hârtiei folosită de troff pentru a formata intrarea este controlată global cu
cereri de .po, .pl și .ll. Vedea groff_tmac(5) pentru pachetul macro „papersize” care
oferă o interfață convenabilă.

fizic dimensiunea hârtiei, dând dimensiunile reale ale foilor de hârtie, este controlată
prin dispozitive de ieșire precum bâjâie cu opțiunile liniei de comandă -p si -l. Vedea groff_font(5)
și paginile de manual ale dispozitivelor de ieșire pentru mai multe detalii. groff folosește linia de comandă
opțiune -P pentru a transmite opțiuni dispozitivelor de ieșire; de exemplu, următoarele selectează hârtie A4
în orientare peisaj pentru dispozitivul PS:

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

Front-end-uri
groff programul este un înveliș în jurul troff(1) program. Permite specificarea
preprocesoare prin opțiunile din linia de comandă și rulează automat postprocesorul care este
adecvat pentru dispozitivul selectat. Procedând astfel, mecanismul de conducte uneori plictisitor al
clasic roff(7) poate fi evitat.

Grog(1) programul poate fi folosit pentru a ghici corect groff linie de comandă pentru a formata a
fișier.

groffer(1) programul este un vizualizator complet pentru groff fișiere și pagini de manual.

Preprocesoare
groff preprocesoarele sunt reimplementari ale preprocesoarelor clasice cu moderate
extensii. Preprocesoarele standard distribuite cu groff pachetul sunt

ec(1) pentru formulele matematice,

GRN(1) pentru includerea Gremlin(1) imagini,

pic(1) pentru desenarea diagramelor,

chim(1)
pentru diagramele structurii chimice,

trimite(1)
pentru referințe bibliografice,

soelim(1)
pentru includerea fișierelor macro din locații standard,

si

tbl(1) pentru mese.

Un nou preprocesor nu este disponibil în versiunea clasică troff is preconv(1) care convertește diverse
introduceți codificări la ceva groff pot intelege. Este întotdeauna rulat primul înainte de oricare
alt preprocesor.

Pe lângă acestea, există unele preprocesoare interne care rulează automat cu unele
dispozitive. Acestea nu sunt vizibile pentru utilizator.

Macro Pachete
Pachetele macro pot fi incluse opțional -m. groff sistemul implementează și extinde toate
pachetele macro clasice într-un mod compatibil și adaugă unele pachete proprii. De fapt,
Următoarele pachete macro vin cu groff:

om Formatul tradițional al paginii de manual; vedea groff_man(7). Poate fi specificat pe
linia de comandă ca -om or -m om.

mandoc Pachetul general pentru paginile de manual; recunoaște automat dacă
documentele utilizează om sau mdoc format și se ramifică la macrocomanda corespunzătoare
pachet. Poate fi specificat pe linia de comandă ca -mandoc or -m mandoc.

mdoc Formatul paginii de manual în stil BSD; vedea groff_mdoc(7). Poate fi specificat pe
linia de comandă ca -mdoc or -m mdoc.

me Clasicul me formatul documentului; vedea groff_me(7). Poate fi specificat pe
linia de comandă ca -pe mine or -m me.

mm Clasicul mm formatul documentului; vedea groff_mm(7). Poate fi specificat pe
linia de comandă ca -mm or -m mm.

ms Clasicul ms formatul documentului; vedea groff_ms(7). Poate fi specificat pe
linia de comandă ca -Domnișoară or -m ms.

www Macrocomenzi asemănătoare HTML pentru includerea în arbitrare groff documente; vedea groff_www(7).

Detalii despre denumirea fișierelor macro și plasarea acestora pot fi găsite în groff_tmac(5);
Această pagină de manual documentează și alte pachete macro auxiliare minore care nu sunt menționate
aici.

Programare Limbă
Concepte generale comune tuturor roff limbajele de programare sunt descrise în roff(7).

groff extensii la clasic troff limba sunt documentate în groff_diff(7).

groff limbajul ca întreg este descris în (încă incomplet) groff info fişier; la
referință scurtă (dar completă) poate fi găsită în groff(7).

Formatatoare
Centrala roff formatator în cadrul groff sistemul este troff(1). Oferă caracteristicile
atât a clasicului troff si nroff, Precum și groff extensii. Linia de comandă
opțiune -C întrerupătoare troff în compatibilitate mod care încearcă să imite clasicul roff as
pe cât posibil.

Există un script shell nroff(1) care emulează comportamentul clasicului nroff. Încearcă
pentru a selecta automat codarea de ieșire adecvată, în funcție de localitatea curentă.

Programul de formatare generează intermediar producție; vedea groff_out(7).

Dispozitive
In roff, țintele de ieșire sunt numite Dispozitive. Un dispozitiv poate fi o piesă hardware,
de exemplu, o imprimantă sau un format de fișier software. Un dispozitiv este specificat de opțiune -T.
groff dispozitivele sunt după cum urmează.

ascii Ieșire de text folosind ascii(7) set de caractere.

cp1047 Ieșire text utilizând pagina de coduri EBCDIC IBM cp1047 (de exemplu, OS/390 Unix).

dvi format TeX DVI.

html Ieșire HTML.

latin1 Ieșire text folosind setul de caractere ISO Latin-1 (ISO 8859-1); vedea iso_8859_1(7).

lbp Ieșire pentru imprimantele Canon CAPSL (imprimante laser din seria LBP-4 și LBP-8).

lj4 Imprimante compatibile HP LaserJet4 (sau alte compatibile PCL5).

ps Ieșire PostScript; potrivit pentru imprimante și previzualizatoare precum gv(1).

pdf fișiere PDF; potrivit pentru vizualizare cu instrumente precum dovadă(1) și ocular(1).

utf8 Ieșire text folosind setul de caractere Unicode (ISO 10646) cu codificare UTF-8; vedea
unicode(7).

xhtml Ieșire XHTML.

X75 Ieșire X Window System de 75 dpi potrivită pentru previzualizatori xditview(1x) și
gxditview(1). O variantă pentru un font de bază de document de 12 puncte este X75-12.

X100 Ieșire X Window System de 100 dpi potrivită pentru previzualizatori xditview(1x) și
gxditview(1). O variantă pentru un font de bază de document de 12 puncte este X100-12.

Postprocesorul care trebuie utilizat pentru un dispozitiv este specificat de postpro comandă în
fișier descriere dispozitiv; vedea groff_font(5). Acest lucru poate fi înlocuit cu -X opțiune.

Dispozitivul implicit este ps.

Postprocesoare
groff oferă 3 postprocesoare hardware:

grolbp(1)
pentru unele imprimante Canon,

grolj4(1)
pentru imprimante compatibile cu HP LaserJet 4 și PCL5,

groaznic(1)
pentru ieșirea textului folosind diverse codificări, de exemplu, pe terminale orientate pe text sau pe linie
imprimante.

Astăzi, majoritatea hardware-ului de imprimare sau de desen se ocupă de sistemul de operare, de dispozitiv
drivere sau prin interfețe software, acceptând de obicei PostScript. În consecință, acolo
nu este o nevoie urgentă de mai multe postprocesoare hardware pentru dispozitive.

groff dispozitivele software pentru conversia în alte formate de fișiere de documente sunt

grodvi(1)
pentru formatul DVI,

grohtml(1)
pentru formatele HTML și XHTML,

bâjâie(1)
pentru PostScript.

gropdf(1)
pentru PDF.

Combinat cu numeroasele instrumente de conversie gratuite existente, acest lucru ar trebui să fie suficient pentru conversie
a troff document în aproape orice format de date existent.

Utilități
Următoarele programe utilitare în jur groff sunt disponibile.

addftinfo(1)
Adăugați informații la troff fișiere de descriere a fonturilor pentru utilizare cu groff.

afmtodit(1)
Creați fișiere de descriere a fonturilor pentru dispozitivul PostScript.

eqn2graph(1)
Convertiți un ec imagine într-o imagine decupată.

gdiffmk(1)
Marcați diferențele dintre groff, nroff, troff fișiere.

grap2graph(1)
Convertiți a glumă diagramă într-o imagine bitmap decupată.

groffer(1)
Program de vizualizare generală pentru groff fișiere și pagini de manual.

gxditview(1)
groff X Viewer, versiunea GNU a xditview.

hpftodit(1)
Creați fișiere de descriere a fonturilor pentru dispozitivul lj4.

indxbib(1)
Faceți index inversat pentru bazele de date bibliografice.

lkbib(1)
Căutați baze de date bibliografice.

lookbib(1)
Căutați interactiv baze de date bibliografice.

pdfroff(1)
Creați documente PDF folosind groff.

pfbtops(1)
Traduceți un font PostScript în format .pfb în ASCII.

pic2graf(1)
Convertiți a pic diagramă într-o imagine decupată.

tfmtodit(1)
Creați fișiere de descriere a fonturilor pentru dispozitivul TeX DVI.

xditview(1x)
roff vizualizator distribuit cu fereastra X.

xtotroff(1)
Convertiți valorile fontului X în GNU troff metrica fonturilor.

MEDIUL

În mod normal, separatorul de cale în următoarele variabile de mediu este două puncte; aceasta poate
variază în funcție de sistemul de operare. De exemplu, DOS și Windows folosesc punct și virgulă
in schimb.

GROFF_BIN_PATH
Această cale de căutare, urmată de $ PATH, este folosit pentru comenzile care sunt executate de
groff. Dacă nu este setat, atunci directorul în care este groff au fost instalate binare
este anexat la PATH.

GROFF_COMMAND_PREFIX
Când este nevoie să alergi diferit roff implementari in acelasi timp groff
oferă posibilitatea de a adăuga un prefix la majoritatea programelor sale care ar putea
provoacă ciocniri de nume în timpul rulării (implicit este să nu existe). Din punct de vedere istoric, asta
prefixul era caracterul g, dar poate fi orice. De exemplu, gtroff a reprezentat
groff's troff, gtbl pentru groff versiune a tbl. Prin setare GROFF_COMMAND_PREFIX
la valori diferite, la diferite roff instalatiile pot fi abordate. Mai mult
exact, dacă este setat la prefix XXX apoi groff ca program wrapper intern
Apeluri XXXtroff în loc de troff. Acest lucru este valabil și pentru preprocesoare ec, GRN,
pic, trimite, tbl, soelim, și la utilități indxbib si lookbib. Această caracteristică
nu se aplică programelor diferite de cele de mai sus (mai ales groff
în sine) deoarece sunt unice pentru groff pachet.

GROFF_ENCODING
Valoarea acestei valori de mediu este transmisă către preconv preprocesor de selectat
codificarea fișierelor de intrare. Setarea acestei opțiuni implică grofflinia de comandă a lui
opțiune -k (aceasta este, groff de fapt sună mereu preconv). Dacă se setează fără valoare,
groff Apeluri preconv fara argumente. Un explicit -K opțiunea de linie de comandă
suprascrie valoarea lui GROFF_ENCODING. Vedea preconv(1) pentru detalii.

GROFF_FONT_PATH
O listă de directoare în care să căutați devnume director pe lângă
cele implicite. Vedea troff(1) și groff_font(5) pentru mai multe detalii.

GROFF_TMAC_PATH
O listă de directoare în care să căutați fișiere macro pe lângă cele implicite
directoare. Vedea troff(1) și groff_tmac(5) pentru mai multe detalii.

GROFF_TMPDIR
Directorul în care sunt create fișierele temporare. Dacă acest lucru nu este setat, ci
variabilă de mediu TMPDIR în schimb, fișierele temporare sunt create în director
$TMPDIR. Pe platformele MS-DOS și Windows 32, variabilele de mediu TMP si
TEMP (în această ordine) sunt căutate și, după GROFF_TMPDIR si TMPDIR. In caz contrar,
fișierele temporare sunt create în / tmp. trimite(1), groffer(1), grohtml(1), și
bâjâie(1) comenzile folosesc fișiere temporare.

GROFF_TYPESETTER
Presetați dispozitivul implicit. Dacă acest lucru nu este setat ps dispozitivul este utilizat implicit.
Acest nume de dispozitiv este suprascris de opțiune -T.

EXEMPLE

Următorul exemplu ilustrează puterea groff program ca un înveliș în jur
troff.

A procesa a roff fișier folosind preprocesoare tbl si pic si me set macro, clasic
troff trebuia chemat de

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

Utilizarea groff, această conductă poate fi scurtată la comanda echivalentă

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

O modalitate și mai ușoară de a apela acest lucru este utilizarea Grog(1) pentru a ghici preprocesorul și macro
opțiuni și executați comanda generată (utilizând ghilimele inverse pentru a specifica comanda shell
substituţie)

`grog -Tlatin1 foo.me`

Cea mai simplă modalitate este să vizualizați conținutul într-un mod automat prin apel

groffer foo.me

Utilizați groff online folosind serviciile onworks.net