gtbl - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

tbl - bảng định dạng cho troff

SYNOPSIS

tbl [-CV] [các tập tin ...]

MÔ TẢ

Trang hướng dẫn sử dụng này mô tả phiên bản GNU của tbl, là một phần của tài liệu tạp kỹ
hệ thống định dạng. tbl biên dịch mô tả của các bảng được nhúng bên trong troff tập tin đầu vào
thành các lệnh được hiểu bởi troff. Thông thường, nó sẽ được gọi bằng cách sử dụng -t
tùy chọn nói tục. Nó tương thích cao với Unix tbl. Đầu ra do GNU tạo ra tbl
không thể được xử lý bằng Unix troff; nó phải được xử lý bằng GNU troff. Nếu không có tệp
được đưa ra trên dòng lệnh hoặc tên tệp của - được đưa ra, đầu vào tiêu chuẩn được đọc.

LỰA CHỌN

-C Bật chế độ tương thích để nhận dạng .ts và .TRÀ ngay cả khi được theo sau bởi một
ký tự khác với dấu cách hoặc dòng mới. Các ký tự lãnh đạo (\ a) được xử lý như
đã diễn giải.

-v In số phiên bản.

NGÔN NGỮ TỔNG QUAN

tbl mong đợi tìm thấy các mô tả bảng được bao bọc trong .ts (đầu bảng) và .TRÀ (bàn
end) macro. Trong mỗi phần bảng như vậy, một bảng khác có thể được xác định bằng cách sử dụng
yêu cầu .NS& trước lệnh cuối cùng .TRÀ. Mỗi định nghĩa bảng có những điều sau đây
kết cấu:

Toàn cầu lựa chọn
Đây là tùy chọn. Phần bảng này có thể sử dụng một số tùy chọn được phân phối trong
1 hoặc nhiều dòng. Các toàn cầu tùy chọn một phần phải luôn luôn được kết thúc bởi một dấu chấm phẩy ;
.

Bàn định dạng đặc điểm kỹ thuật
Phần này phải được đưa ra, nó không phải là tùy chọn. Nó xác định số lượng cột
(các ô) của bảng. Hơn nữa, mỗi ô được phân loại theo vị trí trung tâm, bên trái
được điều chỉnh hoặc số, v.v. Đặc điểm kỹ thuật này có thể có một số dòng, nhưng phải
được hoàn thành bởi một dot . ở cuối dòng cuối cùng. Sau mỗi định nghĩa ô,
cột chuyên gia có thể được thêm vào, nhưng đó là tùy chọn.

Các ô được phân tách bằng ký tự tab theo mặc định. Điều đó có thể được thay đổi bởi toàn cầu
tùy chọn tbl (c), Nơi c là một nhân vật tùy ý.

ĐƠN GIẢN VÍ DỤ

Định nghĩa bảng đơn giản nhất là.
.ts
ccc.
Đây là trung tâm
Vâng, điều này cũng
.TRÀ
Bằng cách sử dụng c c c, mỗi ô trong toàn bảng sẽ được căn giữa. Ký tự tách biệt
ở đây là mặc định chuyển hướng.

Kết quả là

Đây là trung tâm
Vâng, điều này cũng

Định nghĩa này giống hệt với
.ts
chuyển hướng(@);
ccc.
@ Này được căn giữa @
Chà, @ cái này @ cũng có
.TRÀ
Ở đây, ký tự tab phân tách được thay đổi thành chữ cái @.

Hơn nữa, một tiêu đề có thể được thêm vào và các hướng căn giữa có thể được thay đổi thành nhiều tiêu đề khác
định dạng:
.ts
chuyển hướng(@);
css
lcn.
Yêu sách
left @ center @ 123
@ số khác @ 75
.TRÀ
Kết quả là

Yêu sách
trái trung tâm 123
số khác 75
Đây l có nghĩa còn biện minhvà n có nghĩa số học, ở đây chính đáng.

SỬ DỤNG

Toàn cầu lựa chọn
Dòng ngay sau .ts macro có thể chứa bất kỳ toàn cục nào sau đây
tùy chọn (bỏ qua trường hợp ký tự - Unix tbl chỉ chấp nhận các tùy chọn với tất cả
ký tự viết thường hoặc tất cả các ký tự viết hoa), được phân tách bằng dấu cách, tab hoặc dấu phẩy:

tất cả hộp Đóng gói từng mục của bảng trong một hộp.

cái hộp Đóng bảng trong một hộp.

Trung tâm Căn giữa bảng (mặc định là căn trái). Tên từ khóa thay thế trung tâm
cũng được công nhận (đây là một phần mở rộng GNU tbl).

dấu thập phân(c)
Đặt ký tự được nhận dạng là dấu thập phân trong các cột số (GNU tbl
chỉ có).

delim (xy)
Sử dụng x và y làm dấu phân cách bắt đầu và kết thúc cho tương đương(1).

hộp đôi
Đặt bảng trong một hộp đôi.

khung đôi
Tương tự như hộp đôi (chỉ GNU tbl).

mở rộng Tạo bảng rộng bằng chiều dài dòng hiện tại (cung cấp sự phân tách cột
hệ số). Bị bỏ qua nếu một hoặc nhiều ký hiệu cột 'x' được sử dụng (xem bên dưới).

Trong trường hợp tổng chiều rộng cột lớn hơn chiều dài dòng hiện tại,
hệ số phân tách cột được đặt thành không; các bảng như vậy mở rộng sang lề bên phải,
và không có sự phân tách cột nào cả.

khung Giống như hộp (chỉ GNU tbl).

kích thước đường thẳng(n)
Đặt các dòng hoặc quy tắc (ví dụ: từ cái hộp) trong n-loại điểm.

gác xép Không sử dụng chuyển hướng để ngăn ngắt trang (chỉ GNU tbl). Thông thường tbl nỗ lực
để ngăn chặn các ngắt không mong muốn trong các bảng đóng hộp bằng cách sử dụng các chuyển hướng. Cái này có thể
đôi khi tương tác không tốt với các gói macro sử dụng chính các chuyển hướng, khi chú thích cuối trang,
ví dụ, được sử dụng.

không có khoảng trắng
Bỏ qua khoảng trắng đầu và cuối trong các mục dữ liệu (chỉ GNU tbl).

bây giờ học Tắt cảnh báo liên quan đến bảng vượt quá chiều rộng dòng hiện tại (GNU tbl
chỉ có).

chuyển hướng(x) Sử dụng ký tự x thay vì một tab để tách các mục trong một dòng dữ liệu đầu vào.

Các tùy chọn chung phải kết thúc bằng dấu chấm phẩy. Có thể có khoảng trắng giữa một tùy chọn
và đối số của nó trong ngoặc đơn.

Bàn định dạng đặc điểm kỹ thuật
Sau các tùy chọn toàn cục là các dòng mô tả định dạng của từng dòng trong bảng. Mỗi
dòng định dạng như vậy mô tả một dòng của chính bảng, ngoại trừ dòng định dạng cuối cùng
(mà bạn phải kết thúc bằng dấu chấm) mô tả tất cả các dòng còn lại của bảng. Một đơn-
ký tự chính mô tả từng cột của từng dòng của bảng. Các nhân vật chính có thể là
được phân tách bằng dấu cách hoặc tab. Bạn có thể chạy các đặc tả định dạng cho nhiều dòng
trên cùng một dòng bằng cách phân tách chúng bằng dấu phẩy.

Bạn có thể theo dõi từng ký tự chính với các từ xác định kích thước phông chữ và điểm
của mục tương ứng, xác định chiều rộng cột, khoảng cách giữa các cột, v.v.

Dòng định dạng dài nhất xác định số cột trong bảng; định dạng thiếu
bộ mô tả ở cuối dòng định dạng được giả định là L. Các cột bổ sung trong dữ liệu
(không có mục nhập định dạng tương ứng) bị bỏ qua.

Các ký tự chính có sẵn là:

a,A Căn giữa dòng dài nhất trong cột này và sau đó căn bên trái tất cả các dòng khác trong cột này
đối với dòng căn giữa đó. Ý tưởng là sử dụng bảng chữ cái như vậy
các cột con (do đó là tên của nhân vật chính) kết hợp với L; họ đang
được gọi là cột con bởi vì A các mục được thụt vào 1n so với L mục.
Ví dụ:

