gtbl - Online în cloud

PROGRAM:

NUME

tbl - format tabele pentru troff

REZUMAT

tbl [-CV] [fișiere ...]

DESCRIERE

Această pagină de manual descrie versiunea GNU a tbl, care face parte din documentul groff
sistem de formatare. tbl compilează descrieri ale tabelelor încorporate în interior troff fișiere de intrare
în comenzi care sunt înțelese de troff. În mod normal, ar trebui să fie invocat folosind -t
opțiunea de a groff. Este foarte compatibil cu Unix tbl. Ieșirea generată de GNU tbl
nu poate fi procesat cu Unix troff; trebuie procesat cu GNU troff. Dacă nu există fișiere
dat pe linia de comandă sau un nume de fișier de - este dat, intrarea standard este citită.

OPŢIUNI

-C Activați modul de compatibilitate pentru a recunoaște .TS și .TE chiar dacă este urmată de a
alt caracter decât spațiu sau linie nouă. Caracterele lider (\a) sunt tratate ca
interpretat.

-v Tipăriți numărul versiunii.

LIMBA ÎNSCRIERI

tbl se așteaptă să găsească descrieri de tabel împachetate în .TS (începutul mesei) și .TE (masa
sfârşit) macro-uri. În cadrul fiecărei astfel de secțiuni de tabel, un alt tabel poate fi definit utilizând
solicita .T& înainte de comanda finală .TE. Fiecare definiție de tabel are următoarele
structura:

Caritate Opțiuni
Acest lucru este opțional. Această parte a tabelului poate folosi mai multe dintre aceste opțiuni distribuite în
1 sau mai multe rânduri. The global opțiune parte trebuie întotdeauna terminat de a punct şi virgulă ;
.

Tabel format specificație
Această parte trebuie dată, nu este opțională. Determină numărul de coloane
(celule) tabelului. Mai mult, fiecare celulă este clasificată prin faptul că este centrală, stângă
ajustat, sau numeric, etc. Această specificație poate avea mai multe linii, dar trebuie
fi terminat de a punct . la sfârșitul ultimului rând. După fiecare definiție de celulă,
coloană proiectanti poate fi atașat, dar este opțional.

Celulele sunt separate printr-un caracter tabulator în mod implicit. Acest lucru poate fi schimbat de către global
opțiune tbl(c), În cazul în care c este un caracter arbitrar.

SIMPLU EXEMPLE

Cea mai simplă definiție a tabelului este.
.TS
ccc .
Aceasta este centrată
Ei bine, și asta
.TE
Prin folosirea c c c, fiecare celulă din întregul tabel va fi centrată. Personajul separator
este implicit aici fila.

Rezultatul este

Aceasta este centrată
Ei bine, și asta

Această definiție este identică cu
.TS
fila(@);
ccc.
Aceasta@este@centrată
Ei bine, @acest@de asemenea
.TE
Aici, caracterul tabulator de separare este schimbat în literă @.

Mai mult, un titlu poate fi adăugat și direcțiile de centrare pot fi schimbate cu multe altele
formate:
.TS
fila(@);
css
lcn .
Titlu
stânga@centre@123
un alt@număr@75
.TE
Rezultatul este

Titlu
centru stânga 123
un alt număr 75
Aici l mijloace justificat la stânga, și n mijloace numeric, care este aici justificat pe dreapta.

UTILIZARE

Caritate Opțiuni
Linia imediat ce urmează .TS macro poate conține oricare dintre următoarele global
opțiuni (ignorând caracterele – Unix tbl acceptă doar opțiuni cu toate
caractere litere mici sau toate caracterele majuscule), separate prin spații, tab-uri sau virgule:

allbox Închideți fiecare element al tabelului într-o cutie.

cutie Închideți masa într-o cutie.

centru Centrați tabelul (implicit este justificat la stânga). Numele alternativ al cuvântului cheie centru
este de asemenea recunoscut (aceasta este o extensie GNU tbl).

punct zecimal(c)
Setați caracterul pentru a fi recunoscut ca punct zecimal în coloanele numerice (GNU tbl
numai).

delim(xy)
Utilizare x și y ca delimitatori de început și de sfârșit pentru ec(1).

cutie dubla
Închideți masa într-o cutie dublă.

dublu cadru
La fel ca doublebox (doar GNU tbl).

