ttreep - Online nel cloud

PROGRAMMA:

NOME

Template::Tools::ttree - Elabora interi alberi di directory di modelli

SINOSSI

ttree [opzioni] [file]

DESCRIZIONE

Le tre script viene utilizzato per elaborare interi alberi di directory contenenti file modello. Il
l'output risultante dall'elaborazione di ciascun file viene quindi scritto in un file corrispondente in a
directory di destinazione. Lo script confronta i tempi di modifica del sorgente e
file di destinazione (dove esistono già) ed elabora solo quei file che sono stati
modificato. In altre parole, è l'equivalente di "make" per Template Toolkit.

Supporta una serie di opzioni che possono essere utilizzate per configurare il comportamento, definire le posizioni
e imposta le opzioni di Template Toolkit. Lo script prima legge il .ttrerc file di configurazione
nella directory HOME, o un file alternativo specificato nell'ambiente TTREERC
variabile. Quindi, elabora tutti gli argomenti della riga di comando, inclusi quelli aggiuntivi
file di configurazione specificati tramite l'opzione "-f" (file).

Le .ttrerc Configurazione Compila il
Quando corri tre per la prima volta ti chiederà se vuoi che crei un .ttrerc
file per te. Questo verrà creato nella tua home directory.

$ tre
Vuoi che crei un file di esempio ".ttreerc" per te?
(file: /home/abw/.ttreerc) [s/n]: s
/home/abw/.ttreerc creato. Modifica di conseguenza e riesegui ttree

Lo scopo di questo file è impostare qualsiasi globale opzioni di configurazione che si desidera applicare
ogni tempo tre viene eseguito. Ad esempio, puoi utilizzare le opzioni "ignora" e "copia" per
fornire espressioni regolari che specificano quali file dovrebbero essere ignorati e quali dovrebbero essere
copiati invece di essere elaborati come modelli. Potresti anche voler impostare flag come
"verbose" e "recurse" in base alle tue preferenze.

Un minimo .ttrerc:

# ignora questi file
ignora = \b(CVS|RCS)\b
ignora = ^#
ignora = ~$

# copia questi file
copia = \.(gif|png|jpg|pdf)$

# ricorsi nelle directory
ricorso

# fornisci informazioni su cosa sta succedendo
verboso

Nella maggior parte dei casi, ti consigliamo di creare un diverso tre file di configurazione per ogni progetto
stai lavorando. L'opzione "cfg" ti permette di specificare una directory dove tre può
trovare ulteriori file di configurazione.

cfg = /home/abw/.ttree

L'opzione della riga di comando "-f" può essere utilizzata per specificare quale file di configurazione dovrebbe essere
Usato. Puoi specificare un nome file utilizzando un percorso assoluto o relativo:

$ ttree -f /home/abw/web/esempio/etc/ttree.cfg
$ albero -f ./etc/talbero.cfg
$ albero -f ../etc/talbero.cfg

Se il file di configurazione non inizia con "/" o "." o qualcosa che assomiglia a
Percorso assoluto MS-DOS (es. "C:\\etc\\ttree.cfg") quindi tre lo cercherò nel
directory specificata dall'opzione "cfg".

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

L'opzione "cfg" può essere utilizzata solo nel .ttrerc file. Tutte le altre opzioni possono essere utilizzate
nel .ttrerc o qualsiasi altro tre file di configurazione. Possono anche essere tutti specificati come
opzioni della riga di comando.

Ricorda che .ttrerc è sempre elaborato prima qualsiasi file di configurazione specificato con
l'opzione "-f". Alcune opzioni come "lib" possono essere utilizzate un numero qualsiasi di volte e
accumulare i propri valori.

Ad esempio, considera i seguenti file di configurazione:

/home/abw/.ttrerc:

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

/home/abw/.ttree/myconfig:

lib = /home/abw/web/esempio/templates/lib

Quando tre viene invocato come segue:

$ ttree -f miaconfig

l'opzione "lib" sarà impostata nelle seguenti directory:

/usr/local/tt2/templates
/home/abw/web/esempio/modelli/lib

Tutti i modelli che si trovano sotto /usr/local/tt2/templates saranno usati in preferenza a quelli
situato sotto /home/abw/web/esempio/modelli/lib. Questo potrebbe essere quello che vuoi, ma allora
di nuovo, potrebbe non esserlo. Per questo motivo è buona norma mantenere il .ttrerc così semplice
possibile e utilizzare file di configurazione diversi per ciascuno tre progetto.

elenco Opzioni
L'opzione "src" viene utilizzata per definire la directory contenente i modelli sorgente da essere
elaborato. Può essere fornito come opzione della riga di comando o in un file di configurazione come
mostrato qui:

src = /home/abw/web/esempio/templates/src

Ogni modello in questa directory corrisponde in genere a una singola pagina web o altro
documento.

L'opzione "dest" viene utilizzata per specificare la directory di destinazione per l'output generato.

destinazione = /home/abw/web/esempio/html

L'opzione "lib" viene utilizzata per definire una o più directory contenenti librerie aggiuntive
modelli. Questi modelli non sono documenti a sé stanti e in genere comprendono
componenti modulari più piccoli come intestazioni, piè di pagina e menu incorporati in
modelli di pagine

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

L'opzione "lib" può essere utilizzata ripetutamente per aggiungere ulteriori directory al percorso di ricerca.

È possibile passare un elenco di modelli a tre come argomenti della riga di comando.

$ tre pippo.html bar.html

Cerca questi modelli nella directory "src" e li elabora tramite il
Template Toolkit, utilizzando eventuali componenti di template aggiuntivi dalle directory "lib".
L'output generato viene quindi scritto nel file corrispondente nella directory "dest".

