gtbl - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

tbl - формат таблиць для troff

СИНТАКСИС

табл [-Резюме] [файли ...]

ОПИС

Ця сторінка посібника описує версію GNU табл, який є частиною документа groff
система форматування. табл компілює описи таблиць, вбудованих в них троф вхідні файли
на команди, які зрозумілі для троф. Зазвичай його потрібно викликати за допомогою -t
можливість грофф. Він дуже сумісний з Unix табл. Вихід, згенерований GNU табл
не можна обробити за допомогою Unix троф; він повинен бути оброблений за допомогою GNU троф. Якщо файлів немає
вказано в командному рядку або ім’я файлу - дається, стандартний вхід зчитується.

ВАРІАНТИ

-C Увімкніть режим сумісності для розпізнавання .TS та .TE навіть якщо за ним слідує a
символ, відмінний від пробілу або нового рядка. Вивідні символи (\a) обробляються як
інтерпретується.

-v Надрукуйте номер версії.

МОВА ОГЛЯД

табл очікує знайти описи таблиць, загорнуті в .TS (початок таблиці) і .TE (стіл
кінець) макроси. Усередині кожного такого розділу таблиці можна визначити іншу таблицю за допомогою
запросити .T& перед останньою командою .TE. Кожне визначення таблиці має наступне
структура:

Глобальний опції
Це необов’язково. У цій частині таблиці можна використовувати кілька з цих параметрів, розподілених у
1 або більше рядків. The в цілому варіант частина завжди має закінчуватися a крапка з комою ;
.

таблиця формат специфікація
Цю частину необхідно надати, вона не є обов’язковою. Він визначає кількість стовпців
(клітинки) таблиці. Крім того, кожна клітина класифікується як центральна, ліва
скоригована, чисельна тощо. Ця специфікація може мати кілька рядків, але обов'язкова
бути закінчено а точка . в кінці останнього рядка. Після кожного визначення клітинки,
колонка специфікатори можна додати, але це необов'язково.

За замовчуванням клітинки розділені символом табуляції. Це можна змінити за допомогою в цілому
варіант tbl(c), Де c є довільним символом.

ПРОСТО ПРИКЛАДИ

Найпростіше визначення таблиці.
.TS
cc .
Це зосереджено
Ну і це теж
.TE
За допомогою c c c, кожна клітинка у всій таблиці буде відцентрована. Розділяє символ
тут за замовчуванням таб.

В результаті

Це зосереджено
Ну і це теж

Це визначення тотожне
.TS
вкладка (@);
куб.
Це@по центру
Ну,@це@також
.TE
Тут розділовий символ табуляції змінюється на букву @.

Крім того, можна додати заголовок, а напрямки центрування можна змінити на багато інших
формати:
.TS
вкладка (@);
css
lcn .
назва
left@centers@123
інший@номер@75
.TE
В результаті

назва
ліві центри 123
ще один номер 75
тут l засоби вирівнювання по лівому краю та n засоби числовий, який знаходиться тут виправдано праворуч.

ВИКОРИСТАННЯ

Глобальний опції
Лінія, що йде безпосередньо за .TS макрос може містити будь-яке з наступних глобальних
параметри (ігноруючи регістр символів – Unix tbl приймає параметри лише з усіма
символи нижнього регістру або всі символи у верхньому регістрі), розділені пробілами, табуляціями або комами:

allbox Складіть кожен пункт таблиці в коробку.

ящик Закладіть таблицю в коробку.

центр Центрувати таблицю (за замовчуванням вирівнюється по лівому краю). Альтернативна назва ключового слова центр
також розпізнається (це розширення GNU tbl).

десяткова кома(c)
Встановіть символ, який розпізнається як десяткову кому в числових стовпцях (GNU tbl
тільки)

делім(xy)
Скористайтесь x та y як початкові та кінцеві роздільники для екв(1).

подвійний ящик
Вкладіть таблицю в подвійну коробку.

подвійна рама
Те саме, що doublebox (лише GNU tbl).

