gtbl - Daring di Awan

PROGRAM:

NAMA

tbl - format tabel untuk troff

RINGKASAN

tbl [-CV] [arsip ...]

DESKRIPSI

Halaman manual ini menjelaskan versi GNU dari tbl, yang merupakan bagian dari dokumen groff
sistem pemformatan. tbl mengkompilasi deskripsi tabel yang disematkan di dalam troff file masukan
menjadi perintah yang dipahami oleh troff. Biasanya, itu harus dipanggil menggunakan -t
pilihan dari kasar. Ini sangat kompatibel dengan Unix tbl. Keluaran yang dihasilkan oleh GNU tbl
tidak dapat diproses dengan Unix troff; itu harus diproses dengan GNU troff. Jika tidak ada file
diberikan pada baris perintah atau nama file dari - diberikan, input standar dibaca.

PILIHAN

-C Aktifkan mode kompatibilitas untuk mengenali TS dan .TE bahkan ketika diikuti oleh
karakter selain spasi atau baris baru. Karakter pemimpin (\a) ditangani sebagai
ditafsirkan.

-v Cetak nomor versi.

BAHASA GAMBARAN

tbl mengharapkan untuk menemukan deskripsi tabel yang dibungkus dengan TS (mulai tabel) dan .TE (meja
akhir) makro. Dalam setiap bagian tabel tersebut, tabel lain dapat ditentukan dengan menggunakan
permintaan .T& sebelum perintah terakhir .TE. Setiap definisi tabel memiliki yang berikut:
struktur:

Aksi Pilihan
Ini opsional. Bagian tabel ini dapat menggunakan beberapa opsi yang didistribusikan di
1 atau lebih baris. NS global Option bagian harus selalu diselesaikan oleh titik koma ;
.

tabel format spesifikasi
Bagian ini harus diberikan, bukan opsional. Ini menentukan jumlah kolom
(sel) dari tabel. Selain itu setiap sel diklasifikasikan dengan menjadi pusat, kiri
disesuaikan, atau numerik, dll. Spesifikasi ini dapat memiliki beberapa baris, tetapi harus
diselesaikan oleh dot . di akhir baris terakhir. Setelah setiap definisi sel,
kolom penentu dapat ditambahkan, tetapi itu opsional.

Sel dipisahkan oleh karakter tab secara default. Itu bisa diubah oleh global
Option tbl(c), Di mana c adalah karakter yang sewenang-wenang.

SEDERHANA CONTOH

Definisi tabel termudah adalah.
TS
cc.
Ini terpusat
Nah, ini juga
.TE
Dengan menggunakan c c c, setiap sel di seluruh tabel akan berada di tengah. Karakter yang memisahkan
di sini defaultnya tab.

Hasilnya adalah

Ini terpusat
Nah, ini juga

Definisi ini identik dengan
TS
tab(@);
cc.
Ini@is@pusat
Nah,@ini@juga
.TE
Di sini, karakter tab pemisah diubah menjadi huruf @.

Selain itu, judul dapat ditambahkan dan arah pemusatan dapat diubah ke banyak lainnya
format:
TS
tab(@);
css
lcn.
Judul
kiri@pusat@123
lain@nomor@75
.TE
Hasilnya adalah

Judul
kiri tengah 123
nomor lain 75
Sini l cara rata kiri, dan n cara numerik, yang ada disini dibenarkan benar.

PENGGUNAAN

Aksi Pilihan
Garis segera mengikuti TS makro dapat berisi salah satu dari global berikut
pilihan (mengabaikan kasus karakter – Unix tbl hanya menerima pilihan dengan semua
karakter huruf kecil atau semua karakter huruf besar), dipisahkan dengan spasi, tab, atau koma:

kotak semua Lampirkan setiap item tabel dalam sebuah kotak.

kotak Lampirkan tabel ke dalam kotak.

pusat Tengahkan tabel (default rata kiri). Nama kata kunci alternatif pusat
juga dikenali (ini adalah ekstensi tbl GNU).

titik desimal(c)
Atur karakter agar dikenali sebagai titik desimal dalam kolom numerik (GNU tbl
hanya).

batasi (xy)
penggunaan x dan y sebagai pembatas awal dan akhir untuk persamaan(1).

kotak ganda
Lampirkan tabel dalam kotak ganda.

bingkai ganda
Sama seperti doublebox (hanya GNU tbl).

