gtbl - Online in de cloud

PROGRAMMA:

NAAM

tbl - formaattabellen voor troff

KORTE INHOUD

tbl [-CV] [bestanden ​

PRODUCTBESCHRIJVING

Deze handleiding beschrijft de GNU-versie van tbl, dat deel uitmaakt van het groff-document
formatteersysteem. tbl compileert beschrijvingen van tabellen die erin zijn ingebed troff invoerbestanden
in commando's die begrepen worden troff. Normaal gesproken moet het worden aangeroepen met behulp van de -t
optie van groff. Het is zeer compatibel met Unix tbl. De uitvoer gegenereerd door GNU tbl
kan niet worden verwerkt met Unix troff; het moet worden verwerkt met GNU troff. Als er geen bestanden zijn
opgegeven op de opdrachtregel of een bestandsnaam van - wordt gegeven, wordt de standaardinvoer gelezen.

OPTIES

-C Schakel de compatibiliteitsmodus in om te herkennen . TS en .THEE zelfs wanneer gevolgd door een
ander teken dan spatie of nieuwe regel. Leiderkarakters (\a) worden behandeld als
geïnterpreteerd.

-v Druk het versienummer af.

TAAL Overzicht

tbl verwacht tabelbeschrijvingen te vinden die zijn verpakt in de . TS (tabelbegin) en .THEE (tafel
einde) macro's. Binnen elk van deze tabelsecties kan een andere tabel worden gedefinieerd met behulp van de
te vragen .T& vóór het laatste bevel .THEE. Elke tabeldefinitie heeft het volgende
structuur:

Globaal opties
Dit is optioneel. Dit tabelgedeelte kan verschillende van deze opties gebruiken, verdeeld in
1 of meer lijnen. De globaal optie deel moet altijd worden afgerond met a puntkomma ;
.

tafel formaat specificatie
Dit deel moet worden opgegeven, het is niet optioneel. Het bepaalt het aantal kolommen
(cellen) van de tabel. Bovendien wordt elke cel geclassificeerd door centraal en links te zijn
aangepast, of numeriek, enz. Deze specificatie kan meerdere regels bevatten, maar dat moet wel
worden afgerond door een stip . aan het einde van de laatste regel. Na elke celdefinitie wordt
kolom bestekschrijvers kan worden toegevoegd, maar dat is optioneel.

Cellen worden standaard gescheiden door een tabteken. Dat kan veranderd worden door de globaal
optie tbl(c), Waar c is een willekeurig karakter.

EENVOUDIG Voorbeelden

De eenvoudigste tabeldefinitie is.
. TS
ccc.
Dit is gecentreerd
Nou, dit ook
.THEE
Met c c c, wordt elke cel in de hele tabel gecentreerd. Het scheidende karakter
is hier de standaard tab.

Het resultaat is

Dit is gecentreerd
Nou, dit ook

Deze definitie is identiek aan
. TS
tabblad(@);
cc.
Dit@is@gecentreerd
Nou, @dit@ook
.THEE
Hier wordt het scheidende tabteken gewijzigd in de letter @.

Bovendien kan een titel worden toegevoegd en kunnen de centreerrichtingen in vele andere richtingen worden gewijzigd
formaten:
. TS
tabblad(@);
css
ln.
Titel
links@centers@123
een ander@nummer@75
.THEE
Het resultaat is

Titel
links midden 123
nog een nummer 75
Here l middel links uitgelijnd en n middel numeriek, die hier is rechts gerechtvaardigd.

GEBRUIK

Globaal opties
De lijn die onmiddellijk volgt op de . TS macro kan een van de volgende globale bevatten
opties (waarbij de hoofdletters van tekens worden genegeerd – Unix tbl accepteert alleen opties met all
tekens in kleine letters of alle tekens in hoofdletters), gescheiden door spaties, tabs of komma's:

allesdoos Plaats elk item van de tafel in een doos.

doos Plaats de tafel in een doos.

centrum Centreer de tabel (standaard is links uitgelijnd). De alternatieve zoekwoordnaam centrum
wordt ook herkend (dit is een GNU tbl-extensie).

decimale punt(c)
Stel het teken in dat moet worden herkend als decimale punt in numerieke kolommen (GNU tbl
alleen).

afbakenen(xy)
Te gebruiken x en y als begin- en eindscheidingstekens voor gelijk aan(1).

dubbele doos
Plaats de tafel in een dubbele doos.

dubbelframe
Hetzelfde als doublebox (alleen GNU tbl).

uitbreiden Maak de tabel zo breed als de huidige regellengte (zorg voor een kolomscheiding).
factor). Genegeerd als een of meer 'x'-kolomspecificaties worden gebruikt (zie hieronder).

