gtbl — Online w chmurze

PROGRAM:

IMIĘ

tbl - formatowanie tabel dla troffa

STRESZCZENIE

tabl [-Cv] [pliki ...]

OPIS

Ta strona podręcznika opisuje wersję GNU programu tabl, który jest częścią dokumentu groff
system formatowania. tabl kompiluje opisy osadzonych w nich tabel troff pliki wejściowe
na polecenia zrozumiałe dla troff. Zwykle należy go wywołać za pomocą metody -t
opcja groff. Jest wysoce kompatybilny z Unixem tabl. Dane wyjściowe wygenerowane przez GNU tabl
nie mogą być przetwarzane w systemie Unix troff; musi być przetwarzany za pomocą GNU troff. Jeśli nie ma żadnych plików
podana w wierszu poleceń lub nazwa pliku - jest podane, odczytywane jest standardowe wejście.

OPCJE

-C Włącz tryb zgodności, aby rozpoznać .TS i TE nawet jeśli następuje po nim a
znak inny niż spacja lub nowa linia. Znaki wiodące (\a) są traktowane jako
interpretowane.

-v Wydrukuj numer wersji.

JĘZYK INFORMACJE OGÓLNE

tabl oczekuje, że znajdzie opisy tabel zawinięte w plik .TS (początek stołu) i TE (stół
koniec) makra. W obrębie każdej takiej sekcji tabeli można zdefiniować inną tabelę za pomocą opcji
zażądać .T& przed ostatnim poleceniem TE. Każda definicja tabeli zawiera następujące elementy
struktura:

Globalne Opcje
Jest to opcjonalne. W tej części tabeli można korzystać z kilku opcji dostępnych w programie
1 lub więcej linii. The światowy opcja część musi zawsze kończyć się a średnik ;
.

Stół format specyfikacja
Tę część należy podać, nie jest ona opcjonalna. Określa liczbę kolumn
(komórki) tabeli. Ponadto każda komórka jest klasyfikowana według położenia centralnego i lewego
dostosowana, numeryczna itp. Ta specyfikacja może mieć kilka wierszy, ale musi
zostać ukończony przez A kropka . na końcu ostatniej linii. Po definicji każdej komórki
kolumna specyfikatorzy można dołączyć, ale jest to opcjonalne.

Komórki domyślnie oddzielane są znakiem tabulacji. Można to zmienić poprzez światowy
opcja tbl(c), Gdzie c jest dowolnym znakiem.

PROSTY PRZYKŁADY

Najłatwiejsza definicja tabeli to.
.TS
ccc.
To jest wyśrodkowane
Cóż, to także
TE
Za pomocą c c c, każda komórka w całej tabeli zostanie wyśrodkowana. Znak oddzielający
jest tutaj wartością domyślną Zakładka.

Wynikiem jest

To jest wyśrodkowane
Cóż, to także

Definicja ta jest identyczna z
.TS
patka(@);
ccc.
To@jest@wyśrodkowane
Cóż, @to@również
TE
Tutaj znak tabulacji oddzielającej zostaje zmieniony na literę @.

Ponadto można dodać tytuł i zmienić kierunki centrowania na wiele innych
formaty:
.TS
patka(@);
css
lcn.
Tytuł
lewo@centra@123
inny@numer@75
TE
Wynikiem jest

Tytuł
lewe środkowe 123
kolejny numer 75
Tutaj l znaczy wyrównanie do lewej, n znaczy liczbowy, który jest tutaj prawicowo uzasadniony.

ZASTOSOWANIE

Globalne Opcje
Linia bezpośrednio po .TS makro może zawierać dowolne z poniższych global
opcje (ignorując wielkość liter – Unix tbl akceptuje tylko opcje z all
znaki małe lub wszystkie znaki wielkie), oddzielone spacjami, tabulatorami lub przecinkami:

wszystkobox Umieść każdy element tabeli w pudełku.

pudełko Zapakuj stół w pudełko.

centrum Wyśrodkuj tabelę (domyślnie jest wyrównana do lewej). Alternatywna nazwa słowa kluczowego centrum
jest również rozpoznawany (jest to rozszerzenie GNU tbl).

kropka dziesiętna(c)
Ustaw znak rozpoznawany jako przecinek dziesiętny w kolumnach numerycznych (GNU tbl
tylko).

usuń(xy)
Zastosowanie x i y jako ograniczniki początku i końca równo(1).

podwójne pudełko
Zapakuj stół w podwójne pudełko.

podwójna ramka
To samo co doublebox (tylko GNU tbl).

