caixas - Online na nuvem

PROGRAMA:

NOME

caixas - caixa de modo de texto e filtro de desenho de comentário

SINOPSE

caixas [-hlmrv] [-a formato] [-d design] [-f arquivo] [-i recuo] [-k bool] [-p pad] [-s tamanho]
[-t tabopts] [arquivo de entrada [arquivo de saída]]

DESCRIÇÃO

caixas é um filtro de texto que pode desenhar qualquer tipo de caixa ao redor do texto de entrada. Design da caixa
as opções variam de caixas simples a arte ASCII complexa. Uma caixa também pode ser removida e
reparado, mesmo que tenha sido muito danificado pela edição do texto interno. Uma vez que as caixas podem
estar aberto em qualquer lado, caixas também pode ser usado para criar comentários regionais em qualquer programação
língua. Novos designs de caixa de todos os tipos podem ser facilmente adicionados e compartilhados anexando a um
arquivo de configuração de formato livre.
caixas foi originalmente concebido para ser usado com o vitalidade(1) editor de texto, mas pode ser amarrado
a qualquer editor de texto que suporte filtros, bem como chamados a partir da linha de comando como um
ferramenta autônoma.

OPÇÕES

Opções oferecidas por caixas são as seguintes:

-a corda
Alinhamento / posicionamento do texto dentro da caixa. Esta opção leva um argumento de string de formato
que é lido da esquerda para a direita. A string de formato não pode conter espaços em branco e
deve consistir em um ou mais dos seguintes componentes:

hx - alinhamento horizontal do bloco de texto de entrada dentro de uma caixa potencialmente maior.
Valores possíveis para x e guarante que os mesmos estão l (ell, para alinhamento à esquerda), c (centro), ou r (certo).
Isto não afeta a justificação das linhas de texto dentro do bloco de texto de entrada
(use o j argumento em vez).
vx - alinhamento vertical do bloco de texto de entrada dentro de uma caixa potencialmente maior.
Valores possíveis para x e guarante que os mesmos estão t (para alinhamento superior), c (centro), ou b (inferior).
jx - justificação de linhas dentro do bloco de texto de entrada. Valores possíveis para x e guarante que os mesmos estão l
(ell, para justificação à esquerda), c (centro), ou r (direito). Isso não afeta o
alinhamento do próprio bloco de texto de entrada dentro da caixa. Use o h e v argumentos
para posicionamento de bloco de texto de entrada.

Notações curtas (podem ser combinadas com os argumentos acima):
l (ell) - abreviação de hlvcjl
c - abreviatura de hcvcjc
r - abreviatura de hrvcjr

A configuração padrão de fábrica para -a is hlvt.

-c corda
Definição de design de linha de comando para casos simples. O argumento desta opção é o
definição para a forma "oeste" (W). A forma definida deve consistir em exatamente um
linha, ou seja, não são permitidas formas com várias linhas. o -c opção serve como um atalho
para os casos em que devem ser criados comentários regionais simples, que só precisam de um
determinado caractere ou sequência de caracteres a serem colocados na frente de cada linha. No
nesses casos, é muito mais conveniente simplesmente especificar -c do que fazer um completo
definição de design em um arquivo de configuração, onde a única forma definida é o oeste
forma.
Esta opção implica um -d e não acessa o arquivo de configuração. -c pode ser claro
usado em conjunto com qualquer uma das outras opções. Por padrão, -c não é especificado.

-d corda
Seleção do projeto. O único argumento dessa opção é o nome do design a ser usado.

-f corda
Use um arquivo de configuração alternativo. O único argumento desta opção é o nome de um válido
caixas arquivo de configuração, contendo designs novos e interessantes!

-h Imprima informações de uso.

-i corda
Modo de recuo. Os argumentos possíveis são "texto" (indentar o texto dentro da caixa), "caixa"
(caixa de recuo, não texto dentro da caixa) ou "nenhum" (descartar o recuo). Argumentos
pode ser abreviado. O padrão é recuar a caixa, mas não o texto.

-k bool
Elimine as linhas em branco à esquerda / à direita na remoção. O valor de bool pode ser especificado como
on, yes, true, 1 ou t, todos significando sim, ou off, não, false, 0 ou f, o que significa não.
Isso não faz distinção entre maiúsculas e minúsculas. Esta opção só tem efeito em conexão com -r. Se
definido como sim, as linhas em branco iniciais e finais serão removidas da saída. Se definido
para não, todo o conteúdo da caixa anterior é retornado. O padrão é não, se ambos
a parte superior e a parte inferior da caixa são abertas, como é o caso com a maioria das regionais
comentários. Se o design da caixa define uma parte superior ou inferior, o padrão é
sim.