memperluas Buat tabel selebar panjang garis saat ini (menyediakan pemisahan kolom
faktor). Diabaikan jika satu atau lebih penentu kolom 'x' digunakan (lihat di bawah).

Jika jumlah lebar kolom lebih besar dari panjang garis saat ini,
faktor pemisahan kolom diatur ke nol; tabel seperti itu meluas ke margin kanan,
dan tidak ada pemisahan kolom sama sekali.

bingkai Sama seperti kotak (hanya GNU tbl).

ukuran garis (n)
Tetapkan garis atau aturan (mis. dari kotak) di n-Tipe titik.

tidak Jangan gunakan pengalihan untuk mencegah page break (hanya GNU tbl). Biasanya tbl upaya
untuk mencegah istirahat yang tidak diinginkan dalam tabel kotak dengan menggunakan pengalihan. Ini bisa
terkadang berinteraksi buruk dengan paket makro sendiri menggunakan pengalihan, ketika catatan kaki,
misalnya digunakan.

tidak ada ruang
Abaikan spasi awal dan akhir dalam item data (hanya GNU tbl).

sekarang Matikan peringatan yang terkait dengan tabel yang melebihi lebar baris saat ini (GNU tbl
hanya).

tab(x) Gunakan karakter x alih-alih tab untuk memisahkan item dalam baris data input.

Opsi global harus diakhiri dengan titik koma. Mungkin ada spasi putih di antara opsi
dan argumennya dalam kurung.

tabel format spesifikasi
Setelah opsi global muncul baris yang menjelaskan format setiap baris tabel. Setiap
baris format seperti itu menggambarkan satu baris tabel itu sendiri, kecuali baris format terakhir
(yang harus diakhiri dengan tanda titik) menjelaskan semua baris tabel yang tersisa. Tunggal-
karakter kunci menggambarkan setiap kolom dari setiap baris tabel. Karakter kunci dapat berupa
dipisahkan oleh spasi atau tab. Anda dapat menjalankan spesifikasi format untuk beberapa baris
bersama-sama pada baris yang sama dengan memisahkan mereka dengan koma.

Anda dapat mengikuti setiap karakter kunci dengan penentu yang menentukan font dan ukuran titik
item yang sesuai, yang menentukan lebar kolom, jarak antar kolom, dll.

Baris format terpanjang mendefinisikan jumlah kolom dalam tabel; format yang hilang
deskriptor di akhir baris format diasumsikan sebagai L. Kolom tambahan dalam data
(yang tidak memiliki entri format yang sesuai) diabaikan.

Karakter kunci yang tersedia adalah:

a,A Pusatkan garis terpanjang di kolom ini lalu ratakan kiri semua baris lain di kolom ini
kolom sehubungan dengan garis tengah itu. Idenya adalah menggunakan alfabet seperti itu
subkolom (maka nama karakter kunci) dalam kombinasi dengan L; mereka
disebut subkolom karena A item diindentasi oleh 1n relatif terhadap L entri.
Contoh:

TS
tab(;);
ln, an.
item satu; 1
subitem dua;2
subitem tiga;3
.T&
ln, an.
butir sebelas;11
subitem dua puluh dua;22
subitem tiga puluh tiga;33
.TE

Hasil:

item satu 1
subitem dua 2
subitem tiga 3
item sebelas 11
subitem dua puluh dua 22
subitem tiga puluh tiga 33

c,C Pusatkan item di dalam kolom.

l,L Ratakan kiri item di dalam kolom.

n,N Ratakan item dalam kolom secara numerik: Posisi unit angka disejajarkan
Tegak lurus. Jika ada satu atau lebih titik yang berdekatan dengan angka, gunakan yang paling kanan
satu untuk keselarasan vertikal. Jika tidak ada titik, gunakan angka paling kanan untuk
keselarasan vertikal; jika tidak, pusatkan item di dalam kolom. Penjajaran bisa
dipaksa ke posisi tertentu menggunakan '\&'; jika ada satu atau lebih contoh ini
karakter khusus (non-cetak) yang ada dalam data, gunakan yang paling kiri untuk
penyelarasan. Contoh:

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

Hasil:

1
1.5
1.5.3
abcde
abcde

Jika entri numerik digabungkan dengan L or R entri – ini dapat terjadi jika
format tabel diubah dengan .T& – tengah terluas jumlah (dari data yang dimasukkan
bawah N rezim specifier) ​​relatif terhadap terluas L or R masuk, melestarikan
penyelarasan semua entri numerik. Berbeda dengan A ketik entri, tidak ada tambahan
lekukan.

