wml - Интернет в облаке

ПРОГРАММА:

ИМЯ

WML - язык веб-сайта META

Версия

2.0.12 (16 апреля 2008 г.)

СИНТАКСИС

WML [-I PATH] [-i PATH] [-D ИМЯ=STR] [-D ИМЯ~PATH] [-n] [-r] [-O уровень] [-o
[СЛИЦТЕРМ":"]PATH[@ЧМОДОПТ]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [входной_файл]

WML [-V [NUM]] [-h]

ОПИСАНИЕ

Это программа управления Вебсайт ЦЕЛЬ Язык (WML), бесплатное создание HTML
набор инструментов для Unix, состоящий из 9 независимых языков.

Основная идея WML - это схема последовательной фильтрации, в которой каждый язык предоставляет одно из
9 проходов обработки. Так WML читает входной_файл (или из STDIN if входной_файл это тире или
полностью отсутствует), применяет проходы 1–9 (или только проходы, указанные -p) и наконец
производит один или несколько выходной файлs.

Подробнее об этой схеме обработки читайте в WML Введение под wml_intro(7)
и WML учебник под wml_tutorial(7).

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-I, --include =PATH
Добавляет каталог в список пользовательских путей. Используйте эту опцию, чтобы установить время выполнения
среда для прохода 1. См. wml_p1_ipp(3) для получения более подробной информации.

-i, --includefile =PATH
Предварительно загружает конкретное включение файл, т.е. фактически добавляет

#include "ПУТЬ"

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

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

-D, --define =ИМЯ~PATH
Аналогично приведенному выше, но определяет переменную, содержащую путь, который настраивается автоматически.
(см. ниже). Его можно интерполировать так же, как вариант "NAME = STR" из
выше.

-n, --ношебанг
Это заставляет WML игнорировать возможно содержащуюся строку shebang в входной_файл. Это
обычно используется WMk, потому что WMk уже проанализировал эту строку и предоставил параметры для
ВМЛ.

-r, --норкфайл
Это заставляет WML игнорировать все .wmlrc файлы.

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

-O, --optimize =NUM
Это вариант оптимизации, который передается непосредственно на проход 8 (htmlfix). Это
контролирует объем оптимизации / удаления, который применяется к сгенерированному HTML
код разметки.

-o, --outputfile =СЛИЦТЕРМ:выходной файл[@ЧМОДОПТ]
Это перенаправляет вывод в файл. Обычно весь файл отправляется по адресу стандартный вывод
(то же, что и «ВСЕ: -»). Вы можете использовать эту опцию более одного раза для вывода более чем на один
файл при использовании СЛИЦТЕРМ как термин теории множеств срезов, чтобы определить, какие
содержимое будет включено в каждый конкретный выходной файл. Необязательный ЧМОДОПТ is
предназначен для определения параметров окончательно примененного CHMOD команда. Например, используйте
«u + x» '' для создания файла с установленным битом выполнения (функция Apache XBitHack).
Читать кусочек(1) для получения более подробной информации.

-P, --prolog =PATH
Выполняет фильтр пролога над входным файлом. Эта программа получает данные, чтобы действовать на
как STDIN и должен выдавать отфильтрованные данные на STDOUT.

-E, --epilog =PATH
Запускает программу-эпилог над итоговыми файлами вывода. В настоящее время
известны следующие программы, специфичные для WML: htmlинформация, ссылкалинт, аккуратный и паутинка. Но
вы можете указать любую программу, которая доступна в вашем «ПУТЬ». Эта программа получает
файл, который будет действовать как первый аргумент командной строки. Обратите внимание, что вывод не
перенаправлен в этот файл, поэтому вы должны использовать оболочку или специальные флаги программы, если вы
хотите изменить выходные файлы.

-t, --установить время
Это устанавливает время модификации всех выходных файлов равным времени модификации
входной файл плюс 1 секунда. Это полезно, потому что веб-серверы будут генерировать
Заголовки "Last-Modified", и там время редактирования важнее, чем
время поколения. Смещение в 1 секунду предназначено для зависимостей Makefile.

-M, --зависеть[=ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ]
Выведите правило, подходящее для make, описывающее зависимости каждого выходного файла, как
gcc делает. Это имеет смысл только тогда, когда -o опция используется. Обработка не производится
кроме первого прохода.

Ассоциация D Параметр flag записывает правило в файл зависимостей. Имя этого файла
получается заменой суффикса выходного файла на ".d".

Ассоциация M Параметр flag удаляет системные файлы из списка зависимостей.

-p, --pass =STR
Определяет, какой из описанных выше проходов фактически применяется во время выполнения. В
аргумент 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"> внутри прохода 2 и через $ NAME на проходе 3.

WML_SRC_DIRNAME
Текущий рабочий каталог, откуда WML был начат. Абсолютная файловая система Unix
дорожка.

WML_SRC_FILENAME
Имя входной_файл из командной строки. Полезно при беге WML на большей части
файлы и включаемые файлы должны определять, в какие они включены.

WML_SRC_BASENAME
Базовое название входной_файл, то есть "WML_SRC_FILENAME", но с расширением
уже раздели.

WML_SRC_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
внутри заголовка содержится информация о версии инструментов генерации.

ИСПОЛЬЗУЕМЫЙ ПЕРЕМЕННЫЕ
"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 или выше и, следовательно,
отображение обработанных данных после каждого прохода. По умолчанию - «больше».

«ТМПДИР»
Эта переменная содержит каталог, в котором WML хранит свои временные файлы. По умолчанию
'/ Tmp'.

USER FILES

$ HOME / .wmlrc и (../)*.wmlrc
Эти файлы также могут содержать строки параметров, по одному параметру в строке. Обычно
содержимое - одно или несколько -D параметры, особенно с автонастройкой:

-ДРООТРЕЛ ~.
-DROOTABS =http://thishost/thisarea/
:
-DNAME1 = VALUE1
-DNAME2 = VALUE2
:

STANDARD ВКЛЮЧАЮТ FILES

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

# использовать wml :: category :: name

и прочтите их собственную документацию через

$ man wml :: категория :: имя

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

SPECIAL ФУНКЦИИ И ОСОБЕННОСТИ

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

Поддержка линии Шебанг
WML распознает притон строка (`` "#! wml" кредита'') в .wml файлы и
автоматически добавляет кредита в его командную строку. Эта строка также используется WMk. Два
доступны специальные функции в отличие от строк shebang для загрузчика Unix: WML
Строка shebang может быть продолжена символом обратной косой черты, а конструкции% DIR и
% интерполируются (где% DIR - это путь к каталогу источника, а
находится, а% BASE - имя исходного файла без расширения).

Пример:

#! wml -o (ВСЕ-ЯЗЫКИ _ *) + LANG_EN:% BASE.en.html \
-o (ВСЕ-ЯЗЫКИ _ *) + LANG_DE:% BASE.de.html

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

Пример:



...
output = " "+ help_string +" "
...



Внимание!

Начиная с WML 2.0.3, этап 1 включает дополнительные элементы, помогающие сохранить информацию о строке.
соответствующие числа (a la cpp). Так что при написании


#include 'foo'


эти дополнительные команды не будут интерпретироваться во время прохода 2 и останутся на выходе.
Чтобы подавить их, либо скомпилируйте с флагом "-W1, -N", либо напишите


#include 'foo' IPP_NOSYNCLINES

АВТОРЫ

Ральф С. Энгельшалл
[электронная почта защищена]
www.engelsschall.com

Дени Барбье
[электронная почта защищена]

Используйте wml онлайн с помощью сервисов onworks.net