' に置き換える。次に、`' の `color' 属性を修正する。そして、欠けている `alt' と `width'/`height' 属性を追加する。マークアップコードを構造化する LESSON: インクルードファイルを使う WML の最も便利な機能の一つは、よく使うものをインクルードファイルにし、後から選択的に導入できることである。 bar.wml というインクルードファイルを持っているとする... 1| bar 2| The value of bar is: $(bar:-unknown) ...そして、次にファイルを挿入する: 1| foo 3| #include 'bar.wml' bar="FooBar" 2| #include 'bar.wml' 5| quux すると出力は: 1| foo 2| bar 3| The value of bar is: Foobar 4| bar 5| The value of bar is: unknown 6| quux 見ての通り、`#include' が対応したファイルの内容に置き換えられる。そして、このインクルードされたコンテンツ内の変数に標準の値が定義されていれば、含まれた変数に手を加えることができる。この変数を使うことで、単純な if-then-else 構文が実現できる: 1| The value of bar is $(bar:+set)$(bar:*unset). この ``$(bar:+set)$(bar:*unset)'' は以下の構造と同じである。 if (isdefined(bar)) expandto("set") else expandto("unset") LESSON: 行の連結例え HTML が普通空白と改行をきにしないとはいえ、実際に一行でなければならない場合、整形済の領域を作ったりコードを複数行に拡張する機能無しで、自分自身のタグ(後で説明)を書くのは非常に困難である。このために、多くの言語では行連結/継続文字として ``\'' を使う。WML もそうである。 Input: 1| foo\ 2| bar \ 3| quux Output: 1| foobar quux 行の連結は、連結開始から空白の終りまで、空白を保存せずに取り去る。つまり、実際の空白として連結文字の前の空白文字を使えるが、連結の後の空白を実際の空白として使うことはできない。 LESSON: 位置への転用 WMLの最も強力な機能の一つは、定義された*位置*に、データを*転用*する能力である。 Input: 1| {#BAR#:this is:##} 2| foo 3| {#BAR#} 4| quux 5| {#BAR#: bar:##} 6| foobar 7| {#BAR#} Output: 1| foo 2| this is bar 3| quux 4| foobar 5| this is bar 3行目にある `BAR' は1行目と5行目の内容が転用されて表示される。そして、見てのとおり、どんな場所からでも、何度でも転用できる。以降の設定(1と5行目)により、内容を累積することができる。これは、最初にWMLが全ての内容を累積し、それからすべての場所で転用するためだ。 wml::std::tags の高水準のタグと一緒に使う事で、より人が読みやすい方法で、例を書けた: 1| #use wml::std::tags 2| this is 3| foo 4| 5| quux 6| bar 7| foobar 8| LESSON: 分割出力の定義時々、人は複数の出力ファイルを必要とする。通常、コンテンツの90%が同じものであるけれども、人は10%の残りを選択する必要がある。WML のアプローチは、異なる出力ファイルをつくるために後で使う *スライス* を定義することにより違う部分を切離すことにより、10%をファイルの中に直接分割書き込む方法である。 1| 2| 3| [EN:Titleline:][DE:Titelzeile:] 4| 5| 6|

[EN:Headerline:][DE:Ueberschrift:]

7| 8| 上記のページが、ファイル index.wml とコマンドであると仮定すると $ wml -o UNDEF+EN:index.html.en \ -o UNDEF+DE:index.html.de index.wml ``EN''で定義されたスライスと、それ以外の共通の領域を含む、出力ファイル `index.html.en'を生成する... 1| 2| 3| Titleline 4| 5| 6|

Headerline

7| 8| ...そして、``EN''で定義されたスライスと、それ以外の共通の領域を含む、出力ファイル `index.html.de' を出力する。 1| 2| 3| Titelzeile 4| 5| 6|

Ueberschrift

