gtbl - Online nel cloud

PROGRAMMA:

NOME

tbl - tabelle di formato per troff

SINOSSI

TBL [-CV] [file ...]

DESCRIZIONE

Questa pagina di manuale descrive la versione GNU di TBL, che fa parte del documento groff
sistema di formattazione. TBL compila le descrizioni delle tabelle incorporate all'interno trof file di input
in comandi che sono compresi da trof. Normalmente, dovrebbe essere invocato usando il -t
possibilità di groff. È altamente compatibile con Unix TBL. L'output generato da GNU TBL
non può essere elaborato con Unix trof; deve essere elaborato con GNU trof. Se non ci sono file
dato sulla riga di comando o un nome di file di - viene fornito, viene letto lo standard input.

VERSIONI

-C Abilita la modalità di compatibilità per riconoscere . TS ed .PER anche quando seguito da a
carattere diverso da spazio o nuova riga. I caratteri leader (\a) vengono gestiti come
interpretato.

-v Stampa il numero di versione.

LINGUA OVERVIEW

TBL si aspetta di trovare le descrizioni delle tabelle racchiuse nel . TS (inizio tavolo) e .PER (tavolo
fine) macro. All'interno di ciascuna di queste sezioni della tabella, è possibile definire un'altra tabella utilizzando il pulsante
richiesta .T& prima del comando finale .PER. Ogni definizione di tabella ha il seguente
struttura:

globali Opzioni
Questo è facoltativo. Questa parte della tabella può utilizzare molte di queste opzioni distribuite in
1 o più righe. Il globale opzione parte deve essere sempre terminato da a punto e virgola ;
.

Table formato specificazione
Questa parte deve essere data, non è facoltativa. Determina il numero di colonne
(celle) della tabella. Inoltre ogni cella è classificata per essere centrale, sinistra
regolato, o numerico, ecc. Questa specifica può avere più righe, ma deve
essere finito da a punto . alla fine dell'ultima riga. Dopo ogni definizione di cella,
colonna prescrittori può essere aggiunto, ma è facoltativo.

Le celle sono separate da un carattere di tabulazione per impostazione predefinita. Che può essere cambiato dal globale
opzione tbl(c), Dove c è un carattere arbitrario.

SEMPLICE ESEMPI

La definizione di tabella più semplice è.
. TS
ccc.
Questo è centrato
Bene, anche questo
.PER
Utilizzando c c c, ogni cella dell'intera tabella sarà centrata. Il carattere separatore
è qui l'impostazione predefinita linguetta.

Il risultato è

Questo è centrato
Bene, anche questo

Questa definizione è identica a
. TS
scheda(@);
cc.
Questo@è@centrato
Bene, @questo@anche
.PER
Qui, il carattere di tabulazione di separazione viene modificato nella lettera @.

Inoltre può essere aggiunto un titolo e le direzioni di centratura possono essere cambiate in molti altri
formati:
. TS
scheda(@);
css
lcn.
Titolo
sinistra@centri@123
un altro@numero@75
.PER
Il risultato è

Titolo
centri a sinistra 123
un altro numero 75
Qui l si intende giustificato a sinistrae n si intende numerico, che è qui giustificato a destra.

USO

globali Opzioni
La riga immediatamente successiva a . TS macro può contenere uno dei seguenti elementi globali
opzioni (ignorando il caso dei caratteri – Unix tbl accetta solo opzioni con all
caratteri minuscoli o tutti i caratteri maiuscoli), separati da spazi, tabulazioni o virgole:

allbox Racchiudere ogni elemento della tabella in una scatola.

nella scatola Racchiudere la tabella in una scatola.

