ttreep - Online na nuvem

PROGRAMA:

NOME

Template :: Tools :: ttree - Processa árvores inteiras de diretórios de templates

SINOPSE

ttree [opções] [arquivos]

DESCRIÇÃO

A tárvore o script é usado para processar árvores inteiras de diretórios contendo arquivos de modelo. o
a saída resultante do processamento de cada arquivo é então gravada em um arquivo correspondente em um
diretório de destino. O script compara os tempos de modificação da fonte e
arquivos de destino (onde já existem) e processa apenas os arquivos que foram
modificado. Em outras palavras, é o equivalente a 'make' para o Template Toolkit.

Ele suporta uma série de opções que podem ser usadas para configurar o comportamento, definir locais
e definir as opções do Template Toolkit. O script primeiro lê o .trererc arquivo de configuração
no diretório HOME ou em um arquivo alternativo especificado no ambiente TTREERC
variável. Em seguida, ele processa quaisquer argumentos de linha de comando, incluindo quaisquer
arquivos de configuração especificados por meio da opção "-f" (arquivo).

A .trererc Configuração Envie o
Quando você corre tárvore pela primeira vez, ele perguntará se você deseja criar um .trererc
arquivo para você. Isso será criado em seu diretório inicial.

$tárvore
Quer que eu crie um arquivo '.ttreerc' de amostra para você?
(arquivo: /home/abw/.ttreerc) [s / n]: a
/home/abw/.ttreerc criado. Por favor, edite de acordo e execute novamente o ttree

O objetivo deste arquivo é definir qualquer global opções de configuração que você deseja aplicar
cada tempo tárvore é executado. Por exemplo, você pode usar as opções "ignorar" e "copiar" para
fornecem expressões regulares que especificam quais arquivos devem ser ignorados e quais devem ser
copiados em vez de serem processados ​​como modelos. Você também pode definir sinalizadores como
"verbose" e "recurse" de acordo com sua preferência.

Um mínimo .trererc:

# ignorar esses arquivos
ignore = \ b (CVS | RCS) \ b
ignore = ^ #
ignorar = ~ $

# copie esses arquivos
cópia = \. (gif | png | jpg | pdf) $

# recurse em diretórios
recurso

# fornecer informações sobre o que está acontecendo
detalhado

Na maioria dos casos, você desejará criar um diferente tárvore arquivo de configuração para cada projeto
você está trabalhando. A opção "cfg" permite que você especifique um diretório onde tárvore pode
encontre mais arquivos de configuração.

cfg = /home/abw/.ttree

A opção de linha de comando "-f" pode ser usada para especificar qual arquivo de configuração deve ser
usado. Você pode especificar um nome de arquivo usando um caminho absoluto ou relativo:

$ ttree -f /home/abw/web/example/etc/ttree.cfg
$ ttree -f ./etc/ttree.cfg
$ ttree -f ../etc/ttree.cfg

Se o arquivo de configuração não começar com "/" ou "." ou algo que se parece com um
Caminho absoluto do MS-DOS (por exemplo, "C: \\ etc \\ ttree.cfg"), em seguida tárvore vai procurar por isso no
diretório especificado pela opção "cfg".

$ ttree -f teste1 # /home/abw/.ttree/test1

A opção "cfg" só pode ser usada no .trererc Arquivo. Todas as outras opções podem ser usadas
no .trererc ou qualquer outro tárvore arquivo de configuração. Eles também podem ser especificados como
opções de linha de comando.

Lembre-se que .trererc é sempre processado antes qualquer arquivo de configuração especificado com
a opção "-f". Certas opções como "lib" podem ser usadas qualquer número de vezes e
acumular seus valores.

Por exemplo, considere os seguintes arquivos de configuração:

/home/abw/.ttreerc:

cfg = /home/abw/.ttree
lib = / usr / local / tt2 / templates

/home/abw/.ttree/myconfig:

lib = / home / abw / web / example / templates / lib

Quando tárvore é invocado da seguinte forma:

$ ttree -f minhaconfig

a opção "lib" será definida para os seguintes diretórios:

/ usr / local / tt2 / templates
/ home / abw / web / example / templates / lib

Quaisquer modelos localizados em / usr / local / tt2 / templates será usado em preferência àqueles
localizado abaixo / home / abw / web / example / templates / lib. Isso pode ser o que você quer, mas então
novamente, pode não ser. Por este motivo, é uma boa prática manter o .trererc tão simples
quanto possível e usar arquivos de configuração diferentes para cada tárvore projeto.

Diretório Opções
A opção "src" é usada para definir o diretório que contém os modelos de origem a serem
processado. Pode ser fornecido como uma opção de linha de comando ou em um arquivo de configuração como
mostrado aqui:

src = / home / abw / web / example / templates / src

Cada modelo neste diretório normalmente corresponde a uma única página da web ou outro
documento.

A opção "dest" é usada para especificar o diretório de destino para a saída gerada.

dest = / home / abw / web / example / html

A opção "lib" é usada para definir um ou mais diretórios contendo biblioteca adicional
modelos. Esses modelos não são documentos em si e normalmente são compostos por
componentes modulares menores, como cabeçalhos, rodapés e menus que são incorporados
modelos de páginas.

lib = / home / abw / web / example / templates / lib
lib = / usr / local / tt2 / templates

A opção "lib" pode ser usada repetidamente para adicionar outros diretórios ao caminho de pesquisa.

Uma lista de modelos pode ser passada para tárvore como argumentos de linha de comando.

$ ttree foo.html barra.html

Ele procura por esses modelos no diretório "src" e os processa por meio do
Template Toolkit, usando quaisquer componentes de template adicionais dos diretórios "lib".
A saída gerada é então gravada no arquivo correspondente no diretório "dest".

If tárvore é invocado sem especificar explicitamente quaisquer modelos a serem processados, então
irá processar todos os arquivos no diretório "src". Se a opção "-r" (recurse) for definida, então
ele irá, adicionalmente, percorrer subdiretórios e processos e outros modelos
arquivos que encontrar nele.

$ ttree -r

Se um modelo foi processado anteriormente, tárvore irá comparar os tempos de modificação de
os arquivos de origem e destino. Se o modelo de origem (ou um do qual depende) tem
não foi modificado mais recentemente do que o arquivo de saída gerado tárvore não vai processar
isto. o -a A opção (todos) pode ser usada para forçar tárvore para processar todos os arquivos, independentemente de
hora de modificação.

$ árvore -a

Quaisquer modelos explicitamente nomeados como argumento de linha de comando são sempre processados ​​e o
a verificação do tempo de modificação é ignorada.

Envie o Opções
As opções "ignorar", "copiar" e "aceitar" são usadas para especificar o regexen Perl para filtrar o arquivo
nomes. Os arquivos que correspondem a qualquer uma das opções "ignorar" não serão processados. Restante
os arquivos que correspondem a qualquer regexen "copiar" serão copiados para o diretório de destino.
Os arquivos restantes que correspondem a qualquer um dos critérios de "aceitação" são processados ​​por meio do
Kit de ferramentas de modelo. Se nenhum parâmetro "aceitar" for especificado, todos os arquivos serão aceitos
para processamento, se ainda não foi copiado ou ignorado.

# ignorar esses arquivos
ignore = \ b (CVS | RCS) \ b
ignore = ^ #
ignorar = ~ $

# copie esses arquivos
cópia = \. (gif | png | jpg | pdf) $

# aceita apenas modelos .tt2
aceitar = \ .tt2 $

A opção "sufixo" é usada para definir mapeamentos entre as extensões de arquivo para a fonte
modelos e os arquivos de saída gerados. O exemplo a seguir especifica essa fonte
modelos com um sufixo ".tt2" devem ser produzidos como arquivos ".html":

sufixo tt2 = html

Ou na linha de comando,

--suffix tt2 = html

Você pode fornecer qualquer número de mapeamentos de sufixo diferentes, repetindo esta opção.