extinde Faceți tabelul la fel de lat ca lungimea liniei curente (oferind o separare a coloanelor
factor). Ignorat dacă sunt utilizați unul sau mai mulți specificatori de coloană „x” (vezi mai jos).

În cazul în care suma lățimilor coloanei este mai mare decât lungimea curentă a liniei,
factorul de separare a coloanei este setat la zero; astfel de tabele se extind în marginea dreaptă,
și nu există nicio separare a coloanelor.

cadru La fel ca și caseta (doar GNU tbl).

linesize(n)
Stabiliți linii sau reguli (de ex. de la cutie) în n-tip de punct.

nokeep Nu utilizați diversiuni pentru a preveni întreruperea paginii (doar GNU tbl). În mod normal tbl Încercările
pentru a preveni întreruperile nedorite în mesele cutie prin utilizarea diversiunilor. Acesta poate
uneori interacționează prost cu pachetele de macro folosirea proprie a diversiiunilor, când notele de subsol,
de exemplu, sunt folosite.

fara spatii
Ignorați spațiile de început și de final din elementele de date (doar GNU tbl).

acum avertiza Dezactivați avertismentele legate de tabelele care depășesc lățimea curentă a liniei (GNU tbl
numai).

fila(x) Folosește personajul x în loc de o filă pentru a separa elementele dintr-o linie de date de intrare.

Opțiunile globale trebuie să se încheie cu punct și virgulă. Este posibil să existe spațiu alb între o opțiune
și argumentul său între paranteze.

Tabel format specificație
După opțiunile globale vin linii care descriu formatul fiecărei linii a tabelului. Fiecare
o astfel de linie de format descrie o linie a tabelului în sine, cu excepția faptului că ultima linie de format
(pe care trebuie să îl încheiați cu un punct) descrie toate rândurile rămase ale tabelului. Un singur-
caracterul cheie descrie fiecare coloană a fiecărei linii a tabelului. Caracterele cheie pot fi
separate prin spații sau file. Puteți rula specificații de format pentru mai multe linii
împreună pe aceeași linie, separându-le prin virgule.

Puteți urma fiecare caracter cheie cu specificatori care determină fontul și dimensiunea punctului
a articolului corespunzător, care determină lățimea coloanei, distanța dintre coloane etc.

Cea mai lungă linie de format definește numărul de coloane din tabel; format lipsă
se presupune că descriptorii de la sfârșitul liniilor de format sunt L. Coloane suplimentare în date
(care nu au nicio intrare de format corespunzătoare) sunt ignorate.

Caracterele cheie disponibile sunt:

a,A Centrați cea mai lungă linie din această coloană și apoi justifică la stânga toate celelalte linii din aceasta
coloană în raport cu acea linie centrată. Ideea este să folosești un astfel de alfabet
subcoloane (de unde și numele caracterului cheie) în combinație cu L; sunt
numite subcoloane deoarece A articolele sunt indentate cu 1n în raport cu L intrări.
Exemplu:

.TS
fila(;);
ln,an.
elementul unu;1
subpunctul doi;2
subpunctul trei;3
.T&
ln,an.
punctul unsprezece;11
subpunctul douăzeci și doi;22
subpunctul treizeci și trei;33
.TE

Rezultat:

elementul unu 1
subpunctul doi 2
subpunctul trei 3
articolul unsprezece 11
subpunctul douăzeci și doi 22
subpunctul treizeci și trei 33

c,C Centrați elementul în coloană.

l,L Element de justificare la stânga în coloană.

n,N Justificați numeric elementul din coloană: pozițiile unităților de numere sunt aliniate
vertical. Dacă există unul sau mai multe puncte adiacente unei cifre, utilizați cea mai dreaptă
unul pentru aliniere verticală. Dacă nu există niciun punct, utilizați cifra din dreapta pentru
aliniere verticală; în caz contrar, centrați elementul în coloană. Alinierea poate fi
forțat într-o anumită poziție folosind „\&”; dacă există una sau mai multe cazuri în acest sens
caracter special (netipărător) prezent în date, utilizați-l pe cel din stânga pentru
aliniere. Exemplu:

.TS
n.
1
1.5
1.5.3
abcde
a\&bcde
.TE

Rezultat:

1
1.5
1.5.3
abcde
abcde