centro Centrare la tabella (l'impostazione predefinita è giustificata a sinistra). Il nome della parola chiave alternativa centro
è anche riconosciuto (questa è un'estensione GNU tbl).

punto decimale(c)
Imposta il carattere da riconoscere come punto decimale nelle colonne numeriche (GNU tbl
solo).

delimitare(xy)
Usa il x ed y come delimitatori di inizio e fine per eq(1).

doppia scatola
Racchiudere la tabella in una doppia scatola.

doppio telaio
Uguale a doublebox (solo GNU tbl).

espandere Rendi la tabella larga quanto la lunghezza della riga corrente (fornendo una separazione di colonne
fattore). Ignorato se vengono utilizzati uno o più identificatori di colonna "x" (vedi sotto).

Nel caso in cui la somma delle larghezze delle colonne sia maggiore della lunghezza della riga corrente, il
il fattore di separazione delle colonne è impostato su zero; tali tabelle si estendono nel margine destro,
e non c'è affatto separazione delle colonne.

telaio Uguale alla scatola (solo GNU tbl).

dimensione linea(n)
Imposta linee o regole (ad es. da nella scatola) in n-tipo punto.

nokeep Non utilizzare deviazioni per evitare interruzioni di pagina (solo GNU tbl). Normalmente TBL tentativi
per evitare interruzioni indesiderate nelle tabelle in scatola utilizzando deviazioni. questo può
a volte interagiscono male con i pacchetti di macro uso proprio di deviazioni, quando le note a piè di pagina,
ad esempio vengono utilizzati.

no spazi
Ignora gli spazi iniziali e finali negli elementi di dati (solo GNU tbl).

adesso Disattiva gli avvisi relativi alle tabelle che superano la larghezza della riga corrente (GNU tbl
solo).

scheda(x) Usa il personaggio x invece di una scheda per separare gli elementi in una riga di dati di input.

Le opzioni globali devono terminare con un punto e virgola. Potrebbero esserci spazi bianchi tra un'opzione
e il suo argomento tra parentesi.

Table formato specificazione
Dopo le opzioni globali vengono le righe che descrivono il formato di ogni riga della tabella. Ogni
tale riga di formato descrive una riga della tabella stessa, tranne che l'ultima riga di formato
(che deve terminare con un punto) descrive tutte le righe rimanenti della tabella. Una sola-
Il carattere chiave descrive ogni colonna di ogni riga della tabella. I caratteri chiave possono essere
separati da spazi o tab. Puoi eseguire specifiche di formato per più righe
insieme sulla stessa riga separandoli con virgole.

Puoi seguire ogni carattere chiave con identificatori che determinano il carattere e la dimensione in punti
dell'elemento corrispondente, che determinano la larghezza della colonna, la spaziatura tra le colonne, ecc.

La riga di formato più lunga definisce il numero di colonne nella tabella; formato mancante
si presume che i descrittori alla fine delle righe di formato siano L. Colonne extra nei dati
(che non hanno una voce di formato corrispondente) vengono ignorati.

I caratteri chiave disponibili sono:

a,A Centra la riga più lunga in questa colonna e poi giustifica a sinistra tutte le altre righe in questa
colonna rispetto a quella linea centrata. L'idea è di usare tale alfabetico
sottocolonne (da cui il nome del carattere chiave) in combinazione con L; loro sono
chiamate sottocolonne perché A gli elementi sono rientrati di 1n rispetto a L le voci.
Esempio:

. TS
scheda(;);
ln, un.
elemento uno; 1
sottovoce due;2
sottovoce tre;3
.T&
ln, un.
punto undici;11
sottovoce ventidue;22
sottovoce trentatré; 33
.PER

Risultato:

elemento uno 1
sottovoce due 2
sottovoce tre 3
punto undici 11
sottovoce ventidue 22
sottovoce trentatre 33

c,C Centra l'elemento all'interno della colonna.

l,L Giustifica a sinistra l'elemento all'interno della colonna.

n,N Voce giustificata numericamente nella colonna: le posizioni delle unità dei numeri sono allineate
verticalmente. Se ci sono uno o più punti adiacenti a una cifra, usa il più a destra
uno per l'allineamento verticale. Se non ci sono punti, usa la cifra più a destra per
allineamento verticale; in caso contrario, centra l'elemento all'interno della colonna. L'allineamento può essere
forzato in una certa posizione usando '\&'; se c'è uno o più casi di questo
carattere speciale (non stampabile) presente all'interno dei dati, utilizzare quello più a sinistra per
allineamento. Esempio:

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

Risultato:

1
1.5
1.5.3
abcde
abcde

Se le voci numeriche sono combinate con L or R voci – questo può accadere se il
il formato della tabella viene modificato con .T& – centra il più largo numero (dei dati inseriti
sotto il N regime di specificatore) relativo al più ampio L or R ingresso, preservando il
allineamento di tutte le voci numeriche. Contrario a A digita le voci, non ci sono extra
rientro.

Utilizzando equazioni (da elaborare con eq) all'interno di colonne che utilizzano il N specificatore
è problematico nella maggior parte dei casi a causa di TBLl' algoritmo per trovare la verticale
allineamento, come sopra descritto. Usando il globale delim opzione, tuttavia, è
possibile fare TBL ignora i dati all'interno eq delimitatori a tale scopo.

r,R Giustifica a destra l'elemento all'interno della colonna.

s,S Espandi l'elemento precedente a sinistra in questa colonna. Non consentito per la prima colonna.

^ Espandi la voce dalla riga precedente in questa colonna. Non consentito per la prima riga.

_,- Sostituisci questa voce con una linea orizzontale. Nota che '_' e '-' possono essere usati per
solo i campi della tabella, non per le righe di separazione delle colonne.

= Sostituisci questa voce con una doppia linea orizzontale. Nota che '=' può essere usato per
solo i campi della tabella, non per le righe di separazione delle colonne.

| La colonna corrispondente diventa una riga verticale (se due di queste sono adiacenti, a
doppia regola verticale).

Una barra verticale a sinistra della prima lettera chiave o a destra dell'ultima
produce una linea al bordo della tabella.

Per modificare il formato dei dati all'interno di una tabella, utilizzare il pulsante .T& comando (all'inizio di una riga).
È seguito da linee di formato e dati (ma nessuna opzione globale) simili a . TS
richiesta.

Colonna prescrittori
Ecco gli identificatori che possono apparire nei suffissi delle lettere chiave delle colonne (in qualsiasi ordine):

b,B forma breve di fB (rendere in grassetto le voci interessate).

d,D Inizia un elemento che si estende verticalmente sulle righe, utilizzando l'identificatore di colonna '^' o '\^'
elemento di dati, nella parte inferiore del suo intervallo anziché centrarlo verticalmente (GNU tbl
soltanto). Esempio:

. TS
tab(;) tuttobox;
ll
ld
r^
lrd.
0000;piede
T{
1111
. Br
2222
T};pippo
r;
T{
3333
. Br
4444
T};barra
\^;\^
.PER

Risultato:

?
│0000 │ foobar │
?
1111 │ │
2222 │ │
├─────┤ │
│ r │ pippo │
?
3333 │ │
│4444 │ barra │
?
e,E Crea colonne equidistanti. Tutte le colonne contrassegnate con questo identificatore ottengono lo stesso
larghezza; questo accade dopo che sono state calcolate le larghezze delle colonne interessate (questo significa
che regola il valore di larghezza più grande).

f,F Ciascuno di questi identificatori può essere seguito da un nome di carattere (uno o due
caratteri), numero del carattere (una cifra) o nome lungo tra parentesi (il
l'ultima forma è un'estensione GNU tbl). Un nome di carattere di una lettera deve essere separato da uno
o più spazi vuoti da ciò che segue.

i,I forma breve di fI (rendere in corsivo le voci interessate).

m,M Questa è un'estensione GNU tbl. Ciascuno di questi identificatori può essere seguito da una macro
nome (lungo uno o due caratteri) o nome lungo tra parentesi. Un solo-
il nome della macro lettera deve essere separato da uno o più spazi da quanto segue.
La macro il cui nome può essere specificato qui deve essere definita prima di creare il
tavolo. Viene chiamato appena prima dell'output del testo della cella della tabella. Come implementato
attualmente, questa macro viene chiamata solo se viene utilizzato l'input del blocco, ovvero il testo tra
'T{' e 'T}'. La macro dovrebbe contenere solo simple trof chiede di cambiare il
formattazione del blocco di testo, come la regolazione del testo, la sillabazione, la dimensione o il carattere. La macro
è chiamato dopo altre modifiche cellulari come b, f or v sono in uscita. Così la macro
può sovrascrivere altri identificatori di modifica.

p,P Seguito da un numero, cambia la dimensione in punti per i campi interessati. Se
firmato, la dimensione in punti corrente viene incrementata o decrementata (usando un numero con segno
invece di una cifra con segno è un'estensione GNU tbl). Segue uno specificatore di dimensione in punti
da un numero di separazione di colonna deve essere separato da uno o più spazi.

t,T Inizia un elemento verticalmente che copre le righe nella parte superiore del suo intervallo anziché
centrandolo verticalmente.

u,U Sposta la colonna corrispondente in alto di una semiretta.

v,V Seguito da un numero, indica l'interlinea verticale da utilizzare in a
immissione di tabelle su più righe. Se firmato, l'interlinea verticale corrente è
incrementato o decrementato (usare un numero con segno invece di una cifra con segno è a
estensione GNU tbl). Un identificatore di interlinea verticale seguito da una colonna
il numero di separazione deve essere separato da uno o più spazi. Nessun effetto se il
la voce della tabella corrispondente non è un blocco di testo.

w,W Valore minimo della larghezza della colonna. Deve essere seguito da a trof(1) espressione di larghezza
tra parentesi o un numero intero senza unità. Se non viene fornita alcuna unità, vengono utilizzate unità en.
Utilizzato anche come lunghezza di riga predefinita per i blocchi di testo inclusi. Se usato multiplo
volte per specificare la larghezza di una particolare colonna, l'ultima voce ha effetto.

x,X Una colonna espansa. Dopo aver calcolato tutte le larghezze delle colonne senza an x specificatore, uso
la larghezza della linea rimanente per questa colonna. Se c'è più di un espanso
colonna, distribuire uniformemente lo spazio orizzontale rimanente tra le colonne interessate
(questa è un'estensione GNU). Questa funzione ha lo stesso effetto della specifica di a
larghezza minima della colonna.

z,Z Ignora la colonna corrispondente ai fini del calcolo della larghezza, questo è, non usare
i campi ma solo gli specificatori di questa colonna per calcolarne la larghezza.

Un suffisso numerico su un carattere chiave viene interpretato come una separazione di colonne in unità en
(moltiplicato in proporzione se il espandere l'opzione è attiva – in caso di tavoli troppo pieni questo
potrebbe essere zero). La separazione predefinita è 3n.

L'identificatore di colonna x si esclude a vicenda con e ed w (ma e non si escludono a vicenda
con w); se specificato più volte per una particolare colonna, l'ultima voce ha effetto:
x disattiva entrambi e ed w, mentre sia e or w sostituisce x.

Table dati
Le righe di formato sono seguite da righe contenenti i dati effettivi per la tabella, seguite
finalmente da .PER. All'interno di tali righe di dati, gli elementi sono normalmente separati da caratteri di tabulazione
(o il carattere specificato con il linguetta opzione). È possibile interrompere lunghe righe di input
più righe se l'ultimo carattere sulla riga è '\' (che scompare dopo
concatenazione).

Si noti che TBL calcola la larghezza delle colonne riga per riga, applicando \w a ogni voce che
non è un blocco di testo. Di conseguenza, costruzioni come

. TS
c, l.
\s[20]MM
mmmm
.PER

fallire; o devi dire

. TS
cp20,lp20.
MM
mmmm
.PER

or

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

Un punto che inizia una riga, seguito da qualsiasi cosa tranne una cifra viene gestito come un comando troff,
passato senza modifiche. La posizione del tavolo è invariata in questo caso.

Se una linea dati è composta solo da '_' o '=', rispettivamente una linea singola o doppia è
disegnato sul tavolo in quel punto; se un singolo elemento in una riga dati è composto solo da '_'
o '=', allora quell'elemento è sostituito da una linea singola o doppia, che unisce i suoi vicini. Se
un elemento di dati è costituito solo da '\_' o '\=', viene disegnata rispettivamente una linea singola o doppia
attraverso il campo in quel punto che non si unisce ai suoi vicini.

Un dato composto solo da '\Rx' ('x' qualsiasi carattere) è sostituito da ripetizioni di
carattere 'x' largo quanto la colonna (non unendo i suoi vicini).

Un elemento di dati composto solo da '\^' indica che il campo immediatamente sopra si estende
verso il basso su questa riga.

Testo blocchi
Un blocco di testo può essere utilizzato per inserire i dati come una singola voce che sarebbe troppo lunga quanto un
semplice stringa tra le schede. Inizia con 'T{' e si chiude con 'T}'. L'ex
deve terminare una riga e quest'ultima deve iniziare una riga, probabilmente seguita da altre colonne di dati
(separato da tab o il carattere dato con il linguetta opzione globale).

Per impostazione predefinita, il blocco di testo è formattato con le impostazioni che erano attive prima
entrando nella tabella, eventualmente scavalcato dal m, ve w specificatori tbl. Per esempio,
per rendere tutti i blocchi di testo irregolari, inserisci .On subito prima dell'inizio . TS (E .anno Domini
dopo il tavolo).

