ttreep - Bulutta Çevrimiçi

Program:

ADI

Template::Tools::ttree - Şablonların tüm dizin ağaçlarını işle

SİNOPSİS

ağaç [seçenekler] [dosyalar]

TANIM

The ağaç komut dosyası, şablon dosyalarını içeren tüm dizin ağaçlarını işlemek için kullanılır. NS
Her dosyanın işlenmesinden elde edilen çıktı daha sonra bir
hedef dizini. Komut dosyası, kaynağın değişiklik zamanlarını karşılaştırır ve
hedef dosyalar (zaten var oldukları yerde) ve yalnızca daha önce var olan dosyaları işler.
değiştirilmiş. Başka bir deyişle, Şablon Araç Takımı için 'make' ile eşdeğerdir.

Davranışı yapılandırmak, konumları tanımlamak için kullanılabilecek bir dizi seçeneği destekler.
ve Şablon Araç Takımı seçeneklerini ayarlayın. Senaryo ilk önce şunları okur: .trerc yapılandırma dosyası
HOME dizininde veya TTREERC ortamında belirtilen alternatif bir dosyada
değişken. Ardından, herhangi bir ek dahil olmak üzere herhangi bir komut satırı argümanını işler.
"-f" (dosya) seçeneği ile belirtilen yapılandırma dosyaları.

The .trerc yapılandırma fileto
Koştuğunda ağaç oluşturmak isteyip istemediğinizi soracaktır. .trerc
senin için dosya. Bu, ana dizininizde oluşturulacaktır.

$ ağaç
Sizin için örnek bir '.ttreerc' dosyası oluşturmamı ister misiniz?
(dosya: /home/abw/.ttreerc) [y/n]: y
/home/abw/.ttreerc oluşturuldu. Lütfen uygun şekilde düzenleyin ve ağacı yeniden çalıştırın

Bu dosyanın amacı, herhangi bir global uygulanmasını istediğiniz yapılandırma seçenekleri
her zaman ağaç çalıştırılır. Örneğin, "yoksay" ve "kopyala" seçeneklerini kullanabilirsiniz.
hangi dosyaların yok sayılacağını ve hangilerinin dikkate alınacağını belirten düzenli ifadeler sağlayın
şablon olarak işlenmek yerine kopyalanır. Ayrıca aşağıdaki gibi bayraklar ayarlamak isteyebilirsiniz.
tercihinize göre "ayrıntılı" ve "özyineleme".

Minimal .trerc:

# bu dosyaları yoksay
yoksay = \b(CVS|RCS)\b
yoksay = ^#
yoksay = ~$

# bu dosyaları kopyala
kopya = \.(gif|png|jpg|pdf)$

# dizinlere yineleme
recurse

# neler olup bittiği hakkında bilgi verin
gereksiz sözlerle dolu

Çoğu durumda, farklı bir ağaç her proje için yapılandırma dosyası
üzerinde çalışıyorsun. "cfg" seçeneği, bir dizini belirtmenize izin verir. ağaç yapabilmek
daha fazla yapılandırma dosyası bulun.

cfg = /home/abw/.ttree

"-f" komut satırı seçeneği, hangi yapılandırma dosyasının seçileceğini belirtmek için kullanılabilir.
kullanılmış. Mutlak veya göreli bir yol kullanarak bir dosya adı belirtebilirsiniz:

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

Yapılandırma dosyası "/" veya "." ile başlamıyorsa. ya da bir şeye benzeyen bir şey
MS-DOS mutlak yolu (örn. "C:\\etc\\ttree.cfg") sonra ağaç içinde arayacak
"cfg" seçeneği ile belirtilen dizin.

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

"cfg" seçeneği yalnızca .trerc dosya. Diğer tüm seçenekler kullanılabilir
içinde .trerc veya herhangi bir başkası ağaç yapılandırma dosyası. Hepsi de şu şekilde belirtilebilir:
komut satırı seçenekleri.

Unutmayın .trerc her zaman işlenir önce ile belirtilen herhangi bir yapılandırma dosyası
"-f" seçeneği. "lib" gibi belirli seçenekler herhangi bir sayıda kullanılabilir ve
değerlerini biriktirir.

Örneğin, aşağıdaki yapılandırma dosyalarını göz önünde bulundurun:

/home/abw/.ttreerc:

cfg = /home/abw/.ttree
lib = /usr/local/tt2/şablonlar

/home/abw/.ttree/myconfig:

lib = /home/abw/web/örnek/şablonlar/lib

Ne zaman ağaç şu şekilde çağrılır:

$ ağaç -f yapılandırmam

"lib" seçeneği aşağıdaki dizinlere ayarlanacaktır:

/usr/yerel/tt2/şablonlar
/home/abw/web/örnek/şablonlar/lib

Altında bulunan herhangi bir şablon /usr/yerel/tt2/şablonlar olanlara tercih edilecek
altında /home/abw/web/örnek/şablonlar/lib. İstediğin bu olabilir, ama sonra
yine olmayabilir. Bu nedenle, aşağıdakileri tutmak iyi bir uygulamadır. .trerc kadar basit
mümkün olduğunca ve her biri için farklı yapılandırma dosyaları kullanın ağaç projesi.

rehber Opsiyonlar
"src" seçeneği, kaynak şablonları içeren dizini tanımlamak için kullanılır.
işlenmiş. Bir komut satırı seçeneği olarak veya bir yapılandırma dosyasında şu şekilde sağlanabilir:
burada gösterildi:

kaynak = /home/abw/web/örnek/şablonlar/kaynak

Bu dizindeki her şablon tipik olarak tek bir web sayfasına veya diğer
belge.

"hedef" seçeneği, oluşturulan çıktı için hedef dizini belirtmek için kullanılır.

hedef = /home/abw/web/example/html

"lib" seçeneği, ek kitaplık içeren bir veya daha fazla dizini tanımlamak için kullanılır.
şablonlar. Bu şablonlar kendi başlarına belgeler değildir ve tipik olarak aşağıdakilerden oluşur:
entegre edilmiş üstbilgiler, altbilgiler ve menüler gibi daha küçük, modüler bileşenler
sayfa şablonları.

lib = /home/abw/web/örnek/şablonlar/lib
lib = /usr/local/tt2/şablonlar

"lib" seçeneği, arama yoluna başka dizinler eklemek için tekrar tekrar kullanılabilir.

Bir şablon listesi iletilebilir ağaç komut satırı argümanları olarak.

$ ağaç foo.html bar.html

Bu şablonları "src" dizininde arar ve bunları
"lib" dizinlerindeki herhangi bir ek şablon bileşenini kullanan Template Toolkit.
Oluşturulan çıktı daha sonra "dest" dizinindeki ilgili dosyaya yazılır.

If ağaç işlenecek herhangi bir şablon açıkça belirtilmeden çağrılır, ardından
"src" dizinindeki her dosyayı işleyecektir. "-r" (yineleme) seçeneği ayarlanmışsa, o zaman
ayrıca alt dizinler, süreç ve diğer şablonlar arasında yinelenir
orada bulduğu dosyalar.

$ ağaç -r

Bir şablon daha önce işlenmişse, ağaç değişiklik zamanlarını karşılaştıracak
kaynak ve hedef dosyalar. Kaynak şablon (veya buna bağlı olan) varsa
oluşturulan çıktı dosyasından daha yakın zamanda değiştirilmediyse ağaç işlemeyecek
o. -a (tümü) seçeneği zorlamak için kullanılabilir ağaç ne olursa olsun tüm dosyaları işlemek için
değişiklik zamanı.

$ ağaç -a

Açıkça komut satırı argümanı olarak adlandırılan tüm şablonlar her zaman işlenir ve
değişiklik zamanı denetimi atlanır.

fileto Opsiyonlar
Dosyayı filtrelemek için Perl normal ifadesini belirtmek için "yoksay", "kopyala" ve "kabul et" seçenekleri kullanılır.
isimler. "Yoksay" seçeneklerinden herhangi biriyle eşleşen dosyalar işlenmez. Geriye kalan
"kopya" normal ifadelerinden herhangi biriyle eşleşen dosyalar hedef dizine kopyalanacaktır.
"Kabul et" kriterlerinden herhangi biriyle eşleşen kalan dosyalar daha sonra,
Şablon Araç Takımı. "Kabul Et" parametresi belirtilmezse, tüm dosyalar kabul edilecektir.
henüz kopyalanmadıysa veya yoksayılmadıysa işleme için.

# bu dosyaları yoksay
yoksay = \b(CVS|RCS)\b
yoksay = ^#
yoksay = ~$

# bu dosyaları kopyala
kopya = \.(gif|png|jpg|pdf)$

# yalnızca .tt2 şablonlarını kabul et
kabul et = \.tt2$

"Sonek" seçeneği, kaynak için dosya uzantıları arasındaki eşlemeleri tanımlamak için kullanılır.
şablonlar ve oluşturulan çıktı dosyaları. Aşağıdaki örnek, bu kaynağı belirtir
".tt2" son ekine sahip şablonlar ".html" dosyaları olarak çıkarılmalıdır:

son ek tt2=html

Veya komut satırında,

--sonek tt2=html

Bu seçeneği tekrarlayarak istediğiniz sayıda farklı son ek eşlemesi sağlayabilirsiniz.

