• ContentManagementSystem/Forrest

Forrest

目次

• 概要
• URL
• インストールと設定
• 利用方法
• Tips
  • Emacsの設定
  • 日本語対応関係
• 参考サイト

概要

Apache XML プロジェクトが開発している、XMLによるPublishシステム。

比較的利用しやすい。

KrysalisCentipedeを元にして、かなり便利になっている。

Schema定義はRelaxNGを利用しDTDを生成している。

URL

http://xml.apache.org/forrest/

インストールと設定

Forrestサイトよりアーカイブをダウンロードしてきます。

とりあえず説明ではバイナリパッケージapache-forrest-0.4-bin.tar.gz(もしくはapache-forrest-0.4-bin.zip)を利用して解説します。

展開します。

.bashrcなどに以下の設定を追加

FORREST_HOME=/path/to/apache-forrest
PATH=${FORREST_HOME}/bin:$PATH

Terminalより

forrest -projecthelp

で利用方法のヘルプが表示されれば設定は完了です。

利用方法

任意のディレクトリに移動して

forrest seed

すると、テンプレートが作成されます。テンプレートファイル群を整理する事で構成を理解してください。

XMLを編集したら

forrest validate

しチェックをかけてください。XMLがまちがているとサイトが構築されません。

妥当性が確認できたら

forrest
もしくは
forrest site

する事でサイト構築します。構築のたびに全ファイルを構築しなおします。巨大ファイル群になると構築に時間がかかるのが欠点でしょう。。

マニュアル的には

http://xml.apache.org/forrest/your-project.html

あたりを参照するとたいがい問題はなさそうです。

Tips

Emacsの設定

psgml-modeとxslideがインストールされていれば十分です。

psgml-modeの設定としてDTDを定義します。

DTDは

$FORREST_HOME/context/resources/schema/dtd

以下にあります。

CATALOGへの追加

-- OASIS TR 9401 Catalog for Forrest --

OVERRIDE YES

-- Document Type Definitions --
PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
       "forrest/document-v11.dtd"
PUBLIC "-//APACHE//DTD Specification V1.1//EN"
       "forrest/specification-v11.dtd"
PUBLIC "-//APACHE//DTD FAQ V1.1//EN"
       "forrest/faq-v11.dtd"
PUBLIC "-//APACHE//DTD Changes V1.1//EN"
       "forrest/changes-v11.dtd"
PUBLIC "-//APACHE//DTD Todo V1.1//EN"
       "forrest/todo-v11.dtd"
PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN"
       "forrest/book-cocoon-v10.dtd"
PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.0//EN"
       "forrest/tab-cocoon-v10.dtd"
PUBLIC "-//APACHE//DTD How-to V1.0//EN"
       "forrest/howto-v10.dtd"
PUBLIC "-//APACHE//DTD Gump Descriptor V1.0//EN"
       "forrest/xgump-draft.dtd"
PUBLIC "-//APACHE//DTD JavaDoc V1.0//EN"
       "forrest/javadoc-v04draft.dtd"
PUBLIC "-//APACHE//DTD Contributors V1.0//EN"
       "forrest/contributors-v10.dtd"
PUBLIC "-//Outerthought//DTD Libre Configuration V0.1//EN"
       "forrest/libre-v01.dtd"
PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
       "forrest/catalog-v10.dtd"

-- Reusable modules --
PUBLIC "-//APACHE//ENTITIES Documentation V1.1//EN"
       "forrest/document-v11.mod"
PUBLIC "-//APACHE//ENTITIES FAQ V1.1//EN"
       "forrest/faq-v11.mod"
PUBLIC "-//APACHE//ENTITIES Todo V1.1//EN"
       "forrest/todo-v11.mod"
PUBLIC "-//APACHE//ENTITIES Common Elements V1.0//EN"
       "forrest/common-elems-v10.mod"
PUBLIC "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
       "forrest/common-charents-v10.mod"

-- ISO public identifiers for sets of character entities --
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN//XML"
       "entity/ISOlat1.pen"
PUBLIC "ISO 9573-15:1993//ENTITIES Greek Letters//EN//XML"
       "entity/ISOgrk1.pen"
PUBLIC "ISO 8879:1986//ENTITIES Publishing//EN//XML"
       "entity/ISOpub.pen"
PUBLIC "ISO 8879:1986//ENTITIES General Technical//EN//XML"
       "entity/ISOtech.pen"
PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
       "entity/ISOnum.pen"
PUBLIC "ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML"
       "entity/ISOdia.pen"
PUBLIC "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML"
       "entity/ISOlat1.pen"

ECATへの追加

-- Document Type Definitions --
PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
       cdtd/document-v11.dtd
