wml - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

WML - МЕТА мова веб-сайту

Версія

2.0.12 (16 квітня 2008 р.)

СИНТАКСИС

wml [-I PATH] [-i PATH] [-D ІМ'Я=STR] [-D ІМ'Я~PATH] [-n] [-r] [-O рівень] [-o
[РОЗДІЛ":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [вхідний файл]

wml [-V [NUM]] [-h]

ОПИС

Це контрольна програма веб-сайт META Language (WML), безкоштовне покоління HTML
набір інструментів для Unix, що складається з 9 незалежних мов.

Основна ідея WML — це послідовна схема фільтрації, де кожна мова забезпечує один із них
9 проходів обробки. Так wml читає вхідний файл (або від stdin if вхідний файл є тире або
повністю відсутній), застосовується проходи 1-9 (або тільки проходи, зазначені в -p) і, нарешті
виробляє один або кілька вихідний файлs.

Додаткову інформацію про цю схему обробки див WML Вступ при wml_intro(7)
і WML Підручник при wml_tutorial(7).

ВАРІАНТИ

-I, --включати=PATH
Додає а каталог до списку користувачів включити шляхи. Використовуйте цю опцію, щоб встановити час виконання
середовище для проходу 1. Див wml_p1_ipp(3) для більш детальної інформації.

-i, --includefile=PATH
Попереднє завантаження конкретного включає файл, тобто практично додає a

#include "PATH"

на вершині вхідний файл. Використовуйте це для автоматичного включення файлів користувача за замовчуванням.
Якщо ви хочете включити файл системного включення, ви повинні оточити файл PATH з кутом
дужки, наприклад, використовуйте ``"-i" " "'' щоб включити файл foo/bar.wml
із системи включати область. В якості альтернативи можна використовувати спеціальний синтаксис
``"wml::foo::bar"'', як у директиві "#use".

-D, --визначити=ІМ'Я=STR
Визначає змінну, яку можна інтерполювати на проході 1 (IPP) через "$(NAME)", на проході 2
(mp4h) через <"get-var NAME">, на проході 3 (ePerl) через "<:=$NAME:>" і на проході 4 (GNU m4)
через "m4_NAME". Особливий варіант --визначити=ІМ'Я=UNDEF робить навпаки, видаляє
попередні визначення (які можуть відрізнятися від скасування визначення цих змінних, напр
із визначеними системою змінними).

-D, --визначити=ІМ'Я~PATH
Подібно до наведеного вище, але визначає змінну, що містить назву шляху, яка автоматично коригується
(Дивись нижче). Його можна інтерполювати так само, як і варіант "NAME=STR".
вище.

-n, --noshebang
Це змушує WML ігнорувати ймовірно міститься рядок shebang вхідний файл, Це
зазвичай використовується WMk, оскільки WMk вже проаналізував цей рядок і надав параметри до
WML.

-r, --norcfile
Це змушує WML ігнорувати все .wmlrc файли.

-c, --nocd
Коли WML обробляє вхідний файл з іншого каталогу, він переходить до цього каталогу
перед розбором .wmlrc файлів, а після цього перейдіть до поточного каталогу. Якщо цей варіант
встановлено, не змінено каталог і .wmlrc файли читаються відповідно до поточних
робочий каталог.

-O, --оптимізувати=NUM
Це параметр оптимізації, який передається безпосередньо до проходу 8 (htmlfix). Це
контролює кількість оптимізації/вилучення, яке застосовується до згенерованого HTML
код розмітки.

-o, --вихідний файл=РОЗДІЛ:вихідний файл[@CHMODOPT]
Це перенаправляє вихід у файл. Зазвичай на адресу надсилається весь файл stdout
(те саме, що і "УСІ:-"). Ви можете використовувати цю опцію кілька разів, щоб вивести кілька
файл під час використання РОЗДІЛ як термін теорії множин зрізів, щоб визначити який
вміст буде включено до кожного конкретного вихідного файлу. Необов’язковий CHMODOPT is
призначений для вказівки параметрів для остаточно застосованого CHMOD команда. Наприклад, використання
``"u+x"'', щоб створити файл із встановленим бітом виконання (функція Apache XBitHack).
Читати частина(1) для більш детальної інформації.

-P, --prolog=PATH
Запускає фільтр прологу над вхідним файлом. Ця програма отримує дані для дії
як STDIN і має виробляти відфільтровані дані на STDOUT.

-E, --епілог=PATH
Запускає програму епілогу над остаточно отриманими вихідними файлами. В даний час
відомі такі специфічні для WML програми: htmlinfo, linklint, акуратний та weblint. Але
Ви можете вказати будь-яку програму, яка доступна у вашому "PATH". Ця програма отримує
файл, який діятиме як перший аргумент командного рядка. Зауважте, що вихід ні
перенаправлено до цього файлу, тому вам доведеться використовувати обгортку або спеціальні прапорці програми, якщо ви
хочете змінити вихідні файли.

-t, --settime
Це встановлює час модифікації всіх вихідних файлів на час модифікації
вхідний файл плюс 1 секунда. Це корисно, оскільки генеруватимуться веб-сервери
"Останнє змінене" заголовки і там час редагування важливіше, ніж
час покоління. Зміщення на 1 секунду призначено для залежностей Makefiles.

-M, --залежно[=ВАРІАНТИ]
Виведіть правило, яке підходить для `make', що описує залежності кожного вихідного файлу, як
`gcc' робить. Це має сенс лише тоді, коли -o використовується варіант. Обробка не проводиться
крім першого проходу.

Команда D Параметр flag записує правило у файл залежностей. Ім'я цього файлу
отриманий шляхом заміни суфікса вихідного файлу на ".d".

Команда M Параметр flag видаляє системні файли зі списку залежностей.

-p, --pass=STR
Вказує, які з описаних вище проходів насправді застосовуються під час виконання. The
аргумент STR являє собою розділений комами список номерів пропусків з одним особливим випадком: Ви можете
напишіть «XY» для всіх проходів «X...Y». Коли проход 9 не є частиною STR в результаті
вихід записується ВИСТАВКА. За замовчуванням є рядок ``"1-9"''.

-W, --passoption=NUM,STR
Встановити опцію STR за перепустку NUM.

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

Без цієї опції WML попередньо компілює проходи 1,5,6,7,8 (які написані на Perl!)
в інший простір імен поточного запущеного інтерпретатора Perl замість
запустити їх ззовні через "system()". В результаті ці програми запускаються з
у тому самому інтерпретаторі Perl, таким чином заощаджуючи п'ять процесорних і трудомістких "fork()".
Фактичний приріст становить від 2 до 4 секунд часу обробки. Хоча досвід
показав, що він чудово працює, теоретична проблема все ще в тому, що такий підхід є
дещо ризиковано через внутрішні конфлікти змінних Perl.

Використовуйте цю опцію, щоб вимкнути ці прискорення, змусивши WML використовувати безпечний "fork()"
підходу.

-v, -багатослівний[=NUM]
Це встановлює докладний режим (від 1 до 9), в якому буде надана інформація про обробку
на консолі. Корисно для налагодження. Ця опція також передається деяким з
програми фільтрації. За замовчуванням немає багатослівності і просто -v засоби -v1.

-q, --спокійно
Це встановлює тихий режим, коли параметр обробки більше не відображається. Використовуй це
варіант під час бігу wml як пакетна робота. Цей параметр автоматично вмикається, коли
вхідний файл відсутня. Тоді WML автоматично читає з stdin в тихому режимі.

-V, -- версія[=NUM]
Надає рядок ідентифікації версії та застереження (№ NUM or NUM >= 1), WML
створювати інформацію (NUM >= 2) та інформацію про збірку Perl (NUM >= 3). Використовуй це
можливість отримати короткий опис встановленої системи WML, особливо коли
повідомлення про помилки автору.

-h, --допомога
Друкує сторінку підсумку використання.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

ВИЗНАЧЕНИЙ ЗМІННІ
Наступні змінні завжди визначаються wml під час виконання і зазвичай
інтерполюється через <"get-var NAME"> всередині Pass 2 і через $NAME у Pass 3.

WML_SRC_DIRNAME
Поточний робочий каталог звідки wml було розпочато. Абсолютна файлова система Unix
шлях

WML_SRC_FILENAME
Назва вхідний файл з командного рядка. Корисно під час бігу wml на основну масу
файли та includefiles мають визначити, до якого складу вони включені.

WML_SRC_BASENAME
Основна назва вхідний файл, тобто "WML_SRC_FILENAME", але з розширенням
вже роздягнений.

WML_SRC_TIME
Час останньої модифікації вхідний файл у форматі "time()". Корисні внутрішні колонтитули
коли потрібен налаштований формат дати.

WML_SRC_CTIME
Час останньої модифікації вхідний файл у форматі "ctime()". Корисні внутрішні колонтитули
включити файли.

WML_SRC_ISOTIME
Час останньої модифікації вхідний файл у форматі ISO "рррр-мм-дд год:мм:сс". Корисний
внутрішні колонтитули містять файли.

WML_SRC_USERNAME
Ім'я користувача Unix користувача, який володіє вхідний файл.

WML_SRC_REALNAME
Справжнє ім’я користувача, який володіє вхідний файл.

WML_GEN_TIME
Поточний час генерації у форматі "time()". Корисно всередині колонтитулів, коли
потрібен індивідуальний формат дати.

WML_GEN_CTIME
Поточний час генерації у форматі "ctime()". Корисні внутрішні колонтитули включають
файли.

WML_GEN_ISOTIME
Поточний час генерації у форматі ISO "рррр-мм-дд год:мм:сс". Корисний всередині
колонтитули містять файли.

WML_GEN_USERNAME
Ім’я користувача Unix користувача, який запускає файл wml процесу.

WML_GEN_REALNAME
Справжнє ім’я користувача, який запускає wml процесу.

WML_GEN_HOSTNAME
Ім'я хоста, на якому розміщено wml команда виконується.

WML_LOC_PREFIX
Префікс розташування, куди було встановлено WML під час створення.

WML_LOC_BINDIR
Каталог, куди були встановлені двійкові файли WML під час створення.

WML_LOC_LIBDIR
Каталог, куди були встановлені файли бібліотеки WML під час створення.

WML_LOC_DATADIR
Каталог, куди були встановлені файли даних WML під час створення.

WML_LOC_MANDIR
Каталог, куди були встановлені сторінки посібника WML під час створення.

WML_VERSION
Рядок ідентифікації версії WML. Використовуйте це, наприклад, у коментарях HTML
внутрішній заголовок містить для визначення версії інструментів генерації.

USED ЗМІННІ
"WMLOPTS"
Ця змінна може містити рядок параметрів. Зазвичай це використовує Bourne-Shell
користувачам подобається

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ експорт WMLOPTS

і користувачам C-Shell, як

$ setenv WMLOPTS "-DNAME1=VALUE2 -DNAME2=VALUE2"

щоб переконатися, що деякі змінні визначені для всіх запусків wml.

"ПЕЙДЖЕР"
Ця змінна містить пейджер, який потрібно використовувати WML. WML використовує пейджер при виклику з
--verbose=NUM or -vNUM варіант відповідно і NUM становить 3 або вище, тому
показ оброблених даних після кожного проходу. За замовчуванням — «більше».

"TMPDIR"
Ця змінна містить каталог, у якому WML зберігає свої тимчасові файли. За замовчуванням є
'/ Tmp'.

USER ФАЙЛИ

$HOME/.wmlrc та (../)*.wmlrc
Ці файли також можуть містити рядки параметрів, по одному параметру на рядок. Зазвичай
вміст один або кілька -D параметри, особливо автоматично налаштовані:

-СЛИНОВОР~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=VALUE1
-DNAME2=VALUE2
:

STANDARD ВКЛЮЧАТИ ФАЙЛИ

WML постачається зі стандартним набором включаються файлів. Ви можете безпосередньо включити їх через

#використовуйте wml::category::name

і читати власну документацію через

$ man wml::category::name

Читати wml::всі(3) для опису всіх доступних включаються файлів.

СПЕЦІАЛЬНІ ОСОБЛИВОСТІ

Інтерфейс керування WML надає кілька спеціальних функцій сам по собі:

Підтримка лінії Shebang
WML розпізнає a притон рядок (``"#!wml" опції'') в .wml files and
автоматично додає опції до свого командного рядка. Цю лінію також використовує WMk. Два
На відміну від рядків shebang для завантажувача Unix доступні спеціальні функції: WML
shebang рядок можна продовжити за допомогою символу зворотної косої риски та конструкцій %DIR і
% інтерполюються (де %DIR - це шлях до каталогу джерела while
знаходиться, а %BASE — це ім’я вихідного файлу без розширення).

приклад:

#!wml -o (ALL-LANG_*)+LANG_EN:%BASE.en.html \
-o (ALL-LANG_*)+LANG_DE:%BASE.de.html

Тег контейнера захисту даних
WML надає власний внутрішній тег контейнера з назвою "
[pass=SPEC]>"..." ", який можна використовувати для захисту будь-яких типів даних від буття
обробляється будь-яким пропуском WML. Коли атрибут "pass" не надається SPEC за замовчуванням "1-9".
Коли ви використовуєте "pass" тоді SPEC може бути або "#-", "-#", "#-#" або через кому
список пропусків, а "#" може бути від 1 до 9.

приклад:



...
вихід = " " + help_string + " "
...



Увага!

Починаючи з WML 2.0.3, прохід 1 включає додаткові елементи, які допомагають зберігати інформацію про рядок
відповідні числа (а-ля cpp). Тому при написанні


#include 'foo'


ці додаткові команди не будуть інтерпретовані під час проходу 2 і залишаться на виході.
Щоб придушити їх, або скомпілюйте з прапором "-W1,-N", або запишіть


#include 'foo' IPP_NOSYNCLINES

AUTHORS

Ральф С. Енгельшаль
[захищено електронною поштою]
www.engelschall.com

Денис Барб'є
[захищено електронною поштою]

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