Wiki contributions & translations/ja

Resoniteをどの程度プレイしているかに関わらずすべての人が編集に参加できます。

Resonite Wiki はコミュニティ全体で取り組んでいるプロジェクトです。皆さんのご協力に感謝申し上げます。私たちは小さなチームですが、皆さまのおかげでWikiが成り立っています。

どんな貢献も歓迎です。どんどん編集してください！

始め方

Wiki編集を始めるには

1. Resonite Wikiのアカウントを作成する
2. メールアドレスを確認する
3. 「自動モデレーション（Automoderated）」の権限を得る

Resonite Wikiアカウントの作成

アカウントは無料で簡単に作成できます。アカウント作成ページにアクセスし、フォームに入力してください。 本名の入力は不要です。「表示名/ハンドルネーム」として使われます。

登録時に表示されるCaptcha（画像認証）は、簡単な質問です。答えがわからない場合は、ページのフッターなどを探してみてください。これはスパム対策です。

メールの確認

登録後、「wiki@resonite.com」から確認メールが届きます。メールを開き、リンクをクリックすることで、アドレス確認が完了します。

自動モデレーション（Automoderated）の取得

作成したばかりのアカウントでのwikiの編集は即座に反映されず、モデレーションキューに追加されます。このプロセスはスパムや荒らしの対策に繋がります。

自動モデレーション（Automoderated）権限を得るには：

1. 翻訳以外のページを1つ編集する
   • あなたのユーザーページを編集するのがおすすめです。Resoniteでの活動や自己紹介を書いてみましょう。
2. Wikiモデレーターがその編集を確認するのを待つ
3. 承認されると「自動モデレーション（Automoderated）」に昇格されます

この処理には最大で24時間ほどかかる場合があります。モデレーターはキューを随時確認しているためです。上記の手順を完了したら、しばらくお待ちください。

24時間以上経っても承認されない場合や、急ぎで編集したい場合は、Discordでモデレーターに「自動モデレーション（Automoderated）」にしてもらえるようお願いしてください。

編集時のガイドライン

編集を始める前に、Wikiを編集する際に覚えておいてほしいガイドラインをいくつかご紹介します。

下書き・レビューなどについて

1. とにかく編集してください！ Wikiを編集するのに特別なステータス、承認、または許可は必要ありません。
2. 下書きや作業中の文書（WIP）を送る必要はありません。そのまま編集してください。内容は随時改善していきます :)
3. ドキュメントの下書きをGoogle DocsやWordで作成するのは避けてください。Wiki上で直接書くことで、Wiki的な書き方が身につきます。
4. 「段階的な改善（progressive enhancement）」の原則を守りましょう： 良い（Good） → もっと良く（Better） → 最高に（Best）

スタイルについて

このWikiで文章を書く際には、以下のガイドラインに従ってください：

• アメリカ英語を使用してください。
• 他の記事へのリンクを活用してください。
  • 「ここをクリック」「ここ」「このページ」などの表現でリンクするのは避け、自然な文の中でリンクを使用してください。たとえば：
    • 「詳しく説明している記事があります」や「Resonite Botにコマンドを送信できます」のように書いてください。
• 見出しを使ってページをセクションごとに区切ってください。そうすることで読みやすくなります。
  • 見出しは第2レベル（== 見出し ==）から始めてください。ページタイトルが第1レベルに相当するためです。
• 箇条書きを活用してください。
• データや少量のテキストには表を使用してください。
• 文法に則った文章を書き、Wikiスタイルを使用してください。
  • 過度な大文字使用（強調表現）は避けてください。
  • 読者に向けて書いてください。「私（I）」は使わず、「私たち（we）」や「あなた（you）」を使いましょう。
  • 「こんにちは、今日はXについて見ていきます」のような文でページを始めないでください。
  • 記事名に文章を使わないでください。「ProtoFluxとは何か」よりも「ProtoFlux」が適切です。ページ「ProtoFlux」の中でその説明をすればよいからです。
  • 「導入（Introduction）」という見出しは避けてください。ページ冒頭の段落が導入文となります。
  • 「注意」（「Note」や「Please note」など）のような表現は避け、代わりにNoteテンプレートを使用してください。
• 内容は段落ごとに分けてください。長文が続くと非常に読みにくくなります。

迷ったときはWikipediaの記事スタイルを参考にしてください。

書式について

このWikiは常に更新されており、国際化への対応も求められているため、特定の方法で書式を整えていただく必要があります。

Wikitextの書式についての簡単なガイドは、MediaWikiの書式整形ヘルプページで確認できます。

MediaWikiはMarkdownをサポートしていないため、代わりにWikitextを使用してください。

