wml - クラウド上のオンライン

プログラム：

NAME

WML - ウェブサイトのメタ言語

VERSION

2.0.12 (16 年 2008 月 XNUMX 日)

SYNOPSIS

wml [-I パス] [-i パス] [-D NAME=STR] [-D NAME~パス] [-n] [-r] [-O レベル] [-o
[SLICTERM「:」]パス[@チモドプト]][-P パス] [-E パス] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [入力ファイル]

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

DESCRIPTION

の制御プログラムです。 ウェブサイト META 言語設定 (WML)、無料の HTML 生成
Unix 用のツールキット。内部は 9 つの独立した言語で構成されています。

WML の主な考え方は、各言語が次のいずれかを提供する順次フィルタリング スキームです。
9 回の処理パス。 それで wml 読み込み 入力ファイル （またはから stdin if 入力ファイル ダッシュまたは
完全に欠落しています)、パス 1 ～ 9 (または で指定されたパスのみ) を適用します。 -p） そして最後に
XNUMX つ以上を生成します 出力ファイルs.

この処理スキームの詳細については、次のドキュメントを参照してください。 WML 概要 下 wml_intro(7)
と WML チュートリアル 下 wml_チュートリアルとします。

OPTIONS

-I, --include =パス
追加 ディレクトリにジョブを開始します。 ユーザーインクルードパスのリストに追加します。 このオプションを使用してランタイムを設定します
パス 1 の環境。 を参照してください。 wml_p1_ipp（3）詳細については。

-i, --includefile=パス
特定のインクルードをプリロードします file、つまり、仮想的に追加します

#include "パス"

の上部に 入力ファイル。 これを使用して、デフォルトのユーザー インクルード ファイルを自動的に含めます。
システムインクルードファイルをインクルードしたい場合は、 パス 角度付き
括弧、たとえば ``"-i" " を使用します。 ファイルを含めるには「」 foo/bar.wml
システムインクルード領域から。 あるいは、特別な構文を使用することもできます
「#use」ディレクティブと同様に「wml::foo::bar」。

-D, --define =NAME=STR
パス 1 (IPP) では「$(NAME)」を介して補間できる変数をパス 2 で定義します
(mp4h) <"get-var NAME"> 経由、パス 3 (ePerl) 経由 "<:=$NAME:>"、およびパス 4 (GNU m4)
「m4_NAME」経由。 特別なバリエーション --define =NAME=UNDEF 逆にすると削除されます
以前の定義 (これらの変数の定義を解除することとは異なる場合があります。たとえば、
システム定義変数を使用)。

-D, --define =NAME~パス
上記と似ていますが、自動調整されるパス名を保持する変数を定義します。
（以下を参照してください）。 これは、次の「NAME=STR」バリアントと同じ方法で補間できます。
上記。

-n, --ノシェバン
これにより、WML は、含まれている可能性のあるシバン行を無視します。 入力ファイル。 これは
WMk はすでにこの行を解析し、オプションを提供しているため、通常は WMk によって使用されます。
WML。

-r, --norcfile
これにより、WML はすべてを無視します。 .wmlrc ファイル。

-c, --nocd
WML が別のディレクトリからの入力ファイルを処理する場合、そのディレクトリにジャンプします。
解析する前に .wmlrc ファイルを削除し、その後現在のディレクトリに戻ります。 このオプションの場合
が設定されている場合、ディレクトリの変更は行われず、 .wmlrc ファイルは現在と比較して読み取られます
作業ディレクトリ。