PUBLIC "-//APACHE//DTD Specification V1.1//EN"
       cdtd/specification-v11.dtd
PUBLIC "-//APACHE//DTD FAQ V1.1//EN"
       cdtd/faq-v11.dtd
PUBLIC "-//APACHE//DTD Changes V1.1//EN"
       cdtd/changes-v11.dtd
PUBLIC "-//APACHE//DTD Todo V1.1//EN"
       cdtd/todo-v11.dtd
PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN"
       cdtd/book-cocoon-v10.dtd
PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.0//EN"
       cdtd/tab-cocoon-v10.dtd
PUBLIC "-//APACHE//DTD How-to V1.0//EN"
       cdtd/howto-v10.dtd
PUBLIC "-//APACHE//DTD Gump Descriptor V1.0//EN"
       cdtd/xgump-draft.dtd
PUBLIC "-//APACHE//DTD JavaDoc V1.0//EN"
       cdtd/javadoc-v04draft.dtd
PUBLIC "-//APACHE//DTD Contributors V1.0//EN"
       cdtd/contributors-v10.dtd
PUBLIC "-//Outerthought//DTD Libre Configuration V0.1//EN"
       cdtd/libre-v01.dtd
PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
       cdtd/catalog-v10.dtd

-- Reusable modules --
PUBLIC "-//APACHE//ENTITIES Documentation V1.1//EN"
       cdtd/document-v11.mod
PUBLIC "-//APACHE//ENTITIES FAQ V1.1//EN"
       cdtd/faq-v11.mod
PUBLIC "-//APACHE//ENTITIES Todo V1.1//EN"
       cdtd/todo-v11.mod
PUBLIC "-//APACHE//ENTITIES Common Elements V1.0//EN"
       cdtd/common-elems-v10.mod
PUBLIC "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
       cdtd/common-charents-v10.mod

-- ISO public identifiers for sets of character entities --
PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN//XML"
       cdtd/ISOlat1.pen
PUBLIC "ISO 9573-15:1993//ENTITIES Greek Letters//EN//XML"
       cdtd/ISOgrk1.pen
PUBLIC "ISO 8879:1986//ENTITIES Publishing//EN//XML"
       cdtd/ISOpub.pen
PUBLIC "ISO 8879:1986//ENTITIES General Technical//EN//XML"
       cdtd/ISOtech.pen
PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML"
       cdtd/ISOnum.pen
PUBLIC "ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML"
       cdtd/ISOdia.pen
PUBLIC "ISO 8879:1986//ENTITIES Added Latin 1//EN//XML"
       cdtd/ISOlat1.pen

.emacsの定義例は以下のようになります。

(setq sgml-custom-dtd
 '(
   ("Forrest_document-v11"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Documentation V1.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/document-v11.dtd\"/>\n")
   ("Forrest_specification-v11"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Specification V1.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/specification-v11.dtd\"/>\n")
   ("Forrest_faq-v11"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD FAQ V1.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/faq-v11.dtd\"/>\n")
   ("Forrest_changes-v11"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Changes V1.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/changes-v11.dtd\"/>\n")
   ("Forrest_todo-v11"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Todo V1.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/todo-v11.dtd\"/>\n")
   ("Forrest_book-cocoon-v10"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Cocoon Documentation Book V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/book-cocoon-v10.dtd\"/>\n")
   ("Forrest_tab-cocoon-v10"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Cocoon Documentation Tab V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/tab-cocoon-v10.dtd\"/>\n")
   ("Forrest_howto-v10"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD How-to V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/howto-v10.dtd\"/>\n")
   ("Forrest_xgump-draft"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Gump Descriptor V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/xgump-draft.dtd\"/>\n")
   ("Forrest_javadoc-v04draft"
    "<!DOCTYPE document PUBLIC \"-//APACHE//DTD JavaDoc V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/javadoc-v04draft.dtd\"/>\n")
   ("Forrest_contributors-v10"
   "<!DOCTYPE document PUBLIC \"-//APACHE//DTD Contributors V1.0//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/contributors-v10.dtd\"/>\n")
   ("Forrest_libre-v01.dtd"
    "<!DOCTYPE document PUBLIC \"-//Outerthought//DTD Libre Configuration V0.1//EN\"
        \"file:////Users/sakito/etc/psgml/forrest/libre-v01.dtd\"/>\n")
))

日本語対応関係

基本的には日本語に対応しているがデフォルトではファイルの出力エンコーディングがISO-8859-1になっている。

これを変更する方法は複数あるがもっとも根本的に修正する場合

$FORREST_HOME/context/sitemap.xmap
の
map:serializers

部分を変更してしまえばよい。

参考サイト

http://members.jcom.home.ne.jp/super-creek/forrest/ja/

---

CategoryJava CategoryXml