• 古いHTMLタグの使用は避けてください。
  • <b>の代わりに'''を使用してください。
  • <i>の代わりに''を使用してください。
  • 通常の文章に <div> や <p> を使用しないでください。
• 改行が必要な場合は、実際に行を改めてください（改行を入れてください）。
• ページ名と同じ文言の見出しでページを始めるのは避けてください。ページのタイトルはページ名であり、最初の見出しではありません。
• 太字や斜体などの文字修飾の使用には注意してください。
  • すべてが太字であれば、それはもはや強調とは言えません。.
  • 太字や斜体の使い方については、Wikipediaのテキストフォーマットガイドを参考にしてください。
    • Resonite Wikiでは、太字と斜体はどちらも強調に使われており、互換的に扱われています。将来的に変更される可能性はあります。
  • 強調に <u> を使わないでください。ウェブ上ではリンクと誤認される可能性があります。

色について

• Wikiページ上で手動で色を指定するのは避けてください。そうすることで、ライトモード／ダークモードの切り替えが正しく動作しなくなる可能性があります。
• 色を指定する場合は、Mediawiki:Citizen.css に定義された色の変数を使用してください。
• 現在、スキンのカラーテーマ機能を使用する方法を検討中です。これにより、ライトモードとダークモードの両方で一貫性を保ちつつ正しく表示できるようになります。

Component & Flux images

• Make sure the images are taken on a vanilla client without mods or plug-ins

アイコンについて

可能な限り、実際のSVGファイルを使用してください。SVGファイルを使用すると、後からユーザーがより簡単に更新できます。

ページの説明文について

検索結果では、ページに短い説明文を表示するために「Short Description」拡張機能を使用しています。

ページに説明文を追加するには、次のように記述してください：{{SHORTDESC:<description>}}

編集すべきコンテンツの見つけ方

Resonite Wikiは、Resoniteのさまざまな変更やアップデートにコミュニティが対応しているため、非常に動きの速い環境です。そのため、どの部分を編集・調整すべきかが分かりにくくなることがあります。

スタブ（Stubs）

その対策として、編集が必要なコンテンツを一覧にしたページがいくつか用意されています。これらのページは「スタブ（Stubs）」と呼ばれています。スタブの一覧は、以下の自動生成されたページで確認できます：

• Category:Stubs
• Category:ProtoFluxStubs
• Category:ComponentStubs

編集が必要なページの一覧を確認するために、これらのページを定期的にチェックしてください。

コンポーネントとProtoFluxノードについて

Resoniteのユーザーは、ゲーム内コンテンツを作成するために非常に多くのProtoFluxノードやコンポーネントを使用しています。それらすべてにドキュメント（解説）が必要です！

テンプレート

現在のところ、正式なコンポーネント／ノード用のテンプレートは用意されていません。テンプレートが整備され次第、更新される予定です！

ProtoFluxノード

ノードの一覧はCategory:ProtoFluxカテゴリで確認できます。これは、ゲーム内のノードブラウザに似た構成になっています。すべてのノードはレビュー・編集・更新の対象になり得ますが、赤いリンクになっているノードはまだドキュメントが書かれていません。そういったノードについては、ぜひ自由にドキュメントを追加してください！

コンポーネント

Category:Componentsにはコンポーネントの一覧がありますが、情報の抜けやページが存在しないものもあります。ドキュメントが不足しているコンポーネントを見つけたら、ぜひ追加してください。

大きな変更を加える際の注意点

When making changes to the wiki, the general principle is to go right ahead. However, when making changes to larger pages such as the Main Page or pages which are edited, touched or translated frequently, please be careful. There are sometimes subtleties and nuances that need to be covered when editing these pages. Please double check in the Wiki channel of the Resonite Discord before you make such changes. The community there will say yes a lot of the time, but sometimes a discussion may be required.

編集の手引き

Resonite WikiはMediaWikiをWikiエンジンとして使用しており、ページの編集方法についての豊富な公式ドキュメントがあります。

誰でもWikiアカウントを作成して、既存のページに貢献したり、新しいページを作成したりすることができます。

カテゴリについて

A Category is a way to categorize pages that follow a certain theme or topic. You can use them to group together these pages, as a category page will create a table of pages within its category. For more information on categories, please see Media Wiki's guide on categories. However, here are some specific Resonite Wiki items of guidance:

• Category Pages can contain information and text. Use this to explain what the category is and what it does.
• Subcategories can exist.
  • To Create one, put a Category page into another Category.
  • For example, Category:Animals, Could contain Category:Animals:Mammals.
  • To do this, make sure Category:Animals:Mammals is named exactly like that and then ensure it also has [[Category:Animals]] within it.
• A page can be in more than one category.
• Please try to avoid creating categories that have only one page within them.

Be careful when nesting categories. Members of a category should not also be a category themselves. Category:Vegetables is fine. However, Potato being its own category is NOT ok.

Translating

For translating information read Help:Translating.

Citations

We use the MediaWiki Cite Extension to enable you to cite parts of an article. To use this extension you can refer to MediaWiki Cite help page.

For some added guidance for this wiki specifically:

• Citing is not mandatory but it is appreciated when suitable
• Be careful when linking to transient sources. For example, Twitch Vods may become unavailable.
• Examples of suitable sources:
  • Discord Messages
  • Youtube Videos
  • GitHub Issues
  • Social Media
  • Patch Notes etc.

Accessibility

Images

Make sure your images are accessible. Our recommendations:

1. Highlight relevant portions of the image with an image editor such as button pushes or input boxes the user should focus on
2. Upload a large image, and use WikiText to shrink it down.
3. Always specify a caption straight after the image name e.g. [[File:bunny.png|A photograph of a bunny]].
   • When the caption is the first item after the image name, it will be automatically placed in the HTML image tag's alt attribute.
   • If you need to make a separate alt-text from a caption, you can use the alt parameter.

Diagrams

See Help:Diagrams

Images

See Help:Images

Disambiguation

Main article: Help:Disambiguation Use disambiguation pages when the subject matter is ambiguous. Visit Camera (Disambiguation) for an example of a disambiguation page.

External Resources

• MediaWiki's help on links
• MediaWiki's help on images
• MediaWiki's help on formatting
• MediaWiki's help on tables
• MediaWiki's help on templates
• MediaWiki's help on categories

See Also

• Wiki status