7| 8| 整形 LESSON: 領域の置き換え WMLは、置き換え機能を提供する。指定した領域に対し、若干のPerlの置き換えや転換の機能を使うことができる。 Input: 1| foo 2| {: [[s/foo/bar/g]] [[s/quux/foobar/g]] [[tr/[a-z]/[A-Z]/]] 3| this is foo and quux. 4| :} 5| quux Output: 1| foo 2| THIS IS BAR AND FOOBAR. 3| quux これは役にたたないかもしれない。我々はさらにwml::fmt::isolatin と wml::fmt::url の `' と `' コンテナタグを使用した例を示す。 Input: 1| #use wml::fmt::isolatin 2| #use wml::fmt::url 3| 4| Some umlauts `�靍吊' and 5| a hyperlink http://foo.bar.com/ 6| Output: 1| Some umlauts `öäüÖÄß' and 2| a hyperlink http://foo.bar.com/ LESSON: テキストの書式整形テキストに複数の段落を書き込むようになるとき、HTMLは無視する。 WMLは、他のマークアップ言語プロセッサーを通して、入力の領域を書式整形する素晴らしい方法を提供する。この例では、二つの埋め込まれた領域がある。片方は *Plain Old Document* (POD) フォーマットで、もう一つは、 *Simple Document Format* (SDF) フォーマットである。 Input: 1| #use wml::fmt::pod 2| #use wml::fmt::sdf 3| 4| 5| =head1 Headline1 6| 7| Foo 8| 9| =head2 Headline1.1 10| 11| Bar 12| 13| 14| 15| H1: Headline1 16| 17| Foo 18| 19| H2: Headline 1.1 20| 21| Bar 22| * Baz 23| - Foobar 24| - Quux 25| * Foo 26| 27| Output: 1| 2|

Headline1 4|

5| Foo 6|

Headline1.1 8|

9| Bar 10|

11|

1. Headline1

12|

Foo

13|

1.1. Headline 1.1

14|

Bar

15|

Baz
- Foobar 18|
- Quux
19|
Foo

2| 3| 4| 5| 6| 7| 8| 9| 10| 11| 12| 13| 14|

Header 1	Header 2
Cell-A	Cell-B
Cell-C	Cell-D

2| 3| 4| 5| 6| 7| 8| 9| 10| 11| 12| 13| 14|

Header 1	Header 2
Cell-A	Cell-B
Cell-C	Cell-D

独自のHTMLタグを定義する LESSON: 単純なタグとコンテナタグさて。新しい、特製のHTMLタグを定義して、マークアップ言語を拡張する時間である。これには、二種類のHTMLタグがある。単純なタグ例として、`' という私の名前を省略できるタグを定義した。 Input: 1| 2| rse@engelschall.com 3| 4| 5| This is . Output: 1| This is rse@engelschall.com. コンテナタグ例として、`'という、かこまれた文字の色を赤にするタグを定義した。 Input: 1| 2| %body 3| 4| 5| This is very important. Output: 1| This is very important. LESSON: 属性付きのタグ属性の無いタグはあまり柔軟ではないので、属性付きのタグを定義してみよう。 Input: 1| 2| 3| 4| 5| 6| 7| 8| 9| 10| This is and . Output: 1| This is rse@engelschall.com and rse@apache.org. `name=value' という属性を変数としている: Input: 2| 3| 4| 5| " "" "rse@engelschall.com"> 6| " "engelschall" "rse@engelschall.com"> 7| " "netsw" "rse@netsw.org"> 8| " "apache" "rse@apache.org"> 9| " "freebsd" "rse@freebsd.org"> 10| " "sdm" "rse@sdm.de"> 11| 12| 13| 14| This is and . Output: 1| This is rse@engelschall.com and rse@apache.org. LESSON: 既にあるHTMLタグを上書きする WML では、既存のHTMLタグを上書きする事もできる。既存のタグと同じ名前の特製のタグを定義し、その中で元のHTMLタグを使えるのだ。 Input: 1| 2| 4| 5| 6| Some Text
7| Some more Text Output: 1| Some Text