.ts
chuyển hướng(;);
ln, an.
mục một; 1
subitem hai; 2
subitem ba; 3
.NS&
ln, an.
mục mười một; 11
subitem hai mươi hai; 22
subitem thứ ba mươi ba; 33
.TRÀ

Kết quả:

mục một 1
subitem hai 2
subitem ba 3
mục 11 XNUMX
subitem hai mươi hai 22
subitem ba mươi ba 33

c,C Mục chính giữa trong cột.

l,L Căn trái mục trong cột.

n,N Căn lề bằng số cho mục trong cột: Các vị trí đơn vị của số được căn chỉnh
theo chiều dọc. Nếu có một hoặc nhiều dấu chấm liền kề với một chữ số, hãy sử dụng dấu chấm ngoài cùng bên phải
một để căn chỉnh theo chiều dọc. Nếu không có dấu chấm, hãy sử dụng chữ số ngoài cùng bên phải cho
căn chỉnh theo chiều dọc; nếu không, hãy căn giữa mục trong cột. Căn chỉnh có thể được
buộc phải đến một vị trí nhất định bằng cách sử dụng '\ &'; nếu có một hoặc nhiều trường hợp này
ký tự đặc biệt (không in được) hiện diện trong dữ liệu, hãy sử dụng ký tự ngoài cùng bên trái cho
sự liên kết. Thí dụ:

.ts
n.
1
1.5
1.5.3
abcde
a \ & bcde
.TRÀ

Kết quả:

1
1.5
1.5.3
abcde
abcde

Nếu các mục nhập số được kết hợp với L or R mục nhập - điều này có thể xảy ra nếu
định dạng bảng được thay đổi với .NS& - trung tâm rộng nhất con số (trong số dữ liệu đã nhập
theo N chế độ xác định) so với chế độ rộng nhất L or R mục nhập, bảo quản
sự liên kết của tất cả các mục số. Trái với A nhập mục nhập, không có thêm
vết lõm.

Sử dụng các phương trình (được xử lý với tương đương) trong các cột sử dụng N người chỉ định
là vấn đề trong hầu hết các trường hợp do tblthuật toán của để tìm dọc
căn chỉnh, như mô tả ở trên. Sử dụng toàn cầu phân định tùy chọn, tuy nhiên, nó là
có thể làm tbl bỏ qua dữ liệu bên trong tương đương dấu phân cách cho mục đích đó.

r,R Căn phải mục trong cột.

s,S Kéo dài mục trước ở bên trái vào cột này. Không được phép cho cột đầu tiên.

^ Kéo dài mục nhập từ hàng trước trong cột này. Không được phép cho hàng đầu tiên.

_,- Thay thế mục nhập này bằng một đường ngang. Lưu ý rằng '_' và '-' có thể được sử dụng cho
chỉ các trường trong bảng, không dành cho các dòng phân tách cột.

= Thay thế mục nhập này bằng một đường ngang kép. Lưu ý rằng '=' có thể được sử dụng cho
chỉ các trường trong bảng, không dành cho các dòng phân tách cột.

| Cột tương ứng trở thành một quy tắc dọc (nếu hai trong số này liền kề,
quy tắc kép dọc).

Một thanh dọc ở bên trái của chữ cái đầu tiên hoặc ở bên phải của chữ cái cuối cùng
tạo ra một dòng ở cạnh bảng.

Để thay đổi định dạng dữ liệu trong bảng, hãy sử dụng .NS& lệnh (ở đầu dòng).
Tiếp theo là định dạng và dòng dữ liệu (nhưng không có tùy chọn chung) tương tự như .ts
yêu cầu.

Cột chuyên gia
Dưới đây là các từ chỉ định có thể xuất hiện trong các hậu tố của các chữ cái chính của cột (theo bất kỳ thứ tự nào):

b,B Dạng ngắn của fB (tô đậm các mục bị ảnh hưởng).

d,D Bắt đầu một mục kéo dài các hàng theo chiều dọc, sử dụng công cụ chỉ định cột '^' hoặc '\ ^'
mục dữ liệu, ở cuối phạm vi của nó thay vì căn giữa nó theo chiều dọc (GNU tbl
chỉ một). Thí dụ:

.ts
tab (;) allbox;
sẽ
ld
r^
ld.
0000; foobar
T{
1111
.br
2222
T}; foo
r;
T{
3333
.br
4444
T}; thanh
\ ^; \ ^
.TRÀ

Kết quả:

┌─────┬─────────┐
│0000 │ foobar │
├─────┼─────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼─────────┤
│3333 │ │
│4444 │ thanh │
└─────┴─────────┘
e,E Tạo các cột cách đều nhau. Tất cả các cột được đánh dấu bằng thông số này đều giống nhau
chiều rộng; điều này xảy ra sau khi độ rộng cột bị ảnh hưởng đã được tính toán (điều này có nghĩa là
mà giá trị chiều rộng lớn nhất quy định).

f,F Một trong hai số chỉ định này có thể được theo sau bởi một tên phông chữ (một hoặc hai
ký tự dài), số phông chữ (một chữ số) hoặc tên dài trong ngoặc đơn (ký tự
dạng cuối cùng là phần mở rộng GNU tbl). Tên phông chữ một chữ cái phải được phân tách bằng một
hoặc nhiều khoảng trống hơn từ bất cứ điều gì sau đây.

i,I Dạng ngắn của fI (in nghiêng các mục bị ảnh hưởng).

m,M Đây là một phần mở rộng GNU tbl. Một trong hai số chỉ định này có thể được theo sau bởi một macro
tên (dài một hoặc hai ký tự) hoặc tên dài trong ngoặc đơn. Một-
tên macro chữ cái phải được phân tách bằng một hoặc nhiều khoảng trống từ bất cứ điều gì sau đây.
Macro mà tên có thể được chỉ định ở đây phải được xác định trước khi tạo
bàn. Nó được gọi ngay trước khi xuất văn bản ô của bảng. Như đã triển khai
hiện tại, macro này chỉ được gọi nếu đầu vào khối được sử dụng, nghĩa là văn bản giữa
'T {' và 'T}'. Macro chỉ nên chứa đơn giản troff yêu cầu thay đổi
định dạng khối văn bản, như điều chỉnh văn bản, gạch nối, kích thước hoặc phông chữ. Macro
được gọi là sau khi các sửa đổi tế bào khác như b, f or v là đầu ra. Do đó, macro
có thể ghi đè các chỉ định sửa đổi khác.

p,P Theo sau là một số, điều này làm thay đổi kích thước điểm cho các trường bị ảnh hưởng. Nếu như
có dấu, kích thước điểm hiện tại được tăng hoặc giảm (sử dụng số có dấu
thay vì một chữ số có dấu là một phần mở rộng GNU tbl). Theo sau một thông số kích thước điểm
bởi một số phân tách cột phải được phân tách bằng một hoặc nhiều ô trống.

t,T Bắt đầu một mục kéo dài theo chiều dọc các hàng ở đầu phạm vi của nó thay vì
căn giữa theo chiều dọc của nó.

u,U Di chuyển cột tương ứng lên một nửa dòng.

v,V Theo sau là một số, điều này cho biết khoảng cách dòng dọc được sử dụng trong
mục nhập bảng nhiều dòng. Nếu được ký, khoảng cách dòng dọc hiện tại là
tăng hoặc giảm (sử dụng một số có dấu thay vì một chữ số có dấu là một
GNU tbl mở rộng). Một chỉ định khoảng cách dòng dọc theo sau là một cột
số phân cách phải cách nhau một hoặc nhiều ô trống. Không có hiệu lực nếu
mục nhập bảng tương ứng không phải là một khối văn bản.

w,W Giá trị chiều rộng cột tối thiểu. Phải được theo sau bởi một troff(1) biểu thức chiều rộng
trong ngoặc đơn hoặc một số nguyên không đơn vị. Nếu không có đơn vị nào được đưa ra, đơn vị en sẽ được sử dụng.
Cũng được sử dụng làm độ dài dòng mặc định cho các khối văn bản được bao gồm. Nếu sử dụng nhiều
lần để chỉ định chiều rộng cho một cột cụ thể, mục nhập cuối cùng có hiệu lực.