Розширювати Зробіть таблицю шириною поточної довжини рядка (забезпечуючи розділення стовпців
фактор). Ігнорується, якщо використовується один або кілька специфікаторів стовпців 'x' (див. нижче).

Якщо сума ширин стовпців більша за поточну довжину рядка, то
коефіцієнт розділення стовпчиків встановлюється на нуль; такі таблиці поширюються на праве поле,
і немає поділу стовпців взагалі.

кадр Те саме, що коробка (лише GNU tbl).

розмір лінії(n)
Встановіть рядки або правила (наприклад, від ящикв) n- точковий тип.

nokeep Не використовуйте відхилення, щоб запобігти розривам сторінок (лише GNU tbl). Зазвичай табл спроби
щоб запобігти небажаним розривам у коробкових таблицях за допомогою диверсій. Це може
іноді погано взаємодіє з пакетами макросів, власне використання відвернень, коли виноски,
наприклад, використовуються.

непробіли
Ігноруйте початкові та кінцеві пробіли в елементах даних (лише GNU tbl).

nowarn Вимкніть попередження, пов’язані з таблицями, які перевищують поточну ширину рядка (GNU tbl
тільки)

вкладка (x) Використовуйте персонажа x замість вкладки для розділення елементів у рядку вхідних даних.

Глобальні параметри мають закінчуватися крапкою з комою. Між параметрами може бути пробіл
і його аргумент у дужках.

таблиця формат специфікація
Після глобальних параметрів йдуть рядки, що описують формат кожного рядка таблиці. Кожен
такий рядок форматування описує один рядок самої таблиці, за винятком останнього рядка форматування
(яку потрібно закінчити крапкою) описує всі залишилися рядки таблиці. Одинокий-
ключовий символ описує кожен стовпець кожного рядка таблиці. Ключові персонажі можуть бути
розділені пробілами або табуляціями. Ви можете запустити специфікації формату для кількох рядків
разом в одному рядку, розділяючи їх комами.

Ви можете слідувати за кожним ключовим символом специфікаторами, які визначають шрифт і розмір точки
відповідного пункту, що визначають ширину стовпця, міжстовпцевий інтервал тощо.

Найдовший рядок формату визначає кількість стовпців у таблиці; відсутній формат
дескриптори в кінці рядків формату вважаються такими L. Додаткові стовпці в даних
(які не мають відповідного запису формату) ігноруються.

Доступні ключові символи:

a,A Відцентрувати найдовший рядок у цьому стовпці, а потім вирівняти всі інші рядки в ньому за лівим кутом
стовпець відносно цієї центрованої лінії. Ідея полягає в тому, щоб використовувати такий алфавіт
підстовпці (звідси назва ключового символу) у поєднанні з L; вони є
підколонками, тому що A елементи мають відступ 1n відносно L записів
приклад:

.TS
вкладка(;);
ln,an.
пункт перший; 1
підпункт другий; 2
підпункт третій;3
.T&
ln,an.
пункт одинадцятий;11
підпункт двадцять другий;22
підпункт тридцять третій;33
.TE

Результат:

пункт перший 1
підпункт 2
підпункт третій 3
пункт одинадцятий 11
підпункт двадцять другий 22
підпункт тридцять третій 33

c,C Центрувати елемент у стовпці.

l,L Вирівняйте елемент у стовпці за лівим кутом.

n,N Числове обґрунтування пункту в стовпці: Позиції одиниць чисел вирівнюються
вертикально. Якщо поруч із цифрою є одна або кілька крапок, використовуйте крайню праву
один для вертикального вирівнювання. Якщо крапки немає, використовуйте крайню праву цифру для
вертикальне вирівнювання; інакше розмістіть елемент по центру в стовпці. Вирівнювання може бути
примусово до певної позиції за допомогою '\&'; якщо є один або кілька таких випадків
Спеціальний (недрукований) символ, присутній у даних, використовуйте крайній лівий символ
вирівнювання. приклад:

.TS
n.
1
1.5
1.5.3
абсід
a\&bcde
.TE

Результат:

1
1.5
1.5.3
абсід
абсід

