Create  Edit  Diff  FrontPage  Index  Search  Changes  History  RSS  Source  Login

x-hiki Diff - ひらくの工房

  • Added parts are displayed like this.
  • Deleted parts are displayed like this.

//escape_in_quote
//escape_in_pre
{{toc}}
! 注意
*このドキュメントは、バージョン0.21.3用のものです。
*リンク先のドキュメントは、古いバージョンに対するものになっている場合があります。

! 概要
Wikiシステムである[[Hiki|http://hikiwiki.org/]]において、TeXの数式を自動的にMathML変換して記事本文に埋め込む事を目的として開発したプラグイン集及びスタイルです。

[[こちら|http://www.hinet.mydns.jp/~hiraku/hiki/?TestWriteMath]]で実際に動作している様子を見ることが出来ます。

対応するHikiは、バージョン0.8.7です。

!ダウンロード
*http:files/x-hiki-0.21.3.tar.gz

!ファイル構成
<<<
x-hiki-0.21.x/
|-- dot.htaccess_rewrite_sample
|-- lib
|   |-- eim_xml.rb
|   |-- math_ml
|   |   `-- util.rb
|   `-- math_ml.rb
|-- mathwiki
|   |-- html_formatter.rb
|   `-- parser.rb
`-- plugin
    |-- en
    |   `-- x-math.rb
    |-- ja
    |   `-- x-math.rb
    |-- x-html_anchor.rb
    `-- x-math.rb
>>>
キットに含まれているプラグインは以下の通りです。

!!x-math.rb : MathMLプラグイン
Hikiが出力するデータのXHTML化と、LaTeX形式の数式を変換するメソッドの提供を行います。

従来はx-hiki.rbとx-math.rbに分かれていたものが、0.20で統合されました。

XHTMLへの変換は、ブラウザがXHTMLに対応しているかどうかを判別することで対応ブラウザに対してのみ行い、非対応ブラウザに対しては従来のHTMLページを出力します。

XHTMLモードでは、MathMLに変換した数式を表示し、HTMLモードではTeXのソースをXHTMLモードへのリンクとして表示します。

!!x-html_anchor.rb : XHTMLアンカープラグイン([[詳細|hiki_xhtml_anchor.rb]])
[[こちら|http://www.namaraii.com/hiki/?PretendStaticURL]]を参考にして作成した、XHTMLリンク自動生成プラグインです。
通常のリンク(hiki/hiki.cgi?PageName等)に代わって、HTMLモード用のリンク(hiki/PageName.html等)と、XHTMLモード用のリンク(hiki/PageName.xhtml等)を生成します。
Apacheのmod_rewriteが必要です。

! インストール方法
以下、Hikiがインストールされているディレクトリ(例えば /home/foo/public_html/hiki)を \${hiki} と記します。

!!プラグインのインストール
プラグイン用のファイルが x-hiki-0.21.x/plugin/ 以下に入っているので、すべてHikiのプラグイン用ディレクトリ \${hiki}/misc/plugin にコピーします。

ディレクトリ x-hiki-0.21.x/lib には、MathMLプラグインが利用するライブラリが入っています。これは、ディレクトリごと \${hiki}/misc/ にコピーします。''\${hiki}/plugin ディレクトリではありませんので、注意してください。''

コピーが終わると、\${hiki}/misc/ ディレクトリは次のようになるはずです。(以下では、すでにインストール済みの他のプラグインや言語リソースファイルは省略しています。)

misc/lib/
misc/lib/eim_xml.rb
misc/lib/math_ml.rb
misc/lib/math_ml/
misc/lib/math_ml/util.rb

misc/plugin/
misc/plugin/x-html_anchor.rb
misc/plugin/x-math.rb
misc/plugin/ja/
misc/plugin/ja/x-math.rb
misc/plugin/en/
misc/plugin/en/x-math.rb

設定なしでいきなり使う場合は、プラグインファイルを\${hiki}/plugin 以下に入れても構いません。ただし、Firefoxで閲覧した場合は最初からXHTMLモードで動いてしまうので、他のプラグインとの兼ね合いで不正なXHTML要素を出力してしまい、XHTML化キット導入以前に作成したページを表示できなくなる場合があります。

!!スタイルファイルのインストールと設定
!!!スタイルファイルのインストール
プラグインをインストールするだけでもWikiページ中に数式を書き込むことは出来ますが、\$...\$記法と\\[...\\]記法を使うためにはスタイルファイルもインストールする必要があります。

ディレクトリ x-hiki-0.21.x/mathwiki/ を \${hiki}/style へコピーしてください。

コピー後は、既存のディレクトリも含めて以下のようになります。
\${hiki}/style/default
\${hiki}/style/math
\${hiki}/style/mathwiki
\${hiki}/style/mathwiki.st
\${hiki}/style/rd+

!!!XHTML化キットプラグインを有効にする
XHTML化キットを \${hiki}/misc/plugin にインストールした場合は、設定画面で'''x-mathを有効にしてください'''。

!!!キャッシュを削除する
キャッシュディレクトリに以前のスタイルのキャッシュが残っていると正常に動作しないため、キャッシュディレクトリを削除します。
(Hikiの自分のサイトのデータディレクトリに移動)
\$ cd hikidata
(キャッシュディレクトリを削除)
\$ rm -rf cache

!!!スタイルを有効にする
スタイル名を \${hiki}/hikiconf.rb の中で以下のように指定します。
#@style           = 'default'
@style = 'mathwiki' # この行を追加する

!トラックバック
{{trackback}}

* trackback : [[Hiki XHTML化キット0.21.3を公開しました (忘れたときに備えた記録)|http://www.hinet.mydns.jp/tdiary/?date=20080112#p03]] (2008-01-12 (Sat) 16:46:19)
""0.21.3への更新情報

* trackback : [[Hiki XHTML化キット0.21.2を公開しました (忘れたときに備えた記録)|http://www.hinet.mydns.jp/tdiary/?date=20080111#p01]] (2008-01-11 (Fri) 16:24:18)
""0.21.2 への更新情報

* trackback : [[ (忘れたときに備えた記録)|http://www.hinet.mydns.jp/tdiary/?date=20080110#p02]] (2008-01-10 (Thr) 12:43:04)
""0.21.1 への更新情報

* trackback : [[[更新] MathMLライブラリ、Hiki&tDiary XHTML化キット 更新のお知らせ (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20070522.html]] (2007-05-22 (Tue) 17:00:00)
""0.20a への更新情報

* trackback : [[[更新] Hiki XHTML化キット 0.20を公開 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20070509.html]] (2007-05-06 (Sun) 22:27:00)
""0.20への更新情報

* trackback : [[[更新] Hiki XHTML化キット 0.19aを公開 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20060831.html]] (2006-08-30 (Wed) 22:29:15)
""0.19aへの更新情報

* trackback : [[[更新] Hiki XHTML化キット 0.19を公開 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20060824.html]] (2006-08-23 (Wed) 16:05:41)
""バージョン 0.19 への更新情報

* trackback : [[[更新] Hiki XHTML化キット 0.18を公開 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20060714.html]] (2006-07-12 (Wed) 15:13:58)
""0.18 への更新情報

* trackback : [[[更新] Hiki XHTML化キット 0.17を公開 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20060519.html]] (2006-05-17 (Wed) 13:43:05)
""0.17への更新情報

* trackback : [[更新 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20060203.html#p03]] (2006-02-02 (Thr) 16:32:13)
""0.16への更新情報

* trackback : [[MathMLライブラリの更新 (ひらくの工房)|http://www.hinet.mydns.jp/~hiraku/20051231.html#p03]] (2005-12-30 (Fri) 03:42:22)
""0.15更新情報

* trackback : [[ひらくの工房|http://www.hinet.mydns.jp/~hiraku/20051030.html]] (2005-10-30 (Sun) 16:30:16)
""0.14に更新