Wikiの使い方
コメント
この記事ではコメントを受け付けていません。
この記事ではコメントを受け付けていません。
このページでは、カルドセプト部のWikiを作る時の考え方を説明します。
記事を書く手順、エディタの使い方、画像やリンクの入れ方は、次のページを先に確認してください。
ここでは、Wikiに何を書くか、どの階層に置くか、名前や略称をどう扱うかを中心に説明します。
Wikiは、カルドセプトに関する知識を継続的に整理する場所です。
主に、次のような記事を置きます。
一度書いて終わりではなく、後から直したり、別の記事から参照されたりする内容に向いています。
サイトの使い方はWikiではなく、使い方ガイドに置きます。
たとえば、次のような内容はWikiではなくガイドや固定ページで扱います。
Wikiは「サイト機能の説明」ではなく「カルドセプトに関する知識」を置く場所です。
Wiki記事には、読むための記事としての役割と、用語リンクの行き先としての役割があります。
ブログや攻略記事の本文にカード名、マップ名、作品名、能力名などが出てきた時、その言葉に自動リンクを貼れるようにするため、Wikiには多くの名詞を記事として用意していきます。
そのため、長い解説を書ける用語だけでなく、短い説明で十分な用語も記事化する価値があります。
Wiki記事のタイトルは、基本的に正式名称にします。
ただし、本文中では略称、通称、表記ゆれが使われることがあります。その場合は、正式名称の記事にaliasを設定し、略称からも同じ記事へ辿れるようにします。
例:
aliasは、別の記事を増やすためではなく、同じ対象へ自然にリンクするために使います。
Wiki本文は、だ・である調で書きます。
見出しを入れる前に、本文の最初で用語そのものを太字にして説明します。
例:
**防魔**は、キーワード能力のひとつ。用語ページでは、先頭に大見出しを重ねて入れる必要はありません。英語名を毎回括弧書きする必要もありません。英語名が必要になるのは、現時点では主にカードとマップです。
情報ブロックは、記事を読む助けになる項目がある場合にだけ使います。
読みだけ、aliasだけ、内部整理用メモだけを表示する情報ブロックは基本的に不要です。
使う価値がある例:
読者に見せる必要がない管理情報は、本文ではなく下書きメモや投入台帳に残します。
Wikiの階層は、読者が探したい情報の種類で分けます。
現在の大きな候補は次の通りです。
現在の /wiki/terms は、初期投入用の仮置きとして扱います。階層が固まった用語は、必要に応じて適切な場所へ移していきます。
新しい記事を作る時、既存の階層に自然に入らない場合は、すぐに細かい階層を増やす前に、サブ階層を提案してください。
提案では、次の点を整理します。
記事が1本だけの段階では、親階層に置いたままでも構いません。似た記事が増え、一覧から探しにくくなった時にサブ階層を作る方が安全です。
迷った時は、次の順に考えます。
それでも迷う場合は、仮置きにして、後から移動できるように本文とaliasを整理しておきます。