Якщо числові записи поєднуються з L or R записи – це може статися, якщо
формат таблиці змінюється за допомогою .T& – по центру найширше номер (з введених даних
під N специфікуючий режим) відносно найширшого L or R вхід, зберігаючи
вирівнювання всіх цифрових записів. Всупереч A тип записів, немає зайвих
відступ.

Використання рівнянь (для обробки екв) у стовпцях, які використовують N специфікатор
у більшості випадків проблематично через таблАлгоритм пошуку вертикалі
вирівнювання, як описано вище. Використання глобального розмежувати варіант, однак, він є
можливо зробити табл ігнорувати дані всередині екв роздільники для цієї мети.

r,R Вирівняйте елемент у стовпці по правому краю.

s,S Перетягніть попередній елемент ліворуч у цей стовпець. Не допускається для першого стовпця.

^ Розгорнути запис з попереднього рядка в цьому стовпці. Не допускається до першого ряду.

_,- Замініть цей запис горизонтальною лінією. Зауважте, що '_' і '-' можна використовувати для
тільки поля таблиці, не для рядків роздільників стовпців.

= Замініть цей запис подвійною горизонтальною лінією. Зауважте, що '=' можна використовувати для
тільки поля таблиці, не для рядків роздільників стовпців.

| Відповідний стовпець стає вертикальним правилом (якщо два з них сусідні, a
подвійне вертикальне правило).

Вертикальна смуга ліворуч від першої ключової літери або праворуч від останньої
створює рядок на краю таблиці.

Щоб змінити формат даних у таблиці, скористайтеся .T& команда (на початку рядка).
За ним слідують рядки формату та даних (але без глобальних параметрів), подібні до .TS
запит

Колонка специфікатори
Ось специфікатори, які можуть відображатися в суфіксах до ключових літер стовпців (у будь-якому порядку):

b,B Коротка форма fB (зробіть відповідні записи жирним).

d,D Почніть елемент, який вертикально охоплює рядки, використовуючи специфікатор стовпця '^' або '\^'
елемент даних, у нижній частині діапазону, а не вертикально по центру (GNU tbl
тільки). приклад:

.TS
tab(;) allbox;
ll
l ld
г ^
л.р.
0000;фубар
T{
1111
.br
2222
T};foo
r;
T{
3333
.br
4444
T};бар
\^;\^
.TE

Результат:

┌──────┬─────────┐
│0000 │ foobar │
├──────┼─────────┤
│1111 │ │
│2222 │ │
├──────┤ │
│ r │ foo │
├──────┼─────────┤
│3333 │ │
│4444 │ бар │
└─────┴─────────┘
e,E Зробіть рівномірні стовпці. Усі стовпці, позначені цим специфікатором, отримують однакові
ширина; це відбувається після обчислення ширини відповідних стовпців (це означає
що правило найбільшого значення ширини).

f,F За будь-яким із цих специфікаторів може слідувати назва шрифту (один або два
довжина символів), номер шрифту (одна цифра) або довга назва в дужках (
остання форма є розширенням GNU tbl). Назва шрифту з однієї літери має бути розділена одиницею
або більше пробілів з того, що далі.

i,I Коротка форма fI (зробіть відповідні записи курсивом).

m,M Це розширення GNU tbl. За будь-яким із цих специфікаторів може слідувати макрос
ім'я (один або два символи) або довге ім'я в дужках. Один-
Ім’я макросу літери має бути відокремлено одним або кількома пробілами від наступних.
Макрос, ім'я якого можна вказати тут, необхідно визначити перед створенням
стіл. Він викликається безпосередньо перед виведенням тексту клітинки таблиці. Як реалізовано
наразі цей макрос викликається лише у випадку, якщо використовується блоковий введення, тобто текст між ними
"T{" і "T}". Макрос повинен містити тільки прості троф прохання змінити
форматування текстового блоку, як-от коригування тексту, перенесення, розмір або шрифт. Макрос
це називається після інші модифікації клітини, як b, f or v виводяться. Таким чином макрос
може замінювати інші специфікатори модифікації.