Als de som van de kolombreedten groter is dan de huidige lijnlengte, wordt de
kolomscheidingsfactor is ingesteld op nul; dergelijke tabellen strekken zich uit tot in de rechtermarge,
en er is helemaal geen kolomscheiding.

omlijsting Hetzelfde als box (alleen GNU tbl).

lijn grootte(n)
Stel lijnen of regels in (bijv. van doos) in n-punttype.

nee hoor Gebruik geen omleidingen om pagina-einden te voorkomen (alleen GNU tbl). Normaal gesproken tbl pogingen
om ongewenste pauzes in omkaderde tafels te voorkomen door gebruik te maken van omleidingen. Dit kan
werkt soms slecht samen met macropakketten, eigen gebruik van omleidingen, wanneer voetnoten,
worden bijvoorbeeld gebruikt.

geen spaties
Negeer voorloop- en volgspaties in gegevensitems (alleen GNU tbl).

nu leren Schakel waarschuwingen uit met betrekking tot tabellen die de huidige lijnbreedte overschrijden (GNU tbl
alleen).

tabblad(x) Gebruik het karakter x in plaats van een tabblad om items in een regel met invoergegevens te scheiden.

De globale opties moeten eindigen met een puntkomma. Er kan een witruimte tussen een optie staan
en het argument tussen haakjes.

tafel formaat specificatie
Na de globale opties komen regels die het formaat van elke regel van de tabel beschrijven. Elk
zo'n opmaakregel beschrijft één regel van de tabel zelf, behalve de laatste opmaakregel
(die u moet afsluiten met een punt) beschrijft alle overige regels van de tabel. Een-
sleutelteken beschrijft elke kolom van elke regel van de tabel. Sleutelfiguren kunnen zijn
gescheiden door spaties of tabs. U kunt formaatspecificaties voor meerdere regels uitvoeren
samen op dezelfde regel door ze te scheiden met komma's.

U kunt elk sleutelteken volgen met specificaties die het lettertype en de puntgrootte bepalen
van het overeenkomstige item, die de kolombreedte, de afstand tussen de kolommen, enz. bepalen.

De langste opmaakregel definieert het aantal kolommen in de tabel; ontbrekend formaat
Er wordt aangenomen dat descriptors aan het einde van de opmaakregels dat zijn L. Extra kolommen in de gegevens
(die geen overeenkomende formaatinvoer hebben) worden genegeerd.

De beschikbare sleutelfiguren zijn:

a,A Centreer de langste lijn in deze kolom en lijn vervolgens alle andere lijnen in deze kolom links uit
kolom ten opzichte van die gecentreerde lijn. Het idee is om zo'n alfabet te gebruiken
subkolommen (vandaar de naam van het hoofdteken) in combinatie met L; zij zijn
subkolommen genoemd omdat A items worden ingesprongen met 1n ten opzichte van L inzendingen.
Voorbeeld:

. TS
tabblad(;);
ln, een.
punt één;1
subpunt twee;2
subpunt drie;3
.T&
ln, een.
punt elf;11
subpunt tweeëntwintig;22
subpunt drieëndertig;33
.THEE

Resultaat:

punt één 1
subpunt twee 2
subpunt drie 3
punt elf 11
subpunt tweeëntwintig 22
subpunt drieëndertig 33

c,C Centreer het item binnen de kolom.

l,L Item links uitlijnen in de kolom.

n,N Item in de kolom numeriek uitvullen: Eenhedenposities van getallen worden uitgelijnd
verticaal. Als er een of meer punten naast een cijfer staan, gebruik dan het meest rechtse
één voor verticale uitlijning. Als er geen punt is, gebruik dan het meest rechtse cijfer voor
verticale uitlijning; anders centreert u het item binnen de kolom. Uitlijning kan zijn
naar een bepaalde positie gedwongen met '\&'; als er één of meer gevallen hiervan zijn
speciaal (niet-afdrukbaar) teken aanwezig in de gegevens, gebruik hiervoor het meest linkse teken
uitlijning. Voorbeeld:

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

Resultaat:

1
1.5
1.5.3
abcde
abcde

