gtbl - En ligne dans le Cloud

PROGRAMME:

Nom

tbl - tableaux de format pour troff

SYNOPSIS

tbl [-CV] [fichiers ...]

DESCRIPTION

Cette page de manuel décrit la version GNU de tbl, qui fait partie du document groff
système de formatage. tbl compile les descriptions des tableaux intégrés dans trof fichiers d'entrée
en commandes comprises par trof. Normalement, il doit être invoqué à l'aide de la -t
option de groff. Il est hautement compatible avec Unix tbl. La sortie générée par GNU tbl
ne peut pas être traité avec Unix trof; il doit être traité avec GNU trof. Si aucun fichier n'est
donné sur la ligne de commande ou un nom de fichier de - est donnée, l'entrée standard est lue.

OPTIONS

-C Activer le mode de compatibilité pour reconnaître . TS ainsi que .À même lorsqu'il est suivi d'un
caractère autre que l'espace ou la nouvelle ligne. Les caractères de tête (\a) sont traités comme
interprété.

-v Imprimez le numéro de version.

LANGUAGE APERÇU

tbl s'attend à trouver des descriptions de table enveloppées dans le . TS (début du tableau) et .À (table
fin) macros. Dans chacune de ces sections de table, une autre table peut être définie en utilisant le
nécessaire .T& avant la commande finale .À. Chaque définition de table a les éléments suivants
structure:

Global Options
Ceci est facultatif. Cette partie table peut utiliser plusieurs de ces options réparties dans
1 ou plusieurs lignes. Les de défis option partie doit toujours être terminé par un point-virgule ;
.

lampe de table le format spécification
Cette partie doit être renseignée, elle n'est pas facultative. Il détermine le nombre de colonnes
(cellules) du tableau. De plus chaque cellule est classée en étant centrale, gauche
ajusté, ou numérique, etc. Cette spécification peut avoir plusieurs lignes, mais doit
être terminé par un point . à la fin de la dernière ligne. Après chaque définition de cellule,
colonne spécificateurs peut être ajouté, mais c'est facultatif.

Les cellules sont séparées par un caractère de tabulation par défaut. Cela peut être modifié par le de défis
option table(c), Où c est un caractère arbitraire.

SIMPLE EXEMPLES

La définition de table la plus simple est.
. TS
ccc.
C'est centré
Eh bien, cela aussi
.À
En utilisant c c c, chaque cellule de la table entière sera centrée. Le caractère séparateur
est ici la valeur par défaut languette.

Le résultat est

C'est centré
Eh bien, cela aussi

Cette définition est identique à
. TS
languette(@);
ccc.
Ceci@est@centré
Eh bien, @this@aussi
.À
Ici, le caractère de tabulation de séparation est remplacé par la lettre @.

De plus, un titre peut être ajouté et les directions de centrage peuvent être modifiées en de nombreux autres
formats:
. TS
languette(@);
css
lcn.
Titre
gauche@centres@123
un autre@nombre@75
.À
Le résultat est

Titre
centres gauche 123
un autre nombre 75
Ici l veux dire justifié à gaucheet n veux dire numérique, qui est ici justifié à droite.

UTILISATION

Global Options
La ligne qui suit immédiatement le . TS la macro peut contenir l'un des éléments globaux suivants
options (en ignorant la casse des caractères - Unix tbl accepte uniquement les options avec tous
caractères minuscules ou tous les caractères majuscules), séparés par des espaces, des tabulations ou des virgules :

boîte Mettez chaque élément du tableau dans une boîte.

boîte Mettez le tableau dans une boîte.

centre Centrez le tableau (la valeur par défaut est justifiée à gauche). Le nom du mot-clé alternatif centre
est également reconnu (il s'agit d'une extension GNU tbl).

virgule(c)
Définissez le caractère à reconnaître comme point décimal dans les colonnes numériques (GNU tbl
seulement).

délimiter (xy)
Utilisez x ainsi que y comme délimiteurs de début et de fin pour équi (1).

boîte double
Enfermez le tableau dans une double boîte.

double cadre
Identique à doublebox (GNU tbl uniquement).