p,P Після цифри це змінює розмір точки для зачеплених полів. Якщо
зі знаком, поточний розмір точки збільшується або зменшується (за допомогою числа зі знаком
замість знакової цифри є розширення GNU tbl). Далі слідував специфікатор розміру точки
номер розділу стовпців має бути розділений одним або кількома пробілами.

t,T Почніть елемент вертикально охоплюючи рядки у верхній частині діапазону, а не
вертикально центруючи його.

u,U Перемістіть відповідний стовпець на одну піврядку вгору.

v,V Після цифри це вказує вертикальний міжрядковий інтервал, який буде використано в a
введення багаторядкової таблиці. Якщо підписано, поточний вертикальний міжрядковий інтервал дорівнює
збільшується або зменшується (використання знакового числа замість цифри зі знаком є ​​a
розширення GNU tbl). Специфікатор вертикального міжрядкового інтервалу, за яким слідує стовпець
розділовий номер має бути розділений одним або кількома пробілами. Немає ефекту, якщо
відповідний запис таблиці не є текстовим блоком.

w,W Значення мінімальної ширини стовпця. За ним має слідувати а троф(1) вираз ширини
в дужках або ціле безодиничне число. Якщо не вказано одиницю, використовується en.
Також використовується як довжина рядка за замовчуванням для включених текстових блоків. Якщо використовується багаторазово
разів, щоб вказати ширину для конкретного стовпця, останній запис вступає в силу.

x,X Розгорнута колонка. Після обчислення ширини всіх стовпців без символу x специфікатор, використання
ширина рядка, що залишилася для цього стовпця. Якщо їх більше одного розгорнутого
рівномірно розподіліть решту горизонтального простору між ураженими стовпцями
(це розширення GNU). Ця функція має той самий ефект, що й указування a
мінімальна ширина стовпця.

z,Z Ігноруйте відповідний стовпець для розрахунку ширини, тобто не використовуйте
поля, а лише специфікатори цього стовпця для обчислення його ширини.

Суфікс числа на ключовому символі інтерпретується як розділення стовпців у одиницях
(помножити пропорційно, якщо Розширювати увімкнено опцію – у разі переповненості столів це
може бути нульовим). Розділ за замовчуванням — 3n.

Специфікатор стовпця x є взаємовиключними з e та w (але e не є взаємовиключними
з w); якщо вказано кілька разів для певного стовпця, останній запис набуває чинності:
x скидає обидва e та w, в той час як або e or w перевизначає x.

таблиця дані
Після рядків формату йдуть рядки, що містять фактичні дані для таблиці
нарешті .TE. У таких рядках даних елементи зазвичай розділяються символами табуляції
(або символ, зазначений за допомогою таб варіант). Довгі лінії введення можуть бути розбиті
кілька рядків, якщо останнім символом у рядку є '\' (який зникає після
конкатенація).

Зверніть увагу, що табл обчислює ширину стовпців рядок за рядком, застосовуючи \w до кожного запису, який
не є текстовим блоком. Як наслідок, конструкції подібні

.TS
в, л.
\s[20]ММ
ММММ
.TE

невдача; ви повинні або сказати

.TS
cp20,lp20.
MM
ММММ
.TE

or

.TS
в, л.
\s[20]ММ
\s[20]ММММ
.TE

Крапка, що починається рядком, за якою слідує будь-що, крім цифри, обробляється як команда troff,
пройшов без змін. У цьому випадку положення столу не змінюється.

Якщо рядок даних складається лише з '_' або '=', один або подвійний рядок, відповідно
накреслений через стіл у цьому місці; якщо один елемент у рядку даних складається лише з '_'
або '=', тоді цей елемент замінюється одним або подвійним рядком, що з'єднує його сусідів. Якщо
елемент даних складається тільки з '\_' або '\=', малюється одна або подвійна лінія відповідно
через поле в тій точці, яка не приєднується до своїх сусідів.

