差分

このページの2つのバージョン間の差分を表示します。

--- dokuwikiに関して [2019/05/24 00:03] – [PHP(php-fpm)の設定] araki
+++ dokuwikiに関して [2020/11/25 00:56] (現在) – [Pukiwikiからの移行] araki
@@ 行 1: / 行 1: @@
 ====== DocWikiに関して ======
 ===== 概要 =====
+docwiki はファイルベースの wiki であり、モダンなデザイン((レスポンシブデザインなど))を持っている。
+マークアップは、wikiで多く用いられているmarkdownではないものの、webベースのエディタによる十分なサポートがあるため、特に記述には苦労はしないだろう。
+編集も、見出し単位で行えるので、ページを丸ごと編集していておかしなことになってしまったり、長大なページで、編集したい場所を見つけるのに苦労するなどといったことも起きにくい。
+プラグインによる拡張も行うことができるが、大きなバージョンアップの際には、プラグインの互換性が問題となって、アップデート後にページが表示されないようなことも起こりうる。
+バージョンアップ時にはプラグインの互換性を確認する必要があり、場合によってはプラグインの使用を中止する必要もあるので、過度に依存すると問題となることもあるので、適切に管理する必要がある。
 ===== 導入 =====
 ===== 設定 =====
@@ 行 64: / 行 73: @@
 ==== PHP(php-fpm)の設定 ====
 DocWikiはUTF-8を前提としている。
-特に、編集のためのテキストエリアへのコンテンツの呼出には、''htmlspecialchars()''を利用しており、PHPのデフォルトの文字セットがUTF-8になっていないと、編集が出来なくなってしまう。
+特に、編集のためのテキストエリアへのコンテンツの呼出には、''htmlspecialchars()''を利用しており、PHPのデフォルトの文字セットがUTF-8になっていないと、編集が出来なくなってしまう。((編集画面内の''textarea''が''htmlspeialchars()''によって空欄になってしまう。))
 php-fpmが利用したい文字コードとデフォルトのPHPの文字コードが異なる場合、php-fpmの設定で、この部分を上書きするようにすれば良い。
-例えば、VineLinuxのように ''php.ini''が''default-charset="EUC_JP"''となっている場合には、''/etc/php5/fpm.d/default-pool.con'' の下の方に次の一行を追加してやり、php-fpmを再起動すればよい。
+例えば、VineLinuxのように ''php.ini''が''default-charset="EUC_JP"''となっている場合には、''/etc/php5/fpm.d/default-pool.conf'' の下の方に次の一行を追加してやり、php-fpmを再起動すればよい。
 <code>
@@ 行 84: / 行 93: @@
 以下のプラグインを導入する必要がある。
-  * definitions plugin
+  * definitions plugin((HogFather (51.x)では互換性がなく使用できない。))
-  * indexmenu plugin
+  * indexmenu plugin((HogFather (51.x)では互換性がなく、defer_jsを無効化する必要がある。対応を表明しているが2020-11-25現在未対応。))
   * color plugin
@@ 行 107: / 行 116: @@
 同様に、''-E utf8''はUTF-8化していた場合にのみ用いる。
+==== アップグレード ====
+=== アップグレードプラグイン ===
+=== Hogfather (51.x)へのアップグレード ===
+互換性のないプラグインが原因で、アップグレード後に500エラーを起こす。
+当方で使用していたものとしては foont sizeと description listのプラグインが該当した。
+また、indexmenu は未対応だが、 <code>$conf[defer_js]=0;</code>を conf/local.php に追記してからアップグレードすることで問題を回避できる。
+この設定はHogfatherへアップグレードしたのちは、管理メニューの設定画面からOFFできるようになる。