Als numerieke invoer wordt gecombineerd met L or R vermeldingen – dit kan gebeuren als de
tabelformaat wordt gewijzigd met .T& – midden het breedste aantal (van de ingevoerde gegevens
onder de N specificatieregime) ten opzichte van de breedste L or R binnenkomst, behoud van de
uitlijning van alle numerieke invoer. In tegenstelling tot A type vermeldingen, er is geen extra
inspringing.

Met behulp van vergelijkingen (te verwerken met gelijk aan) in kolommen die de N specificeerder
is in de meeste gevallen problematisch vanwege tbl's algoritme voor het vinden van de verticaal
uitlijning, zoals hierboven beschreven. Het gebruik van de mondiale delim optie is het echter wel
mogelijk te maken tbl negeer de gegevens erin gelijk aan scheidingstekens voor dat doel.

r,R Rechts uitlijnen van item binnen de kolom.

s,S Plaats het vorige item aan de linkerkant in deze kolom. Niet toegestaan ​​voor de eerste kolom.

^ Span de invoer uit de vorige rij in deze kolom. Niet toegestaan ​​voor de eerste rij.

_,- Vervang deze invoer door een horizontale lijn. Merk op dat '_' en '-' kunnen worden gebruikt voor
alleen tabelvelden, niet voor kolomscheidingslijnen.

= Vervang deze invoer door een dubbele horizontale lijn. Merk op dat '=' kan worden gebruikt voor
alleen tabelvelden, niet voor kolomscheidingslijnen.

| De corresponderende kolom wordt een verticale regel (als twee hiervan naast elkaar liggen, a
dubbele verticale regel).

Een verticale balk links van de eerste sleutelletter of rechts van de laatste
produceert een lijn aan de rand van de tafel.

Om het gegevensformaat binnen een tabel te wijzigen, gebruikt u de .T& commando (aan het begin van een regel).
Het wordt gevolgd door formaat- en datalijnen (maar geen globale opties), vergelijkbaar met de . TS
verzoek.

Kolom bestekschrijvers
Dit zijn de specificaties die kunnen verschijnen in achtervoegsels van kolomsleutelletters (in willekeurige volgorde):

b,B korte vorm van fB (maak de betreffende vermeldingen vetgedrukt).

d,D Start een item dat rijen verticaal omspant, met behulp van de kolomspecificatie '^' of '\^'
gegevensitem, aan de onderkant van het bereik in plaats van het verticaal te centreren (GNU tbl
alleen). Voorbeeld:

. TS
tab(;) allesvak;
ll
Ik zou
r^
l rd.
0000; foobar
T{
1111
. Br
2222
T}; foe
r;
T{
3333
. Br
4444
T};balk
\^;\^
.THEE

Resultaat:

┌─────┬────────┐
│0000 │ foobar │
├─────┼────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼────────┤
│3333 │ │
│4444 │ reep │
└─────┴────────┘
e,E Maak kolommen op gelijke afstand van elkaar. Alle kolommen die met deze specificatie zijn gemarkeerd, krijgen hetzelfde
breedte; dit gebeurt nadat de betreffende kolombreedtes zijn berekend (dit betekent
dat de grootste breedtewaarde geldt).

f,F Elk van deze specificaties kan worden gevolgd door een lettertypenaam (een of twee).
tekens lang), lettertypenummer (één cijfer) of een lange naam tussen haakjes (de
laatste vorm is een GNU tbl-extensie). Een lettertypenaam van één letter moet door één worden gescheiden
of meer spaties uit wat volgt.

i,I korte vorm van fI (maak de betreffende vermeldingen cursief).

m,M Dit is een GNU tbl-extensie. Elk van deze specificaties kan worden gevolgd door een macro
naam (een of twee tekens lang), of een lange naam tussen haakjes. Een een-
letter macronaam moet worden gescheiden door een of meer spaties van wat volgt.
De macro waarvan de naam hier kan worden opgegeven, moet worden gedefinieerd voordat de macro wordt gemaakt
tafel. Het wordt aangeroepen net voordat de celtekst van de tabel wordt uitgevoerd. Zoals geïmplementeerd
momenteel wordt deze macro alleen aangeroepen als blokinvoer wordt gebruikt, dat wil zeggen tekst ertussen
'T{' en 'T}'. De macro mag alleen eenvoudig bevatten troff verzoeken om wijziging van de
opmaak van tekstblokken, zoals tekstaanpassing, woordafbreking, grootte of lettertype. De macro
wordt genoemd na andere celmodificaties zoals b, f or v zijn output. De macro dus
kan andere wijzigingsspecificaties overschrijven.

