PukiWiki における見出しブロック指向編集のためのパッチ。概要paraedit.inc.php と類似の機能である fixed_heading_anchor_edit の有効化パッチ。 1.4.7_notb 対応版です。 詳細paraedit.inc.php は PukiWiki でパラグラフ指向、 正確には見出しブロック単位での編集を有効にするパッチです。 類似機能の本体への取り込み作業が fixed_heading_anchor_edit というキーワードで 1.4.5 近辺で行われていたようですが、現在、進行が保留となっているようです。 このパッチは PukiWiki_1.4.7_notb に実装されかけている、 fixed_heading_anchor_edit をとりあえず動作させるもので、 PukiWiki-dev official site にある para_edit.diff を、オフィシャルリリース最新の 1.4.7_notb に対応させたものです。(製造物というのはちょっとおこがましい気もしますが、配布管理、パッケージング、テスト、ドキュメンテーションなど、手間はそれなりにかけています。) 知る限り、および、コードを読んでざっと試験した限り、実用上の深刻な問題はありません。 なお、これらブロック単位での編集機能は 3-6 年ほど前に活発に議論されていたりしたようですが、 最近はあまり動きが無いようです。興味があれば、後述する関連 URL で本家の議論などを漁ってみてください。 主な仕様まず、patch コマンドを利用してパッチを当てるか、ファイルをパッチ済みのを置き換えます。 パッチ適用後 pukiwiki.ini.php 中の $fixed_heading_anchor_edit を 1 (デフォルト)にすることで、 見出しの右上に鉛筆アイコンが現れます。これをクリックすることで、その見出し部分のみの編集が可能となります。 追加の仕様(多分?)ベースとした para_edit.diff に、以下の仕様を追加しました。
パッチによって編集されるファイル
パッチのあてかたパッチファイルを利用する場合pukiwiki-1.4.7_notb_paraedit_enable_diff_...txt を取得。(既存の環境で無いならば)pukiwiki を展開 $ tar zxvf pukiwiki-1.4.7_notb.tar.gz パッチあて $ cd pukiwiki-1.4.7_notb $ patch -p0 < pukiwiki-1.4.7_notb_paraedit_enable_diff_...txt パッチ済みファイルを利用する場合pukiwiki-1.4.7_notb_paraedit_enable_diff_...zip を取得。 $ zip pukiwiki-1.4.7_notb_paraedit_enable_diff_...zip で展開。ツリー状に展開されたファイルをそれぞれの場所に上書きし、 pukiwiki.ini.php の任意の場所に、 $fixed_heading_anchor_edit = 1 を追加。 なお、pukiwiki.ini.php も同梱されているが、 変更箇所は上記の一点のみなので上書きせずに手動編集することを推奨。 既知の問題点同一の anchor を持つ見出しがあると、先頭のものが選択されてしまいます。 * 見出し1 [#anchor1] hogefuga * 見出し2 [#anchor1] hogefuga * 見出し3 [#anchor1] hogefuga この場合に、見出し2の鉛筆アイコンをクリックしても、 見出し1が編集対象として選択されます。 見出し1が編集された場合に見出し2、見出し3が削除されるようなことは無いですが、 この一見不可思議で不便な挙動をとめるには、ソース中のアンカーを削除、 または手動変更するなど、運用で対処する必要があります。 配布ポイントhttp://infobsession.net/wiki/index.php?PukiWiki%2F%C0%BD%C2%A4%CA%AA%2FParaEdit 関連 URL質問などはこちらへ (下記の参考 URL に質問されても多分私は気がつきません。) 参考URL
謝辞および周知非常に便利なこのパッチ、 para_edit.diff を作成してくださった方、および、PukiWiki Developer Team の皆様に感謝します。 私の作業は、pukiwiki-1.4.7_notb への para_edit.diff のアダプテーション、追加のドキュメンテーション、 および、配布用パッケージングがほとんどです。(これはこれで結構面倒ですけれど。) ライセンスおよび免責 / License and Disclaimer of liabilityCopyright: Related to enabling fixed_heading_anchor_edit; ryu1k ( ryu1kkb_ATMARK_gmail_DOT_com ) 厳密には GPLv2 原文を参照していただく必要がありますが、要は GPL v2 またはそれ以降です ( 参考日本語訳 ) 。 なお、詳細は GPL v2 にも含まれますが、このパッチを利用することにおいて、提供者は何ら保障・義務を提供しません。 |