rozszerzać Ustaw tabelę tak szeroką, jak bieżąca długość linii (zapewniając separację kolumn
czynnik). Ignorowane, jeśli użyto co najmniej jednego specyfikatora kolumny „x” (patrz poniżej).

W przypadku, gdy suma szerokości kolumn jest większa niż bieżąca długość linii,
współczynnik separacji kolumn jest ustawiony na zero; takie tabele sięgają do prawego marginesu,
i nie ma w ogóle separacji kolumn.

rama To samo co pudełko (tylko GNU tbl).

Rozmiar linii(n)
Ustaw linie lub reguły (np. from pudełko) w n-typ punktowy.

nie trzymaj się Nie używaj przekierowań, aby zapobiec podziałom stron (tylko GNU tbl). Normalnie tabl próby
aby zapobiec niepożądanym przerwom w pudełkowych stołach poprzez zastosowanie objazdów. To może
czasami źle współdziałają z pakietami makr, korzystają z własnych przekierowań, gdy przypisy,
są używane np.

bez odstępów
Ignoruj ​​spacje początkowe i końcowe w elementach danych (tylko GNU tbl).

nowość Wyłącz ostrzeżenia dotyczące tabel przekraczających bieżącą szerokość linii (GNU tbl
tylko).

patka(x) Użyj znaku x zamiast tabulatora oddzielającego elementy w wierszu danych wejściowych.

Opcje globalne muszą kończyć się średnikiem. Pomiędzy opcjami może znajdować się spacja
i jego argument w nawiasach.

Stół format specyfikacja
Po opcjach globalnych pojawiają się linie opisujące format każdej linii tabeli. Każdy
taka linia formatu opisuje jedną linię samej tabeli, z wyjątkiem ostatniej linii formatu
(który należy zakończyć kropką) opisuje wszystkie pozostałe wiersze tabeli. Pojedynczy-
znak kluczowy opisuje każdą kolumnę każdego wiersza tabeli. Kluczowe postacie mogą być
oddzielone spacjami lub tabulatorami. Możesz uruchomić specyfikacje formatu dla wielu wierszy
razem w tym samym wierszu, oddzielając je przecinkami.

Po każdym kluczowym znaku możesz podać specyfikatory określające czcionkę i rozmiar punktu
odpowiedniej pozycji, które określają szerokość kolumny, odstępy między kolumnami itp.

Najdłuższa linia formatu określa liczbę kolumn w tabeli; brak formatu
Zakłada się, że deskryptory na końcu linii formatu to: L. Dodatkowe kolumny w danych
(które nie mają odpowiadającego wpisu formatu) są ignorowane.

Dostępne znaki kluczowe to:

a,A Wyśrodkuj najdłuższą linię w tej kolumnie, a następnie wyrównaj do lewej wszystkie pozostałe linie w tej kolumnie
kolumny względem tej linii środkowej. Pomysł jest taki, żeby użyć takiego alfabetu
podkolumny (stąd nazwa znaku kluczowego) w połączeniu z L; oni są
nazywane podkolumnami, ponieważ A elementy są wcięte o 1n względem L wpisy.
Przykład:

.TS
patka(;);
ln,an.
pozycja pierwsza;1
podpunkt drugi;2
podpunkt trzeci;3
.T&
ln,an.
pozycja jedenasta;11
podpunkt dwudziesty drugi;22
podpunkt trzydziesty trzeci;33
TE

Wynik:

element pierwszy 1
podpunkt drugi 2
podpunkt trzeci 3
punkt jedenasty 11
podpunkt dwudziesty drugi 22
podpunkt trzydziesty trzeci 33

c,C Wyśrodkuj element w kolumnie.

l,L Wyrównaj element w kolumnie do lewej.

n,N Numerycznie uzasadnij element w kolumnie: Pozycje jednostek w liczbach są wyrównane
pionowo. Jeśli obok cyfry znajduje się jedna lub więcej kropek, użyj skrajnej prawej kropki
jeden do wyrównania w pionie. Jeśli nie ma kropki, użyj cyfry znajdującej się najbardziej na prawo
wyrównanie w pionie; w przeciwnym razie wyśrodkuj element w kolumnie. Wyrównanie może być
zmuszony do określonej pozycji za pomocą „\&”; jeśli istnieje jeden lub więcej takich przypadków
specjalny (niedrukowalny) znak obecny w danych, użyj znaku skrajnego z lewej strony
wyrównanie. Przykład:

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

Wynik:

1
1.5
1.5.3
abcde
abcde