A opção "binmode" é usada para definir a codificação do arquivo de saída. Por exemplo, use
"--binmode =: utf8" para definir o formato de saída para Unicode.

Modelo Dependências
As opções "depend" e "depend_file" permitem que você especifique como qualquer arquivo de modelo dado
depende de outro arquivo ou grupo de arquivos. A opção "depend" é usada para expressar um
dependência única.

$ ttree --depend foo = bar, baz

Este exemplo de linha de comando mostra a opção "--depend" sendo usada para especificar que o Foo
arquivo depende do Barra e baz modelos. Esta opção pode ser usada muitas vezes no
linha de comando:

$ ttree --depend foo = bar, baz --depend crash = bang, wallop

ou em um arquivo de configuração:

depend foo = bar, baz
depend crash = bang, wallop

O arquivo que aparece à esquerda de "=" é especificado em relação a "src" ou "lib"
diretórios. Os arquivos que aparecem à direita podem ser especificados em relação a qualquer um destes
diretórios ou como caminhos de arquivo absolutos.

Por exemplo:

$ ttree --depend foo = bar, / tmp / baz

Para definir uma dependência que se aplica a todos os arquivos, use "*" à esquerda de "=".

$ ttree --depend * = cabeçalho, rodapé

ou em um arquivo de configuração:

depend * = cabeçalho, rodapé

Quaisquer modelos que são definidos no "pre_process", "post_process", "process" ou
As opções de "wrapper" serão automaticamente adicionadas à lista de dependências globais que
aplicam-se a todos os modelos.

A opção "depend_file" pode ser usada para especificar um arquivo que contém dependência
informações.

$ ttree --depend_file = / home / abw / web / example /etc/ttree.dep

Aqui está um exemplo de um arquivo de dependência:

# Este é um comentário. É ignorado.

index.html: barra de menu do rodapé do cabeçalho

cabeçalho: links da barra de título

barra de menu: item de menu

# estendendo-se por várias linhas com barra invertida
another.html: barra de menu do rodapé do cabeçalho \
formulário de pesquisa da barra lateral

As linhas que começam com o caractere "#" são comentários e são ignoradas. Linhas em branco também são
ignorado. Todas as outras linhas devem fornecer um nome de arquivo seguido de dois pontos e uma lista de
arquivos dependentes separados por espaços em branco, vírgulas ou ambos. O espaço em branco ao redor do cólon é
também opcional. As linhas que terminam com o caractere "\" continuam na linha seguinte.

Arquivos que contenham espaços podem ser citados. Isso só é necessário para arquivos após os dois pontos
(':'). O arquivo antes dos dois pontos pode ser colocado entre aspas se contiver dois pontos.

Tal como acontece com as opções de linha de comando, o caractere "*" pode ser usado como um curinga para especificar um
dependência para todos os modelos.

*: configuração, cabeçalho

Modelo Kit de ferramentas Opções
tárvore também fornece acesso à gama usual de opções do Template Toolkit. Por exemplo,
o "--pre_chomp" e "--post_chomp" tárvore opções correspondem ao "PRE_CHOMP" e
Opções "POST_CHOMP".

Execute "ttree -h" para obter um resumo das opções disponíveis.

AUTORES

Andy Wardley[email protegido]>

<http://www.andywardley.com/>

Com contribuições de Dylan William Hardison (suporte para dependências), Bryce
Harrington (opções "absolutas" e "relativas"), Mark Anderson ("sufixo" e "depuração"
opções), Harald Joerg e Leon Brocard, que chega a todos os lugares, ao que parece.

VERSÃO

2.68, distribuído como parte do Template Toolkit versão 2.19, lançado em 27 de abril de 2007.

DIREITOS AUTORAIS

Copyright (C) 1996-2007 Andy Wardley. Todos os direitos reservados.

Este módulo é um software livre; você pode redistribuí-lo e / ou modificá-lo sob o mesmo
termos como o próprio Perl.

Use ttreep online usando serviços onworks.net