使用法
| Table of Contents |
インストール
ここでは仮に
http://www.example.com/pukiwiki-static/
というアドレスで運用するものとし、サーバ上でのローカルパスは
$HOME/public_html/pukiwiki-static/
であるものとします。$HOME/public_html/ が DOCUMENT_ROOT であるものとします。
アーカイブファイルをダウンロードし、サーバ上で上記のパスとなるように展開します。
$ cd $HOME/public_html/ $ unzip pukiwiki-static.zip pukiwiki-static/ pukiwiki-static/index.php pukiwiki-static/pukiwki/ pukiwiki-static/pukiwiki/ぷきうぃきファイル群
まず、従来の PukiWiki Plus! のインストールと同様に PukiWiki Plus! ファイル群の設定を行います。
ディレクトリ、ファイルのパーミッション設定、管理者パスワードの設定等を行っておきます。
plus:Documents/Install
のページを参照してください。
次に、pukiwiki-static ディレクトリに書き込み許可を出します。pukiwiki-static ディレクトリに html ファイルが作成されるためです。
$ chmod 777 pukiwiki-static
設定は以上です。 設置サイトにアクセスし、正常に動作することを確認してください。 特にページ間リンクが正常に動作していることを確認します。
正しくダンプが行われることを確認します。
index.php?cmd=statichtml
にアクセスしダンプしてください。 また、ページを編集、保存すると HTML ファイルが更新されていることを確認してください。
ディレクトリ名を pukiwiki-static から変更する場合以下の修正を行います。 pukiwiki-static/.htaccess ファイルを開き、
## RewriteMap
RewriteEngine On
RewriteBase /pukiwiki-static
RewriteCond %{REQUEST_URI} =/pukiwiki-static/
RewriteCond %{QUERY_STRING} =''
RewriteCond %{REQUEST_FILENAME}/index.html -f
RewriteRule .* index.html [QSA,L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.+)\.html$ index.php?cmd=rewritemap&page=$1 [QSA,L]
RewriteBase とその次の RewriteCond の値を変更します。 RewriteBase に設置ディレクトリ名をドキュメントルートからの絶対パスで指定します。 RewriteCond に設置ディレクトリ名をドキュメントルートから絶対 URI で指定します。最後の / に気をつけてください。
pukiwiki-static/index.php ファイルを開き
define('ROOT_URI', '/pukiwiki-static/pukiwiki/');
の値を変更します。skin, image ディレクトリへの接頭辞となる URI を絶対 URI で指定します（http 始まりでも可）。
独自設定する際の詳細情報は、以下を参照してください。
- statichtml.inc.php -- RewriteMap を使用することを前提とした dump2html 軽量版
- RewriteMap - 静的ページ風 URL に偽装
FAQ
HTML ファイルが作成されない
xrea.com のいくつかのサーバーなど SAFE_MODE が有効になっているレンタルサーバーではファイル（ディレクトリ）が正常に作成できない場合があります。 mkdir.cgi を作成し、梱包しましたのでそれを使用することで回避できます*1。
1. mkdir.cgi を編集、パスワードを設定。mkdir.cgi に実行権限を付与 (755)
-$GLOBALS['password'] = md5('');
+$GLOBALS['password'] = 'md5変換されたパスワード文字列';
2. 起動確認。
http://..../mkdir.cgi
にアクセスし、エラーがでないか確認する。php へのパスは
#!/usr/local/bin/php
が指定してあるが、異なる場合変更する（正しいパスは各レンタルサーバーのドキュメントで調べてください）
3. pukiwiki/init/statichtml.ini.php 中の以下の部分のコメントをはずし有効化
$topurl = get_script_uri();
if (($pos = strrpos($topurl, '/')) !== FALSE) {
$topurl = substr($topurl, 0, $pos + 1);
}
$GLOBALS['PLUGIN_STATICHTML_MKDIR_CGI'] = $topurl . '/mkdir.cgi?password=' . md5('');
この時、さきほど設定したパスワードを md5('') の部分に同様に設定。
HTMLファイル名を短くしたい
日本語をページ名に使用すると長く、読解不能な HTML ファイル名にエンコードされます。
できるだけページ名にはアルファベットを、スペースも使用せずに _ （アンダースコア）を使用してみてください。 通常の HTML ファイルに名前を付ける要領です。
その時、タイトル表示に日本語を使用したい場合、PukiWiki Plus! には TITLE: コマンドがあるので、それを使用してみてください。
TITLE: PukiWiki 静的HTML変換版
のようにページのどこかに記述しておくと、ページ名とは別にタイトルを変更できます。
