mimetex.inc.php

Top > Plugin > mimetex.inc.php
First Edition. 06/08/2006
Last Modified. 01/03/2007

Display Math Equations using mimetex.cgi

Table of Contents

Abstract

This plugin shows images of TeX style math equation using mimetex. In principal, this just returns img tag which calls mimetex.cgi, but this has a cache functionality also.

Please see original site mimetex.html about what you can do with mimetex.

How to use and examples

&mimetex( \sqrt{x^2+y^2} = z );

\sqrt{x^2+y^2} = z

#mimetex( \sqrt{x^2+y^2} = z )

In block type, it centerizes automatically.

\sqrt{x^2+y^2} = z

You can use multiline block plugin style, too.

#mimetex(){{
e^{i \theta} = \cos \theta + i \, \sin \theta\\
e^{\pi i} + 1 = 0
}}
e^{i \theta} = \cos \theta + i \, \sin \theta\\e^{\pi i} + 1 = 0

設定

Installation of mimetex

I will omit. Please refer the mimetex original site, http://www.forkosh.com/mimetex.html.

PukiWiki 設定

プラグインで複数行引数を使えるようにしておきます。PukiWiki を 1.4.6 以上にアップデートしてください。

pukiwiki.ini.php

-define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 1); // 1 = Disabled
+define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 0); // 1 = Disabled

Plugin Configuration

Open mimetex.inc.php and modify.

defined('MIMETEX_PATH') or define('MIMETEX_PATH', 'http://www.forkosh.dreamhost.com/cgi-bin/mimetex.cgi');
defined('MIMETEX_CACHE') or define('MIMETEX_CACHE', 1); // 1: Use Cache Function
defined('MIMETEX_CACHE_DIR') or define('MIMETEX_CACHE_DIR',  CACHE_DIR);
defined('MIMETEX_CACHE_URI') or define('MIMETEX_CACHE_URI',  CACHE_DIR);
defined('MIMETEX_CACHE_POSTFIX') or define('MIMETEX_CACHE_POSTFIX',  '.mimetex.gif');

MIMETEX_PATH is the url of mimetex.cgi. The original site is preparing http://www.forkosh.com/mimetex.cgi for testing purpose, so this plugin will use it on default settings. Change this url after installing mimetex.cgi on your server.

ヒント:設定を別ファイルに分離しておけます。プラグインアップデートの際に楽です。 plugin ディレクトリなどと同階層に init ディレクトリを作成、そのディレクトリに以下のファイルを保存し、編集してください。(Pukiwiki Plus! i18n の場合は init ディレクトリがデフォルトで存在するはずです。)

mimetex.ini.php

Access to cache image

This plugin uses cache functionality as default. Cache images are stored in cache directory as cache/md5(mathequation).mimetex.gif.

Please modify cache/.htaccess to enable to access the cache files via http. It is not necessary in the case of pukiwiki plus because this is the default setting.

Order allow,deny
Deny from all

<Files ~ "\.(gif|jpg|png)$">
	Allow from all
</Files>

FAQ

$ $ で数式を書きたい

Hack/convwiki_rules を適用し、rules.ini.php に

$convwiki_rules = array(
	'^\$\$ (.+) \$\$$'	=> '#mimetex($1)',
	'\$ ([^$]+) \$'		=> '&mimetex($1);',
);

のように追加します。これで

$$ x $$
this is $ a $ pen. 

のように記述することで

#mimetex(x)
this is &mimetex(a); pen.

と記述するのと同じことになります。

この設定例では

$ x $

のように $ の間に空白がないと発動しないようになっています。$hoge = $hoge + 1; のような文章では発動しないようにするためです。

ただし本体改造になりますので、PukiWiki のアップデートの際に面倒くさくなるかもしれないことは覚悟してください。

Download

Save from right-click, and put into plugin directory.

mimetex.inc.php

What's new viewcvs

Compatibility Check

Please join us to check compatibilities.

Compatible

Selection Vote
PHP4 12
PHP5 17
1.3.7 1
1.4.3 3
1.4.4 1
1.4.5_1 2
1.4.6 3
1.4.7 20
1.4.5plus-eucjp 0
1.4.6plus-u1-eucjp 0
1.4.6plus-u2-eucjp 1
1.4.5plus-u2-i18n 0
1.4.6plus-u1-i18n 0
1.4.6plus-u2-i18n 1
1.4.7plus-i18n 4
1.4.7plus-u2-i18n 1

Incompatible

Selection Vote
PHP4 0
PHP5 0
1.3.7 0
1.4.3 1
1.4.4 0
1.4.5_1 0
1.4.6 0
1.4.7 1
1.4.5plus-eucjp 0
1.4.6plus-u1-eucjp 0
1.4.6plus-u2-eucjp 0
1.4.5plus-u2-i18n 0
1.4.6plus-u1-i18n 0
1.4.6plus-u2-i18n 0
1.4.7plus-i18n 0
1.4.7plus-u2-i18n 0

技術的詳細

Rivals

References