Pukiwiki 1.5.4も無理やりMarkdown記法とPukiwiki記法に両対応させた
以前にPukiwiki 1.5.3も無理やりMarkdown記法とPukiwiki記法に両対応させたという記事を公開していました。今回はそのPukiwiki 1.5.4版です。
Pukiwiki ではどうしても書き方が馴染めないと言う人が少なくない上にMarkdownエディターはいろいろな優れたアプリがどんどん増えていて自分に合った使いやすいものがかなり選べる状態になっています。その考えからPukiwiki 1.5.3を無理やりMarkdown記法とPukiwiki記法の両方に対応させたものが前回の記事のものになります。
スクリーンショット
画面はPukiwiki 1.5.3のものですが、ほとんど見た目は変わりません。
従来のPukiwikiとの違い
- Pukiwiki 1.5.4がベースになっているので、PHP 8.0やPHP 8.1に対応しているほか、s.inc.phpなども組み込みやすくなっています。
- ページ毎にPukiwiki記法かMarkdown記法を選択可能になっています。
- 編集画面のチェックボックスでどちらの記法を使うかを選べます。
- 新規ページの初期設定はMarkdownに設定しています（変更可能です）。これまでに書いたページはPukiwiki記法で残しつつ、今後のページはMarkdown記法で書き足してゆくということもできます。
- Markdown記法を使っているときでもプラグインが使用可能です。
- ブロックプラグインでは #plugin の代わりに !plugin の表記を用います。
- リンクはPukiwiki記法（[[リンク>URL]]）でもMarkdown記法（[リンク](URL)）でも使用可能です。
- Pukiwiki記法の場合はCSSとjavascriptを各1行ずつ読み込むだけで簡単にビジュアルMarkdownエディタ「SimpleMDE」が使用可能で、書いたマークダウン書式はリアルタイムに反映されます。
- 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();
ただし、Pukiwiki 1.5.3版と同様にMarkdown parserに本文を投入する関係で複数行プラグインには未対応です。lib/convert_html.phpの190行目付近や980行目付近にカギがありそうな気はしているのですが・・・。
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に比べてまだ残っている課題の機能
- 複数行プラグインは使用不可：複数行プラグインは現在動作させることができません。
- プラグイン動作確認：プラグインによっては動作確認が不十分なことがあります。
- 画面表示以外に働くプラグイン：#freezeや#relatedのようにページの表記以外に、しかもページ横断的に働く必要があるため、pukiwikiで#freezeと記載したページとmarkdownで!freezeと記載したページが混在する可能性があります。したがってどちらで書いても作動するようにする必要があり、現在まだ解決していません。
ダウンロード
ダウンロードはこちらからどうぞ。従来のPukiwiki 1.5.4を解凍した後に、さらにこのpukiwiki154_mdで重複するファイルを上書きしてください。中に含まれていないファイルはオリジナルのPukiwiki 1.5.4と同様です。
ただし、pukiwiki.ini.phpに上記の設定項目を設置するのを忘れないようにしてください。
ライセンスはGPL2。
動作しないときのチェックリスト
- pukiwiki.ini.phpへの追記設定はできていますか？
- Markdown parser（plugin/vendorフォルダ内）は設置できていますか？
もしうまく動かない時は不具合修正のため、ぜひ問題点をコメント機能でお知らせください。
この記事に対するコメント
このページには、まだコメントはありません。
更新日：2022-04-25 閲覧数：1023 views.