Menggunakan persamaan (untuk diproses dengan persamaan) dalam kolom yang menggunakan N penentu
bermasalah dalam banyak kasus karena tblalgoritma untuk menemukan vertikal
keselarasan, seperti yang dijelaskan di atas. Menggunakan global batasi pilihan, bagaimanapun, itu adalah
mungkin untuk membuat tbl abaikan data di dalamnya persamaan pembatas untuk tujuan itu.

r,R Rata-kanan item di dalam kolom.

s,S Rentangkan item sebelumnya di sebelah kiri ke dalam kolom ini. Tidak diperbolehkan untuk kolom pertama.

^ Rentangkan entri dari baris sebelumnya di kolom ini. Tidak diperbolehkan untuk baris pertama.

_,- Ganti entri ini dengan garis horizontal. Perhatikan bahwa '_' dan '-' dapat digunakan untuk
bidang tabel saja, bukan untuk garis pemisah kolom.

= Ganti entri ini dengan garis horizontal ganda. Perhatikan bahwa '=' dapat digunakan untuk
bidang tabel saja, bukan untuk garis pemisah kolom.

| Kolom yang sesuai menjadi aturan vertikal (jika dua di antaranya berdekatan, a
aturan vertikal ganda).

Bilah vertikal di sebelah kiri huruf kunci pertama atau di sebelah kanan huruf terakhir
menghasilkan garis di tepi meja.

Untuk mengubah format data dalam tabel, gunakan .T& perintah (di awal baris).
Ini diikuti oleh format dan jalur data (tetapi tidak ada opsi global) yang mirip dengan TS
permintaan.

Kolom penentu
Berikut adalah penentu yang dapat muncul dalam sufiks pada huruf kunci kolom (dalam urutan apa pun):

b,B Bentuk singkat dari fB (buat entri yang terpengaruh dicetak tebal).

d,D Mulai item yang membentang baris secara vertikal, menggunakan penentu kolom '^' atau '\^'
item data, di bagian bawah jangkauannya daripada memusatkannya secara vertikal (GNU tbl
hanya). Contoh:

TS
tab(;) semua kotak;
ll
aku ld
r^
aku rd.
0000; foobar
T{
1111
. Br
2222
T};uu
r;
T{
3333
. Br
4444
T};bar
\^;\^
.TE

Hasil:

┌─────┬────────┐.
0000 foobar
├─────┼────────┤.
1111
2222
├─────┤ │.
r foo
├─────┼────────┤.
3333
4444 bar
└─────┴────────┘.
e,E Buat kolom dengan spasi yang sama. Semua kolom yang ditandai dengan penentu ini mendapatkan hal yang sama
lebar; ini terjadi setelah lebar kolom yang terpengaruh telah dihitung (ini berarti
bahwa aturan nilai lebar terbesar).

f,F Salah satu dari penentu ini dapat diikuti dengan nama font (salah satu atau dua)
karakter panjang), nomor font (satu digit), atau nama panjang dalam tanda kurung (the
bentuk terakhir adalah ekstensi tbl GNU). Nama font satu huruf harus dipisahkan satu
atau lebih kosong dari apa pun yang mengikuti.

i,I Bentuk singkat dari fI (buat entri yang terpengaruh miring).

m,M Ini adalah ekstensi tbl GNU. Salah satu dari penentu ini dapat diikuti oleh makro
nama (panjang satu atau dua karakter), atau nama panjang dalam tanda kurung. Satu-
huruf nama makro harus dipisahkan oleh satu atau lebih kosong dari apapun berikut.
Makro yang namanya dapat ditentukan di sini harus ditentukan sebelum membuat
meja. Ini disebut tepat sebelum teks sel tabel dikeluarkan. Seperti yang diterapkan
saat ini, makro ini hanya dipanggil jika input blok digunakan, yaitu teks antara
'T{' dan 'T}'. Makro seharusnya hanya berisi yang sederhana troff permintaan untuk mengubah
pemformatan blok teks, seperti penyesuaian teks, tanda hubung, ukuran, atau font. makro
disebut setelah modifikasi sel lainnya seperti b, f or v adalah keluaran. Jadi makro
dapat menimpa penentu modifikasi lainnya.

