wiki:editor

差分

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

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
wiki:editor [2024/12/01 02:41] snakewiki:editor [2025/02/11 04:14] (現在) snake
行 1: 行 1:
 ====== wiki 編集者向け ====== ====== wiki 編集者向け ======
  
-このページは wiki 編集権限持っている人向けのページです。+/* 
 +ページが肥大化してきた場合要分割 
 +*/ 
 + 
 +wiki 編集活動ている人向けのページです。
 wiki ページを編集する際に気をつけるべき点や編集のやり方について書いてあります。 wiki ページを編集する際に気をつけるべき点や編集のやり方について書いてあります。
 +
 +<alert type="warning">wiki の編集は誰アカウントを取得し、ログインしてから編集することをおすすめします。
 +アカウントの取得方法は **''[[wiki:editor:join]]''** を参照してください。
 +</alert>
  
 ===== 編集時の注意点 ===== ===== 編集時の注意点 =====
  
-wiki を編集する場合、必ず以下の点に問題がないか確認してください。 +wiki を編集する場合、以下の点に注意してください。
-もし、ここに書いてあることだけでは判断に悩むことがあれば [[https://ja.wikipedia.org/wiki/Wikipedia:%E6%96%B9%E9%87%9D%E3%81%A8%E3%82%AC%E3%82%A4%E3%83%89%E3%83%A9%E3%82%A4%E3%83%B3%E3%81%AE%E4%B8%80%E8%A6%A7|Wikipedia のガイドライン]]を参考にすることをおすすめします+
  
 ==== 1. 命名規則を意識してください。 ==== ==== 1. 命名規則を意識してください。 ====
行 20: 行 27:
  
 名前空間は wiki のページ構造において非常に重要です。(SEE: [[https://www.dokuwiki.org/ja:namespaces|名前空間について]]) 名前空間は wiki のページ構造において非常に重要です。(SEE: [[https://www.dokuwiki.org/ja:namespaces|名前空間について]])
-名前空間がページ URL やカテゴリ分けにそのまま使われるものとなります。+名前空間がページ URL やカテゴリ分けにそのまま使われます。
 そのためページを作成する場合には、どの名前空間に所属すべきなのかをよく検討してください。 そのためページを作成する場合には、どの名前空間に所属すべきなのかをよく検討してください。
 +現在の名前空間については、[[https://wiki.mcplay.biz/?do=index|サイトマップ]]を参照してください。
  
 ページ名は必ずアルファベットとアンダースコアのみで構成してください。 ページ名は必ずアルファベットとアンダースコアのみで構成してください。
-また、明快で分かりやすページ名をつけるようにしてください。 +また、分かりやすページ名をつけるようにしてください。 
-例えば、このページであれば ''wiki:editor:guideline'' という非常にシンプルなページ名がつけられています。+例えば、このページであれば ''wiki:editor'' という非常にシンプルなページ名がつけられています。
  
 ページ名は必ずスネークケースにしてください。(SEE: [[https://ja.wikipedia.org/wiki/%E3%82%B9%E3%83%8D%E3%83%BC%E3%82%AF%E3%82%B1%E3%83%BC%E3%82%B9|スネークケースについて]]) ページ名は必ずスネークケースにしてください。(SEE: [[https://ja.wikipedia.org/wiki/%E3%82%B9%E3%83%8D%E3%83%BC%E3%82%AF%E3%82%B1%E3%83%BC%E3%82%B9|スネークケースについて]])
行 38: 行 46:
 ==== 2. 編集合戦を避けてください。 ==== ==== 2. 編集合戦を避けてください。 ====
  
-wiki の性質上、ページは原則誰でも編集が可能となっています。+wiki の性質上、誰でも編集が可能となっています。
 そのため納得がいかない編集がされることがあるでしょう。 そのため納得がいかない編集がされることがあるでしょう。
-その時、すぐに自分にとって納得がい編集を繰り返行為悪手です。 +その時、すぐに自分にとって納得がいように再編集するのよくありません
-それは相手も同じことを繰り返すことになる可能性がありま+
  
 必ず、編集する前にいつ・誰が・なぜ編集したのかを確認してみてください。 必ず、編集する前にいつ・誰が・なぜ編集したのかを確認してみてください。
 編集履歴にはなぜ編集されたのかが記載されている可能性があります。 編集履歴にはなぜ編集されたのかが記載されている可能性があります。
-それでもなお編集したい場合、注意深く編集するか、編集した相手に連絡を取るなどしてください。+それでもなお編集したい場合、注意深く編集するか、編集した相手に連絡を取るなどして編集合戦にならないようにしてください。
  
 ==== 3. 判断に悩む事項は相談する。 ==== ==== 3. 判断に悩む事項は相談する。 ====
行 54: 行 61:
 wiki を作っているのは自分だけではないはずなので、必要に応じて相談してください。 wiki を作っているのは自分だけではないはずなので、必要に応じて相談してください。
 相談先は [[info:discord]] が最適です。 相談先は [[info:discord]] が最適です。
 +
 +相談するほどのことでもないが悩んでいると感じる場合は、[[https://ja.wikipedia.org/wiki/Wikipedia:%E6%96%B9%E9%87%9D%E3%81%A8%E3%82%AC%E3%82%A4%E3%83%89%E3%83%A9%E3%82%A4%E3%83%B3%E3%81%AE%E4%B8%80%E8%A6%A7|Wikipedia のガイドライン]]を参照してみることをおすすめします。Wikipedia 独自のルールや仕組みについての話もありますが、概ね一般的な wiki に当てはまるルールが書いてあるため、この通りに判断できれば大きな判断ミスには繋がらないはずです。
  
 ===== 新規ページの作成について ===== ===== 新規ページの作成について =====
  
 新規ページを作成する場合は、ウェブサイト右上の検索ボックスに命名規則に沿った名前空間を入力してください。 新規ページを作成する場合は、ウェブサイト右上の検索ボックスに命名規則に沿った名前空間を入力してください。
-例えば ''user:snake'' と検索することで、ページを作成するかどうかの案内文が表示されます。+例えば ''wiki:test'' と検索することで、ページを作成するかどうかの案内文が表示されます。
  
 ===== ページ名について ===== ===== ページ名について =====
行 89: 行 98:
  
 個別に対応してもらっても構いませんが、大規模な変更をする場合は wiki 管理者に連絡してください。 個別に対応してもらっても構いませんが、大規模な変更をする場合は wiki 管理者に連絡してください。
 +
 +===== 記法について =====
 +
 +この wiki は DokuWiki と呼ばれるソフトウェアで作られています。
 +そのため記述には DokuWiki 独自の記法を理解する必要があります。
 +
 +基本的な書き方については [[wiki:syntax]] を参照してください。
 +あるいは、[[https://www.dokuwiki.org/ja:syntax|DokuWiki 公式ドキュメント]]を参照しても良いです。
 +このウェブサイト独自の機能や書き方も少なからず存在していますので、このウェブサイト上の [[wiki:syntax]] は参照することをおすすめします。
 +
 +記法について勉強したい場合は、ユーザページか、[[playground:playground]] を実際に編集してみてください。
 +これらの名前空間については自由に編集して問題ありません。
 +重要なことが書かれていないことが保証されているので、他人の記述について気にする必要もありません。
 +
 +==== 参考になるウェブサイト ====
 +
 +以下は wiki 執筆に参考になりそなウェブサイトです。
 +いずれも DokuWiki で作られているため、各ウェブサイト上からソースを参照することで、どのような記述で作られているかが確認できます。
 +ソースを確認するには URL の最後に ''?do=edit'' をつけてみてください。
 +
 +  * [[https://www.dokuwiki.org/|DokuWiki 公式ドキュメント]]
 +    * 公式なので基本的な情報が揃っている。日本語訳有り。
 +  * [[https://wiki.minecraftuser.jp/forum_boot/doku.php|節電鯖]]
 +    * 他の Minecraft サーバさん。国内の DokuWiki サイトの中でもトップクラスの完成度をしている。wiki の用途も似通っているので、参考になるところが多い。
 +  * [[https://dokuwiki.oreda.net/index.html|DokuWikiで情報発信]]
 +    * 国内向けに DokuWiki に関する情報を発信してくれているウェブサイト。
 +  * [[https://wiki.php.net/|PHP 公式ドキュメント]]
 +    * プログラミング言語 PHP の公式ドキュメント。世界トップクラスの規模感の DokuWiki サイト。
 +  * [[https://wiki.viasnake.com/|管理人の個人サイト]]
 +    * この wiki と非常に似通った設定になっている。実際にこのサイトに入れる前のテストをやっていたりするので、内容というよりサイトデザイン的なところで参考になるかもしれない。
 +
  • wiki/editor.1733020909.txt.gz
  • 最終更新: 2024/12/01 02:41
  • by snake