p,P Gevolgd door een getal, wordt de puntgrootte gewijzigd voor de betreffende velden. Als
ondertekend, wordt de huidige puntgrootte verhoogd of verlaagd (met behulp van een ondertekend getal
in plaats van een ondertekend cijfer is er een GNU tbl-extensie). Er volgde een puntgroottespecificatie
door een kolomscheidingsnummer moet worden gescheiden door een of meer spaties.

t,T Begin een item verticaal verspreid over rijen bovenaan het bereik in plaats van
verticaal centreren.

u,U Verplaats de overeenkomstige kolom een ​​halve lijn omhoog.

v,V Gevolgd door een getal, dit geeft de verticale lijnafstand aan die moet worden gebruikt in a
tabelinvoer met meerdere regels. Indien ondertekend, is de huidige verticale regelafstand gelijk
verhoogd of verlaagd (het gebruik van een ondertekend nummer in plaats van een ondertekend cijfer is een
GNU tbl-extensie). Een specificatie voor de verticale regelafstand, gevolgd door een kolom
scheidingsnummer moet worden gescheiden door een of meer spaties. Geen effect als de
bijbehorende tabelinvoer is geen tekstblok.

w,W Minimale kolombreedtewaarde. Moet worden gevolgd door een troff(1) breedte-expressie
tussen haakjes of een geheel getal zonder eenheid. Als er geen eenheid is opgegeven, worden en-eenheden gebruikt.
Wordt ook gebruikt als standaardregellengte voor opgenomen tekstblokken. Indien meerdere gebruikt
keer om de breedte voor een bepaalde kolom op te geven, wordt de laatste invoer van kracht.

x,X Een uitgevouwen kolom. Na het berekenen van alle kolombreedtes zonder een x specificeerder, gebruik
de resterende lijnbreedte voor deze kolom. Als er meer dan één is uitgebreid
kolom, verdeel de resterende horizontale ruimte gelijkmatig over de betreffende kolommen
(dit is een GNU-extensie). Deze functie heeft hetzelfde effect als het opgeven van a
minimale kolombreedte.

z,Z Negeer de corresponderende kolom voor breedteberekeningsdoeleinden, gebruik deze niet
de velden, maar alleen de specificaties van deze kolom om de breedte ervan te berekenen.

Een cijferachtervoegsel op een sleutelteken wordt geïnterpreteerd als een kolomscheiding in en-eenheden
(vermenigvuldigd in evenredigheid als de uitbreiden optie staat aan – bij overvolle tafels dit
kan nul zijn). De standaardscheiding is 3n.

De kolomspecificatie x is wederzijds exclusief met e en w (maar e sluit elkaar niet uit
Met w); indien meerdere keren opgegeven voor een bepaalde kolom, wordt de laatste invoer van kracht:
x schakelt beide uit e en w, terwijl ofwel e or w overschrijvingen x.

tafel gegevens
De opmaakregels worden gevolgd door regels die de feitelijke gegevens voor de tabel bevatten
eindelijk door .THEE. Binnen dergelijke gegevensregels worden items normaal gesproken gescheiden door tabtekens
(of het teken dat is opgegeven met de tab keuze). Lange invoerlijnen kunnen worden doorbroken
meerdere regels als het laatste teken op de regel '\' is (dit verdwijnt daarna
aaneenschakeling).

Merk op dat tbl berekent de kolombreedten regel voor regel, waarbij \w wordt toegepast op elke invoer die
is geen tekstblok. Het gevolg is dat constructies zoals

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

mislukking; je moet óf zeggen

. TS
cp20,lp20.
MM
MMM
.THEE

or

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

Een punt als beginpunt van een regel, gevolgd door iets anders dan een cijfer, wordt behandeld als een troff-commando.
ongewijzigd doorlopen. De tafelpositie blijft in dit geval ongewijzigd.

Als een datalijn alleen uit '_' of '=' bestaat, is dat respectievelijk een enkele of dubbele lijn
op dat moment over de tafel getrokken; als een enkel item in een dataregel alleen uit '_' bestaat
of '=', dan wordt dat item vervangen door een enkele of dubbele lijn, die zijn buren verbindt. Als
een data-item bestaat alleen uit '\_' of '\=', er wordt respectievelijk een enkele of dubbele lijn getekend
over het veld op dat punt dat zich niet bij zijn buren voegt.

Een gegevensitem dat alleen bestaat uit '\Rx' ('x' elk teken) wordt vervangen door herhalingen van
teken 'x' zo breed als de kolom (niet aansluitend op de aangrenzende kolommen).