Se gli specificatori 'w' o 'x[cq] non vengono forniti per contro tutti i colonne di un blocco di testo span, il
lunghezza predefinita del blocco di testo (per essere più precisi, la lunghezza della riga utilizzata per elaborare il
la deviazione del blocco di testo) viene calcolata come L×C/(N+1), dove 'L' è la lunghezza della riga corrente, 'C'
il numero di colonne occupate dal blocco di testo e 'N' il numero totale di colonne in
la tavola. Si noti, tuttavia, che la larghezza effettiva della deviazione restituita nel registro \n[dl]
viene utilizzato eventualmente come larghezza del blocco di testo. Se necessario, puoi anche controllare il testo
larghezza blocco con inserimento diretto di a .LL richiesta subito dopo 'T{'.

Miscellanea
Il numero di registro \n[TW] tiene la larghezza del tavolo; non può essere utilizzato all'interno della tabella stessa
ma è definito subito prima di chiamare .PER in modo che questa macro possa farne uso.

TBL definisce anche una macro .T# che produce le linee inferiore e laterale di una tabella in scatola.
Mentre TBL chiama questa macro stessa alla fine della tabella, può essere utilizzata dalla macro
pacchetti per creare riquadri per tabelle multipagina richiamandolo all'interno del piè di pagina. Un
esempio di questo è mostrato dal -SM macro che forniscono questa funzionalità se una tabella
inizia con . TS H invece della chiamata standard al . TS macro.

