gtbl - Online na nuvem

PROGRAMA:

NOME

tbl - formata tabelas para troff

SINOPSE

tbl [-Cv] [arquivos ...]

DESCRIÇÃO

Esta página do manual descreve a versão GNU do tbl, que faz parte do documento groff
sistema de formatação. tbl compila descrições de tabelas incorporadas em troff arquivos de entrada
em comandos que são compreendidos por troff. Normalmente, ele deve ser invocado usando o -t
opção de groff. É altamente compatível com Unix tbl. A saída gerada pelo GNU tbl
não pode ser processado com Unix troff; deve ser processado com GNU troff. Se nenhum arquivo for
fornecido na linha de comando ou um nome de arquivo de - é fornecido, a entrada padrão é lida.

OPÇÕES

-C Ative o modo de compatibilidade para reconhecer . TS e .TE mesmo quando seguido por um
caractere diferente de espaço ou nova linha. Personagens líderes (\ a) são tratados como
interpretado.

-v Imprima o número da versão.

IDIOMA VISÃO GERAL

tbl espera encontrar descrições de tabela dentro do . TS (início da mesa) e .TE (mesa
fim) macros. Dentro de cada uma dessas seções de tabela, outra tabela pode ser definida usando o
solicitar .T & antes do comando final .TE. Cada definição de tabela tem o seguinte
estrutura:

Global opções
Isso é opcional. Esta parte da tabela pode usar várias dessas opções distribuídas em
1 ou mais linhas. o global opção parte deve sempre ser finalizado por um ponto e vírgula ;
.

mesa formato especificação
Esta parte deve ser fornecida, não é opcional. Determina o número de colunas
(células) da mesa. Além disso, cada célula é classificada por ser central, esquerda
ajustado, ou numérico, etc. Esta especificação pode ter várias linhas, mas deve
ser terminado por um ponto . no final da última linha. Após cada definição de célula,
coluna especificadores pode ser anexado, mas isso é opcional.

As células são separadas por um caractere de tabulação por padrão. Isso pode ser alterado pelo global
opção tbl (c), Onde c é um personagem arbitrário.

SIMPLES EXEMPLOS

A definição de tabela mais fácil é.
. TS
ccc.
Isto é centrado
Bem, isso também
.TE
Usando c c c, cada célula da tabela inteira será centralizada. O personagem de separação
aqui é o padrão aba.

O resultado é

Isto é centrado
Bem, isso também

Esta definição é idêntica a
. TS
aba(@);
ccc.
Este @ é @ centrado
Bem, @ this @ também
.TE
Aqui, o caractere de tabulação de separação é alterado para a letra @.

Além disso, um título pode ser adicionado e as direções de centralização podem ser alteradas para muitos outros
formatos:
. TS
aba(@);
css
lcn.
Título
left @ centres @ 123
outro @ número @ 75
.TE
O resultado é

Título
centros esquerdos 123
outro número 75
Aqui l significa justificado à esquerda e n significa numérico, que está aqui justificado corretamente.

USO

Global opções
A linha imediatamente após o . TS macro pode conter qualquer um dos seguintes globais
opções (ignorando maiúsculas e minúsculas - Unix tbl só aceita opções com todos
caracteres minúsculos ou todos os caracteres maiúsculos), separados por espaços, tabulações ou vírgulas:

caixa de entrada Coloque cada item da mesa em uma caixa.

caixa Coloque a mesa em uma caixa.

centro Centralize a tabela (o padrão é justificado à esquerda). O nome alternativo da palavra-chave Centro
também é reconhecido (esta é uma extensão GNU tbl).

ponto decimal(c)
Defina o carácter a ser reconhecido como o ponto decimal nas colunas numéricas (GNU tbl
só).

delim (xy)
Use x e y como delimitadores de início e fim para eqn(1).

caixa dupla
Coloque a mesa em uma caixa dupla.

moldura dupla
O mesmo que doublebox (GNU tbl apenas).