-l (ell) Listar designs. Produz uma lista de todos os designs de caixa disponíveis na configuração
arquivo, junto com uma caixa de amostra e informações sobre o seu criador. Também verifica
sintaxe de todo o arquivo de configuração. Se usado em conexão com -d, exibe detalhes
informações sobre o projeto especificado.

-m Mend box. Isso remove uma caixa (potencialmente quebrada) como com -r, e redesenha-o
após. A caixa remendada é desenhada de acordo com as opções fornecidas. Isso pode ser
importante saber quando se trata de restaurar preenchimento, identificação, etc. para o
caixa remendada. Implica -k falsa

-p corda
Preenchimento. Especifique o preenchimento em espaços ao redor do bloco de texto de entrada para todos os lados do
caixa. A string do argumento não pode conter espaços em branco e deve consistir em um
combinação dos seguintes caracteres, cada um seguido por um número que indica o
preenchimento em espaços:
a - (todos) fornecem preenchimento para todos os lados de uma vez
h - (horiz) fornece preenchimento para ambos os lados horizontais
v - (vertical) fornece preenchimento para ambos os lados verticais
b - (inferior) fornece preenchimento para o lado inferior (sul)
l - (esquerda) fornece preenchimento para o lado esquerdo (oeste)
t - (topo) fornece preenchimento para o lado superior (norte)
r - (direita) fornece preenchimento para o lado direito (leste)
Exemplo: -p a4t2 definiria o preenchimento com 4 caracteres em todos os lados, exceto
para o topo da caixa, onde o bloco de texto de entrada estará a apenas 2 linhas de distância
a Caixa.
Por padrão, a menos que especificado de outra forma no arquivo de configuração, nenhum preenchimento é usado.

-r Remova a caixa. Remove uma caixa existente em vez de desenhá-la. Qual design usar é
detectado automaticamente. Para economizar tempo ou caso a detecção não
decidir corretamente, combinar com -d para especificar o design. O padrão é desenhar um
nova caixa.

-s larguraxaltura
Tamanho da caixa. Esta opção especifica o tamanho da caixa desejada em unidades de colunas (para largura)
e linhas (para altura). Se apenas um único número for dado como argumento, este número
especifica a largura desejada da caixa. Um único número prefixado por 'x' especifica apenas o
altura da caixa. O tamanho real da caixa resultante pode variar dependendo do indivíduo
tamanhos de forma do desenho escolhido. Além disso, outras opções de linha de comando podem influenciar o
tamanho da caixa (como -p).
Por padrão, a menor caixa possível é criada em torno do texto.

-t corda
Tratamento de guias. Esta opção controla como os caracteres de tabulação no texto de entrada são tratados.
A string de opção deve sempre começar com um uint número indicando a distância
entre paradas de tabulação. É importante que este valor seja definido corretamente, ou tabulador
caracteres irão perturbar o seu texto de entrada. O valor correto da distância da guia depende de
as configurações usadas para o texto que você está processando. Um valor comum é 8.
Imediatamente após a distância da tabulação, um caractere opcional pode ser anexado,
dizendo caixas como tratar as guias principais. As seguintes opções estão disponíveis:
e - expanda as guias em espaços
k - mantenha o controle o mais próximo possível do que eram
u - guias não expandidas. Isto faz caixas transformar tantos espaços quanto possível em guias.

A fim de manter a compatibilidade com versões anteriores, o -t corda pode ser apenas um número. No
Aquele caso, e é assumido para manipulação de guias, que remove todas as guias e as substitui
com espaços. O padrão de fábrica para o -t opção é simplesmente 8, que é apenas um desses
caso.
Por exemplo, você pode especificar -t 4u para que suas guias principais não sejam expandidas.
No conteúdo da caixa, as guias são sempre convertidas em espaços. A distância da guia neste
o exemplo é 4.

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

CONFIGURAÇÃO ARQUIVOS

caixas irá usar o arquivo de configuração especificado na linha de comando (usando -f) Se não
arquivo de configuração é especificado na linha de comando, caixas irá verificar o ambiente BOXES
variável, que pode conter um nome de arquivo a ser usado. Se BOXES não estiver definido, caixas tentará ler
$ HOME / .boxes e use-o como um arquivo de configuração. Falhando naquilo, caixas tentará ler o
arquivo de configuração de todo o sistema (consulte ARQUIVOS).

A sintaxe de caixas Os arquivos de configuração são descritos no site (veja abaixo). São bastante
autoexplicativo, no entanto.

DISPONIBILIDADE

caixas está disponível em seu site emhttp://boxes.thomasjensen.com/>. O site
também apresenta uma série de exemplos que ilustram esta página do manual, bem como mais em profundidade
documentação.

Dê uma olhada na vitalidade(1) nohttp://www.vim.org/>!

Use caixas online usando serviços onworks.net