ユーザ用ツール

サイト用ツール


Language:

サイドバー

バーチャルキャスト公式Wiki

メインメニュー

初心者向けガイド

VirtualCast

遊ぶ世界

THE SEED ONLINE

ニコニコ

SHOWROOM

配信

配信ツール

その他

wikiについて

デベロッパー向け


開発環境

VRM(アバター)

VCI(アイテム/背景)

VCI更新情報

更新日 - UniVCI バージョン
2021/03/17 v0.32
2.0.3b
2021/01/14 v0.31
2.0.1a
2020/12/03 v0.30
2.0.0b
2020/11/12 v0.30
2.0.0a
2020/10/22 v0.29
1.9.5b
2020/07/30 v0.29
1.9.3e
2020/06/25 v0.28
1.9.3c
2020/05/21 v0.27
1.9.2e

以前のアップデート履歴


GLB(背景)

wiki:rule

Wikiの編集ルール

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

wikiの方針


ページ分類 意味
単項目ページ 1つの内容ついて説明したページ
ネームスペースはツール・サービス・データ形式 等の単位で区切る
ガイドページ 単項目ページへのリンクだけを行うページ

wikiでは基本的に単項目ページガイドページの2種類のページしか作成しません。
例えば「VRMの作り方」を説明しようとした場合…
Unityの準備、VRMの仕様や設定方法、MToonの設定、SEEDへのアップロード、VirtualCastの作業…
といった感じで、多くのツールや物事について横断的に説明する必要があります。

この時に作業手順ベースでページを作成してしまうと、
VRMの作り方以下のネームスペースに様々なジャンルの情報が掲載され検索性が落ちます、また、別の作業手順の説明をした際に似たような内容を再掲載してしまったり、作業全体ではなく特定の事だけ知りたいのに、作業全体を順番になぞって探す必要がある等の問題が発生します。


なので、具体的な内容は単項目ページに持たせ、
作業手順や全体を俯瞰したページを書きたい場合ガイドページとして作成して、単項目ページへのリンクだけ持ちます。
そうする事で、重複した作業内容を繰り返し書く必要がなくなり、保守するページも最小限になります。
ページを作りすぎてもwikiの構造が複雑になり保守コストが上がり検索性が落ちるので、不足なく必要なページのみを作成するように心がけます。

ページ分類

ページ分類 意味
単項目ページ 1つの内容ついて説明したページ
ネームスペースはツール・サービス・データ形式 等の単位で区切る
ガイドページ 単項目ページへのリンクだけを行うページ
wikiページ wikiの事について書かれたページ
ネームスペース 各カテゴリーのネームスペース一覧が書かれたページ

ページテンプレート

ページ分類 テンプレート
単項目ページ 単項目ページ(テンプレート)
ガイドページ ガイドページ(テンプレート)
ネームスペース一覧 ネームスペース一覧 (テンプレート)

編集ルール

  1. 新規に作成するページは ガイドページ か 単項目ページ のどちらかを作成する
  2. 単項目ページのネームスペースは ツール、サービス、データ形式 等で分類する
  3. 単項目ページは1つの内容について書く
  4. ガイドページには詳細な内容は書かず、単項目ページへのリンクを掲載する形で説明を行う
    (俯瞰的な概要については適宜記述)
  5. ネームスペースは半角英数字を使用する
  6. 文章の区切りは余白で表現する(hr 禁止)
  7. 見出しの前後にbr 禁止
  8. スマートフォンなどの端末で表示した際に破錠する恐れがあるため画像の右揃え、左揃えを禁止。

ネームスペースは半角英数字について

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

[[namespace | リンク文字列]]

上記のように | で区切って右側にリンクの表示を書く事ができます。

[[namespace]]

このようにリンク文字列を省略すると、リンク先のページの最初の見出しが、リンク文字列として表示されます。

ネームスペースの区切り方についての詳細

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

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

画像ファイルのネームスペース

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

大まかな方針としましては、他の人が見て分かりやすければOKです。
既に掲載されているメディアの中には上記のルールにあてはまらないものもありますが、それらは、古くなって差し替えになったタイミングや、ページを再編集した際に改めて差し替えればよいかと思います。

用語・表記に関するルール

正しい用語・表記 ルール 表記ゆれ
バーチャルキャスト Virtual Cast, VirtualCast
SHOWROOMhttps://www.showroom-live.com/ 略さずに全て大文字で統一してください。また、ロゴ利用はガイドラインに則って利用してください。 ショールーム,ShowRoom,SR
関数 VCIスクリプト等を説明する際に、メソッドという言葉を使わずに関数で統一してください。
VSCode wikiでVisual Studio Codeを指す場合はVSCodeで統一してください(Cは大文字)。 VScode
コピー&ペースト コピペという略語は使わずに、コピー&ペーストで統一してください。
THE SEED ONLINE 略さずに全て大文字で統一してください。 THE SEED, SEED, The Seed Online
VCIスクリプト VCIScript
Lua lua
部屋主 Owner, オーナー

メニューや、キーを記述する場合

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

ファイル、フォルダや設定項目を記述する場合

例: この中に書かれた[main.lua]を編集すればスクリプトの書き換えができます。

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

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

本文中にコードを挿入する場合

例: シンプルな方法としては string.find() を使用して message の中を検索する方法です。

強調したい場合

例: %d+ とした場合、数値が繰り返されている最長の箇所を意味します。

その他

  • 記号なしリスト数値、括弧は半角にしてください。
  • 図表のフォントは、NotoSansJP-Regularを使ってください。

:top ページの作成ルール

TOPのページにはそれより下のネームスペースを羅列します。目次のような役割を果たすと理想です。
ページ数が増えてTOPページが長くなる場合、ネームスペースが細分化されてるページは折り畳み機能を使用して見やすくします。
折り畳みのタイトルには (クリックで展開) を含めてください。(展開できると思われない場合があります)

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

  * 1
  * 2
  * 3

<--
wiki/rule.txt · 最終更新: 2021/06/19 15:30 by mikagew

ページ用ツール