Home

モジュール

概要

モジュール は、LiuLian記法ではできない細かい指定や、複雑な機能を実行します。

モジュールには以下の2つの形式があります。

ブロックモジュール

行単位に記述します。

#モジュール名(パラメータ)<<EOD
内容...
内容...
EOD

内容 にはモジュールを含む任意のLiuLian記法を記述できます。 EOD には任意の文字が使用できますので、目印となる名前をつけるとよいでしょう。

インラインモジュール

1行の中に記述します。

&モジュール名(パラメータ){内容};

複数行にまたがっての記述はできません。 内容 にはインラインモジュールも記述できます。


title - HTMLのタイトルを指定する

#title(タイトル)

文書のタイトル (h1) の代わりに、指定した タイトル をHTMLのタイトル (title) として使用します。 タイトル 中に $$ を記述すると、その位置に文書のタイトルを挿入します。

contents - 目次を作成する

#contents(開始レベル,終了レベル,区切り文字)

指定された位置に目次を作成します。 開始レベル終了レベル を指定した場合は、その範囲のレベルの見出しのみ目次とします。 区切り文字 を指定した場合は、終了レベルを区切り文字で区切って一列に表示します。

#nav(URL[,title,top])<<EOD

URL で指定されたページ内のリンクを順にたどるナビゲーションを生成します。 同一サーバ内の LiuLian形式テキスト のみが指定可能です。 目次へのリンクを作成する場合は title に名称、top にURLを指定してください。

footnote - 脚注を表示する

#footnote

指定された位置に脚注を表示します。

include - 別のファイルを読み込む

#include(URL)

指定された位置に URL で指定されたファイルの内容を展開します。 同一サーバ内の LiuLian形式テキスト のみがインクルード可能です。

img - 画像を埋め込む

#img(URL, 代替文字列, オプション...)
&img(URL, 代替文字列, オプション...);

URL で指定された画像を埋め込みます (img)代替文字列alt 属性になります。

オプション には以下が指定できます。 複数のオプションを指定する場合は、カンマで区切ってください。

color - 文字の色を変える

&color(文字色,背景色,縁取色){文字列};

文字列文字色背景色縁取色 を指定します。 それぞれの色は省略できます。

色には以下の形式が使えます。

size - 文字の大きさを変える

#size(サイズ)<<EOD
&size(サイズ){文字列};

文字列 のフォントサイズを指定します。 サイズ には以下の形式が使えます。

br - 改行する

&br;

指定された位置で改行します。

clear - 文字の回り込みを解除する

#clear(オプション)
#clear
&clear(オプション);
&clear;

imgモジュールなどで指定された文字の回り込みを解除します。

オプション にはleftもしくはrightが指定できます(CSSの clear: プロパティ)。 オプションを省略した場合は、左右両方の回り込みを解除します(CSSの both)。

class - スタイルシート用のクラスを定義する

#class(クラス名)<<EOD
&class(クラス名){文字列};

ブロックモジュールの形式の場合、以下のHTMLに変換されます。

<div class="クラス名"> ... </div>

インラインモジュールの形式の場合は、以下のHTMLです。

<span class="クラス名">文字列</span>

style - スタイルシートを指定する

#style(URL[, media])
#style<<EOD

URL が指定された場合、そのURLを外部スタイルシートのURLとします。 外部スタイルシートは複数指定できます。 media にスタイルシートの media 属性を指定することもできます。

内容 が指定されている場合は、 内容をHTML内部にスタイルシートとして展開します。

icon - アイコンを指定する

#icon(URL)

URL で指定された画像をアイコン(favicon)として使用します。

lang - コンテンツの言語を指定する

#lang(言語)
#lang(言語)<<EOD
&lang(言語){内容};

言語 をコンテンツの言語とします。 言語 には、ja, en-US といった言語タグを指定してください。 内容 を指定した場合は、内容の部分のコンテンツの言語を指定します。

redirect - 指定したURLにリダイレクトする

#redirect(URL[, 秒数])

URL で指定したURLに 秒数 後にリダイレクトします。 秒数 を省略した場合は、即座にリダイレクトします。

script - JavaScriptを使う

#script(URL)
#script<<EOD

URL で指定したJavaScriptを読み込みます。 内容 を指定した場合は、内容をJavaScriptのコードとして展開します。

_ - HTMLタグを使う

#_(タグ名 属性)<<EOD
#_(タグ名 属性)
&_(タグ名 属性){内容};
&_(タグ名 属性);

自由にHTMLのタグを埋め込むことができます。

内容 が指定された場合は以下に変換します。

<タグ名 属性>内容</タグ名>

内容 が指定されていない場合は以下に変換します。

<タグ名 属性>

属性 は、属性名="属性値" の形式で、複数指定できます。

import - 外部モジュールをインポートする

#import(モジュール名)

モジュール名 で指定した外部モジュールをインポートし、使用できるようにします。