yuuho.wiki

カオスの欠片を集めて知恵の泉を作る

ユーザ用ツール

サイト用ツール


tips:dokuwiki

Dokuwiki

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

ブログや他のwikiと比べて以下のようなメリットがある

  • メディアファイルの管理などが非常に楽であるので使いやすい.
  • bitname/dokuwikiというDockerイメージが配布されていて利用しやすい.
  • wikiは常に未完成であるので完成させるのが苦手な人にとって書くことの抵抗が少ない.

インストール後,最初にやること

  • ログイン
  • 日本語化 admin > Configuration Settings
  • サイドバーを作る.次のページを作る. :sidebar
  • 受付可能なMIME typeを変更
  • 拡張機能 mathjaxをインストール.

Dokuwikiでの特別なページ

名前空間 説明
:sidebar サイドバー
:start トップページ
:**:start 各階層のホームページ(index.html的存在)

ディレクトリ構成

- dokuwiki/
    - bin/
    - conf/
        - userstyle.css  : wikiのスタイルを変更する場合はここを書き換える
    - data/              : wikiの内容
        - pages/         : ページの内容
        - media/         : メディアファイルの内容
    - inc/
    - lib/
        - styles/
        - tpl/           : テンプレートなどが入っている
            - dokuwiki/  : デフォルトで使用されているテンプレート
    - vendor/
略称 正式名称
tpl template
bin binary
lib library
conf configuration
inc includes

情報

テンプレートについて

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

faviconやサイトロゴ

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

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

参考にできそうなDokuwikiサイト

syntax

ハマったところ.

  • monospace(インラインコードこれ)にダブルアンダースコア__を入れたいときはダブルアンダースコアをダブルパーセント%%で囲む.

名前空間の変更

バックアップ・移行

tips/dokuwiki.txt · 最終更新: 2020/02/27 11:01 by yuuho