wpmathpub readme 日本語訳

投稿記事およびコメントで数式を表示するプラグイン。
わーどぷれすっ！で紹介されていたもの。ドキュメントを日本語化した。

=== wpmathpub ===
Contributors: ronf
Donate link: http://www.embeddedcomponents.com/blogs/wordpress/wpmathpub/
Tags: axiom, equation, math, mathematics, MathML, LaTeX, symbol, arrow, set, root, limit, operator, delimiter, matrix, constructor, sum, integral, derivative, calculus, phpmathpublisher, wpmathpub, plugin, formatting, Post, comments, images
Requires at least: 1.5
Tested up to: 2.6.2
Stable tag: 1.0.7

== 概要 ==

投稿記事およびコメントで数式を表示する。

テキスト形式の mathmatical expressions を、[pmath size=xx]…[/pmath] タグの間に挿入する。size 属性(オプション)は、表示される画像の大きさを制御する。 有効な数値は、8から24である。(訳注:ソースを読むと10から24？)属性を省略した場合のデフォルト値は12。 Pascal Brachet 氏の PHP Math Publisher ライブラリ を同梱する。

== インストール ==

  1. `/wp-content/plugins/` ディレクトリに解凍する。アップロードするときは最上位フォルダにwpmathpub をアップロードすること。
  2. 新しくインストールした ./wpmathpub/phpmathpublisher/img ディレクトリを、サーバーが読み書き可能にすること。(詳細はFAQ参照)
  3. WordPress 管理画面の ‘プラグイン’ メニューでプラグインの有効化を行う。

== FAQ(よくある質問) ==

= wpmathpub のテキストからイメージへの変換を試すことができますか？ =

wpmathpub は Pascal Brachet 氏作成の phpmathpublisher ライブラリに依存しています。

phpmathpublisher の動作例は [demo and test](See “click here to go to Pascal’s phpmathpubisher demo page and test page”) で見ることができます。

注： wpmathpub WordPress プラグインは、記事およびコメントで数式を記述するのに [pmath]your math text[/pmath] を利用します。Pascal 氏のデモでは、 <m>your math text</m> を利用します。

= [pmath] タグが動作しないようです。どうすれば良いでしょうか？ =

バージョン 1.0.7 以降では、管理者の「管理」メニューで wpmathpub plugin status が表示されます。詳細は(スクリーンショットタブの)スクリーンショット#5を参照してください。以下の情報が表示されます。

  • 必要なディレクトリに正しくアクセスできるか確かめる
  • 必要なライブラリが利用可能か判定する
  • テキストから画像への変換例を表示する

= wpmathpub プラグインと他のプラグインは干渉しますか？ =

バージョン 1.0.7 以降では、優先度を高めることにより、高帯域動画配信プラグインと共存しやすくなっています。

現時点では、Live Comment Preview というプラグインが、コメントの数式画像表示を破壊することが判明しています。投稿記事には影響しません。このプラグインは、開始タグ [pmath] と終了タグ [/pmath] の対応を破壊します。

プラグインが干渉している可能性がある場合の簡単なテスト方法は、wpmathpub を除くすべてのプラグインを無効化することです。他のプラグイン無しで wpmathpub が動作する場合は、プラグインを1つずつ有効にしていくことで、どのプラグインが [pmath] タグと干渉するかを知ることができます。もしそのような場合は、作者まで連絡してください。解決策が見つかるかもしれません。

= インストール中に ‘img’ ディレクトリに書き込み権限があることを確認できますか？ =

数式テキストから数式画像を生成するには、’img’ ディレクトリに書き込み権限が必要です。wpmathpub プラグインは、バージョン 1.0.5 以降では、 Linux/Unix 上へのインストール時に、’img’ ディレクトリに適切なアクセス権を自動的に付与します。自動付与機能は、wpmathpub.php の55行目を下のように変更すると無効化されます。


define("AUTOCHMOD", false);

手作業で ‘img’ ディレクトリに移動し、書き込み権限を与え、変更されたことを確かめる bash シェルセッションの例を以下に示します。


-bash-3.00$ cd wp-content
-bash-3.00$ cd plugins
-bash-3.00$ cd wpmathpub
-bash-3.00$ cd phpmathpublisher
-bash-3.00$ chmod 755 img
-bash-3.00$ stat -c %a img
755
-bash-3.00$ stat -c %A img
drwxr-xr-x

= コメント部で [pmath] タグを無効にする方法は？ =

デフォルトでは、wpmathpub プラグインは、訪問者がコメントで数式を生成するのをサポートしています。バージョン 1.0.6 以降では、コメントでの [pmath] タグは、wpmathpub.php の58行目を下のように変更すると無効化されます。


define("ENGAGECOMMENTS", false);

この設定は、投稿記事およびページでの数式表示には影響しません。

= “&gt;”(“>” を表示) のような HTML エンティティを数式で用いることはできますか？ =

wpmathpub バージョン 1.0.5 以降で HTML エンティティがサポートされています。

= 投稿記事とコメントで pmath タグを使用することができますか？ =

wpmathpub バージョン 1.0.5 以降で 投稿記事とコメントで pmath タグをサポートしています。

= 上記に無い質問があります。 =

WordPress wpmathpub サポートページで質問することができます。[WordPress wpmathpub Support Page]

== スクリーンショット ==

  1. [pmath] タグとテキストからなる WordPress 投稿記事
  2. [pmath] タグとテキストからなる WordPress コメント (WP 2.5.1 の管理パネル詳細)
  3. アップロードして有効化した後の WordPress プラグイン管理画面
  4. WordPress 内の当プラグインのディレクトリ構造の例
  5. 著者のブログの管理 > wpmathpub メニューで表されるステータス

== 使い方 ==

ブログのコンテンツ内で数式モードにするには、[pmath size=xx]…[/pmath] タグを使用します。your math text commandを、以下のような HTML 画像タグに自動的に変換します。

<img src="MathFileName.png" style="vertical-align:-xxpx; display: inline-block ;" alt="your math t