アドバイスdokuwiki_tips差分この文書の現在のバージョンと選択したバージョンの差分を表示します。DokuWikiは色々な使い方ができるので最適なアドバイスとならないかもしれませんが、私が使っていてこうした方が良いと思った事を書き出しておきます。#​9400d3>​単語そのままが良い</​fc>​です。<​code>​例文:[[日本]]の初代[[内閣総理大臣]]は[[伊藤博文]]である。>​例文:[[日本]]の初代[[内閣総理大臣]]は[[伊藤博文]]である。日本語でのリンクは一部のブラウザやWebサービスでURLエンコード(例:日本→%E6%97%A5%E6%9C%AC)される点は留意しなければなりません。外国人向けの内容でURLが英字しか使えないローカルルールがある場合は、サイト設定で「最初の見出しをページ名とする」を「常に使用する」にして__ファイル名は英語__として__日本語の見出しをページ名__とする方法もあります。編集する人は下記のような意味不明な文書を書かなければならないので大変です。<​code>​例文:[[japan]]の初代[[prime_minister]]は[[hirohumi_ito]]である。各ページの見出しが、japan=日本、prime_minister=内閣総理大臣、hirohumi_ito=伊藤博文、となっていれば表示は。「[[日本]]の初代[[内閣総理大臣]]は[[伊藤博文]]である。#​9400d3>​省略したファイル名にする</​fc>​のが良いです。「DokuWikiのインストール方法」の場合は「dokuwiki_install」などとします。名前空間(ネームスペース)はWindowsのフォルダのような物で、名前空間が違えば同じファイル名が使えたり編集権限を一元管理できるようになります。#​fa8072>​Windowsのフォルダ管理と同じ考え方はNG</​fc>​です。#​ff00ff>​名前空間は<​del>​1つだけのほうが</​del>​(※)少ない方が良い</​fc>​です。(※サーバーの性能にもよりますが1つの名前空間に1万近いページがあるとサイトマップ表示などで速度が低下するので少し分類した方が良いみたいです。理由はウィキの内部リンクにあります。単一の名前空間であれば下記のように書き方で内部リンクできます。例文Good:[[日本]]の初代[[内閣総理大臣]]は[[伊藤博文]]である。名前空間を多用した場合は下記のように書かなければなりません。例文Bad:[[国家:​日本]]の初代[[役職:​内閣総理大臣]]は[[人名:​伊藤博文]]である。一つの名前空間に文書が多くなると目的のファイルを探すのが大変になるのではと思うかもしれませんが、ウィキではファイルが直接見える場面はほとんどありません。「わかりやすいページ名」にし「目次の作成」や「検索用キーワードの登録」など心掛ける事で目的の文書に簡単にたどり着く事ができます。世界最大のインターネット百科事典「Wikipedia」を見ても名前空間はヘルプや公式発表ページなどで一部でしか使われおらずメインの用語辞典では名前空間は使っていません。一つの名前空間で完結する内容で、他の名前空間にリンクしない/​されない時。同名ファイルができやすい状態。#​ff00ff>​文書とは別の名前空間で管理</​fc>​した方が良いです。1つめの理由はメディアマネージャーとアップロード画面のサムネイル(縮小画像)表示です。#​fa8072>​画像が多いと縮小画像であってもダウンロードや表示に時間がかかる</​fc>​ようになります。#​ff00ff>​1つの名前空間に画像は200枚以下</​fc>​になるよう細分化するのが良さそうです。#​fa8072>​アップロードは権限が高い</​fc>​事です。DokuWikiのアクセスコントロールは「読取→編集→(新規)作成→アップロード→削除」の順なのでユーザーにアップロード権限を与えると文書の新規作成もできるようなります。#​ff00ff>​アップロードはアップロード専用の名前空間だけ</​fc>​にする事で文書用の名前空間を守る事ができます。この状態でもアップロード用の名前空間には文書の新規作成ができますが他の文書が無いので発見と削除が容易です。#​fa8072>​メディアファイルは文書からリンクが1つでもあると削除できない</​fc>​仕組みだからです。何らかの理由(部署の統廃合など)で文書を別の名前空間に移動する場合に、自分に編集権限の無い文書からメディアファイルにリンクがあるとファイルを削除できません。#​ff00ff>​メディアファイルは生涯変更しない名前空間で管理</​fc>​した方が良いです。#​ff0000>​ファイル名検索でしかファイルを探せない</​fc>​ので、本稿の管理方法を使っても使わなくても、ファイルが多くなると特定のファイルを見つけ出すのは難しくなります。対策としてはファイル名に検索用のキーワードを入れるか、文書としてファイル名・内容・キーワードなどをリスト化したファイル目録を作成して管理するなど対策が必要です。WordPress等のブログには、トップページやカテゴリページの作成やページ送りや戻りなどページ間のリンクを自動で行ってくれますが、ウィキにはそのような機能が無く内部リンクは自分で作成する必要があります。はじめは面倒に感じますが慣れてしまえば気にならないと思います。足りない機能を補ってくれるプラグインですが、プラグインは開発が止まったりバグで利用できなくなったりDokuWiki本体のバージョンアップの影響で動作しなくなる事がありますので、下記の点の注意してインストールした方が良いです。文書に手を加えない入力支援や管理者専用のプラグインであればアンインストールする事態になってもフロント側のWebサイトには影響が出ません。専用タグなどで文書を加工するタイプで使用範囲が広いと、アンインストールする事態になった時にタグを削除するなどの修正が広範囲に及び修正作業に時間がかかります。使用範囲がトップページやサイドバーなど限られた場所だけであれば修正も簡単に終わります。目安でしかありませんが利用者が多ければバグは不具合の発見が早く、バグ修正が行われてるならDokuWiki本体やPHPのバージョンアップ時でも継続して使える可能性が高いです。本当に必要なプラグインだけ入れるのが良いです。以前のリビジョンバックリンク文書の先頭へ。