expandir Faça a tabela tão larga quanto o comprimento da linha atual (fornecendo uma separação de coluna
fator). Ignorado se um ou mais especificadores de coluna 'x' forem usados ​​(veja abaixo).

Caso a soma das larguras das colunas seja maior do que o comprimento da linha atual, o
o fator de separação de coluna é definido como zero; tais tabelas se estendem até a margem direita,
e não há separação de coluna em tudo.

quadro O mesmo que a caixa (GNU tbl apenas).

tamanho da linha(n)
Defina linhas ou regras (por exemplo, de caixa) em n-tipo de ponto.

nokeep Não use desvios para evitar quebras de página (GNU tbl apenas). Normalmente tbl tentativas
para evitar quebras indesejáveis ​​em tabelas encaixotadas usando desvios. Isso pode
às vezes interagem mal com os próprios pacotes de macro uso de desvios, quando notas de rodapé,
por exemplo, são usados.

sem espaços
Ignore espaços à esquerda e à direita em itens de dados (GNU tbl apenas).

agora Desligue os avisos relacionados com as tabelas que excedem a largura da linha actual (GNU tbl
só).

aba(x) Use o personagem x em vez de uma guia para separar itens em uma linha de dados de entrada.

As opções globais devem terminar com um ponto e vírgula. Pode haver um espaço em branco entre uma opção
e seu argumento entre parênteses.

mesa formato especificação
Depois das opções globais, vêm as linhas que descrevem o formato de cada linha da tabela. Cada
essa linha de formato descreve uma linha da própria tabela, exceto que a última linha de formato
(que deve terminar com um ponto) descreve todas as linhas restantes da tabela. Um único
personagem-chave descreve cada coluna de cada linha da tabela. Os personagens principais podem ser
separados por espaços ou tabulações. Você pode executar especificações de formato para várias linhas
juntos na mesma linha, separando-os com vírgulas.

Você pode seguir cada caractere chave com especificadores que determinam a fonte e o tamanho do ponto
do item correspondente, que determina a largura da coluna, espaçamento entre colunas, etc.

A linha de formato mais longa define o número de colunas na tabela; falta de formato
descritores no final das linhas de formato são considerados L. Colunas extras nos dados
(que não têm entrada de formato correspondente) são ignorados.

Os personagens principais disponíveis são:

a,A Centraliza a linha mais longa nesta coluna e, em seguida, justifica à esquerda todas as outras linhas neste
coluna em relação a essa linha centrada. A ideia é usar essa linguagem alfabética
subcolunas (daí o nome do caractere-chave) em combinação com L; eles são
chamadas subcolunas porque A itens são recuados por 1n em relação a L entradas.
Exemplo:

. TS
aba(;);
ln, an.
item um; 1
subitem dois; 2
subitem três; 3
.T &
ln, an.
item onze; 11
subitem vinte e dois; 22
subitem trinta e três; 33
.TE

Resultado:

item um 1
subitem dois 2
subitem três 3
item onze 11
subitem vinte e dois 22
subitem trinta e três 33

c,C Centralize o item na coluna.

l,L Justifique o item à esquerda na coluna.

n,N Justificar numericamente o item na coluna: As posições das unidades dos números estão alinhadas
verticalmente. Se houver um ou mais pontos adjacentes a um dígito, use o mais à direita
um para alinhamento vertical. Se não houver nenhum ponto, use o dígito mais à direita para
Alinhamento vertical; caso contrário, centralize o item na coluna. O alinhamento pode ser
forçado a uma determinada posição usando '\ &'; se houver uma ou mais instâncias deste
caractere especial (não imprimível) presente nos dados, use o mais à esquerda para
alinhamento. Exemplo:

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

Resultado:

1
1.5
1.5.3
abcde
abcde