p,P Diikuti oleh angka, ini melakukan perubahan ukuran titik untuk bidang yang terpengaruh. Jika
ditandatangani, ukuran titik saat ini bertambah atau berkurang (menggunakan nomor yang ditandatangani
alih-alih digit yang ditandatangani adalah ekstensi GNU tbl). Penentu ukuran titik diikuti
dengan nomor pisah kolom harus dipisahkan oleh satu atau lebih blanko.

t,T Mulai item yang merentangkan baris secara vertikal di bagian atas jangkauannya daripada
memusatkannya secara vertikal.

u,U Pindahkan kolom yang sesuai ke atas satu setengah garis.

v,V Diikuti oleh angka, ini menunjukkan jarak garis vertikal yang akan digunakan dalam a
entri tabel multi-baris. Jika ditandatangani, jarak garis vertikal saat ini adalah
bertambah atau berkurang (menggunakan nomor bertanda alih-alih digit bertanda adalah a
ekstensi GNU tbl). Penentu spasi garis vertikal diikuti oleh kolom
nomor pisah harus dipisahkan oleh satu atau lebih blanko. Tidak berpengaruh jika
entri tabel yang sesuai bukan blok teks.

w,W Nilai lebar kolom minimum. Harus diikuti oleh a troff(1) ekspresi lebar
dalam tanda kurung atau bilangan bulat tanpa unit. Jika tidak ada satuan yang diberikan, maka digunakan satuan en.
Juga digunakan sebagai panjang garis default untuk blok teks yang disertakan. Jika digunakan beberapa
kali untuk menentukan lebar kolom tertentu, entri terakhir berlaku.

x,X Kolom yang diperluas. Setelah menghitung semua lebar kolom tanpa x penentu, gunakan
lebar garis yang tersisa untuk kolom ini. Jika ada lebih dari satu yang diperluas
kolom, distribusikan ruang horizontal yang tersisa secara merata di antara kolom yang terpengaruh
(ini adalah ekstensi GNU). Fitur ini memiliki efek yang sama seperti menentukan a
lebar kolom minimum.

z,Z Abaikan kolom yang sesuai untuk tujuan perhitungan lebar, ini, jangan gunakan
bidang tetapi hanya penentu kolom ini untuk menghitung lebarnya.

Sufiks angka pada karakter kunci diinterpretasikan sebagai pemisahan kolom dalam satuan en
(dikalikan secara proporsional jika memperluas opsi aktif – jika tabel terlalu penuh ini
mungkin nol). Pemisahan default adalah 3n.

Penentu kolom x saling eksklusif dengan e dan w (tujuan e tidak saling eksklusif
dengan w); jika ditentukan beberapa kali untuk kolom tertentu, entri terakhir berlaku:
x hapus keduanya e dan w, sedangkan e or w menimpa x.

tabel data
Baris format diikuti oleh baris yang berisi data aktual untuk tabel, diikuti
akhirnya oleh .TE. Dalam baris data seperti itu, item biasanya dipisahkan oleh karakter tab
(atau karakter yang ditentukan dengan tab pilihan). Jalur input yang panjang dapat dipatahkan
beberapa baris jika karakter terakhir pada baris adalah '\' (yang menghilang setelah
rangkaian).

Perhatikan bahwa tbl menghitung lebar kolom baris demi baris, menerapkan \w pada setiap entri yang
bukan blok teks. Akibatnya, konstruksi seperti

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

gagal; Anda juga harus mengatakan

TS
cp20, lp20.
MM
MMM
.TE

or

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

Sebuah titik yang memulai sebuah baris, diikuti oleh apapun kecuali sebuah angka ditangani sebagai perintah troff,
dilalui tanpa perubahan. Posisi tabel tidak berubah dalam kasus ini.

Jika garis data hanya terdiri dari '_' atau '=', masing-masing garis tunggal atau ganda adalah
ditarik melintasi meja pada saat itu; jika satu item dalam baris data hanya terdiri dari '_'
atau '=', maka item tersebut diganti dengan satu atau dua baris, bergabung dengan tetangganya. Jika
item data hanya terdiri dari '\_' atau '\=', garis tunggal atau ganda, masing-masing, ditarik
melintasi lapangan pada titik yang tidak bergabung dengan tetangganya.

Item data yang hanya terdiri dari '\Rx' ('x' karakter apa pun) diganti dengan pengulangan
karakter 'x' selebar kolom (tidak bergabung dengan tetangganya).