-O, --最適化=NUM
これは、パス 8 に直接渡される最適化オプションです (htmlfix）。 それ
生成された HTML に適用される最適化/除去の量を制御します。
マークアップコード。

-o, --outputfile=SLICTERM:出力ファイル[@チモドプト]
これにより、出力がファイルにリダイレクトされます。 通常、ファイル全体が次の場所に送信されます。 (Linuxで言うところのstdout）
(「ALL:-」と同じ)。 このオプションを複数回使用して、複数のデバイスに出力できます。
使用中にファイルを SLICTERM どのスライスを決定するためのスライスの集合論の項として
コンテンツは、それぞれの特定の出力ファイルに組み込まれます。 オプションの チモドプト is
最終的に適用されるオプションの指定を目的としています。 chmod 指示。 たとえば、使用
「"u+x"」を実行すると、実行ビットが設定されたファイルが作成されます (Apache の XBitHack 機能)。
見る スライス（1）詳細については。

-P, --プロローグ=パス
入力ファイルに対してプロローグ フィルターを実行します。 このプログラムは動作するデータを受け取ります
STDIN として、フィルタリングされたデータを STDOUT に生成する必要があります。

-E, --エピローグ=パス
最終的に生成された出力ファイルに対してエピローグ プログラムを実行します。 現在、
次の WML 固有のプログラムが知られています。 html情報, リンクリント, きちんとした & ウェブリント。 しかし
「PATH」で利用可能な任意のプログラムを指定できます。 この番組が受け取るのは、
最初のコマンドライン引数として動作するファイル。 出力はそうではないことに注意してください。
このファイルにリダイレクトされるため、次の場合はラッパーまたはプログラム固有のフラグを使用する必要があります。
出力ファイルを変更したい。

-t, --settime
これにより、すべての出力ファイルの変更時刻が次の時刻に設定されます。
入力ファイル プラス1秒。 これは、Web サーバーが生成するため便利です。
「Last-Modified」ヘッダーでは、編集時間の方が重要です。
生成時間。 1 秒のオフセットは、Makefile の依存関係用です。

-M, - それによる[=OPTIONS]
各出力ファイルの依存関係を記述する `make' に適したルールを次のように出力します。
`gcc' はそうします。 それは、次の場合にのみ意味を持ちます。 -o オプションが使用されます。 処理は行われません
最初のパスを除いて。

　 D flag オプションは、ルールを依存関係ファイルに書き込みます。 このファイルの名前は、
出力ファイルのサフィックスを「.d」に置き換えることで得られます。

　 M flag オプションは、依存関係のリストからシステム ファイルを削除します。

-p, --pass=STR
上で説明したパスのどれが実行時に実際に適用されるかを指定します。 の
引数 STR は、パス番号のカンマ区切りのリストで、次のような特別な場合があります。
すべてのパス「X...Y」には「XY」と書き込みます。 パス 9 が含まれていない場合 STR 結果として
出力が書き込まれる 標準出力。 デフォルトは文字列「"1-9"」です。

-W, --passoption=NUM,STR
設定オプション STR パスのために NUM.

-s, - 安全な
これにより、WML 内の一部の Perl ハックが無効になり、
さまざまなパスを実行するときに頭上で分岐します。

このオプションを使用しない場合、WML はパス 1,5,6,7,8、XNUMX、XNUMX、XNUMX、XNUMX (Perl で記述されています) をプリコンパイルします。
代わりに、現在実行中の Perl インタープリタの別の名前空間に移動します。
「system()」を介して外部から実行します。 その結果、これらのプログラムは次から実行されます。
同じ Perl インタプリタ内で実行できるため、CPU と時間のかかる XNUMX つの「fork()」が節約されます。
実際の処理時間は 2 ～ 4 秒になります。 経験はあるものの
それがうまく機能することを示しましたが、理論的な問題はまだ残っています。このアプローチは
Perl 変数の内部競合により、多少危険です。

このオプションを使用して、WML に安全な「fork()」の使用を強制することでこれらの高速化を無効にします。
アプローチで回避できます。

-v, -詳細[=NUM]
これにより、一部の処理情報が提供される冗長モード (1 から 9) が設定されます。
コンソール上で。 デバッグに役立ちます。 このオプションは一部のにも渡されます。
プログラムのフィルタリング。 デフォルトでは冗長性はなく、単に -v 手段 -v1.

-q, - 静かな
これにより、処理プロパティが表示されなくなる Quiet モードが設定されます。 これを使って
実行時のオプション wml バッチジョブとして。 このオプションは、次の場合に自動的に強制されます。
入力ファイル 不足している。 その後、WML が自動的に読み取ります stdin 静音モードで。

-V, - バージョン[=NUM]
バージョン識別文字列と免責事項 (いいえ) を示します。 NUM or NUM >= 1)、WML
ビルド情報 (NUM >= 2) および Perl ビルド情報 (NUM >= 3)。 これを使って
特に次の場合に、インストールされている WML システムの簡単な説明を取得するオプション
作者にバグを報告する。

-h, - 助けて
使用量の概要ページを印刷します。

ENVIRONMENT

定義済み 変数
次の変数は常に次のように定義されます。 wml ランタイム中、通常は
パス 2 内では <"get-var NAME"> を介して、パス 3 では $NAME を介して補間されます。

WML_SRC_DIRNAME
現在の作業ディレクトリの場所 wml 始まった。 絶対的な Unix ファイルシステム
パス。

WML_SRC_FILENAME
の名前 入力ファイル コマンドラインから。 ランニング時に便利 wml 大量に
files と includefile は、どちらにインクルードされるかを決定する必要があります。

WML_SRC_BASENAME
のベース名 入力ファイル、つまり「WML_SRC_FILENAME」ですが、拡張子が付いています。
すでに剥がされています。

WML_SRC_TIME
の最終変更時刻 入力ファイル 「time()」形式で。 フッター内の便利な機能
カスタマイズされた日付形式が必要な場合。

WML_SRC_CTIME
の最終変更時刻 入力ファイル 「ctime()」形式で。 フッター内の便利な機能
インクルードファイル。

WML_SRC_ISOTIME
の最終変更時刻 入力ファイル ISO「yyyy-mm-dd hh:mm:ss」形式。 役に立つ
フッター内にはファイルが含まれます。

WML_SRC_USERNAME
を所有するユーザーの Unix ユーザー名 入力ファイル.

WML_SRC_REALNAME
所有するユーザーの本名 入力ファイル.

WML_GEN_TIME
「time()」形式の現在の生成時刻。 フッター内で使用すると便利です。
カスタマイズされた日付形式が必要です。

WML_GEN_CTIME
「ctime()」形式の現在の生成時刻。 内側のフッターには次のような便利な機能があります。
ファイル。

WML_GEN_ISOTIME
ISO「yyyy-mm-dd hh:mm:ss」形式での現在の生成時刻。 内部で役立つ
フッターにはファイルが含まれます。

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 以上であるため、
各パスの後に処理されたデータを示します。 デフォルトは「さらに」です。

「TMPDIR」
この変数には、WML が一時ファイルを保存するディレクトリが含まれます。デフォルトは次のとおりです。
'/ tmpに'.

USER ファイル

$HOME/.wmlrc & (../)*.wmlrc
これらのファイルには、XNUMX 行に XNUMX つのオプションを含むオプション文字列も含めることができます。 通常、
コンテンツは XNUMX つ以上です -D オプション、特に自動調整されるオプション:

～ドルートル～。
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=VALUE1
-DNAME2=VALUE2
:

STANDARD インクルード ファイル

WML には、標準のインクルード ファイル セットが付属しています。 これらを直接含めることができます。

#wml::カテゴリ::名前を使用します

そして、自分のドキュメントを読んでください。

$ man wml::category::name

見る wml::を(3) 利用可能なすべてのインクルード ファイルの説明。

特殊 商品特徴

WML コントロール フロントエンドは、独自にいくつかの特別な機能を提供します。

シバンラインのサポート
WML が認識するのは、 シェバング line (``"#!wml" オプション''） の中に .wml ファイルと
自動的に追加される オプション コマンドラインに。 この行は WMk によっても使用されます。 二
Unix ローダーのシバン行とは対照的な特別な機能が利用可能です: WML の
シバン行はバックスラッシュ文字と構成要素 %DIR および %DIR を使用して継続できます。
% 補間されます (%DIR はソース ディレクトリへのパスです)
が存在し、%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」です。
「パス」を使用する場合は、 SPEC 「#-」、「-#」、「#-#」、またはカンマ区切りのいずれかにすることができます
パスのリスト。「#」には 1 ～ 9 を指定できます。

例：



...
出力 = " " + ヘルプ文字列 + " 」
...



警告：

WML 2.0.3 以降、パス 1 には、行に関する情報を保持するのに役立つ追加のものが含まれています。
関連する数値 (cpp のようなもの)。 だから書くときは


#「ふー」を含める


これらの追加のコマンドはパス 2 では解釈されず、出力に残ります。
それらを抑制するには、「-W1,-N」フラグを使用してコンパイルするか、次のように記述します。


#include 'foo' IPP_NOSYNCLINES

作者

ラルフ・S・エンゲルシャル
[メール保護]
www.engelschall.com

ドゥニ・バルビエ
[メール保護]

onworks.net サービスを使用してオンラインで wml を使用する