Çıktı dosyasının kodlamasını ayarlamak için "binmode" seçeneği kullanılır. örneğin kullanım
"--binmode=:utf8" çıktı biçimini unicode olarak ayarlamak için.

şablon Bağımlılıklar
"Depend" ve "depend_file" seçenekleri, verilen herhangi bir şablon dosyasının nasıl
başka bir dosyaya veya dosya grubuna bağlıdır. "bağımlı" seçeneği, bir durumu ifade etmek için kullanılır.
tek bağımlılık.

$ ttree --bağımlı foo=bar,baz

Bu komut satırı örneği, "--depend" seçeneğini belirtmek için kullanılan seçeneği gösterir. foo
dosya bağlıdır bar ve baz şablonlar. Bu seçenek ekranda birçok kez kullanılabilir.
Komut satırı:

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

veya bir yapılandırma dosyasında:

foo=bar,baz bağımlı
çarpışmaya bağlı = bang, wallop

"=" öğesinin solunda görünen dosya, "src" veya "lib" ile ilişkili olarak belirtilir.
dizinler. Sağda görünen dosya(lar) bunlardan herhangi birine göre belirtilebilir.
dizinler veya mutlak dosya yolları olarak.

Örneğin:

$ ttree --bağımlı foo=bar,/tmp/baz

Tüm dosyalar için geçerli olan bir bağımlılık tanımlamak için "=" işaretinin solundaki "*" kullanın.

$ ttree --depend *=üstbilgi,altbilgi

veya bir yapılandırma dosyasında:

bağımlı *=üstbilgi,altbilgi

"pre_process", "post_process", "process" veya
"sarmalayıcı" seçenekleri otomatik olarak küresel bağımlılıklar listesine eklenecektir.
tüm şablonlara uygulayın.

"depend_file" seçeneği, bağımlılık içeren bir dosyayı belirtmek için kullanılabilir.
bilgiler.

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

İşte bir bağımlılık dosyası örneği:

# Bu bir yorumdur. Göz ardı edilir.

index.html: üstbilgi altbilgi menü çubuğu

başlık: başlık çubuğu kısayolları

menü çubuğu: menü öğesi

# ters eğik çizgi ile birden çok satıra yayılan
başka.html: üstbilgi altbilgi menü çubuğu \
kenar çubuğu arama formu

"#" karakteri ile başlayan satırlar yorumdur ve dikkate alınmaz. Boş satırlar da
görmezden gelindi. Diğer tüm satırlar bir dosya adı, ardından iki nokta üst üste ve ardından bir dosya adı sağlamalıdır.
boşluk, virgül veya her ikisi ile ayrılmış bağımlı dosyalar. Kolonun etrafındaki boşluk
ayrıca isteğe bağlı. "\" karakteri ile biten satırlar bir sonraki satırda devam ettirilir.

Boşluk içeren dosyalar alıntı yapılabilir. Bu yalnızca iki nokta üst üste işaretinden sonraki dosyalar için gereklidir
(':'). İki nokta üst üste işareti içeriyorsa, iki nokta üst üste işaretinden önceki dosya alıntılanabilir.

Komut satırı seçeneklerinde olduğu gibi, "*" karakteri bir joker karakter belirtmek için kullanılabilir.
tüm şablonlar için bağımlılık.

* : yapılandırma, başlık

şablon Toolkit Opsiyonlar
ağaç ayrıca her zamanki Şablon Araç Takımı seçeneklerine erişim sağlar. Örneğin,
"--pre_chomp" ve "--post_chomp" ağaç seçenekler "PRE_CHOMP" ye karşılık gelir ve
"POST_CHOMP" seçenekleri.

Mevcut seçeneklerin bir özeti için "ttree -h" komutunu çalıştırın.

YAZARLAR

Andy Wardley[e-posta korumalı]>

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

Dylan William Hardison'ın katkılarıyla (bağımlılıklar için destek), Bryce
Harrington ("mutlak" ve "göreceli" seçenekler), Mark Anderson ("sonek" ve "hata ayıklama"
seçenekler), Harald Joerg ve her yere ulaşan Leon Brocard gibi görünüyor.

VERSION

2.68, Template Toolkit sürüm 2.19'un bir parçası olarak dağıtılır ve 27 Nisan 2007'de yayımlanır.

TELİF HAKKI

Telif Hakkı (C) 1996-2007 Andy Wardley. Her hakkı saklıdır.

Bu modül ücretsiz bir yazılımdır; yeniden dağıtabilir ve/veya aynı şekilde değiştirebilirsiniz.
Perl'in kendisi olarak terimler.

onworks.net hizmetlerini kullanarak ttreep'i çevrimiçi kullanın