INTERAZIONE CON EQN

TBL(1) dovrebbe essere sempre chiamato prima eq(1) (groff(1) si occupa automaticamente del
corretto ordine dei preprocessori).

GNU TBL MIGLIORAMENTI

Non c'è limite al numero di colonne in una tabella, né alcun limite al numero di testo
blocchi. Nel decidere le larghezze delle colonne vengono considerate tutte le righe di una tabella, non solo la
primi 200. Proseguimento tabella (.T&) non sono limitate alle prime 200 righe.

Gli elementi numerici e alfabetici possono essere visualizzati nella stessa colonna.

Gli elementi numerici e alfabetici possono estendersi orizzontalmente.

TBL usa nomi di registro, stringa, macro e deviazione che iniziano con la cifra 3. Quando
utilizzando TBL dovresti evitare di usare nomi che iniziano con a 3.

GNU TBL ENTRO MACRO

Dal TBL definisce le proprie macro (subito prima di ogni tabella) è necessario utilizzare un 'end-
of-macro' macro. Inoltre, il carattere di escape deve essere disattivato. qui e
esempio.

.e
.de TABELLA ..
. TS
scheda allbox(;);
cl.
\$1;\$2
.PER
...
.ec
.ATABLE Un tavolo
.TABILE Un altro tavolo
.ATABLE E "un altro"

Si noti, tuttavia, che non tutte le funzioni di TBL può essere racchiuso in una macro perché TBL vede
l'ingresso prima di trof. Ad esempio, formattazione dei numeri con allineamento verticale
i punti decimali falliscono se quei numeri vengono passati come parametri macro perché decimal
l'allineamento dei punti è gestito da TBL stesso: vede solo '\$1', '\$2', ecc., e quindi
non riesco a riconoscere la virgola.

Usa gtbl online utilizzando i servizi onworks.net