Jeśli wpisy numeryczne zostaną połączone z L or R wpisy – może się to zdarzyć, jeśli
format tabeli zmienia się za pomocą .T& – środek najszerszy numer (z wprowadzonych danych
pod N reżim specyfikatora) w stosunku do najszerszego L or R wpis, zachowując
wyrównanie wszystkich wpisów numerycznych. Przeciwnie do A wpisz wpisy, nie ma żadnych dodatkowych
wcięcie.

Używając równań (do przetworzenia równo) w kolumnach, które używają N specyficzny
w większości przypadków jest problematyczny z powodu tablAlgorytm znajdowania pionu
wyrównanie, jak opisano powyżej. Korzystanie z globala rozgraniczać opcja jednak jest
możliwe do wykonania tabl zignoruj ​​zawarte w nim dane równo przeznaczone do tego celu ograniczniki.

r,R Wyrównaj element w kolumnie do prawej strony.

s,S Rozciągnij poprzedni element po lewej stronie na tę kolumnę. Niedozwolone w pierwszej kolumnie.

^ Rozwiń w dół wpis z poprzedniego wiersza w tej kolumnie. Niedozwolone w pierwszym rzędzie.

_,- Zastąp ten wpis linią poziomą. Należy pamiętać, że można używać znaków „_” i „-”.
tylko pola tabeli, a nie linie oddzielające kolumny.

= Zastąp ten wpis podwójną poziomą linią. Pamiętaj, że „=” może być użyte do
tylko pola tabeli, a nie linie oddzielające kolumny.

| Odpowiednia kolumna staje się linią pionową (jeśli dwie z nich sąsiadują ze sobą, a
reguła podwójnego pionu).

Pionowy pasek na lewo od pierwszej litery klucza lub na prawo od ostatniej
tworzy linię na krawędzi stołu.

Aby zmienić format danych w tabeli, użyj opcji .T& polecenie (na początku linii).
Po nim następują linie formatu i danych (ale bez opcji globalnych) podobne do .TS
prośba.

Kolumna specyfikatorzy
Oto specyfikatory, które mogą pojawić się w przyrostkach liter kluczowych kolumn (w dowolnej kolejności):

b,B Krótka forma fB (pogrubienie odpowiednich wpisów).

d,D Rozpocznij element rozciągający się w pionie za pomocą specyfikatora kolumny „^” lub „\^”
element danych, na dole jego zakresu, zamiast go centrować w pionie (GNU tbl
tylko). Przykład:

.TS
tab(;) wszystkobox;
ll
ja
r^
XNUMX miejsce
0000;foobar
T{
1111
.br
2222
T}; fuj
r;
T{
3333
.br
4444
T};pasek
\^;\^
TE

Wynik:

┌─────┬────────┐
│0000 │ foobar │
├─────┼────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼────────┤
│3333 │ │
│4444 │ bar │
└─────┴────────┘
e,E Utwórz kolumny o równych odstępach. Wszystkie kolumny oznaczone tym specyfikatorem są takie same
szerokość; dzieje się to po obliczeniu szerokości kolumn, których to dotyczy (oznacza to
że obowiązuje największa wartość szerokości).

f,F Po każdym z tych specyfikatorów może następować nazwa czcionki (jeden lub dwa
znaków), numer czcionki (jedna cyfra) lub długa nazwa w nawiasie (tzw
ostatnia forma jest rozszerzeniem GNU tbl). Jednoliterowa nazwa czcionki musi być oddzielona jedynką
lub więcej pustych miejsc z tego, co następuje.

i,I Krótka forma fI (zapisz odpowiednie wpisy kursywą).

m,M To jest rozszerzenie GNU tbl. Po każdym z tych specyfikatorów może nastąpić makro
nazwa (o długości jednego lub dwóch znaków) lub długa nazwa w nawiasach. Jeden-
litera nazwa makra musi być oddzielona co najmniej jednym odstępem od wszystkiego, co następuje.
Makro, którego nazwę można tu podać, należy zdefiniować przed utworzeniem pliku
tabela. Jest wywoływana tuż przed wyświetleniem tekstu komórki tabeli. Jak wdrożono
obecnie to makro jest wywoływane tylko wtedy, gdy używane jest wejście blokowe, to znaczy tekst pomiędzy
„T{” i „T}”. Makro powinno zawierać tylko proste troff prośby o zmianę
formatowanie bloku tekstu, takie jak dostosowywanie tekstu, dzielenie wyrazów, rozmiar lub czcionka. Makro
jest nazywany po inne modyfikacje komórek, takie jak b, f or v są wyjściowe. Zatem makro
może zastąpić inne specyfikatory modyfikacji.