expand Rendre le tableau aussi large que la longueur de ligne actuelle (en fournissant une séparation de colonnes
facteur). Ignoré si un ou plusieurs spécificateurs de colonne « x » sont utilisés (voir ci-dessous).

Si la somme des largeurs de colonne est supérieure à la longueur de ligne actuelle, le
le facteur de séparation des colonnes est défini sur zéro ; ces tableaux s'étendent dans la marge de droite,
et il n'y a aucune séparation de colonne du tout.

cadre Identique à box (GNU tbl uniquement).

la taille de la ligne(n)
Définir des lignes ou des règles (par exemple à partir de boîte) dans n-type de point.

non N'utilisez pas de détournements pour éviter les sauts de page (GNU tbl uniquement). Normalement tbl tentatives
pour éviter les ruptures indésirables dans les tableaux encadrés en utilisant des détournements. Ceci peut
interagissent parfois mal avec les packages de macros propre utilisation des détournements, lorsque les notes de bas de page,
par exemple, sont utilisés.

sans espaces
Ignorer les espaces de début et de fin dans les éléments de données (GNU tbl uniquement).

maintenant Désactiver les avertissements liés aux tableaux dépassant la largeur de ligne actuelle (GNU tbl
seulement).

languette(x) Utiliser le personnage x au lieu d'un onglet pour séparer les éléments dans une ligne de données d'entrée.

Les options globales doivent se terminer par un point-virgule. Il peut y avoir un espace entre une option
et son argument entre parenthèses.

lampe de table le format spécification
Après les options globales viennent les lignes décrivant le format de chaque ligne du tableau. Chaque
une telle ligne de format décrit une ligne du tableau lui-même, sauf que la dernière ligne de format
(que vous devez terminer par un point) décrit toutes les lignes restantes du tableau. Un seul-
le caractère clé décrit chaque colonne de chaque ligne du tableau. Les caractères clés peuvent être
séparés par des espaces ou des tabulations. Vous pouvez exécuter des spécifications de format pour plusieurs lignes
ensemble sur la même ligne en les séparant par des virgules.

Vous pouvez suivre chaque caractère clé avec des spécificateurs qui déterminent la police et la taille des points
de l'élément correspondant, qui déterminent la largeur des colonnes, l'espacement entre les colonnes, etc.

La ligne de format la plus longue définit le nombre de colonnes du tableau ; format manquant
les descripteurs à la fin des lignes de format sont supposés être L. Colonnes supplémentaires dans les données
(qui n'ont pas d'entrée de format correspondante) sont ignorés.

Les caractères clés disponibles sont :

