差分

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

--- tips:dokuwiki [2019/02/25 05:52] – yuuho
+++ tips:dokuwiki [2020/02/27 11:01] (現在) – yuuho
@@ 行 1: / 行 1: @@
 ====== 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 | トップページ |
+| '':sidebar'' | サイドバー |
-| :**:home | 各階層のホームページ(index.html的存在) |
+| '':start'' | トップページ |
+| '':**:start'' | 各階層のホームページ(index.html的存在) |
 ===== ディレクトリ構成 =====
@@ 行 11: / 行 29: @@
     - bin/
     - conf/
-        - userstyle.css  : こっちを書き換えるのが良い？
+        - userstyle.css  : wikiのスタイルを変更する場合はここを書き換える
     - data/              : wikiの内容
         - pages/         : ページの内容
@@ 行 17: / 行 35: @@
     - inc/
     - lib/
-        - styles/        : css
+        - styles/
-            - style.css  : 通常のcss
+        - tpl/           : テンプレートなどが入っている
-            - print.css  : 印刷時のcss?
+            - dokuwiki/  : デフォルトで使用されているテンプレート
-            - all.css    : 全てに適用するcss?
-            - feed.css   : ?
-        - tpl/
-            - dokuwiki/
-                - images/
-                    - logo.png    : サイトロゴ
-                    - favicon.ico : ファビコン
     - vendor/
 </code>
-略称
+^ 略称 ^ 正式名称 ^
 | tpl  | template      |
 | bin  | binary        |
@@ 行 43: / 行 54: @@
 ===== テンプレートについて =====
-Dokuwikiのテンプレートは/lib/tplであり，デフォルトテンプレート/lib/tpl/dokuwikiが使われている．
+有志によって作られたテンプレートによって
+サイトデザインを変更できる．
+インストールしたテンプレートは''/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を入れる．
+''lib/tpl/dokuwiki/images/''以下にlogo.png，favicon.ico，apple-touch-icon.pngを入れる．
+</del>
-メディアファイルから設定する場合は，
-ルート : もしくは :wiki: の中にlogo.png，favicon.ico，apple-touch-icon.pngを入れる．
+===== 参考にできそうな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/]]
+  *