Елемент даних, що складається лише з '\Rx' ('x' будь-який символ), замінюється повтореннями
символ 'x' такий же ширини, як стовпець (не з'єднується зі своїми сусідами).

Елемент даних, що складається лише з '\^', вказує, що поле безпосередньо вище охоплює
вниз над цим рядком.

текст Блоки
Текстовий блок можна використовувати для введення даних як одного запису, який був би занадто довгим, як a
простий рядок між вкладками. Він починається з 'T{' і завершується 'T}'. Колишній
повинен закінчувати рядок, а останній повинен починати рядок, за яким, ймовірно, слідують інші стовпці даних
(відокремлено символами табуляції або символом, заданим за допомогою таб глобальний варіант).

За замовчуванням текстовий блок форматується з налаштуваннями, які були активні раніше
введення в таблицю, можливо, замінено m, v та w специфікатори tbl. Наприклад,
щоб зробити всі текстові блоки рваними вправо, вставте .na безпосередньо перед стартом .TS (І .ad
після столу).

Якщо специфікатори 'w' або 'x[cq] не вказані для всі стовпці діапазону текстового блоку,
довжина текстового блоку за замовчуванням (точніше, довжина рядка, яка використовується для обробки
переведення текстового блоку) обчислюється як L×C/(N+1), де 'L' - поточна довжина рядка, 'C'
кількість стовпців, охоплених текстовим блоком, і "N" - загальна кількість стовпців
стіл. Зауважте, однак, що фактична ширина відхилення, яка повертається в регістрі \n[dl]
зрештою використовується як ширина текстового блоку. При необхідності ви також можете керувати текстом
ширина блоку з прямою вставкою a .ll запит відразу після "T{".

Різне
Регістр номерів \n[TW] утримує ширину столу; його не можна використовувати в самій таблиці
але визначається безпосередньо перед викликом .TE щоб цей макрос міг ним скористатися.

табл також визначає макрос .T# який створює нижню і бічні лінії коробкового столу.
У той час як табл викликає сам цей макрос в кінці таблиці, його можна використовувати макросом
пакети для створення блоків для багатосторінкових таблиць, викликавши їх у нижньому колонтитулі сторінки. An
прикладом цього є -РС макроси, які забезпечують цю функціональність, якщо табл
починається з .TS H замість стандартного виклику .TS макрос.

ВЗАЄМОДІЯ З EQN

табл(1) завжди слід викликати раніше екв(1) (groff(1) автоматично піклується про
правильний порядок препроцесорів).

GNU TBL УДОСКОНАЛЕННЯ

Немає жодних обмежень ні на кількість стовпців у таблиці, ні на кількість тексту
блоків. Усі рядки таблиці враховуються при визначенні ширини стовпців, а не тільки
перші 200. Продовження таблиці (.T&) рядки не обмежуються першими 200 рядками.

Цифрові та алфавітні елементи можуть відображатися в одному стовпці.

Цифрові та алфавітні елементи можуть розташовуватися горизонтально.

табл використовує регістр, рядок, макрос і назви переадресації, які починаються з цифри 3. Коли
використання табл вам слід уникати використання будь-яких імен, які починаються на а 3.

GNU TBL ВНУТРІ МАКРОС

З табл визначає власні макроси (прямо перед кожною таблицею), необхідно використовувати 'end-
of-macro' макрос. Крім того, escape-символ потрібно вимкнути. Тут ан
приклад.

.eo
.de ATABLE ..
.TS
вкладка allbox(;);
кл.
\$1;\$2
.TE
...
.ec
Таблиця
.ATABLE Ще один стіл
.ATABLE І "ще один"

Однак зауважте, що не всі особливості табл можна загорнути в макрос, тому що табл бачить
введення раніше ніж троф. Наприклад, форматування чисел з вертикальним вирівнюванням
десяткові точки не вдається, якщо ці числа передаються як параметри макросу, оскільки десяткові
Вирівнювання точки обробляється за допомогою табл сам: він бачить лише '\$1', '\$2' тощо, і тому
не можу розпізнати десяткову кому.

Використовуйте gtbl онлайн за допомогою служб onworks.net