Se as entradas numéricas forem combinadas com L or R entradas - isso pode acontecer se o
o formato da tabela é alterado com .T & - centrar o mais largo número (dos dados inseridos
sob a N regime do especificador) em relação ao mais amplo L or R entrada, preservando o
alinhamento de todas as entradas numéricas. Contrário a A digite entradas, não há nenhum extra
recuo.

Usando equações (para ser processado com eqn) em colunas que usam o N especificador
é problemático na maioria dos casos devido a tblalgoritmo de para encontrar o vertical
alinhamento, conforme descrito acima. Usando o global delim opção, no entanto, é
possível fazer tbl ignore os dados dentro eqn delimitadores para esse fim.

r,R Justifique o item à direita na coluna.

s,S Estenda o item anterior à esquerda nesta coluna. Não permitido para a primeira coluna.

^ Amplie a entrada da linha anterior nesta coluna. Não permitido para a primeira linha.

_,- Substitua esta entrada por uma linha horizontal. Observe que '_' e '-' podem ser usados ​​para
campos de tabela apenas, não para linhas separadoras de coluna.

= Substitua esta entrada por uma linha horizontal dupla. Observe que '=' pode ser usado para
campos de tabela apenas, não para linhas separadoras de coluna.

| A coluna correspondente se torna uma regra vertical (se duas delas forem adjacentes, um
regra vertical dupla).

Uma barra vertical à esquerda da primeira letra ou à direita da última
produz uma linha na borda da mesa.

Para alterar o formato dos dados em uma tabela, use o .T & comando (no início de uma linha).
Ele é seguido por formato e linhas de dados (mas sem opções globais) semelhantes ao . TS
solicitação.

Coluna especificadores
Aqui estão os especificadores que podem aparecer em sufixos para letras-chave de coluna (em qualquer ordem):

b,B Forma abreviada de fB (coloque as entradas afetadas em negrito).

d,D Inicie um item que abranja linhas verticalmente, usando o especificador de coluna '^' ou '\ ^'
item de dados, na parte inferior de seu intervalo, em vez de centralizá-lo verticalmente (GNU tbl
só). Exemplo:

. TS
tab (;) allbox;
tudo
ld
^
lrd.
0000; foobar
T{
1111
.br
2222
T}; foo
r;
T{
3333
.br
4444
T}; bar
\ ^; \ ^
.TE

Resultado:

┌─────┬────────┐
│0000 │ foobar │
├─────┼────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼────────┤
│3333 │ │
│4444 │ barra │
└─────┴────────┘
e,E Faça colunas igualmente espaçadas. Todas as colunas marcadas com este especificador têm o mesmo
largura; isso acontece depois que as larguras das colunas afetadas foram calculadas (isso significa
que as regras de maior valor de largura).

f,F Qualquer um desses especificadores pode ser seguido por um nome de fonte (um ou dois
caracteres de comprimento), número da fonte (um único dígito) ou nome longo entre parênteses (o
a última forma é uma extensão GNU tbl). Um nome de fonte de uma letra deve ser separado por um
ou mais espaços em branco de tudo o que se segue.

i,I Forma abreviada de fI (coloque as entradas afetadas em itálico).

m,M Esta é uma extensão GNU tbl. Qualquer um desses especificadores pode ser seguido por uma macro
nome (com um ou dois caracteres) ou nome longo entre parênteses. Um-
o nome da macro de letras deve ser separado por um ou mais espaços em branco do que vem a seguir.
A macro cujo nome pode ser especificado aqui deve ser definida antes de criar o
tabela. É chamado imediatamente antes da saída do texto da célula da tabela. Conforme implementado
atualmente, esta macro só é chamada se a entrada de bloco for usada, ou seja, o texto entre
'T {' e 'T}'. A macro deve conter apenas simples troff pedidos para mudar o
formatação de bloco de texto, como ajuste de texto, hifenização, tamanho ou fonte. A macro
é chamado depois de outras modificações de células como b, f or v são produzidos. Assim, a macro
pode substituir outros especificadores de modificação.