x,X Một cột được mở rộng. Sau khi tính toán tất cả các chiều rộng cột mà không có x người chỉ định, sử dụng
chiều rộng dòng còn lại cho cột này. Nếu có nhiều hơn một được mở rộng
, phân phối đều không gian ngang còn lại giữa các cột bị ảnh hưởng
(đây là một phần mở rộng của GNU). Tính năng này có tác dụng tương tự như việc chỉ định một
chiều rộng cột tối thiểu.

z,Z Bỏ qua cột tương ứng cho mục đích tính toán chiều rộng, đây là, không sử dụng
các trường nhưng chỉ các giá trị xác định của cột này để tính chiều rộng của nó.

Hậu tố số trên một ký tự khóa được hiểu là sự phân tách cột theo đơn vị en
(nhân theo tỷ lệ nếu mở rộng tùy chọn đang bật - trong trường hợp bảng quá đầy, điều này
có thể bằng không). Độ phân ly mặc định là 3n.

Công cụ chỉ định cột x loại trừ lẫn nhau với e và w (mục tiêu e không loại trừ lẫn nhau
với w); nếu được chỉ định nhiều lần cho một cột cụ thể, mục nhập cuối cùng sẽ có hiệu lực:
x bỏ thiết lập cả hai e và w, trong khi e or w ghi đè x.

Bàn dữ liệu
Các dòng định dạng được theo sau bởi các dòng chứa dữ liệu thực tế cho bảng, tiếp theo là
cuối cùng bởi .TRÀ. Trong các dòng dữ liệu như vậy, các mục thường được phân tách bằng các ký tự tab
(hoặc ký tự được chỉ định với chuyển hướng Lựa chọn). Các dòng đầu vào dài có thể bị đứt ngang
nhiều dòng nếu ký tự cuối cùng trên dòng là '\' (biến mất sau
nối).

Lưu ý rằng tbl tính toán độ rộng của cột theo từng dòng, áp dụng \ w trên mỗi mục nhập
không phải là một khối văn bản. Do đó, các công trình xây dựng như

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

Thất bại; bạn phải nói

.ts
cp20, lp20.
MM
MMMM
.TRÀ

or

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

Một dấu chấm bắt đầu một dòng, theo sau là bất kỳ thứ gì ngoại trừ một chữ số được xử lý như một lệnh troff,
đi qua mà không có thay đổi. Vị trí bảng không thay đổi trong trường hợp này.

Nếu một dòng dữ liệu chỉ bao gồm '_' hoặc '=', thì một dòng đơn hoặc đôi, tương ứng là
được vẽ trên bàn tại điểm đó; nếu một mục trong dòng dữ liệu chỉ bao gồm '_'
hoặc '=', thì mục đó được thay thế bằng một dòng đơn hoặc dòng kép, nối với các dòng lân cận của nó. Nếu như
một mục dữ liệu chỉ bao gồm '\ _' hoặc '\ =', một dòng đơn hoặc dòng kép, tương ứng, được vẽ
trên toàn trường tại điểm đó mà không tham gia với các nước láng giềng của nó.

Một mục dữ liệu chỉ bao gồm '\ Rx' ('x' bất kỳ ký tự nào) được thay thế bằng các lần lặp lại của
ký tự 'x' rộng bằng cột (không nối với các hàng xóm của nó).

Mục dữ liệu chỉ bao gồm '\ ^' cho biết rằng trường ngay phía trên các khoảng
xuống hàng này.

bản văn khối
Một khối văn bản có thể được sử dụng để nhập dữ liệu dưới dạng một mục nhập duy nhất sẽ quá dài như một
chuỗi đơn giản giữa các tab. Nó được bắt đầu bằng 'T {' và được đóng lại bằng 'T}'. Trước đây
phải kết thúc một dòng và phần sau phải bắt đầu một dòng, có thể được theo sau bởi các cột dữ liệu khác
(được phân tách bằng các tab hoặc ký tự được cho bằng chuyển hướng tùy chọn toàn cầu).

