ttreep - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

Template::Tools::ttree - Обробляти цілі дерева каталогів шаблонів

СИНТАКСИС

ttree [параметри] [файли]

ОПИС

Команда дерево скрипт використовується для обробки цілих дерев каталогів, що містять файли шаблонів. The
отриманий результат обробки кожного файлу потім записується у відповідний файл у форматі a
каталог призначення. Сценарій порівнює час модифікації джерела і
цільові файли (де вони вже існують) і обробляє лише ті файли, які були
змінений. Іншими словами, це еквівалент «make» для Набору інструментів шаблонів.

Він підтримує ряд параметрів, які можна використовувати для налаштування поведінки, визначення розташування
і встановіть параметри Набору шаблонів. Сценарій спочатку читає .ttreerc файл конфігурації
в каталозі HOME або в альтернативному файлі, зазначеному в середовищі TTREERC
змінний. Потім він обробляє будь-які аргументи командного рядка, включаючи будь-які додаткові
файли конфігурації, зазначені за допомогою параметра "-f" (файл).

Команда .ttreerc конфігурація Файл
Коли ти біжиш дерево вперше він запитає вас, чи хочете ви, щоб він створив a .ttreerc
файл для вас. Це буде створено у вашому домашньому каталозі.

$ tдерево
Ви хочете, щоб я створив для вас зразок файлу ".ttreerc"?
(файл: /home/abw/.ttreerc) [y/n]: y
/home/abw/.ttreerc створено. Будь ласка, відредагуйте відповідним чином і повторно запустіть ttree

Метою цього файлу є встановлення будь-якого в цілому параметри конфігурації, які ви хочете застосувати
кожен час дерево запускається. Наприклад, ви можете використовувати параметри «ігнорувати» та «копіювати».
надайте регулярні вирази, які вказують, які файли слід ігнорувати, а які —
копіювати, а не обробляти як шаблони. Ви також можете встановити прапорці як
"докладний" і "повторний" відповідно до ваших уподобань.

Мінімум .ttreerc:

# ігнорувати ці файли
ігнорувати = \b(CVS|RCS)\b
ігнорувати = ^#
ігнорувати = ~$

# копіюйте ці файли
копія = \.(gif|png|jpg|pdf)$

# рекурсія в каталоги
рецидивувати

# надайте інформацію про те, що відбувається
докладний

У більшості випадків вам захочеться створити інший дерево конфігураційний файл для кожного проекту
ти працюєш. Параметр "cfg" дозволяє вказати каталог, де дерево може
знайти додаткові файли конфігурації.

cfg = /home/abw/.ttree

Параметр командного рядка «-f» можна використовувати, щоб вказати, який файл конфігурації має бути
використаний. Ви можете вказати ім’я файлу, використовуючи абсолютний або відносний шлях:

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

Якщо файл конфігурації не починається з "/" або "." або щось схоже на a
Абсолютний шлях MS-DOS (наприклад, "C:\\etc\\ttree.cfg"), потім дерево буде шукати його в
каталог, визначений опцією "cfg".

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

Параметр "cfg" можна використовувати тільки в .ttreerc файл. Усі інші варіанти можна використовувати
в .ttreerc або будь-який інший дерево файл конфігурації. Всі вони також можуть бути вказані як
параметри командного рядка.

Пам'ятайте, що .ttreerc завжди обробляється перед тим будь-який файл конфігурації, зазначений у
параметр "-f". Певні параметри, такі як "lib", можна використовувати будь-яку кількість разів і
накопичувати свої цінності.

Наприклад, розглянемо такі файли конфігурації:

/home/abw/.ttreerc:

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

/home/abw/.ttree/myconfig:

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

Коли дерево викликається таким чином:

$ttree -f myconfig

параметр "lib" буде встановлено для таких каталогів:

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

Будь-які шаблони, розташовані під /usr/local/tt2/templates буде використовуватися в якості переваги перед тими
знаходиться під /home/abw/web/example/templates/lib. Це може бути те, що ви хочете, але тоді
знову ж таки, може й ні. З цієї причини доцільно зберігати .ttreerc так просто
і використовувати різні файли конфігурації для кожного дерево Проект.

Каталог Опції
Параметр "src" використовується для визначення каталогу, що містить вихідні шаблони
оброблено. Його можна надати як параметр командного рядка або у файлі конфігурації як
показано тут:

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

Кожен шаблон у цьому каталозі зазвичай відповідає одній чи іншій веб-сторінці
документа.

Параметр "dest" використовується для визначення каталогу призначення для згенерованого виводу.

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

Параметр «lib» використовується для визначення одного або кількох каталогів, що містять додаткову бібліотеку
шаблони. Ці шаблони не є документами самі по собі і, як правило, складаються з
менші модульні компоненти, такі як верхні, нижні колонтитули та меню, які включені в
шаблони сторінок.

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

Опцію «lib» можна використовувати багаторазово, щоб додати додаткові каталоги до шляху пошуку.

Можна передати список шаблонів дерево як аргументи командного рядка.

$ ttree foo.html bar.html

Він шукає ці шаблони в каталозі "src" і обробляє їх через файл
Template Toolkit, використовуючи будь-які додаткові компоненти шаблону з каталогів «lib».
Згенерований результат записується у відповідний файл у каталозі "dest".

If дерево викликається без явного вказівки будь-яких шаблонів, які потрібно обробити, потім він
оброблятиме кожен файл у каталозі "src". Якщо встановлено параметр "-r" (рекурс).
він додатково перебирає підкаталоги, процеси та інші шаблони
файли, які він там знаходить.

$ tдерево -r

