====== Dokuwiki Tips ======
===== update 2024-05-07 =====

  * indexmenuのjsが動かない
  * loginしていないときwarnが表示されてる

pluginが悪さしていると思われるので一旦全部外す\\
動いたので、戻していく

^plugin^結果^
|BBCode Plugin|OK|
|Box Plugin|OK|
|EditTable plugin|OK|
|Google Analytics Plugin 1.1.0|?|
|imgpaste plugin|OK|
|Info Plugin |?|
|logviewer plugin |?|
|Open Document Plugin|?|
|Popularity Feedback Plugin|?|
|Revert Manager |?|
|safefnrecode plugin|?|
|styling plugin |?|
|XBR Plugin|OK|
|Embedded PHP Plugin|?|

===== indexmenuのjsが動かない、EditTableが動かない =====

update後に生じたためupdate起因かと思われたがlogには

   client prematurely closed connection while sending to client

が大量に記録されている
一般にはクライアントのネットワーク接続やタイムアウト設定が疑われるがそのあたりではなさそう
で、フロントのリバースProxyをチェックしたところ、一部のアクセスログのnewsyslog設定が漏れているためにdiskfullを起こしていたorz
logの削除、newsyslog設定で治った模様



===== DokuWikiからMarkdownに変換 =====

==== DokuWiki to Markdown Converter ====

https://github.com/ludoza/DokuWiki-to-Markdown-Converter

  $ php convert.php input/myfile.txt


ref: https://dokuwiki.oreda.net/dokuwiki-markdown.html

ref: [[https://dokuwiki.oreda.net/dokuwiki-pukiwiki.html| DokuWikiとPukiWikiの書き方の比較と移行方法]]


===== キャッシュの削除 =====
DokuWikiではページのキャッシュを生成することで速度を上げているが、何かの拍子でキャッシュがおかしくなる事もある

  * DiskFull
  * Update
  * サーバの引っ越し
  * ......

こんな時は、path/to/dokuwiki/data/cache の中をきれいに削除すればOK

//cacherevisionseraseプラグインを使うのもありのはずです......((未使用のため保証しません))//

===== 遅い、遅い、遅い =====

サーバ更新とアップデートを同時に行う…………\\
げろ遅いんですが

はまったアルヨ

indexmenuプラグインをsidebarに仕込んでいたんだが、「%%~~NOCACHE~~%%」と指定していた。\\
今のバージョンだと、これがあるとmenuを全部作り直しに行きやがった。そりは遅い（笑）
===== プラグイン：ファイルをダウンロードできません =====
以下の点をチェックしてみてください
  * permissionをチェック：dokuwikipath/inc/pluginsのWrite権限が必要
  * php-zlibがインストールされていない

**2017.04.20**：ca rootが古い。FreeBSD10.3で発生。標準だと公開証明書がないので以下の手順で入れる。((さんざんはまって、ふと、コマンドラインでfetchしてみたら、「error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify」これで気が付いた))
  $ sudo pkg install ca_root_nss
  or
  $ cd /usr/ports/security/ca_root_nss
  $ sudo make install


===== インデント =====

DokuWikiではインデントはサポートされていないがPlugInなどを使用せずにインデントしたい。 で、こんな感じで逃げる

**テンプレート依存なので注意**

<code>
普通の文章
== ==
インデントされた文章
===== =====
もとに戻る
</code>

実際の表示

----

普通の文章
==  ==
インデントされた文章
=====  =====
もとに戻る

----

うまく動かなくなったので、リストで逃げる
<nowiki>

普通の文章

  * <code>

    インデントされたCode

</code>

もとに戻る

</nowiki> 

普通の文章
  * <code>
    インデントされたCode
</code>

もとに戻る


===== PHP機能がSSLをサポートしていないため、拡張機能のダウンロードが正常に動作しません。 =====

  # pkg install php##-openssl

php.ini

  extension=openssl.so

===== プラグインのインストール失敗 =====

log(/var/log/nginx/........)に以下のエラー

  undefined function splitbrain\PHPArchive\gzopen() 

zlibがなかったorz

  # php -i | grep -i zlib
  ZLib Version => 1.2.8
  gzip compression => disabled (install ext/zlib)

  # pkg install php71-zlib
  # php -i | grep -i zlib
  zlib
  ZLib Support => enabled
  Stream Wrapper => compress.zlib://
  ......

===== url =====
[[https://materializer.co/lab/blog/7|【2018年版】Dokuwikiによるサイト開発で知っていると役立つTips集]]