クレジット
タイトル: ユーザーコンポーネントに関するポリシー
著者: SCP財団
作成年: 2022
本ページはSCPコミュニティのために作成され、SCP財団に帰属します。本ページの管理はサイトスタッフに委任されています。
このポリシーについて
このポリシーは、ページの一部要素の追加や外観の変更を目的とするWikidotシンタックスとCSSを内包し、簡易に利用することができる「ユーザーコンポーネント」を運用するためのものです。
このポリシーは、以下に定める「ユーザーコンポーネント」を対象に制定されたものです。あなたが個々のページに複雑なWikidotシンタックスを追加、適用しようと考えている場合、このポリシーに書かれていることを意識することは、あなたと、あなたの記事を読む読者、そして同じWikidotシンタックスを追加しようと考える人を助けることにつながります。
------
コンポーネントの定義
コンポーネントとはページの見た目、もしくはページ内に記述されているWikidotシンタックスを変更することを目的とするCSSコードを含み、[[include]]構文を用いて他のページに導入できるものを指します。これにはテーマは含まれません。これらのページには「コンポーネント1」タグもしくは「コンポーネント・バックエンド2」タグが付与されています。
原則、コンポーネントはSCP-JPのスタッフのみが作成できます。他支部のコンポーネントページを移植したい場合、サイトスタッフまで連絡し内容を確認した上で代理投稿を行います。その際、サイトスタッフによって内容の追加・変更が行われることがあります。
もしあなたが作成したコンポーネントページをサイトに投稿したい場合は、以下の定義に従う必要があります。
------
ユーザーコンポーネントの定義
このポリシーが適用されるページを「ユーザーコンポーネント」と呼称します。ユーザーコンポーネントとは、コンポーネントの定義を継承し、以下の定義に全て当てはまるものを指します。
- user-component:カテゴリに投稿される、または投稿されたページ
- SCP-JPの一般メンバーが作成したコンポーネントページ
- 下記の制限事項を満たすもの
これらの定義に当てはまらないページをuser-component:カテゴリに作成することはできません。
------
制限事項
サイトに投稿されるユーザーコンポーネントは、以下の制限事項を満たす必要があります。
ライセンス
ユーザーコンポーネントはWikiの他のコンテンツと同様に、CC BY-SA 3.0で公開されている必要があります。
許容される条件
あなたは、ユーザーコンポーネントを作成するうえで以下に定める条件を満たす必要があります。
- 明確な使用目的を定め、ページの最初に明記する必要があります。
- ページを作成するのが妥当であると判断されるのに十分な内容を含んでいる必要があります。
- 内容はサイトルールや各ガイドラインに違反しない、また違反を助長しないものである必要があります。
許容される要素
あなたは、以下に定める要素以外の、Wikiのすべての部分を変更することができます。但し、現実的な範囲を超えてはいけません。サイトの内容は正しく認識でき、可読である必要があります。
また、ユーザーコンポーネントにサイトルールに違反する内容を含めることはできません。
変更が制限される要素
- カスタムテーマに関するポリシー 制限事項/許容される変更の変更が制限される要素で定める要素
- ユーザーコンポーネントで追加するWikidotシンタックスに対して影響しない要素
互換性の維持
主要なブラウザ(Google Chrome, Firefox, Safari)、主要なOS(Windows, macOS)、及びモバイル端末(画面幅320px以上)の全てで正常に機能しなければなりません。
コードの質の維持
ユーザーコンポーネントは不必要なWikidotシンタックス/CSSを大量に含むことはできません。既存のコンポーネントを参考にすることは構いませんが、必要でないコードは参照性の悪化、読み込み速度の低下を引き起こすため削除してください。
また、Wikidotシンタックス/CSSの知識を持つ人がコードを読んだ時、それが何を意図して書かれたものかが十分に理解できるように書かれている必要があります。最低限、あなたはあなたの書いたコードの全ての行に対して、それが何をしているか説明できなければなりません。
また、必要な場合、また他のコンポーネントとの互換性のために使用したほうが良いと判断される場合を除き、CSSでの!importantの使用は避けることを推奨します。
直リンクの禁止
外部サイトにアップロードされたファイルを@importやurl:()などの方法を用いて直接使用することは、原則として禁止されます。ユーザーコンポーネントに使用される画像ファイルなどは、すべてSCP-JPファイルストレージにアップロードし、それを参照しなければなりません。
但し、SCP-JPファイルストレージ、Google Fonts、BootStrapCDN、cdnjsなどのいくつかのサイトについては、その信頼性やWikiの容量節約を鑑み、特例的に直リンクでの利用が許可されます。ここに挙げられていないサイトについては、個別に審査されます。
また、サンドボックスを含むメインWiki以外の場所にあるコードブロックを参照してはいけません。上記の特例を除き、ユーザーコンポーネントは他のユーザーコンポーネント以外に依存せず、他のコンテンツの変更や削除の影響を極力受けないようにする必要があります。
もし、他のユーザーコンポーネントのコードを使用する場合以下のコードを最下部に挿入する必要があります。
[[iftags]]
[[include :scp-jp:user-component:コードを使用したページ]]
[[/iftags]]ページ数
ユーザーコンポーネントは特にページ数に制限は設けていませんが、可能な限り少ないページで済むようにする必要があります。適切なページ数かどうかは査読時にスタッフによって判断されます。
リファレンスの提示
ユーザーコンポーネントを説明するページを「リファレンス」と呼称します。ユーザーコンポーネントには、他のメンバーがそのユーザーコンポーネントを使用したい時のためのリファレンスを用意されなければなりません。
リファレンスには、他の記事でユーザーコンポーネントを使用するために何をしなければならないか、どのような機能を持ちどのような見た目で出力されるのかを記述することを意識してください。知っておくべき特別な機能があるのであれば、それも記述してください。
また、リファレンスでは、[[include]]メソッドでユーザーコンポーネントを参照することで、ユーザーコンポーネントをページに適用するようにユーザーに指示しなければなりません。これは、バックリンク機能を利用して、そのユーザーコンポーネントを利用しているページを正確に把握するためのものです。
運用上、リファレンスを除くすべてのユーザーコンポーネントに関するページはuser-component:カテゴリに投稿されます。必要なユーザーコンポーネントページはすべて「コンポーネント」タグもしくは「コンポーネント・バックエンド」タグのうち適切な方を付与してください。この時、「コンポーネント」タグもしくは「コンポーネント・バックエンド」タグの付与を決定する基準としてユーザーコンポーネントを使用する際に[[include]]を行うページは「コンポーネント」タグであり「コンポーネント」タグが付くページが[[include]]を行うページは「コンポーネント・バックエンド」タグが付与されます。
リファレンスには「リファレンス」タグが必要です。また、reference:カテゴリにユーザーコンポーネントとの関係性が分かりやすいページネームで作成される必要があります。
ユーザーコンポーネント，リファレンスのページネームには以下の制限があります。
- ユーザーコンポーネント
- user-component:[固定名]-[自由名]
- 「コンポーネント・バックエンド」タグが付与されているユーザーコンポーネント
- 参照先のページネームに-baseを付与する
- リファレンス
- reference:[固定名]
以下にリファレンスのテンプレートを示します。必ずしもこの通りに作る必要はありませんが、[[iftags]]メソッドの使用方法など、このテンプレートを参考にすると良いでしょう。
サイトスタッフは、このリファレンスを含むユーザーコンポーネントページの全体を査読の対象とします。
全てのユーザーコンポーネントページは以下の方法でリファレンスへのバックリンクを含める必要があり、如何なる評価モジュールも設置してはなりません。リファレンスページにはクレジット付き評価モジュールを設置する必要があります。
ユーザーコンポーネントが使用されている
使われていない、また使われる予定のないユーザーコンポーネントの投稿は認められません。ユーザーコンポーネントを投稿するためには、以下の条件を1つ以上満たす必要があります3。
------
ユーザーコンポーネントの作成
ユーザーコンポーネントを作成、投稿したい場合以下のルールと手順に従う必要があります。
申請者
ユーザーコンポーネントの査読、投稿を申請できるのは、原則としてそのユーザーコンポーネントの作成者に限ります。自分以外が作成したユーザーコンポーネントを許可なく投稿することはできません。
あなたを含む複数人によって作成されたユーザーコンポーネントである場合は、その全員の許可のもとでのみ申請することができます。
手順
1. 作成
ユーザーコンポーネントが完成したら、Wikidot上でユーザーコンポーネントページとリファレンスの下書きを作成してください6。ユーザーコンポーネントページには如何なる評価モジュールも設置してはならず、リファレンスページにはクレジット付き評価モジュールを設置する必要があります。
2. 査読
上記の下書きページのリンクと、投稿を予定しているページのURLを付記し、サイトスタッフに査読を依頼してください。SCP-JP Information Technical LaboratoryやスタッフへのPMで連絡できます。
スタッフは、あなたの作成したユーザーコンポーネントがこのポリシーに適しているかを判断し、問題がなければ投稿を許可します。モデレーター以上のサイトスタッフが許可を出す権利を持ちますが、投稿許可を出すには必ず1人以上のテクニカルスタッフの承認が必要です。
スタッフが査読した後、修正すべき点があればそれを、なければ投稿を許可する旨をご連絡します。
査読中もしくは査読後、下書きに大規模な編集を加えることは避けてください。必要な場合は、編集後に再度査読を依頼してください。
3. 投稿
査読が完了し、投稿が許可されたら、あなたはuser-component:カテゴリにページを投稿することができます。
任意のタイミングでサイトにユーザーコンポーネントを投稿しましょう。その際、必ずuser-component:カテゴリに投稿し、「コンポーネント jp」もしくは「コンポーネント・バックエンド jp」のいずれかの適切なタグを付与してください。その際、リファレンスに親登録を忘れないようにしてください。
ページを投稿したら、投稿報告を行ってください。
------
ユーザーコンポーネントの編集と削除
ユーザーコンポーネントは通常の記事と同様に扱われ、原著者でないメンバーによる大規模編集は制限されます。誤字やコードの文法的誤りなどは小規模編集として他のユーザーが行っても構いません。
ユーザーコンポーネントの作成者や、作成者の許可を得たユーザーは、ユーザーコンポーネントの大規模編集を行うことができます。これには機能の追加や削除・編集などが含まれます。大規模編集の際にスタッフの査読は必要ありませんが、編集後の内容に問題があるとサイトスタッフが判断した場合は編集前の内容に差し戻しを行う可能性があります。
ユーザーコンポーネントページはVoteが可能ですが、低評価削除の対象とはなりません。
また、ユーザーコンポーネントページの使用されていない状態が1週間以上続いていた場合、予告の後に削除されることがあります。この際、予告から削除の実行までは12時間以上の時間が設けられます。
------
問題が確認されたユーザーコンポーネントの扱いについて
ユーザーコンポーネントは必要だと判断された場合に限り、サイトスタッフによる大規模編集が行われる可能性があります。この大規模編集には、サイトの仕様変更やルールやガイドラインの改定・新設に伴う内容の変更を含みます。
また、ユーザーコンポーネントページは、その内容に問題があると判断された場合、またはサイトスタッフによって内容や使用状況などを鑑みて存在する意義が薄いと判断された場合は、予告の後に削除されることがあります。その際、予告から削除の実行までは12時間以上の時間が設けられます。
但し、その問題が極めて重大であると判断される場合、削除のガイドラインに基づいて即時削除が行われます。
------
他支部のコンポ―ネントの翻訳について
他支部で作成・投稿されたコンポ―ネントページを翻訳・投稿したい場合、翻訳が終了したらサイトスタッフに査読を依頼してください。査読を受けずに投稿することはできません。
サイトスタッフは、そのコンポ―ネントがSCP-JP独自の仕様に対応しているか、翻訳は十全であるかなどを確認し、問題がなければ翻訳ページの投稿をスタッフが代理投稿します。
査読中もしくは査読後、下書きに大規模な編集を加えることは避けてください。必要な場合は、編集後に再度査読を依頼してください。
投稿時の査読を除いては、通常の翻訳記事と同様の扱いがなされます。