Dacă intrările numerice sunt combinate cu L or R intrări – acest lucru se poate întâmpla dacă
formatul tabelului este schimbat cu .T& – centrul cel mai lat număr (din datele introduse
în temeiul N regimul specificatorului) relativ la cel mai larg L or R intrarea, păstrând
alinierea tuturor intrărilor numerice. Contrar la A tastați intrări, nu există suplimentar
indentare.

Folosind ecuații (de prelucrat cu ec) în coloanele care utilizează N specificator
este problematică în majoritatea cazurilor din cauza tblalgoritmul lui pentru găsirea verticalei
aliniere, așa cum este descris mai sus. Folosind globalul delim opțiune, totuși, este
posibil de realizat tbl ignora datele din interior ec delimitatori în acest scop.

r,R Justificare dreapta element în coloană.

s,S Întindeți elementul anterior din stânga în această coloană. Nu este permis pentru prima coloană.

^ Întindeți în jos intrarea din rândul anterior din această coloană. Nu este permis pentru primul rând.

_,- Înlocuiți această intrare cu o linie orizontală. Rețineți că „_” și „-” pot fi folosite pentru
Numai câmpurile de tabel, nu pentru liniile separatoare de coloane.

= Înlocuiți această intrare cu o linie orizontală dublă. Rețineți că „=” poate fi folosit pentru
Numai câmpurile de tabel, nu pentru liniile separatoare de coloane.

| Coloana corespunzătoare devine o regulă verticală (dacă două dintre acestea sunt adiacente, a
dublă regulă verticală).

O bară verticală în stânga primei litere cheie sau în dreapta ultimei litere
produce o linie la marginea mesei.

Pentru a schimba formatul datelor dintr-un tabel, utilizați .T& comandă (la începutul unei linii).
Este urmată de format și linii de date (dar fără opțiuni globale) similare cu .TS
cerere.

Coloană proiectanti
Iată specificatorii care pot apărea în sufixe la literele cheilor de coloană (în orice ordine):

b,B Forma scurtă de fB (faceți intrările afectate aldine).

d,D Începeți un element care se întinde pe rânduri, folosind specificatorul coloanei „^” sau „\^”
element de date, în partea de jos a intervalului său, mai degrabă decât centrarea verticală (GNU tbl
numai). Exemplu:

.TS
tab(;) allbox;
ll
ld
r ^
l rd.
0000;foobar
T{
1111
.br
2222
T};foo
r;
T{
3333
.br
4444
T};bar
\^;\^
.TE

Rezultat:

┌─────┬────────┐
│0000 │ foobar │
├─────┼────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼────────┤
│3333 │ │
│4444 │ bar │
└─────┴────────┘
e,E Faceți coloane la distanță egală. Toate coloanele marcate cu acest specificator primesc aceleași
lăţime; acest lucru se întâmplă după ce lățimile coloanelor afectate au fost calculate (aceasta înseamnă
că regulă cea mai mare valoare a lăţimii).

f,F Oricare dintre acești specificatori poate fi urmat de un nume de font (fie unul sau doi
caractere lungi), numărul fontului (o singură cifră) sau numele lung între paranteze (the
ultima formă este o extensie GNU tbl). Numele fontului cu o literă trebuie să fie separat cu una
sau mai multe spații libere din ceea ce urmează.

i,I Forma scurtă de fI (faceți intrările afectate cursive).

m,M Aceasta este o extensie GNU tbl. Oricare dintre acești specificatori poate fi urmat de o macrocomandă
nume (fie unul sau două caractere) sau nume lung între paranteze. Unul-
Numele macro-litera trebuie să fie separat prin unul sau mai multe spații libere de ceea ce urmează.
Macrocomanda care poate fi specificată aici trebuie să fie definită înainte de a crea
masa. Este apelat chiar înainte ca textul celulei tabelului să fie scos. După cum a fost implementat
în prezent, această macrocomandă este apelată numai dacă este utilizată intrarea blocului, adică text între
„T{” și „T}”. Macro-ul ar trebui să conțină doar simplu troff solicită schimbarea
formatarea blocurilor de text, cum ar fi ajustarea textului, separarea în silabe, dimensiunea sau fontul. Macro-ul
se numește după alte modificări celulare cum ar fi b, f or v sunt ieșite. Astfel macro
poate suprascrie alți specificatori de modificare.

