Wikiを編集する人は一読お願いします。

• https://www.dokuwiki.org/ja:syntax

基本的には単項目ページとガイドページの２種類のページによって構成します。
「知りたいページが見つからない」のを防ぐためにサイドメニューにリンクを作成します。

例えば「VRMの作り方」を説明しようとした場合…
Unityの準備、VRMの仕様や設定方法、MToonの設定、SEEDへのアップロード、VirtualCastの作業…
といった感じで、多くのツールや物事についてまたいだ形で説明する必要があります。

この時に作業手順を全て書き出してページを作成してしまうと、
別の作業手順の説明をした際に似たような内容を再掲載してしまったり、作業全体ではなく特定の事だけ知りたいのに作業全体を順番になぞって探す必要がある等の問題が発生します。

具体的な内容は単項目ページに記載し、
作業手順のページや全体を俯瞰したページを書きたい場合はガイドページとして作成しましょう。

上図のように、ガイドページはいくつかの単項目ページへのリンクで構成します。
そうする事で、重複した作業内容を繰り返し書く必要がなくなり、保守するページも最小限になります。
ページを作りすぎてもwikiの構造が複雑になり保守コストが上がり検索性が落ちるので、不足なく必要なページのみを作成するように心がけます。

1. 新規に作成するページは 単項目ページ か ガイドページ のどちらかを作成する
2. 単項目ページは１つの内容について書く
3. ガイドページには詳細な内容は書かず、単項目ページへのリンクを掲載する形で説明を行う
   
4. 文章の区切りは余白で表現する(hr 禁止)
5. 見出しの前後にbr 禁止
6. スマートフォンなどの端末で表示した際に破錠する恐れがあるため画像の右揃え、左揃えを禁止。

ネームスペースとは、ページを作成したときに割り振られるURLのことです。
ネームスペースには階層があり、「/」(スラッシュ)で区切られます。

• １番上のネームスペースは サービスの種類・ツール・扱うデータの種類 で分けます
• その下のカテゴリーは比較的柔軟に決めてOKです（既存ページの命名など参考にしながら）
• 既存のネームスペースに分類できそうなものは既存のネームスペースに分類してください

ネームスペースの方針の基準として 何がどこにあるのか分かりやすくする・分類しやすくする を第一とします。ネームスペース通りに単項目ページを並べると目次になるような状態が理想です。

⇒ ネームスペース一覧

画像はアップロードした際の名前がそのままネームスペースになります。
可能であれば下記ルールでアップロードしましょう。

• 画像を掲載するページと同じネームスペースにする
• カテゴリー名事に大文字やアンダーバーで区切る（item_make , ItemPointer 等）
• 複数枚にまたがる場合は末尾に数字を付ければOK

全角文字(2byte)を使用してしまうとリンクが長くなり、改行の際に変な切れ方をする事があります。
サービスによってはリンクが文字数制限に引っかかったり、リンクが切れる事があります。
wikiのリンクを外部に貼りやすくするためにも、ネームスペースは半角英数字で区切るようにしましょう。

正しい用語・表記を使用するように心がけましょう。

Wikiの編集ルールのようなリンクは、次のように記載します。

[[wiki:rule]]

このようにネームスペースをかっこで括り、「/」(スラッシュ)を「:」(コロン)で置き換えると、
リンク先のページの最初の見出しが、リンク文字列として表示されます。

[[wiki:rule | リンク文字列]]

上記のように | で区切ることで、右側に任意のリンク文字列を書く事ができます。

ガイドページやTOPページが長くなる場合、折り畳み機能を使用して見やすくします。
折り畳みのタイトルには (クリックで展開) を含めてください。(展開できると思われない場合があります)

〇〇一覧 (クリックで展開)

• 1
• 2
• 3

--> 〇〇一覧 (クリックで展開) #

  * 1
  * 2
  * 3

<--

書き方を統一するため、次のような場合は例文のように記載して下さい。

[]を使用します。
例: [表示 > 隠しファイル]にチェックを入れてください。
例: Windowsなら[Ctrl + Shift + X]を押して拡張機能のウィンドウが開けます。

フルパスの場合はcodeタグを使ってください。

C:/Users/_USER_/AppData/LocalLow/infiniteloop Co,Ltd/VirtualCast

<code@>C:/Users/_USER_/AppData/LocalLow/infiniteloop Co,Ltd/VirtualCast</code@>

※@マークを抜いてください。

文章中にコード を挿入。

文章中に''コード'' を挿入。

1つ目の強調、2つ目の強調。

''1つ目の強調''、**2つ目の強調。**

右上に表示される目次を消したいときに、ページの一番上に記載します。

~~NOTOC~~

参考リンクがあるとき、青色がバーチャルキャストっぽいのでこちらを使います。
⇒ Wikiの編集ルール

<wrap notice right>⇒ [[wiki:rule]]</wrap>\\

• 図表のフォントは、NotoSansJP-Regular等の見やすいフォントを使ってください。