kahua.xml-template

[module] kahua.xml-template

非常にシンプルなページテンプレート機能を提供するモジュールです。

pathで与えられたXMLファイルからテンプレートオブジェクトを生成します。 pathはフルパスで与えるのが安全です。kahua.configのtemplate-directory に置かれているXMLファイルを指定したければ

(kahua:make-xml-template (kahua-template-path "foo.xml"))

とすればよいでしょう。

使用するXMLは、文字エンコーディングがUTF-8でなければなりません(これは現在の実装上の制限です)。

ns-alistは省略可能な引数で、#f か、名前空間を表すプレフィックスと URIのalistを指定します。省略時は

((#f . "http://www.w3.org/1999/xhtml"))

を渡したのと同じです。#fを渡すと、「部分テンプレート」を作成します。この時、pathで指定するXMLファイルにはXML宣言を含めてはいけません (これも現在の実装上の制約です)。

テンプレートtemplateにkargsを適用して、SXMLノードを構築します。kargsはキーワード引数で、次のような書式になります。

:id1 node1 :id2 node2 ...

:idは、テンプレート生成時に指定したXMLファイルの、要素に与えられたID属性値と同じ名前のキーワードです。nodeには、高階タグ関数で作られる関数ノード、単純タグ関数で作られるSXMLノード、SXMLリテラルのいずれも渡すことができますし、混在させることもできます。