MDC 記述者向けガイド

ページでスクリプト エラーが発生しました。編集者によって解決されるまでの間は、以下の部分的なコンテンツのみが表示可能です。

{{ MDCProjectPagesTOC() }}

この記述者向けガイドは、Mozilla Developer Center の "独自スタイル" です。厳密なルールセットというよりも、むしろ使いやすいガイドラインを意図していますので、厳密にこれに従う必要はありません。ただ、もし熱心なボランティアがあとからやって来て、あなたの作業をこのガイドラインにより合わせる形に編集しても、驚いた混乱したりしないでください。

当然ながら、このガイドは主として英語版の MDC に適用されます。日本語版については、MDC:記述者ガイド のほうも参考にしてください。 なお、日本語版内で、英語表記を利用する場合 (ほとんどの場合は英語版の文章そのままだと思いますが) は、下記のガイドを参考にしてください。

好ましいスタイルガイド

もし、ここで述べられていない使い方やスタイルについての疑問があれば、まずは エコノミスト誌のスタイルガイド (英語) もしくは、そこになければ シカゴのスタイルマニュアル を参照してください。

優先すべき辞書

スペルに関する質問は Answers.com での結果を参考にしてください。代替スペルは絶対に利用しないでください。(honor の代わりに honour を利用しないでください。)

このガイドをどんどん拡張していくつもりではありますが、このガイドに含まれない特定の事柄についての質問があれば、MDC メーリングリスト もしくは、プロジェクトリーダー まで何を追加すべきかを連絡してください。

ページ名と頭文字の大文字化

  • ページ名と節の見出しには、見出しに利用されるスタイルでの大文字化 (すべての単語の先頭文字を大文字化する) ではなく、文単位での大文字化 (最初の単語と固有名詞の先頭のみを大文字化) を利用してください。
    • <font color="green"></font>: "A new method for creating JavaScript rollovers"
    • <font color="red"></font>: "A New Method for Creating JavaScript Rollovers"
現在、ページ名についての大文字化ルールは新規ページにのみ適用されています。wiki 内には、かなりの数のこの規則に従わないページがありますが、現時点での修正は行わないでください。将来のどこかの時点で、それらの古くからあるページについて新しいページ名の決定を行います。よろしくお願いいたします。 -- dria 09:20, 14 March 2006 (PST)


ラテン略語

注釈と括弧

  • 一般的なラテン略語 (etc., i.e., e.g.) を挿入的な説明と注意書きの中で利用するでしょう。これらの略語ではピリオドを使ってください。
    • <font color="green"></font>: Web browsers (e.g. Firefox) can be used ...
    • <font color="red"></font>: Web browsers e.g. Firefox can be used ...
    • <font color="red"></font>: Web browsers, e.g. Firefox, can be used ...
    • <font color="red"></font>: Web browsers, (eg: Firefox) can be used ...

本文中

  • 通常の文章中 (ノートや注釈でない文章) では、略語と同義の英語を使ってください。
    • <font color="green"></font>: ... web browsers, and so on.
    • <font color="red"></font>: ... web browsers, etc.
    • <font color="green"></font>: Web browsers such as Firefox can be used ...
    • <font color="red"></font>: Web browsers e.g. Firefox can be used ...

ラテン略語に対応するラテン表記と英語表現

略語 ラテン語 英語
cf. confer compare
e.g. exempli gratia for example
et al. et alii and others
etc. et cetera and so forth, and so on
i.e. id est that is, in other words
N.B. nota bene note well
P.S. post scriptum postscript

注 : "e.g." と "i.e." の違いに注意してください。

頭字語と略語

大文字化とピリオド

  • "US" や "UN" などといった組織名を含む頭字語と略語では、全体を大文字にしてピリオドを除いてください。
    • <font color="green"></font>: XUL
    • <font color="red"></font>: X.U.L.; Xul

略語の展開

  • 文書ではじめに略語が出てくる際に、丸括弧囲みで説明を入れてください。
    • <font color="green"></font>: "XUL (XML User Interface Language) is Mozilla's XML-based language..."
    • <font color="red"></font>: "XUL is Mozilla's XML-based language..."
例外
  • 利用者にとってなじみのないであろう頭字語のみについて展開してください。もし、なじみがあるかどうかわからない場合は、展開してください。

頭字語や略語の複数形

  • 頭字語や略語が複数の場合は、s を追加してください。
    • <font color="green"></font>: CD-ROMs
    • <font color="red"></font>: CD-ROM's

短縮形

  • 短縮形 ("don't", "can't", "shouldn't" など) を利用するのは問題ありません。

複数形

  • 英語式の複数形を使い、ラテン語やギリシャ語での変形は使わないでください。
    • <font color="green"></font>: syllabuses, octopusses
    • <font color="red"></font>: syllabi, octopi

ハイフン付け

  • 接頭詞が母音で終わり、しかも続く語の先頭と同じ文字であるような複合語については、ハイフンを入れてください。
    • <font color="green"></font>: email, re-elect, co-op
    • <font color="red"></font>: e-mail, reelect, coop

数と数詞

日付の項目は変わるかもしれません。

日付

  • 日付は (コードサンプル中の日付は含まない) この書式を使います: January 1, 1990.
    • <font color="green"></font>: February 24, 2006
    • <font color="red"></font>: February 24th, 2006; 24 February, 2006; 24/02/2006
  • 代わりに、YYYY/MM/DD フォーマットを使うこともできます。
    • <font color="green"></font>: 2006/02/24
    • <font color="red"></font>: 02/24/2006; 24/02/2006; 02/24/06

10年 (decade)

  • 10 年 (年代) はこの書式を使います: 1990s.
    • <font color="green"></font>: 1990s
    • <font color="red"></font>: 1990's

数詞の複数形

  • 数詞の複数形には s を加えます。
    • <font color="green"></font>: 486s
    • <font color="red"></font>: 486's

コンマ

  • 本文では、コンマは 5 桁以上ある数字に使います。
    • <font color="green"></font>: 4000; 54,000
    • <font color="red"></font>: 4,000; 54000

句読点

シリアルコンマ

  • シリアルコンマを作ってください。シリアル ("Oxford" としても知られる) コンマとは、3 つ以上連続した項目での“and" の前に挿入するコンマのことです。
    • <font color="green"></font>: I will travel on trains, planes, and automobiles.
    • <font color="red"></font>: I will travel on trains, planes and automobiles.

つづり

  • 変異つづりを持っている単語は、Answers.com の最初のエントリを常に使ってください。変異つづりは使わないでください。
    • <font color="green"></font>: localize, honor
    • <font color="red"></font>: localise, honour

その他の資料

もし、文章作成や編集のスキルを向上させることに興味があるなら、以下の資料が参考になるでしょう。

{{ languages( { "en": "Project:en/Writer\'s_guide", "pl": "Project:pl/Przewodnik_dla_edytor\u00f3w" } ) }}

Document Tags and Contributors

タグ:
Contributors to this page: Taken, Okome, Shimono
最終更新者: Shimono,