Markdown記法とPukiwiki記法に両対応のPukiwiki改造 v0.2
以前にPukiwikiを無理やりMarkdown記法とPukiwiki記法に両対応させたという記事を公開していました。しかし、いくつかの未対応機能がありました。なかなか時間が取れずそのまま放置していましたが、今回、ChatGPT（codex）の力を借りて修正版（v0.2）をリリースいたしました。
前回の記事
Pukiwiki ではどうしても書き方が馴染めないと言う人が少なくない上にMarkdownエディターはいろいろな優れたアプリがどんどん増えていて自分に合った使いやすいものがかなり選べる状態になっています。その考えからPukiwiki 1.5.4を無理やりMarkdown記法とPukiwiki記法の両方に対応させたものが前回の記事のものになります。最低限の機能は実装していましたが、いくつかの部分で未対応の状態を残していました。
前回未対応だった主な機能
- 複数行プラグインが使用できない
- プレビュー画面ではMarkdown記法が反映されない
- プラグインによっては動作確認が不十分なことがある
今回は上記の不具合のうち、複数行プラグインとプレビュー画面での問題を改善したバージョンv0.2を公開します。ベースとなったPukiwikiのバージョンは1.5.4です。
オリジナルのPukiwikiとの違い
- Pukiwiki 1.5.4がベースになっているので、PHP 8.0やPHP 8.1に対応しているほか、s.inc.phpなども組み込みやすくなっています。
- ページ毎にPukiwiki記法かMarkdown記法を選択可能になっています。
- 編集画面のチェックボックスでどちらの記法を使うかを選べます。
- これまでに書いたページはPukiwiki記法で残しつつ、今後のページはMarkdown記法で書き足してゆくということもできます。
- Markdown記法を使っているときでもプラグインが使用可能です。
- ブロックプラグインでは #plugin の代わりに !plugin の表記を用います。
- リンクはPukiwiki記法（[[リンク>URL]]）でもMarkdown記法（[リンク](URL)）でも使用可能です。
- Pukiwiki記法の場合はCSSとjavascriptを各1行ずつ読み込むだけで簡単にビジュアルMarkdownエディタ「SimpleMDE」が使用可能で、書いたマークダウン書式はリアルタイムに反映されます。pukiwiki.ini.phpの設定でビジュアルMarkdownエディタ機能のオンオフが可能です
- Pukiwiki記法で記載しているときは書式は反映されません。
- 不要な場合は下記のpukiwiki.ini.phpで$use_simplemde = 0;を設定してください。
使い方
Markdownパーサーの準備
Markdown記法を使うにはMarkdownパーサーが必要です。今回はerusev/parsedownを利用しました。plugin/vendorフォルダの中にこのパーサーを置いています。Markdownパーサーは他にも幾つかの種類があるので好みのものを使えば良いと思います。下記の記事も参考にしてください。
pukiwiki.ini.phpの準備
今回の改良を有効にするためにpukiwiki.ini.phpに$markdown_safemodeと$use_simplemdeの設定項目が必要です。以下の設定項目をpukiwiki.ini.phpに書き加えてください。
///////////////////////////////////////////////// // Pukiwiki Markdown // https://github.com/m0370/pukiwiki153_md // https://github.com/sparksuite/simplemde-markdown-editor/ $markdown_safemode = 1; // Safemode 1:On, 0:Off $use_simplemde = 1; // simple Markdown editorを使用 1:Enable, 0:Disable
編集画面
チェックボックスでMarkdownにチェックを入れると、Markdown記法で書くことができるようになります。チェックボックスを外していると従来のPukiwiki記法になります。
いずれの記法を選んでいるかは内部的にはテキストファイルに#notemdという偽装プラグインを書くことで区別しています。ページ毎に使い分けが可能になっています。プレビューも可能になっています。
Markdown記法でもプラグインが使用可能
従来のPukiwiki記法ではブロックプラグインを使用する場合は行頭に#（シャープ）の記号を付けていました。しかし、Markdown記法では行頭の#は見出し記号になりますのでプラグインに使用できません。そこで、!を使っています。インラインプラグインは従来通り&plugin();で記載します。
- #plugin
- !plugin
- &plugin();
また、v0.2から複数行プラグインでも動作するようになっているかと思います。細かいテストはできていないので、異常があればコメント欄などでお知らせいただければ幸いです。
Markdown記法が可能になる仕組み
- 本文に#notemdというキーワード（偽装プラグイン）がある場合はMarkdown記法で、ない場合はPukiwiki記法でパースします。このため、convert_html.phpを2つのParser（Pukiwiki用とerusev/Parsedown）を本文中に#notemdが含まれているかどうかで区別しています。
- さらに#notemdそのものを消してしまったり書き間違えたりするリスクを減らすため、編集画面などにはこの#notemdは非表示になるようにconvert_html.phpに改装を行いました。
- 編集画面で#notemdが非表示になるということは、手動で#notemdと書いてMarkdown記法に切り替えることができなくなることでもあるので、lib/file.phpの1093-1105行目付近およびlib/html.phpの409行目付近および430行目付近に手を入れてチェックボックスでMarkdownかどうかを選択できるようにしました。なお、新規ページ作成での初期設定はMarkdownになるようにしました。
- 本文中に#notemdがあるかどうかでMarkdownのチェックボックスのデフォルト値を振り分けるようにしました。これを行うためにlib/file.phpに内部functionとして（#authorプラグインを参考に）remove_notemd、get_notemdなどのfunctionを新設しました。
既存のPukiwikiからの引っ越しも可能
この、ページ毎に従来のPukiwiki記法とMarkdown記法のいずれかを選んで使い分けることができるという方式で何が有利かというと、既存ページのwikiフォルダはそのままに設定ファイルなどを書き換えれば、今まで使っていたPukiwikiがそのままMarkdownも併用できるようになるという点です。全てのページがMarkdownしか使えないのは全ページの書き換えが必要だったので、新規に設置するPukiwikiにはよくても既存の稼働しているPukiwikiからの引っ越しには不向きでした。
今回の改造では、Pukiwiki記法で使用しているページの保存ファイルは手を加えず、一方でMarkdown記法を指定した保存ファイルには #notemd の偽装プラグインを書き込むようにしています。Pukiwiki記法で書いたページのファイルは手を加えていないと言うことは、wikiフォルダをそのまま移植すればこの新しいPukiwiki 1.5.3-mdでも続きを使い続けることができるということを意味します。
必ずバックアップを取ってから引っ越し作業をしてください。データの消失などには責任を負えませんので、ご使用は自己責任で。タイムスタンプを保持したままPukiwikiを丸ごとバックアップする方法についてはこちらのページもご覧ください。
本家のPukiwikiに比べてまだ残っている課題の機能
複数行プラグインは使用不可：複数行プラグインは現在動作させることができません。v2.0で解決！- プラグイン動作確認：プラグインによっては動作確認が不十分なことがあります。
- 画面表示以外に働くプラグイン：#freezeや#relatedのようにページの表記以外に、しかもページ横断的に働く必要があるため、pukiwikiで#freezeと記載したページとmarkdownで!freezeと記載したページが混在する可能性があります。したがってどちらで書いても作動するようにする必要があり、現在まだ解決していません。
ダウンロード
ダウンロードはこちらからどうぞ。
pukiwiki.ini.phpに上記の設定項目を設置するのを忘れないようにしてください。
ライセンスはGPL2。
動作しないときのチェックリスト
- pukiwiki.ini.phpへの追記設定はできていますか？
- Markdown parser（plugin/vendorフォルダ内）は設置できていますか？
もしうまく動かない時は不具合修正のため、ぜひ問題点をコメント機能でお知らせください。
ChatGPT codexについて
実は、このv0.2を作るときはPHPのスクリプトは人間の手では一切打っていません。すべてChatGPT Plusで利用可能なCodexで作成しました。生成AIもここまでできるようになっているんですね。
この記事に対するコメント
このページには、まだコメントはありません。
更新日：2025-07-19 閲覧数：814 views.