Item data yang hanya terdiri dari '\^' menunjukkan bahwa bidang tepat di atas bentang
ke bawah di atas baris ini.

Teks blok
Blok teks dapat digunakan untuk memasukkan data sebagai entri tunggal yang akan terlalu panjang sebagai
string sederhana antar tab. Ini dimulai dengan 'T{' dan ditutup dengan 'T}'. Mantan
harus mengakhiri satu baris, dan yang terakhir harus memulai satu baris, mungkin diikuti oleh kolom data lainnya
(dipisahkan dengan tab atau karakter yang diberikan dengan tab pilihan global).

Secara default, blok teks diformat dengan pengaturan yang aktif sebelumnya
memasuki tabel, mungkin ditimpa oleh m, v, dan w penentu tbl. Sebagai contoh,
untuk membuat semua blok teks compang-camping, masukkan .na tepat sebelum memulai TS (Dan .iklan
setelah meja).

Jika salah satu penentu 'w' atau 'x[cq] tidak diberikan untuk semua kolom dari rentang blok teks, the
panjang default dari blok teks (lebih tepatnya, panjang garis yang digunakan untuk memproses
pengalihan blok teks) dihitung sebagai L×C/(N+1), di mana 'L' adalah panjang baris saat ini, 'C'
jumlah kolom yang direntang oleh blok teks, dan 'N' jumlah total kolom di
meja. Namun, perhatikan bahwa lebar pengalihan sebenarnya seperti yang dikembalikan dalam register \n[dl]
akhirnya digunakan sebagai lebar blok teks. Jika perlu, Anda juga dapat mengontrol teks
lebar blok dengan penyisipan langsung a .II permintaan tepat setelah 'T{'.

bermacam-macam
Nomor register \n[TW] memegang lebar meja; itu tidak dapat digunakan di dalam tabel itu sendiri
tetapi didefinisikan tepat sebelum menelepon .TE sehingga makro ini dapat memanfaatkannya.

tbl juga mendefinisikan makro .T# yang menghasilkan garis bawah dan samping meja kotak.
Sementara tbl tidak menyebut makro ini sendiri di akhir tabel, itu dapat digunakan oleh makro
paket untuk membuat kotak untuk tabel multi-halaman dengan memanggilnya di dalam footer halaman. NS
contoh ini ditunjukkan oleh -MS makro yang menyediakan fungsionalitas ini jika tabel
dimulai dengan TS H alih-alih panggilan standar ke TS makro.

INTERAKSI DENGAN PERSAMAAN

tbl(1) harus selalu dipanggil sebelumnya persamaan(1) (kasar(1) secara otomatis mengurus
urutan preprosesor yang benar).

GNU TBL PENINGKATAN

Tidak ada batasan jumlah kolom dalam tabel, atau batasan jumlah teks
blok. Semua baris tabel dipertimbangkan dalam menentukan lebar kolom, bukan hanya
200 pertama. Kelanjutan tabel (.T&) baris tidak terbatas pada 200 baris pertama.

Item numerik dan alfabet dapat muncul di kolom yang sama.

Item numerik dan alfabet dapat menjangkau secara horizontal.

tbl menggunakan register, string, makro, dan nama pengalihan yang dimulai dengan digit 3. Ketika
menggunakan tbl Anda harus menghindari penggunaan nama apa pun yang dimulai dengan a 3.

GNU TBL DALAM MAKROS

Sejak tbl mendefinisikan makronya sendiri (tepat sebelum setiap tabel) perlu menggunakan 'end-
makro' makro. Selain itu, karakter pelarian harus dimatikan. Di sini dan
contoh.

.eo
.de DAPAT DILAKUKAN ..
TS
tab semua kotak(;);
kl.
\$1;\$2
.TE
...
.ec
.ATABLE Sebuah meja
.ATABLE Meja lain
.ATABLE Dan "satu lagi"

Namun, perhatikan bahwa tidak semua fitur dari tbl dapat dibungkus menjadi makro karena tbl melihat
masukan lebih awal dari troff. Misalnya, pemformatan angka dengan rata vertikal
titik desimal gagal jika angka-angka tersebut diteruskan sebagai parameter makro karena desimal
perataan titik ditangani oleh tbl dirinya sendiri: Ia hanya melihat '\$1', '\$2', dll., dan karenanya
tidak dapat mengenali titik desimal.

Gunakan gtbl online menggunakan layanan onworks.net