p,P Po której następuje liczba, powoduje zmianę rozmiaru punktu dla dotkniętych pól. Jeśli
ze znakiem, bieżący rozmiar punktu jest zwiększany lub zmniejszany (przy użyciu liczby ze znakiem
zamiast cyfry ze znakiem jest rozszerzenie GNU tbl). Następnie podano specyfikator rozmiaru punktu
numerem separacji kolumny muszą być oddzielone jednym lub większą liczbą spacji.

t,T Rozpocznij element rozciągający się pionowo na rzędy na górze jego zakresu, a nie
centrując go w pionie.

u,U Przesuń odpowiednią kolumnę w górę o jedną półlinię.

v,V Po którym następuje liczba, wskazuje odstęp między wierszami w pionie, jaki należy zastosować w a
wpis do tabeli wielowierszowej. Jeśli jest podpisany, bieżący odstęp między wierszami w pionie wynosi
zwiększany lub zmniejszany (użycie liczby ze znakiem zamiast cyfry ze znakiem to a
rozszerzenie GNU tbl). Specyfikator odstępu między wierszami w pionie, po którym następuje kolumna
numer separacji musi być oddzielony jedną lub większą liczbą spacji. Brak efektu, jeśli
odpowiedni wpis w tabeli nie jest blokiem tekstowym.

w,W Minimalna wartość szerokości kolumny. Po nim musi nastąpić a troff(1) wyrażenie szerokości
w nawiasach lub liczbę całkowitą bez jednostki. Jeśli nie podano jednostki, stosuje się jednostki en.
Używana również jako domyślna długość linii dla dołączonych bloków tekstu. Jeśli użyto wielu
razy, aby określić szerokość konkretnej kolumny, ostatni wpis zaczyna obowiązywać.

x,X Rozbudowana kolumna. Po obliczeniu wszystkich szerokości kolumn bez x specyfikator, użyj
pozostała szerokość linii dla tej kolumny. Jeśli jest więcej niż jeden rozwinięty
kolumnie, rozprowadź równomiernie pozostałą przestrzeń poziomą pomiędzy odpowiednimi kolumnami
(jest to rozszerzenie GNU). Ta funkcja ma taki sam efekt, jak określenie a
minimalna szerokość kolumny.

z,Z Zignoruj ​​odpowiednią kolumnę do celów obliczenia szerokości, to znaczy nie używaj
pola, ale tylko specyfikatory tej kolumny, aby obliczyć jej szerokość.

Sufiks liczby na znaku kluczowym jest interpretowany jako separacja kolumn w jednostkach en
(pomnożone proporcjonalnie, jeśli rozszerzać opcja jest włączona – w przypadku przepełnienia stołów
może wynosić zero). Domyślna separacja to 3n.

Specyfikator kolumny x wyklucza się wzajemnie e i w (ale e nie wyklucza się wzajemnie
w w); jeśli określono wielokrotnie dla danej kolumny, ostatni wpis zaczyna obowiązywać:
x rozbraja oba e i w, podczas gdy albo e or w nadpisuje x.

Stół dane
Po wierszach formatu następują wiersze zawierające rzeczywiste dane tabeli
w końcu przez TE. W takich wierszach danych elementy są zwykle oddzielone znakami tabulacji
(lub znak określony za pomocą Zakładka opcja). Długie linie wejściowe można podzielić
wiele linii, jeśli ostatnim znakiem w linii jest „\” (który znika po
powiązanie).

Należy pamiętać, że tabl oblicza szerokość kolumn linia po linii, stosując \w dla każdego wpisu, który
nie jest blokiem tekstowym. W konsekwencji konstrukcje takie jak

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

ponieść porażkę; musisz albo powiedzieć

.TS
cp20, lp20.
MM
MMM
TE

or

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

Kropka rozpoczynająca linię, po której następuje cokolwiek innego niż cyfra, jest traktowana jako polecenie troff,
przeszło bez zmian. Pozycja stołu nie ulega w tym przypadku zmianie.

Jeśli linia danych składa się tylko z „_” lub „=”, odpowiednio jest to linia pojedyncza lub podwójna
narysowane w tym momencie po stole; jeśli pojedynczy element w linii danych składa się tylko z „_”
lub „=”, wówczas element ten zostaje zastąpiony pojedynczą lub podwójną linią łączącą jego sąsiadów. Jeśli
element danych składa się tylko z „\_” lub „\=”, rysowana jest odpowiednio linia pojedyncza lub podwójna
przez pole w tym miejscu, które nie łączy się z sąsiadami.

Element danych składający się wyłącznie z '\Rx' ('x' dowolny znak) jest zastępowany powtórzeniami
znak „x” o szerokości kolumny (nie łączący się z sąsiadami).

