====== Dokuwiki ======

dokuwikiはphpで作られているwikiシステム．
記法自体は独自のものを使っている．
(設定次第でgithub flavor markdownなどにも変更は可能であるが．)

ブログや他のwikiと比べて以下のようなメリットがある
  * メディアファイルの管理などが非常に楽であるので使いやすい．
  * ''bitname/dokuwiki''というDockerイメージが配布されていて利用しやすい．
  * wikiは常に未完成であるので完成させるのが苦手な人にとって書くことの抵抗が少ない．

===== インストール後，最初にやること =====
  * ログイン
  * 日本語化 ''admin > Configuration Settings''
  * サイドバーを作る．次のページを作る． '':sidebar''
  * 受付可能なMIME typeを変更
  * 拡張機能 ''mathjax''をインストール．
  * [[https://dokuwiki.oreda.net/page/html.html|HTML有効化]]

===== Dokuwikiでの特別なページ =====
^ 名前空間 ^ 説明 ^
| '':sidebar'' | サイドバー |
| '':start'' | トップページ |
| '':**:start'' | 各階層のホームページ(index.html的存在) |

===== ディレクトリ構成 =====
<code>
- dokuwiki/
    - bin/
    - conf/
        - userstyle.css  : wikiのスタイルを変更する場合はここを書き換える
    - data/              : wikiの内容
        - pages/         : ページの内容
        - media/         : メディアファイルの内容
    - inc/
    - lib/
        - styles/
        - tpl/           : テンプレートなどが入っている
            - dokuwiki/  : デフォルトで使用されているテンプレート
    - vendor/
</code>

^ 略称 ^ 正式名称 ^
| tpl  | template      |
| bin  | binary        |
| lib  | library       |
| conf | configuration |
| inc  | includes      |

===== 情報 =====
  * [[https://www.dokuwiki.org/ja:acl|アクセス制御について]]
  * [[https://www.dokuwiki.org/ja:devel:css|スタイルシート，デザインについて]]


===== テンプレートについて =====
有志によって作られたテンプレートによって
サイトデザインを変更できる．
インストールしたテンプレートは''/lib/tpl''に保存される．
最初はデフォルトテンプレート''/lib/tpl/dokuwiki''が使われている．
[[https://dokuwiki.biz/template/point|ここ]]が詳しい．

===== faviconやサイトロゴ =====
メディアファイルから設定する場合は，
ルート'':''もしくは'':wiki:''の中にサイトロゴ''logo.png''，
ファビコン''favicon.ico''，
ブックマークアイコン''apple-touch-icon.png''を入れる．
'':wiki:''に入れるほうが望ましいと思う．

テンプレートに入れて設定する方法もあるが非推奨であるとおもう．
<del>
テンプレートで指定する場合は，
''lib/tpl/dokuwiki/images/''以下にlogo.png，favicon.ico，apple-touch-icon.pngを入れる．
</del>


===== 参考にできそうなDokuwikiサイト =====
  * [[https://jyutaku-reform.co.jp/akiya/doku.php?id=start|1]]
  * [[https://dokuwiki.biz/start|2]]

===== syntax =====
ハマったところ．
  * monospace(インラインコード''これ'')にダブルアンダースコア''%%__%%''を入れたいときはダブルアンダースコアをダブルパーセント''%%''で囲む．

===== 名前空間の変更 =====
[[https://dokuwiki.oreda.net/page/delete.html]]

===== バックアップ・移行 =====

  * Dokuwikiは実はデータベース不要でファイルだけでの管理をしているらしい．[[https://itlogs.net/dokuwiki-backup/]]
  *