p,P Seguido por um número, isso faz uma mudança no tamanho do ponto para os campos afetados. Se
assinado, o tamanho do ponto atual é incrementado ou diminuído (usando um número assinado
em vez de um dígito com sinal é uma extensão GNU tbl). Um especificador de tamanho de ponto seguido
por um número de separação de coluna deve ser separado por um ou mais espaços em branco.

t,T Comece um item verticalmente estendendo as linhas no topo de sua faixa, em vez de
centralizando-o verticalmente.

u,U Mova a coluna correspondente meia-linha acima.

v,V Seguido por um número, indica o espaçamento entre linhas verticais a ser usado em um
entrada de tabela multilinha. Se assinado, o espaçamento de linha vertical atual é
incrementado ou decrementado (usar um número com sinal em vez de um dígito com sinal é um
Extensão GNU tbl). Um especificador de espaçamento de linha vertical seguido por uma coluna
o número de separação deve ser separado por um ou mais espaços em branco. Sem efeito se o
a entrada da tabela correspondente não é um bloco de texto.

w,W Valor mínimo da largura da coluna. Deve ser seguido por um troff(1) expressão de largura
entre parênteses ou um inteiro sem unidade. Se nenhuma unidade for fornecida, unidades en são usadas.
Também usado como comprimento de linha padrão para blocos de texto incluídos. Se usado múltiplo
vezes para especificar a largura de uma coluna específica, a última entrada entra em vigor.

x,X Uma coluna expandida. Depois de calcular todas as larguras de coluna sem um x especificador, use
a largura da linha restante para esta coluna. Se houver mais de um expandido
coluna, distribua o espaço horizontal restante uniformemente entre as colunas afetadas
(esta é uma extensão GNU). Este recurso tem o mesmo efeito que especificar um
largura mínima da coluna.

z,Z Ignore a coluna correspondente para fins de cálculo de largura, isto é, não use
os campos, mas apenas os especificadores desta coluna para calcular sua largura.

Um sufixo numérico em um caractere-chave é interpretado como uma separação de coluna em unidades
(multiplicado na proporção se o expandir opção está ativada - no caso de tabelas muito cheias,
pode ser zero). A separação padrão é 3n.

O especificador de coluna x é mutuamente exclusivo com e e w (mas e não é mutuamente exclusivo
com w); se especificado várias vezes para uma coluna específica, a última entrada terá efeito:
x desarma ambos e e w, enquanto qualquer um e or w Substitui x.

mesa dados,
As linhas de formato são seguidas por linhas contendo os dados reais da tabela, seguidas
finalmente por .TE. Dentro de tais linhas de dados, os itens são normalmente separados por caracteres de tabulação
(ou o caractere especificado com o aba opção). Longas linhas de entrada podem ser quebradas
várias linhas se o último caractere da linha for '\' (que desaparece após
concatenação).

Observe que tbl calcula as larguras das colunas linha por linha, aplicando \ w em cada entrada que
não é um bloco de texto. Como consequência, construções como

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

falhou; você deve dizer

. TS
cp20, lp20.
MM
MMMM
.TE

or

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

Um ponto iniciando uma linha, seguido por qualquer coisa, exceto um dígito, é tratado como um comando troff,
passou sem alterações. A posição da mesa permanece inalterada neste caso.

Se uma linha de dados consiste em apenas '_' ou '=', uma linha simples ou dupla, respectivamente, é
desenhado sobre a mesa naquele ponto; se um único item em uma linha de dados consistir em apenas '_'
ou '=', então esse item é substituído por uma linha simples ou dupla, unindo seus vizinhos. Se
um item de dados consiste apenas em '\ _' ou '\ =', uma linha simples ou dupla, respectivamente, é desenhada
através do campo naquele ponto que não se junta a seus vizinhos.

Um item de dados consistindo apenas em '\ Rx' ('x' qualquer caractere) é substituído por repetições de
caractere 'x' tão largo quanto a coluna (não unindo seus vizinhos).