a,A Centrez la ligne la plus longue dans cette colonne, puis justifiez à gauche toutes les autres lignes de cette colonne
colonne par rapport à cette ligne centrée. L'idée est d'utiliser un tel ordre alphabétique
sous-colonnes (d'où le nom du caractère clé) en combinaison avec L; elles sont
appelés sous-colonnes parce que A les éléments sont indentés de 1n par rapport à L entrées.
Mise en situation :

. TS
languette(;);
Dans, un.
élément un ;1
sous-élément deux ;2
sous-élément trois ;3
.T&
Dans, un.
point onze ;11
sous-point vingt-deux ;22
sous-point trente-trois ;33
.À

Résultat:

article un 1
sous-élément deux 2
sous-élément trois 3
point onze 11
sous-point vingt-deux 22
sous-point trente-trois 33

c,C Centrer l'élément dans la colonne.

l,L Justifiez à gauche l'élément dans la colonne.

n,N Justifier numériquement l'élément dans la colonne : les positions des unités des nombres sont alignées
verticalement. S'il y a un ou plusieurs points adjacents à un chiffre, utilisez le point le plus à droite
un pour l'alignement vertical. S'il n'y a pas de point, utilisez le chiffre le plus à droite pour
alignement vertical; sinon, centrez l'élément dans la colonne. L'alignement peut être
forcé à une certaine position en utilisant '\&'; s'il y a un ou plusieurs cas de ce
caractère spécial (non imprimable) présent dans les données, utilisez le plus à gauche pour
alignement. Exemple:

. TS
n.
1
1.5
1.5.3
a B c d e
a\&bcde
.À

Résultat:

1
1.5
1.5.3
a B c d e
a B c d e

Si des entrées numériques sont combinées avec L or R entrées – cela peut arriver si le
le format du tableau est modifié avec .T& – centrer le plus large nombre (des données saisies
sous le N spécificateur) par rapport au plus large L or R entrée, en préservant la
alignement de toutes les entrées numériques. Contrairement à A tapez les entrées, il n'y a pas de supplément
échancrure.

En utilisant des équations (à traiter avec équi) dans les colonnes qui utilisent le N spécificateur
est problématique dans la plupart des cas en raison de tblalgorithme de recherche de la verticale
alignement, comme décrit ci-dessus. Utiliser le global délimiter option, cependant, il est
possible de faire tbl ignorer les données dans équi délimiteurs à cet effet.

r,R Justifiez à droite l'élément dans la colonne.

s,S Étendez l'élément précédent à gauche dans cette colonne. Non autorisé pour la première colonne.

^ Déployez l'entrée de la ligne précédente dans cette colonne. Non autorisé pour la première rangée.

_,- Remplacez cette entrée par une ligne horizontale. Notez que '_' et '-' peuvent être utilisés pour
champs de table uniquement, pas pour les lignes de séparation de colonnes.

= Remplacez cette entrée par une double ligne horizontale. Notez que '=' peut être utilisé pour
champs de table uniquement, pas pour les lignes de séparation de colonnes.

| La colonne correspondante devient une règle verticale (si deux d'entre elles sont adjacentes, une
double règle verticale).

Une barre verticale à gauche de la première lettre clé ou à droite de la dernière
produit une ligne au bord de la table.

Pour modifier le format des données dans un tableau, utilisez le .T& commande (en début de ligne).
Il est suivi de lignes de format et de données (mais pas d'options globales) similaires à . TS
demande.

Colonne spécificateurs
Voici les spécificateurs qui peuvent apparaître dans les suffixes des lettres clés de colonne (dans n'importe quel ordre) :

b,B Forme courte de fB (mettre en gras les entrées concernées).

d,D Démarrez un élément qui s'étend verticalement sur des lignes, en utilisant le spécificateur de colonne '^' ou '\^'
élément de données, au bas de sa plage plutôt que de le centrer verticalement (GNU tbl
seul). Exemple:

. TS
tab(;) allbox ;
ll
ld
r^
Je rd.
0000;barre de pied
T{
1111
.br
2222
T};toto
r;
T{
3333
.br
4444
T};barre
\^;\^
.À

Résultat:

??
│0000 │ barre de foo │
??
1111 │
2222 │
│
r │ foo │
??
3333 │
4444 barre │
??
e,E Faites des colonnes équidistantes. Toutes les colonnes marquées avec ce spécificateur ont la même
largeur; cela se produit après que les largeurs de colonnes affectées ont été calculées (cela signifie
que les règles de la plus grande valeur de largeur).

f,F Chacun de ces spécificateurs peut être suivi d'un nom de police (un ou deux
caractères), le numéro de police (un seul chiffre) ou le nom long entre parenthèses (le
dernière forme est une extension GNU tbl). Un nom de police d'une lettre doit être séparé par un
ou plusieurs blancs de tout ce qui suit.

i,I Forme courte de fI (mettre les entrées affectées en italique).

m,M Ceci est une extension GNU tbl. Chacun de ces spécificateurs peut être suivi d'une macro
nom (un ou deux caractères) ou nom long entre parenthèses. Un-
Le nom de la macro lettre doit être séparé par un ou plusieurs blancs de ce qui suit.
La macro dont le nom peut être spécifié ici doit être définie avant de créer le
table. Il est appelé juste avant la sortie du texte de la cellule du tableau. Tel que mis en œuvre
actuellement, cette macro n'est appelée que si une entrée de bloc est utilisée, c'est-à-dire du texte entre
'T{' et 'T}'. La macro ne doit contenir que de simples trof demande de changer le
la mise en forme des blocs de texte, comme l'ajustement du texte, la césure, la taille ou la police. La macro
est appelé après d'autres modifications cellulaires comme b, f or v sont sorties. Ainsi la macro
peut écraser d'autres spécificateurs de modification.

p,P Suivi d'un nombre, cela modifie la taille en points des champs concernés. Si
signé, la taille actuelle en points est incrémentée ou décrémentée (en utilisant un nombre signé
au lieu d'un chiffre signé est une extension GNU tbl). Un spécificateur de taille de point suivi
par un numéro de séparation de colonne doit être séparé par un ou plusieurs blancs.

t,T Démarrer un élément en s'étendant verticalement sur les lignes en haut de sa plage plutôt que
en le centrant verticalement.

u,U Déplacez la colonne correspondante d'une demi-ligne vers le haut.

v,V Suivi d'un nombre, il indique l'interligne vertical à utiliser dans un
entrée de table multiligne. S'il est signé, l'interligne vertical actuel est
incrémenté ou décrémenté (l'utilisation d'un nombre signé au lieu d'un chiffre signé est un
extension GNU tbl). Un spécificateur d'interligne vertical suivi d'une colonne
le numéro de séparation doit être séparé par un ou plusieurs blancs. Aucun effet si le
l'entrée de table correspondante n'est pas un bloc de texte.

w,W Valeur de largeur de colonne minimale. Doit être suivi soit d'un trof(1) expression de largeur
entre parenthèses ou un entier sans unité. Si aucune unité n'est donnée, les unités en sont utilisées.
Également utilisé comme longueur de ligne par défaut pour les blocs de texte inclus. Si utilisé plusieurs
fois pour spécifier la largeur d'une colonne particulière, la dernière entrée prend effet.

x,X Une colonne agrandie. Après avoir calculé toutes les largeurs de colonnes sans x spécificateur, utiliser
la largeur de ligne restante pour cette colonne. S'il y a plus d'une extension
colonne, répartissez uniformément l'espace horizontal restant entre les colonnes affectées
(il s'agit d'une extension GNU). Cette fonction a le même effet que de spécifier un
largeur de colonne minimale.

z,Z Ignorez la colonne correspondante à des fins de calcul de largeur, c'est-à-dire n'utilisez pas
les champs mais uniquement les spécificateurs de cette colonne pour calculer sa largeur.

Un suffixe numérique sur un caractère clé est interprété comme une séparation de colonne en unités en
(multiplié en proportion si le expand l'option est activée - en cas de tables surchargées, cette
peut-être zéro). La séparation par défaut est 3n.

Le spécificateur de colonne x est mutuellement exclusif avec e ainsi que w (mais e n'est pas mutuellement exclusif
avec w); si spécifié plusieurs fois pour une colonne particulière, la dernière entrée prend effet :
x désactive les deux e ainsi que w, tandis que soit e or w remplacements x.

lampe de table données
Les lignes de format sont suivies de lignes contenant les données réelles du tableau, suivies
enfin par .À. Dans ces lignes de données, les éléments sont normalement séparés par des tabulations
(ou le caractère spécifié avec le languette option). Les longues lignes d'entrée peuvent être interrompues
plusieurs lignes si le dernier caractère de la ligne est '\' (qui disparaît après
enchaînement).

Notez que tbl calcule les largeurs de colonnes ligne par ligne, en appliquant \w sur chaque entrée qui
n'est pas un bloc de texte. En conséquence, des constructions comme

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

échouer; vous devez soit dire

. TS
CP20,LP20.
MM
mmmm
.À

or

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

Un point commençant une ligne, suivi de tout sauf d'un chiffre est traité comme une commande troff,
passé sans changement. La position de la table est inchangée dans ce cas.

Si une ligne de données se compose uniquement de '_' ou '=', une ligne simple ou double, respectivement, est
dessiné à travers la table à ce moment-là; si un seul élément dans une ligne de données se compose uniquement de '_'
ou '=', alors cet élément est remplacé par une ligne simple ou double, joignant ses voisins. Si
un élément de données se compose uniquement de '\_' ou '\=', une ligne simple ou double, respectivement, est dessinée
à travers le champ à ce point qui ne rejoint pas ses voisins.

Un élément de données composé uniquement de '\Rx' ('x' n'importe quel caractère) est remplacé par des répétitions de
caractère 'x' aussi large que la colonne (ne rejoignant pas ses voisins).

Un élément de données composé uniquement de '\^' indique que le champ immédiatement au-dessus s'étend sur
vers le bas sur cette rangée.

Texte blocs
Un bloc de texte peut être utilisé pour saisir des données en une seule saisie qui serait trop longue comme
chaîne simple entre les onglets. Il commence par 'T{' et se termine par 'T}'. L'ancien
doit terminer une ligne, et cette dernière doit commencer une ligne, probablement suivie d'autres colonnes de données
(séparé par des tabulations ou le caractère donné par le languette option globale).

Par défaut, le bloc de texte est formaté avec les paramètres qui étaient actifs avant
entrant dans la table, éventuellement outrepassée par le m, vet w spécificateurs tbl. Par exemple,
pour rendre tous les blocs de texte irréguliers à droite, insérez .n / a juste avant le départ . TS (Et .un d
après le tableau).

Si les spécificateurs 'w' ou 'x[cq] ne sont pas donnés pour TOUTE colonnes d'une étendue de bloc de texte, le
longueur par défaut du bloc de texte (pour être plus précis, la longueur de ligne utilisée pour traiter le
le détournement de bloc de texte) est calculé comme L×C/(N+1), où « L » est la longueur de ligne actuelle, « C »
le nombre de colonnes couvertes par le bloc de texte, et 'N' le nombre total de colonnes dans
la table. Notez, cependant, que la largeur de déviation réelle telle qu'elle est renvoyée dans le registre \n[dl]
est finalement utilisé comme largeur de bloc de texte. Si nécessaire, vous pouvez également contrôler le texte
largeur de bloc avec insertion directe d'un .ll demande juste après 'T{'.

Divers
Le registre des numéros \n[TW] détient la largeur de la table ; il ne peut pas être utilisé dans la table elle-même
mais est défini juste avant d'appeler .À pour que cette macro puisse l'utiliser.

tbl définit également une macro .T# qui produit les lignes inférieures et latérales d'une table en boîte.
Tandis que tbl appelle cette macro elle-même à la fin du tableau, elle peut être utilisée par la macro
packages pour créer des boîtes pour les tableaux de plusieurs pages en l'appelant dans le pied de page. Un
exemple de ceci est montré par le -SP macros qui fournissent cette fonctionnalité si une table
commence avec . TS H au lieu de l'appel standard au . TS macro.

INTERACTION WITH NQE

tbl(1) doit toujours être appelé avant équi(1) (groff(1) prend automatiquement en charge la
ordre correct des préprocesseurs).

GNU TBL AMÉLIORATIONS

Il n'y a pas de limite sur le nombre de colonnes dans un tableau, ni de limite sur le nombre de texte
blocs. Toutes les lignes d'un tableau sont prises en compte pour décider de la largeur des colonnes, pas seulement le
200 premiers. Suite de la table (.T&) les lignes ne sont pas limitées aux 200 premières lignes.

Les éléments numériques et alphabétiques peuvent apparaître dans la même colonne.

Les éléments numériques et alphabétiques peuvent s'étendre horizontalement.

tbl utilise les noms de registre, de chaîne, de macro et de détournement commençant par le chiffre 3. Quand
en utilisant tbl vous devez éviter d'utiliser des noms commençant par un 3.

GNU TBL DANS MACRO

Depuis que tbl définit ses propres macros (juste avant chaque table) il est nécessaire d'utiliser un 'end-
de-macro' macro. De plus, le caractère d'échappement doit être désactivé. Ici un
Exemple.

.eo
.de TABLE ..
. TS
onglet boîte(;);
cl.
\$1;\$2
.À

.ec
.ATABLE Une table
.ATABLE Une autre table
.ATABLE Et "un autre"

Notez cependant que toutes les fonctionnalités de tbl peut être enveloppé dans une macro car tbl voit
l'entrée plus tôt que trof. Par exemple, le formatage des nombres avec un alignement vertical
les points décimaux échouent si ces nombres sont transmis en tant que paramètres de macro car décimal
l'alignement des points est géré par tbl lui-même : il ne voit que '\$1', '\$2', etc., et donc
ne peut pas reconnaître la virgule décimale.

Utiliser gtbl en ligne en utilisant les services onworks.net