wiki 編集者向け
これは wiki の編集権限を持っている人向けのページです。
wiki ページを編集する際に気をつけるべき点や編集のやり方について書いてあります。
編集時の注意点
wiki を編集する場合、以下の点に注意してください。
1. 命名規則を意識してください。
新規ページを作成する場合やページを移動する場合、必ず命名規則を意識するようにしてください。
特に気をつけるべき点は以下です。
- どこの名前空間に属すか。
- ページ名はアルファベットとアンダースコアのみで構成されているか。
- ページ名はスネークケースになっているか。
- そもそも新規ページを作るべきか。
名前空間は wiki のページ構造において非常に重要です。(SEE: 名前空間について)
名前空間がページ URL やカテゴリ分けにそのまま使われます。
そのためページを作成する場合には、どの名前空間に所属すべきなのかをよく検討してください。
現在の名前空間については、サイトマップを参照してください。
ページ名は必ずアルファベットとアンダースコアのみで構成してください。
また、分かりやすいページ名をつけるようにしてください。
例えば、このページであれば wiki:editor
という非常にシンプルなページ名がつけられています。
ページ名は必ずスネークケースにしてください。(SEE: スネークケースについて)
例えば、 wiki:this_is_page
といった具合です。
そもそも新規ページを作るべきか検討してください。
すでに類似するページがある場合、そのページに追記するだけで良いことがあります。
また、新規ページの情報量が少ない場合も、既存のページに追記だけで良いことがあります。
必ずしもページを作ることが優れた選択肢ではありません。
分かりやすくする時にのみページが作られるべきです。
2. 編集合戦を避けてください。
wiki の性質上、誰でも編集が可能となっています。
そのため納得がいかない編集がされることがあるでしょう。
その時、すぐに自分にとって納得がいように再編集するのはよくありません。
必ず、編集する前にいつ・誰が・なぜ編集したのかを確認してみてください。
編集履歴にはなぜ編集されたのかが記載されている可能性があります。
それでもなお編集したい場合、注意深く編集するか、編集した相手に連絡を取るなどして編集合戦にならないようにしてください。
3. 判断に悩む事項は相談する。
自分で判断できないことや判断に悩むことがあれば、他の wiki 編集者に相談してください。
wiki の編集自由度は非常に高いため、一人の判断ミスが全体に大きな影響を与えることがあります。
それの大きな影響には取り返しがつかないことも含まれます。
wiki を作っているのは自分だけではないはずなので、必要に応じて相談してください。
相談先は Discord が最適です。
相談するほどのことでもないが悩んでいると感じる場合は、Wikipedia のガイドラインを参照してみることをおすすめします。Wikipedia 独自のルールや仕組みについての話もありますが、概ね一般的な wiki に当てはまるルールが書いてあるため、この通りに判断できれば大きな判断ミスには繋がらないはずです。
新規ページの作成について
新規ページを作成する場合は、ウェブサイト右上の検索ボックスに命名規則に沿った名前空間を入力してください。
例えば user:snake
と検索することで、ページを作成するかどうかの案内文が表示されます。
ページ名について
ページ名は、一番最初に書かれた見出しが反映されます。
内容がひと目でわかるような見出しをつけてください。
例えば、このページであれば wiki 編集者向け
が最初の見出し & ページ名となっています。
ページの削除について
ページの編集から白紙化することで削除が可能です。
ただし、ページが不要であるかの判断は非常に難しいことがあるので、必要に応じて相談してください。
ユーザページについて
必要であれば、自分用のページを作ることができます。
ユーザページは名前空間 name
配下に作成してください。
例えば、snake のユーザページであれば user:snake
となります。
user:snake:profile
のように配下に更にページを作ることも可能です。
ユーザページ配下の管理は、各人におまかせします。
原則として wiki 全体の細かな編集ルールなどは適用されません。
画像の削除について
画像の削除は wiki 管理者のみが可能となっています。
削除が必要な場合は、wiki 管理者に連絡してください。
名前空間の変更、ページ移動について
個別に対応してもらっても構いませんが、大規模な変更をする場合は wiki 管理者に連絡してください。
記法について
この wiki は DokuWiki と呼ばれるソフトウェアで作られています。
そのため記述には DokuWiki 独自の記法を理解する必要があります。
基本的な書き方については Formatting Syntax を参照してください。
あるいは、DokuWiki 公式ドキュメントを参照しても良いです。
このウェブサイト独自の機能や書き方も少なからず存在していますので、このウェブサイト上の Formatting Syntax は参照することをおすすめします。
記法について勉強したい場合は、ユーザページか、PlayGround を実際に編集してみてください。
これらの名前空間については自由に編集して問題ありません。
重要なことが書かれていないことが保証されているので、他人の記述について気にする必要もありません。
参考になるウェブサイト
以下は wiki 執筆に参考になりそなウェブサイトです。
いずれも DokuWiki で作られているため、各ウェブサイト上からソースを参照することで、どのような記述で作られているかが確認できます。
ソースを確認するには URL の最後に ?do=edit
をつけてみてください。
-
- 公式なので基本的な情報が揃っている。日本語訳有り。
-
- 他の Minecraft サーバさん。国内の DokuWiki サイトの中でもトップクラスの完成度をしている。wiki の用途も似通っているので、参考になるところが多い。
-
- 国内向けに DokuWiki に関する情報を発信してくれているウェブサイト。
-
- プログラミング言語 PHP の公式ドキュメント。世界トップクラスの規模感の DokuWiki サイト。
-
- この wiki と非常に似通った設定になっている。実際にこのサイトに入れる前のテストをやっていたりするので、内容というよりサイトデザイン的なところで参考になるかもしれない。