If tre viene invocato senza specificare esplicitamente alcun modello da elaborare allora
elaborerà ogni file nella directory "src". Se l'opzione "-r" (ricorrenza) è impostata allora
scorrerà inoltre verso il basso attraverso le sottodirectory, i processi e altri modelli
file che trova al suo interno.

$ tre -r

Se un modello è stato elaborato in precedenza, tre confronterà i tempi di modifica di
i file di origine e di destinazione. Se il modello di origine (o uno da cui dipende) ha
non è stato modificato più di recente rispetto al file di output generato allora tre non elaborerà
esso. Il -a (tutti) l'opzione può essere utilizzata per forzare tre per elaborare tutti i file indipendentemente da
tempo di modifica.

$ albero -a

Tutti i modelli esplicitamente denominati come argomento della riga di comando vengono sempre elaborati e
il controllo dell'ora di modifica viene ignorato.

Compila il Opzioni
Le opzioni "ignora", "copia" e "accetta" vengono utilizzate per specificare l'espressione regolare Perl per filtrare il file
nomi. I file che corrispondono a una delle opzioni "ignora" non verranno elaborati. Rimanente
i file che corrispondono a qualsiasi regexen "copia" verranno copiati nella directory di destinazione.
I file rimanenti che corrispondono a uno dei criteri di "accettazione" vengono quindi elaborati tramite il
Toolkit modello. Se non viene specificato alcun parametro "accetta", tutti i file verranno accettati
per l'elaborazione se non già copiato o ignorato.

# ignora questi file
ignora = \b(CVS|RCS)\b
ignora = ^#
ignora = ~$

# copia questi file
copia = \.(gif|png|jpg|pdf)$

# accetta solo modelli .tt2
accettare = \.tt2$

L'opzione "suffisso" viene utilizzata per definire le mappature tra le estensioni di file per source
modelli e i file di output generati. L'esempio seguente specifica che source
i modelli con un suffisso ".tt2" dovrebbero essere emessi come file ".html":

suffisso tt2=html

O sulla riga di comando,

--suffisso tt2=html

È possibile fornire un numero qualsiasi di mappature suffissi diverse ripetendo questa opzione.

L'opzione "binmode" viene utilizzata per impostare la codifica del file di output. Ad esempio usa
"--binmode=:utf8" per impostare il formato di output su unicode.

Modello dipendenze
Le opzioni "dipende" e "file_dipende" consentono di specificare come un determinato file modello
dipende da un altro file o gruppo di file. L'opzione "dipende" è usata per esprimere a
singola dipendenza.

$ tre --dipende pippo=bar,baz

Questo esempio di riga di comando mostra l'opzione "--depend" utilizzata per specificare che il foo
il file dipende dal bar e a baz modelli. Questa opzione può essere utilizzata più volte sul
riga di comando:

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

o in un file di configurazione:

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

Il file che appare a sinistra di "=" è specificato rispetto a "src" o "lib"
directory. I file che appaiono a destra possono essere specificati in relazione a uno di questi
directory o come percorsi di file assoluti.

Per esempio:

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

Per definire una dipendenza che si applica a tutti i file, utilizzare "*" a sinistra di "=".

$ ttree --depend *=intestazione, piè di pagina

o in un file di configurazione:

dipendenza *=intestazione,piè di pagina

Qualsiasi modello definito in "pre_process", "post_process", "process" o
Le opzioni "wrapper" verranno automaticamente aggiunte all'elenco delle dipendenze globali che
applicare a tutti i modelli.

L'opzione "depend_file" può essere utilizzata per specificare un file che contiene dipendenza
informazioni.

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

Ecco un esempio di un file di dipendenza:

# Questo è un commento. È ignorato.

index.html: barra dei menu intestazione piè di pagina

intestazione: collegamenti della barra del titolo

barra dei menu: voce del menu

# che copre più righe con la barra rovesciata
altro.html: barra dei menu piè di pagina intestazione \
modulo di ricerca nella barra laterale

Le righe che iniziano con il carattere "#" sono commenti e vengono ignorate. Le righe vuote sono anche
ignorato. Tutte le altre righe dovrebbero fornire un nome file seguito da due punti e quindi un elenco di
file dipendenti separati da spazi, virgole o entrambi. Lo spazio bianco intorno ai due punti è
anche facoltativo. Le righe che terminano con il carattere "\" continuano nella riga successiva.

I file che contengono spazi possono essere citati. Questo è necessario solo per i file dopo i due punti
(':'). Il file prima dei due punti può essere citato se contiene i due punti.

Come con le opzioni della riga di comando, il carattere "*" può essere utilizzato come carattere jolly per specificare a
dipendenza per tutti i modelli.

* : configurazione, intestazione

Modello Kit di strumenti Opzioni
tre fornisce anche l'accesso alla consueta gamma di opzioni di Template Toolkit. Per esempio,
il "--pre_chomp" e "--post_chomp" tre le opzioni corrispondono a "PRE_CHOMP" e
Opzioni "POST_CHOMP".

Esegui "ttree -h" per un riepilogo delle opzioni disponibili.

AUTORI

Andy Wardley[email protected]>

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

Con il contributo di Dylan William Hardison (supporto per le dipendenze), Bryce
Harrington (opzioni "assoluta" e "relativa"), Mark Anderson ("suffisso" e "debug"
opzioni), Harald Joerg e Leon Brocard che arriva ovunque, a quanto pare.

VERSIONE

2.68, distribuito come parte del Template Toolkit versione 2.19, rilasciato il 27 aprile 2007.

COPYRIGHT

Copyright (C) 1996-2007 Andy Wardley. Tutti i diritti riservati.

Questo modulo è un software gratuito; puoi ridistribuirlo e/o modificarlo sotto lo stesso
termini come Perl stesso.

Usa treep online utilizzando i servizi onworks.net