ヘルプ:表記ガイド/草案のソースを表示

{{ガイドラインの草案}}
以下は当Wikiにおける表記の基準である。この基準は、記事にのみ適用される。なお、これを100%守る必要はない。この方針をブロックの理由としてはならない。

== ページ名 ==
表記ゆれがある場合は、そのすべてをリダイレクトとし、正式名称のみを記事とする。また、主観的な表現を使ってはいけない。例:「すばらしいブロック」「おかしなScratch」

=== ページ名の技術的な制約 ===
ページ名には次の文字を含めることができない。<nowiki>{ } [ ] | # < ></nowiki>この場合は、以下の手順で対処する。
# 記号の意味が強いときは、全角記号を使う。例:[[() ＞ () (ブロック)]]
# 容易に言いかえができるときは、言い換える。例:[[コスチューム番号 (ブロック)]]
# どちらの場合も、{{t|不適切なタイトル}}を記事におく。

次の文字も使用はできるが、推奨されないため、「リダイレクト」として上記の規定に沿ったページを作成し、本来のページ名は次の文字を含むようにする。<nowiki>: /</nowiki>

?や%はURLにて特殊な意味を持つ。?,%がある場合は、?や%つきを記事(%3F,%25を使う)、ないほうをリダイレクトとする。例:[[Why!プログラミング]]

=== 大文字・小文字 ===
英文字から始まるページ名では、最初の一文字目が大文字になる。ただし、[[scratch2.0の提案]]のような、固有名詞で小文字から始まるものに対しては、大文字記事名+{{t|小文字}}で対処する。

=== 記号 ===
[[#ページ名の技術的な制約]]にかかわらず、記号の使用は控える。ただし、ブロックの引数を表す括弧、半角スペース、ブロック名・トピック名などの固有名詞、固有名詞に対する技術的な制約を回避するための記号、曖昧さ回避、FAQの「?」、サブページを示す「/」を除く。

=== 曖昧さ回避 ===
曖昧さ回避括弧の前には半角スペースが必要で、また曖昧さ回避括弧は半角でないといけない。

== 全般事項 ==
これらはすべてに適用される。

=== 翻訳が確定していない場合 ===
「Scratchにて翻訳されるべきもので、広く一般に使われるもの」(例:ブロック名)に対しては、以下の順番で使用する。
# 実際に使われているもの。
# TransifexのJapaneseにて、レビューされたもの。
これ以降は記事に但し書きをつける。
# TransifexのJapanese Hiraganaにて、レビューされたものを、漢字交じりにしたもの。
# TransifexのJapaneseにて、翻訳されたもの。
# TransifexのJapanese Hiraganaにて、翻訳されたものを、漢字交じりにしたもの。
# 過去の入手できるScratchにて使われているもの。
# [[scratch:discuss/topic/4196/|Japanese translation (日本語の翻訳)]]にて決定したもの。
# フォーラムなどで一般的に使用されているもの。ただし、略称や俗称を控える。
# 書籍などで使用されているもの。
# ※過去のもので、現在廃止されたものに限る: インターネットアーカイブなどの魚拓サイトにて確認できるもの。
# ※現在存在しないものに対して: 英語を正しく訳したもの。
# 英語タイトル。

上記の対象外のもの(たとえば[[60秒ルール]]や[[パックマン事件]])に対しての決まりはない。

=== Scratch関係の固有名詞 ===
Scratch、Gobo、Pico、Nano、Giga、Teraを訳さない。カタカナにしたページ名はリダイレクト可。なお、容量単位としての「ギガバイト」などを訳すのは問題ない。

Scratchの一文字目は大文字で書く。ただしトピック名など固有名詞を除く。

=== ことば ===
書き言葉で常体(だである調)を使う。また、方言は原則使わない。この節の内容は引用文に影響を与えない。

=== 主語の省略 ===
英語で「one」「Scratchers」「they」などとある場合や、主語を省略したほうがわかりやすい場合は、省略していい。これは定義文には当てはまらない。

=== 機種依存文字 ===
丸付き、ローマ数字、半角かななど環境依存文字を用いてはならない。ただし[[クラウドデータ]]に言及するときの☁は除く。

== 導入部 ==
導入部とは、主題について定義する部分である。導入部に節をおいてはいけない。(言い換えると、記事の先端とはじめの節の間には、かならず定義文が必要である。)

=== 定義文 ===
定義文の基本形式は「'''XX'''とは、YYである。」である。定義文では通常主語の省略をしてはならない。NG例:「Scratchの命令語のことである。」

定義文は以下をポイントにして書く。
# だれ - 例:[[Scratchチーム]]はScratchの運営管理を行う人である。
# なに - 例:[[60秒ルール]]とは、Scratcherがトピックへの投稿ごとに60秒待つルールである。
# どこ - 例:[[ブロックパレット]]とは、ブロックが置かれているところである。
# いつ - 例:[[パックマン事件]]は2010年に起こったScratchの事件である。
# なぜ - 例:[[ペン拡張機能]]は初心者への配慮を目的として拡張機能化された。

定義文にてページ名の曖昧さ回避括弧は省く。なお、太字部分を自己参照リンクなどにしてはいけない。たとえば、[[Scratch]]の記事にて「'''[[Scratch]]'''はプログラミング言語である。」などは推奨されない。

== リンク ==
Wikiに記事があるからといって、すべての単語にリンクをしてはいけない。必要な場所のみ使用する。また、外部リンク(Scratch Wiki、Scratch、Wikipediaへのリンクを除く)は、外部リンク節以外に置かない。ただし以下は除く。

# 著作権の関係上置く必要があるとき
# 引用元を示すとき
# 記事の主体が外部サイトであるとき。例:[[Why!?プログラミング]]

== 見出し ==
見出しは短いほうがよい。また、見出しを追加すべき場合は以下のとおり。

# 関連項目、出典、外部リンク(あれば)
# 内容が大きく変わるとき

見出しにリンクや文字装飾を置くことは推奨されていない。(ただ、これがわかりやすい場合もある。)また、見出しに画像を含んではいけない。

== 現在 ==
現在、今などを単独で使用してはいけない。2018年7月現在などは良い。この規定は引用文に適用されない。

== 画像 ==
=== 場所と大きさ ===
画像は画面の右端に置くことを強く推奨する。また表示サイズは500pxを越えてはならない。ただし、横長の[[ナビゲーションバー]]などは、中央でも良い。また、ボタン、アイコン、絵文字などは、インライン表示してもいいが、25pxまでが限度である。

=== プロパティ ===
画像は基本的にファイルページ以外へのリンクにしてはいけない。ただし、意味のない画像、たとえば記号などはリンクなしでも良い。画像は500KB以下かつ1366x768px以下でないといけない。

== テンプレート ==
テンプレートを置く場所は基本的には[[ヘルプ:テンプレート一覧]]にあるものに従う。

== カテゴリ・言語間リンク ==
カテゴリはページの最下部に置く。

== ブロック ==
文中におく場合、およびリンクにする場合はsbタグ、スクリプトの場合はscratchblocksタグを使う。

[[en:Scratch Wiki:Editing Conventions]]