Een gegevensitem dat alleen uit '\^' bestaat, geeft aan dat het veld direct erboven zich uitstrekt
naar beneden over deze rij.

Tekst blokken
Een tekstblok kan worden gebruikt om gegevens in één keer in te voeren, wat te lang zou zijn als a
eenvoudige tekenreeks tussen tabbladen. Het begint met 'T{' en wordt afgesloten met 'T}'. De voormalige
moet een regel beëindigen, en deze moet een regel beginnen, waarschijnlijk gevolgd door andere gegevenskolommen
(gescheiden door tabs of het teken dat wordt gegeven met de tab globale optie).

Standaard wordt het tekstblok opgemaakt met de instellingen die eerder actief waren
de tafel betreedt, mogelijk overschreven door de m, v en w tbl-specificaties. Bijvoorbeeld,
om alle tekstblokken rafelig rechts te maken, voegt u in .na vlak voor de start . TS (En .advertentie
na de tafel).

Als er geen 'w'- of 'x[cq]-specificaties zijn opgegeven allen kolommen van een tekstblokreeks, de
standaardlengte van het tekstblok (om preciezer te zijn, de regellengte die wordt gebruikt om de
tekstblokomleiding) wordt berekend als L×C/(N+1), waarbij 'L' de huidige regellengte is, 'C'
het aantal kolommen dat door het tekstblok wordt omspannen, en 'N' het totale aantal kolommen erin
de tafel. Houd er echter rekening mee dat de werkelijke omleidingsbreedte wordt geretourneerd in het register \n[dl]
wordt uiteindelijk gebruikt als tekstblokbreedte. Indien nodig kunt u ook de tekst besturen
blokbreedte met een directe invoeging van a .NS verzoek direct na 'T{'.

Diversen
Het nummerregister \n[TW] houdt de tafelbreedte vast; het kan niet binnen de tabel zelf worden gebruikt
maar wordt vlak voor het bellen gedefinieerd .THEE zodat deze macro er gebruik van kan maken.

tbl definieert ook een macro .T# die de onder- en zijlijnen van een tafel in dozen produceert.
Terwijl tbl Roept deze macro zelf aan het einde van de tabel op, dan kan deze door de macro worden gebruikt
pakketten om vakken te maken voor tabellen met meerdere pagina's door deze in de paginavoettekst aan te roepen. Een
Een voorbeeld hiervan wordt gegeven door de -Mevrouw macro's die deze functionaliteit bieden als het om een ​​tabel gaat
begint met . TS H in plaats van de standaardoproep naar de . TS macro.

WISSELWERKING MET EQN

tbl(1) moet altijd eerder worden aangeroepen gelijk aan(1) (groff(1) zorgt automatisch voor de
juiste volgorde van preprocessors).

GNU TBL Verbeteringen

Er is geen limiet op het aantal kolommen in een tabel, noch op het aantal tekst
blokken. Bij het bepalen van de kolombreedte wordt rekening gehouden met alle regels van een tabel, niet alleen met de
eerste 200. Vervolg tabel (.T&) regels zijn niet beperkt tot de eerste 200 regels.

Numerieke en alfabetische items kunnen in dezelfde kolom voorkomen.

Numerieke en alfabetische items kunnen zich horizontaal uitstrekken.

tbl gebruikt register-, string-, macro- en omleidingsnamen die beginnen met het cijfer 3. Wanneer
gebruik tbl u moet vermijden om namen te gebruiken die met een beginnen 3.

GNU TBL BINNEN MACRO'S

Sinds tbl zijn eigen macro's definieert (vlak voor elke tabel), is het noodzakelijk om een ​​'end-
van-macro' macro. Bovendien moet het escape-teken worden uitgeschakeld. Hier een
voorbeeld.

.eo
.de ATAFEL ..
. TS
allbox-tabblad(;);
kl.
\$1;\$2
.THEE
...
.ec
.ATABLE Een tafel
.ATABLE Nog een tafel
.ATABLE En "nog eentje"

Houd er echter rekening mee dat niet alle kenmerken van tbl kan in een macro worden verpakt omdat tbl ziet
de invoer eerder dan troff. Bijvoorbeeld getalnotatie met verticaal uitgelijnd
decimale punten mislukken als deze getallen worden doorgegeven als macroparameters omdat ze decimaal zijn
puntuitlijning wordt afgehandeld door tbl zelf: Het ziet alleen '\$1', '\$2', enz., en daarom
kan de komma niet herkennen.

Gebruik gtbl online met behulp van onworks.net-services