Theo mặc định, khối văn bản được định dạng với các cài đặt đã hoạt động trước đó
vào bảng, có thể bị ghi đè bởi m, vvà w thông số kỹ thuật tbl. Ví dụ,
để làm cho tất cả các khối văn bản rời rạc-bên phải, hãy chèn .na ngay trước khi bắt đầu .ts (Và .ad
sau bảng).

Nếu các từ chỉ định 'w' hoặc 'x [cq] không được cung cấp cho tất cả các cột của khoảng khối văn bản,
độ dài mặc định của khối văn bản (nói chính xác hơn, độ dài dòng được sử dụng để xử lý
chuyển hướng khối văn bản) được tính là L × C / (N + 1), trong đó 'L' là độ dài dòng hiện tại, 'C'
số cột được mở rộng bởi khối văn bản và 'N' tổng số cột trong
cái bàn. Tuy nhiên, lưu ý rằng chiều rộng chuyển hướng thực tế được trả về trong thanh ghi \ n [dl]
cuối cùng được sử dụng làm chiều rộng khối văn bản. Nếu cần, bạn cũng có thể kiểm soát văn bản
chiều rộng khối với sự chèn trực tiếp của một .NS yêu cầu ngay sau 'T {'.

hỗn hợp
Số đăng ký \ n [TW] giữ chiều rộng bảng; nó không thể được sử dụng trong chính bảng
nhưng được xác định ngay trước khi gọi .TRÀ để macro này có thể sử dụng nó.

tbl cũng xác định một macro .NS# tạo ra các dòng dưới cùng và bên cạnh của một bảng đóng hộp.
Trong khi tbl tự gọi macro này ở cuối bảng, nó có thể được sử dụng bởi macro
gói để tạo hộp cho bảng nhiều trang bằng cách gọi nó trong phần chân trang. Một
ví dụ về điều này được hiển thị bởi -bệnh đa xơ cứng macro cung cấp chức năng này nếu một bảng
bắt đầu với .ts H thay vì cuộc gọi tiêu chuẩn tới .ts vĩ mô.

SỰ TƯƠNG TÁC CÙNG VỚI EQN

tbl(1) nên luôn được gọi trước tương đương(số 1) (sự lộn xộn(1) tự động chăm sóc
đúng thứ tự của các bộ tiền xử lý).

GNU TBL NÂNG CAO

Không có giới hạn về số cột trong bảng, cũng không có giới hạn nào về số lượng văn bản
các khối. Tất cả các dòng của bảng được xem xét để quyết định độ rộng cột, không chỉ
200 đầu tiên. Tiếp tục bảng (.NS&) dòng không bị giới hạn trong 200 dòng đầu tiên.

Các mục chữ số và chữ cái có thể xuất hiện trong cùng một cột.

Các mục chữ số và chữ cái có thể kéo dài theo chiều ngang.

tbl sử dụng tên đăng ký, chuỗi, macro và chuyển hướng bắt đầu bằng chữ số 3. Khi nào
sử dụng tbl bạn nên tránh sử dụng bất kỳ tên nào bắt đầu bằng 3.

GNU TBL TRONG MACRO

từ tbl xác định các macro của chính nó (ngay trước mỗi bảng), cần phải sử dụng 'end-
của macro '. Ngoài ra, ký tự thoát phải được tắt. Đây là một
thí dụ.

.eo
.de CÓ THỂ ..
.ts
tab allbox (;);
cl.
\ $ 1; \ $ 2
.TRÀ
hữu ích. Cảm ơn !
.
.ATABLE A bảng
.ATABLE Bảng khác
.ATABLE và "một cái khác"

Tuy nhiên, lưu ý rằng không phải tất cả các tính năng của tbl có thể được bao bọc thành một macro bởi vì tbl nhìn
đầu vào sớm hơn troff. Ví dụ: định dạng số với căn chỉnh theo chiều dọc
dấu thập phân không thành công nếu những số đó được chuyển dưới dạng tham số macro vì số thập phân
căn chỉnh điểm được xử lý bởi tbl chính nó: Nó chỉ nhìn thấy '\ $ 1', '\ $ 2', v.v., và do đó
không thể nhận dạng dấu thập phân.

Sử dụng gtbl trực tuyến bằng các dịch vụ onworks.net