Um item de dados consistindo apenas em '\ ^' indica que o campo imediatamente acima abrange
para baixo sobre esta linha.

Texto blocos
Um bloco de texto pode ser usado para inserir dados como uma única entrada que seria muito longa como um
string simples entre as guias. Ele é iniciado com 'T {' e fechado com 'T}'. O antigo
deve terminar uma linha, e este último deve iniciar uma linha, provavelmente seguida por outras colunas de dados
(separados por tabulações ou o caractere fornecido com o aba opção global).

Por padrão, o bloco de texto é formatado com as configurações que estavam ativas antes
entrar na tabela, possivelmente substituído pelo m, v e w especificadores tbl. Por exemplo,
para tornar todos os blocos de texto irregulares - à direita, insira .n / D um pouco antes do começo . TS (E .de Anúncios
após a mesa).

Se os especificadores 'w' ou 'x [cq] não forem fornecidos para todos os colunas de um intervalo de bloco de texto, o
comprimento padrão do bloco de texto (para ser mais preciso, o comprimento da linha usado para processar o
desvio de bloco de texto) é calculado como L × C / (N + 1), onde 'L' é o comprimento da linha atual, 'C'
o número de colunas distribuídas pelo bloco de texto, e 'N' o número total de colunas em
a mesa. Observe, no entanto, que a largura de desvio real conforme retornada no registro \ n [dl]
é usado eventualmente como a largura do bloco de texto. Se necessário, você também pode controlar o texto
largura do bloco com uma inserção direta de um .ll pedido logo após 'T {'.

Gerais
O número de registro \ n [TW] segura a largura da mesa; não pode ser usado dentro da própria mesa
mas é definido logo antes de chamar .TE para que esta macro possa fazer uso dele.

tbl também define uma macro .T # que produz as linhas inferior e lateral de uma mesa em caixa.
Enquanto tbl chama esta macro no final da tabela, ela pode ser usada pela macro
pacotes para criar caixas para tabelas de várias páginas chamando-o no rodapé da página. Um
exemplo disso é mostrado pelo -em macros que fornecem esta funcionalidade se uma tabela
começa com . TS H em vez da chamada padrão para o . TS macro.

INTERAÇÃO COM EQN

tbl(1) deve ser sempre chamado antes eqn(1) (Groff(1) automaticamente cuida do
ordem correta dos pré-processadores).

GNU TBL AMENAGENS

Não há limite para o número de colunas em uma tabela, nem qualquer limite para o número de texto
blocos. Todas as linhas de uma tabela são consideradas para decidir as larguras das colunas, não apenas o
primeiros 200. Continuação da tabela (.T &) as linhas não estão restritas às primeiras 200 linhas.

Os itens numéricos e alfabéticos podem aparecer na mesma coluna.

Os itens numéricos e alfabéticos podem abranger horizontalmente.

tbl usa nomes de registro, string, macro e desvio começando com o dígito 3. Quando
utilização tbl você deve evitar usar qualquer nome que comece com um 3.

GNU TBL DENTRO MACROS

Como tbl define suas próprias macros (logo antes de cada tabela), é necessário usar um 'end-
macro of-macro. Além disso, o caractere de escape deve ser desativado. Aqui um
exemplo.

.eo
.de ATÁVEL ..
. TS
guia allbox (;);
cl.
\ $ 1; \ $ 2
.TE
...
.ec
.ATABLE A mesa
.ATABLE Outra mesa
.ATABLE E "outro"

Observe, no entanto, que nem todos os recursos do tbl pode ser agrupado em uma macro porque tbl vê
a entrada antes de troff. Por exemplo, formatação de número com alinhamento vertical
pontos decimais falharão se esses números forem passados ​​como parâmetros de macro porque decimais
o alinhamento do ponto é tratado por tbl próprio: ele vê apenas '\ $ 1', '\ $ 2', etc., e portanto
não consegue reconhecer a vírgula decimal.

Use gtbl online usando serviços onworks.net