2| Some more Text LESSON: Perl でタグをプログラムする WML の重要な機能の一つに、どのような場所でも、``<:'' と ``:>'' で囲んだ領域に、Perl コードを書けるという事がある。これは、タグを定義と組み合わせることで、Perlでタグをプログラムできるということだ。 Input: 1| #use wml::std::tags 2| 3| 4| 5| <:{ 6| my $at = qq//; 7| my $addr; 8| $addr = "rse@engelschall.org" if $at eq ''; 9| $addr = "rse@engelschall.org" if $at eq 'engelschall'; 10| $addr = "rse@netsw.org" if $at eq 'netsw'; 11| $addr = "rse@apache.org" if $at eq 'apache'; 12| $addr = "rse@freebsd.org" if $at eq 'freebsd'; 13| $addr = "rse@sdm.de" if $at eq 'sdm'; 14| print $addr; 15| }:> 16| 17| 18| 19| This is and . Output: 1| This is rse@engelschall.com and rse@apache.org. 上級向け機能 LESSON: テンプレートを使う既に、データを他の位置に転用する方法は見た。WML はファイルの終端で、既に開いている転用を自動的に閉じる。我々はテンプレートを作るためにこの機能を使うことができる。例えば、template.wml というテンプレートファイルがあると仮定する。 1| # the template itself 2| 3| 4| {#SUBJECT_LOC#} 5| 6| 7|

{#SUBJECT_LOC#}

9| {#BODY#} 10|

11| 12| 13| 14| # way to insert the subject 15| 16| {#SUBJECT_LOC#:%0:##} 17| 18| 19| # per default we are in body 20| {#BODY#: Input: 1| #include 'template.wml' 2| 3| 4| 5| This is about Foo, Bar and Quux... Output: 1| 2| 3| Foo, Bar and Quux 4| 5| 6|

Foo, Bar and Quux

8| This is about Foo, Bar and Quux... 9|

10| 11| WMLの転用メカニズムがどんなポイントでも転用を行うため、複数のテンプレー� � を入れ子にすることもできる。 LESSON: 多言語ページを作成する WML のコアとなる言語は、それぞれ違う人間の言語で同じページ情報を含む場合を除き、一つの入力から複数のページを作るといった、多言語ページを作るための専用の機能を提供しない。しかし、WML は ``スライス処理'' (9番目の処理) を通してこれを提供する。そして、色々な出力ファイルを作ることのできるタグ群を含む、 wml::std::lang というものが存在する。 Let take an example: 1| #!wml -o (ALL-LANG_*)+LANG_EN:index.en.html \ 2| -o (ALL-LANG_*)+LANG_DE:index.de.html 3| 4| #use wml::std::page 5| #use wml::std::lang 6| 7| 8| 9| 10| 11| 12|

!

13| 14| Index 2 15| 16| 17| (en)This is a test page 18| (de)Dies ist eine Testseite 19| 処理の1番目から8番目 (`wml -p1-8') まで行うと、WMLは内部で以下のようなコードを生成する: 1| 2| 3| 4| 5|

[LANG_EN:Welcome:][LANG_DE:Willkommen:]!

6| Index 2 7| [LANG_EN:This is a test page 8| :][LANG_DE:Dies ist eine Testseite:] 9| 10| そしてその後、9番目の処理で WMLのマジック行である (`#!wml -o...') が以下の二つのファイルを生成する: index.en.html: 1| 2| 3| 4| 5|

Welcome!

6| Index 2 7| This is a test page 8| 9| 10| index.de.html: 1| 2| 3| 4| 5|

Willkommen!

6| Index 2 7| Dies ist eine Testseite 8| 9| そして、これらの2ページは、WEB サーバの言語選択機能あるいは直接参照により提供される。付記ここまで、WMLの様々な機能を見たはずである。詳細を知りたいのならば、 wml_intro(7) でのWMLの概略またはそれぞれのコア言語のマニュアルを調べる必要がある。まずは、フロントエンドである wml(1) からはじめよう。さらに、インクルードされる WML ファイルにより、規格を詳細に知ることもできる。これは最上位のインクルードファイルである wml:all(3) からはじめよう。関連項目 wml_intro(7) wml_p1_ipp(1), wml_p2_mp4h(1), wml_p3_eperl(1), wml_p4_gm4(1), wml_p5_divert(1), wml_p6_asubst(1), wml_p7_htmlfix(1), wml_p8_htmlstrip(1), wml_p9_slice(1). wml::all(3)