p,P Urmat de un număr, aceasta modifică dimensiunea punctului pentru câmpurile afectate. Dacă
semnat, dimensiunea curentă a punctului este incrementată sau decrementată (folosind un număr semnat
în loc de o cifră semnată este o extensie GNU tbl). A urmat un specificator de dimensiune a punctului
printr-o coloană numărul de separare trebuie despărțit prin unul sau mai multe spații libere.

t,T Începeți un element care se întinde pe rânduri în partea de sus a intervalului său, mai degrabă decât
centrându-l pe verticală.

u,U Mutați coloana corespunzătoare cu o jumătate de linie în sus.

v,V Urmat de un număr, acesta indică distanța dintre linii pe verticală care trebuie utilizată în a
intrare în tabel cu mai multe rânduri. Dacă este semnat, distanța dintre linii verticală actuală este
incrementat sau decrementat (folosirea unui număr semnat în loc de o cifră semnată este a
extensia GNU tbl). Un specificator de spațiere verticală, urmat de o coloană
numărul de separare trebuie să fie separat prin unul sau mai multe spații libere. Niciun efect dacă
intrarea corespunzătoare în tabel nu este un bloc de text.

w,W Valoarea lățimii minime a coloanei. Trebuie urmat fie de a troff(1) expresia lățimii
între paranteze sau un întreg fără unitate. Dacă nu este dată nicio unitate, se folosesc unități en.
Folosit și ca lungime implicită a liniei pentru blocurile de text incluse. Dacă se utilizează mai multe
de ori pentru a specifica lățimea pentru o anumită coloană, ultima intrare are efect.

x,X O coloană extinsă. După calcularea tuturor lățimii coloanelor fără un x specificator, folosire
lățimea liniei rămasă pentru această coloană. Dacă există mai multe extinse
coloană, distribuiți spațiul orizontal rămas în mod egal între coloanele afectate
(aceasta este o extensie GNU). Această caracteristică are același efect ca și specificarea a
lățimea minimă a coloanei.

z,Z Ignorați coloana corespunzătoare pentru calcularea lățimii, adică nu folosiți
câmpurile, ci numai specificatorii acestei coloane pentru a calcula lățimea acesteia.

Un sufix numeric pe un caracter cheie este interpretat ca o separare a coloanelor în unități en
(înmulțit proporțional dacă extinde opțiunea este activată – în cazul tabelelor prea pline, aceasta
ar putea fi zero). Separarea implicită este 3n.

Specificatorul coloanei x se exclud reciproc cu e și w (dar e nu se exclud reciproc
cu w); dacă este specificat de mai multe ori pentru o anumită coloană, ultima intrare are efect:
x dezactivează pe amândouă e și w, în timp ce fie e or w suprascrie x.

Tabel de date
Liniile de format sunt urmate de linii care conțin datele reale pentru tabel, urmate
in sfarsit de .TE. În astfel de linii de date, elementele sunt în mod normal separate prin caractere de tabulatură
(sau caracterul specificat cu fila opțiune). Liniile lungi de intrare pot fi întrerupte
mai multe linii dacă ultimul caracter de pe linie este „\” (care dispare după
concatenare).

Rețineți că tbl calculează lățimea coloanei linie cu linie, aplicând \w pe fiecare intrare care
nu este un bloc de text. În consecință, construcții ca

.TS
c,l.
\s[20]MM
MMM
.TE

eșuează; trebuie să spui fie

.TS
cp20,lp20.
MM
MMM
.TE

or

.TS
c,l.
\s[20]MM
\s[20]MMMM
.TE

Un punct care începe o linie, urmat de orice, în afară de o cifră, este tratat ca o comandă troff,
a trecut fără modificări. Poziția mesei este neschimbată în acest caz.

Dacă o linie de date constă numai din „_” sau „=”, o linie simplă sau dublă, respectiv, este
trasat peste masă în acel punct; dacă un singur articol dintr-o linie de date constă doar din „_”
sau „=”, atunci acel articol este înlocuit cu o linie simplă sau dublă, unindu-și vecinii. Dacă
un articol de date constă numai din „\_” sau „\=”, este trasată o singură linie sau, respectiv, dublă
peste câmp în acel punct care nu se alătură vecinilor săi.