Element danych składający się wyłącznie z „\^” wskazuje, że pole bezpośrednio nad nim obejmuje zakres
w dół nad tym rzędem.

Tekst Bloki
Blok tekstowy może zostać użyty do wprowadzenia danych jako pojedynczego wpisu, który byłby zbyt długi jak np
prosty ciąg znaków między zakładkami. Zaczyna się od „T{” i kończy „T}”. Były
musi kończyć linię, a ta ostatnia musi zaczynać linię, po której prawdopodobnie następują inne kolumny danych
(oddzielone tabulatorami lub znakiem nadanym przez Zakładka opcja globalna).

Domyślnie blok tekstowy jest sformatowany z ustawieniami, które były wcześniej aktywne
wejście do tabeli, prawdopodobnie zastąpione przez m, v, w specyfikatory tbl. Na przykład,
aby wszystkie bloki tekstu były niewyrównane w prawo, wstaw .na tuż przed startem .TS (I .ogłoszenie
po stole).

Jeśli nie podano specyfikatorów „w” lub „x[cq] cała kolekcja kolumny zakresu bloku tekstu,
domyślna długość bloku tekstu (dokładniej długość linii używanej do przetwarzania
przekierowanie bloku tekstu) jest obliczane jako L×C/(N+1), gdzie „L” to bieżąca długość linii, „C”
liczba kolumn objętych blokiem tekstu i „N” całkowita liczba kolumn
stół. Należy jednak pamiętać, że rzeczywista szerokość przekierowania jest zwrócona w rejestrze \n[dl]
jest ostatecznie używana jako szerokość bloku tekstu. W razie potrzeby możesz także kontrolować tekst
szerokość bloku z bezpośrednim wstawieniem a .NS żądanie zaraz po „T{”.

Różne
Rejestr numerów \n[TW] utrzymuje szerokość stołu; nie można go używać w samej tabeli
ale jest zdefiniowany tuż przed wywołaniem TE aby to makro mogło z niego skorzystać.

tabl definiuje również makro .T# który tworzy dolne i boczne linie pudełkowego stołu.
Kompletujemy wszystkie dokumenty (wymagana jest kopia paszportu i XNUMX zdjęcia) potrzebne do tabl wywołuje samo to makro na końcu tabeli, może zostać użyte przez makro
pakiety do tworzenia pól dla tabel wielostronicowych, wywołując je w stopce strony. Jakiś
przykładem tego jest pokazany przez -ms makra, które zapewniają tę funkcjonalność w przypadku tabeli
zaczynać z .TS H zamiast standardowego wywołania metody .TS makro.

INTERAKCJA Z EQN

tabl(1) należy zawsze wywoływać wcześniej równo(1) (groff(1) automatycznie zajmuje się
prawidłowa kolejność preprocesorów).

GNU TBL ULEPSZENIA

Nie ma ograniczeń co do liczby kolumn w tabeli, ani też nie ma ograniczeń co do liczby tekstu
Bloki. Przy ustalaniu szerokości kolumn brane są pod uwagę wszystkie wiersze tabeli, a nie tylko
pierwsze 200. Kontynuacja tabeli (.T&) linie nie są ograniczone do pierwszych 200 linii.

Elementy numeryczne i alfabetyczne mogą pojawiać się w tej samej kolumnie.

Elementy numeryczne i alfabetyczne mogą rozciągać się poziomo.

tabl używa nazw rejestrów, ciągów znaków, makr i przekierowań zaczynających się od cyfry 3. Kiedy
za pomocą tabl powinieneś unikać używania nazw zaczynających się na a 3.

GNU TBL W CIĄGU MAKRO

Ponieważ tabl definiuje własne makra (tuż przed każdą tabelą) konieczne jest użycie
makro-makro. Dodatkowo należy wyłączyć znak ucieczki. Tutaj
przykład.

.eo
.de TABELA ..
.TS
zakładka allbox(;);
kl.
\$1;\$2
TE
...
.ec
.ATABLE Stół
.ATABLE Kolejny stół
.ATABLE I „kolejny”

Należy jednak pamiętać, że nie wszystkie funkcje tabl można zawinąć w makro, ponieważ tabl widzi
wejście wcześniej niż troff. Na przykład formatowanie liczb z wyrównaniem w pionie
dziesiętnych kończy się niepowodzeniem, jeśli te liczby są przekazywane jako parametry makro, ponieważ są dziesiętne
wyrównanie punktów jest obsługiwane przez tabl sam: widzi tylko '\$1', '\$2' itd. i dlatego
nie rozpoznaje przecinka dziesiętnego.

Korzystaj z gtbl online, korzystając z usług onworks.net