Якщо шаблон був оброблений раніше, дерево порівняє час модифікації
вихідні та цільові файли. Якщо вихідний шаблон (або той, від якого він залежить) є
не було змінено пізніше, ніж тоді згенерований вихідний файл дерево не буде оброблятися
це. The -a (all) можна використовувати для примусу дерево для обробки всіх файлів незалежно від
час модифікації.

$ дерево -а

Будь-які шаблони, явно названі аргументом командного рядка, завжди обробляються, і
перевірка часу модифікації обходиться.

Файл Опції
Параметри «ігнорувати», «копіювати» та «прийняти» використовуються для визначення регулярного виразу Perl для фільтрування файлу
імена. Файли, які відповідають будь-якому з параметрів "ігнорувати", не оброблятимуться. Залишилося
файли, які відповідають будь-якому з регулярних виразів "копіювання", будуть скопійовані в каталог призначення.
Решта файлів, які потім відповідають будь-якому з критеріїв "прийняти", потім обробляються за допомогою файлу
Набір інструментів шаблонів. Якщо параметр "accept" не вказано, усі файли будуть прийняті
для обробки, якщо ще не скопійовано або проігноровано.

# ігнорувати ці файли
ігнорувати = \b(CVS|RCS)\b
ігнорувати = ^#
ігнорувати = ~$

# копіюйте ці файли
копія = \.(gif|png|jpg|pdf)$

# приймає лише шаблони .tt2
прийняти = \.tt2$

Параметр «суфікс» використовується для визначення зіставлення між розширеннями файлів для джерела
шаблони та згенеровані вихідні файли. Наступний приклад визначає це джерело
шаблони із суфіксом ".tt2" мають бути виведені як файли ".html":

суфікс tt2=html

Або в командному рядку,

--суфікс tt2=html

Ви можете надати будь-яку кількість різних зіставлень суфіксів, повторивши цю опцію.

Параметр "binmode" використовується для встановлення кодування вихідного файлу. Наприклад, використовувати
"--binmode=:utf8", щоб встановити вихідний формат на Unicode.

шаблон Залежності
Параметри "depend" і "depend_file" дозволяють вказати, яким чином буде виконуватися будь-який файл шаблону
залежить від іншого файлу або групи файлів. Параметр "залежить" використовується для вираження a
єдина залежність.

$ ttree --depend foo=bar,baz

У цьому прикладі командного рядка показано, що параметр "--depend" використовується для визначення того, що Foo
файл залежить від бар та Baz шаблони. Цю опцію можна використовувати багато разів на
командний рядок:

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

або у файлі конфігурації:

залежать foo=bar,baz
залежать crash=bang,wallop

Файл, що з'являється зліва від "=", вказується відносно "src" або "lib"
каталогів. Файл(и), що з’являється праворуч, можна вказати відносно будь-якого з них
каталогів або як абсолютні шляхи до файлів.

Наприклад:

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

Щоб визначити залежність, яка застосовується до всіх файлів, використовуйте «*» зліва від «=".

$ttree --depend *=заголовок,нижній колонтитул

або у файлі конфігурації:

залежать *=заголовок, нижній колонтитул

Будь-які шаблони, визначені в "pre_process", "post_process", "process" або
Параметри "обгортки" будуть автоматично додані до списку глобальних залежностей, які
застосувати до всіх шаблонів.

Параметр "depend_file" можна використовувати для визначення файлу, який містить залежність
інформація.

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

Ось приклад файлу залежностей:

# Це коментар. Це ігнорується.

index.html: панель меню нижнього колонтитула

заголовок: гарячі посилання заголовка

панель меню: пункт меню

# охоплює декілька рядків із зворотною косою рискою
another.html: панель меню верхнього колонтитула \
форма пошуку бічної панелі

Рядки, що починаються з символу "#", є коментарями та ігноруються. Порожні рядки також є
ігнорується. Усі інші рядки мають містити назву файлу, потім двокрапку, а потім список
залежні файли, розділені пробілами, комами або обома. Пробіли навколо товстої кишки є
також необов'язковий. Рядки, що закінчуються на символ «\», продовжуються в наступному рядку.

Файли, які містять пробіли, можна вводити в лапки. Це необхідно лише для файлів після двокрапки
(':'). Файл перед двокрапкою може бути в лапках, якщо він містить двокрапку.

Як і у випадку з параметрами командного рядка, символ «*» можна використовувати як підстановку для вказівки a
залежність для всіх шаблонів.

* : конфігурація, заголовок

шаблон Інструментарій Опції
дерево також надає доступ до звичайного діапазону параметрів Template Toolkit. Наприклад,
"--pre_chomp" і "--post_chomp" дерево параметри відповідають "PRE_CHOMP" і
Параметри "POST_CHOMP".

Запустіть "ttree -h", щоб переглянути список доступних параметрів.

AUTHORS

Енді Вордлі[захищено електронною поштою]>

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

За участі Ділана Вільяма Хардісона (підтримка залежностей), Брайса
Харрінгтон ("абсолютний" і "відносний" варіанти), Марк Андерсон ("суфікс" і "налагодження"
варіанти), Харальд Йорг і Леон Брокард, який, здається, всюди потрапляє.

Версія

2.68, що поширюється як частина Template Toolkit версії 2.19, випущеної 27 квітня 2007 року.

АВТОРСЬКЕ

Авторські права (C) 1996-2007 Енді Уордлі. Всі права захищені.

Цей модуль є безкоштовним програмним забезпеченням; ви можете розповсюджувати його та/або змінювати під ним
терміни як сам Perl.

Використовуйте ttreep онлайн за допомогою служб onworks.net