Un element de date format doar din „\Rx” („x” orice caracter) este înlocuit cu repetări ale
caracterul „x” la fel de lat ca coloana (nu se unește cu vecinii).

Un element de date format numai din „\^” indică faptul că câmpul imediat deasupra se întinde
în jos peste acest rând.

Text blocuri
Un bloc de text poate fi folosit pentru a introduce date ca o singură intrare care ar fi prea lungă ca a
șir simplu între file. Începe cu „T{” și se încheie cu „T}”. Fostul
trebuie să se termine o linie, iar aceasta din urmă trebuie să înceapă o linie, urmată probabil de alte coloane de date
(separate cu file sau caracterul dat cu fila opțiune globală).

În mod implicit, blocul de text este formatat cu setările care erau active înainte
intrând la masă, eventual suprascrisă de m, v, și w specificatorii tbl. De exemplu,
pentru a face toate blocurile de text ragged-dreapta, inserați .n / A chiar înainte de pornire .TS (Și .anunț
după masă).

Dacă nu sunt date specificatorii „w” sau „x[cq]. toate coloanele unui bloc de text se întind, the
lungimea implicită a blocului de text (pentru a fi mai precis, lungimea liniei utilizată pentru procesarea fișierului
devierea blocului de text) este calculată ca L×C/(N+1), unde „L” este lungimea curentă a liniei, „C”
numărul de coloane acoperite de blocul de text și „N” numărul total de coloane în
masa. Rețineți, totuși, că lățimea reală de deviere, așa cum este returnată în registru \n[dl]
este folosit în cele din urmă ca lățime a blocului de text. Dacă este necesar, puteți controla și textul
lățimea blocului cu o inserare directă a a .ll cerere imediat după „T{”.

Diverse
Registrul de numere \n[TW] menține lățimea mesei; nu poate fi folosit în cadrul tabelului în sine
dar este definit chiar înainte de a apela .TE astfel încât această macrocomandă să o poată folosi.

tbl definește, de asemenea, o macro .T# care produce liniile de jos și laterale ale unei mese în casete.
In timp ce tbl denumește această macrocomandă în sine la sfârșitul tabelului, poate fi folosită de macrocomandă
pachete pentru a crea casete pentru tabele cu mai multe pagini, apelând-o în subsolul paginii. Un
exemplu în acest sens este arătat de -Domnișoară macrocomenzi care oferă această funcționalitate dacă un tabel
incepe cu .TS H în loc de apelul standard către .TS macro.

INTERACŢIUNE CU EQN

tbl(1) ar trebui să fie apelat întotdeauna înainte ec(unu) (groff(1) se ocupă automat de
ordinea corectă a preprocesoarelor).

GNU TBL IMBUNATATIRI

Nu există o limită a numărului de coloane dintr-un tabel și nici o limită a numărului de text
blocuri. Toate liniile unui tabel sunt luate în considerare pentru a decide lățimea coloanei, nu doar
primele 200. Continuarea tabelului (.T&) liniile nu sunt limitate la primele 200 de linii.

Elementele numerice și alfabetice pot apărea în aceeași coloană.

Elementele numerice și alfabetice se pot întinde pe orizontală.

tbl folosește nume de registru, șir, macro și deviere care încep cu cifra 3. Când
folosind tbl ar trebui să evitați să folosiți orice nume care încep cu a 3.

GNU TBL ÎN MACROS

Întrucât tbl își definește propriile macrocomenzi (chiar înainte de fiecare tabel), este necesar să se folosească un „end-
de-macro' macro. În plus, caracterul de evacuare trebuie să fie dezactivat. Aici un
exemplu.

.eo
.de TABLE ..
.TS
fila allbox(;);
cl.
\$1;\$2
.TE
...
.ec
.TABUL O masă
.TABLĂ O altă masă
.TABLĂ Și „altul”

Rețineți, totuși, că nu toate caracteristicile tbl poate fi împachetat într-o macro pentru că tbl vede
intrarea mai devreme de troff. De exemplu, formatarea numerelor cu aliniat vertical
punctele zecimale nu reușesc dacă acele numere sunt transmise ca parametri macro pentru că zecimală
alinierea punctului este gestionată de tbl în sine: vede doar „\$1”, „\$2”, etc. și, prin urmare
nu pot recunoaște punctul zecimal.

Utilizați gtbl online folosind serviciile onworks.net