MDC 用テンプレート

目次

  1. 1. 翻訳用テンプレート (日本語版独自)
    1. 1.1. Template:訳語
    2. 1.2. Template:原語併記
    3. 1.3. Template:訳注
  2. 2. ハイパーリンクの作成
    1. 2.1. Template:anch - アンカーへのリンク
    2. 2.2. Template:bug - bug-org へのリンク
    3. 2.3. Template:enter-bug - bug-org のバグ登録画面へのリンク
    4. 2.4. Template:ifmethod - メソッドへのリンク
    5. 2.5. Template:manch - メソッドへのリンク(ページ内)
    6. 2.6. Template:Interwiki
    7. 2.7. Template:LXRSearch - LXR 検索の短縮表示
    8. 2.8. Template:seealso_tag - タグ付けられた関連ページ
    9. 2.9. Template:source - ソースコードリンク
    10. 2.10. Template:source_cvs - ソースコードリンク(CVS)
    11. 2.11. Template:taggedsubpages - タグ付けられたサブページ
    12. 2.12. リファレンスの中のページへのリンク
  3. 3. ページをタギングする
    1. 3.1. Template:disambig - あいまい性除去
    2. 3.2. Template:outdated and Template:NeedsTechnicalReview - 時代遅れ・技術レビューが必要
    3. 3.3. Template:LockedPage - ロックされたページ
    4. 3.4. Template:deprecated_header, non-standard_header, obsolete_header - 非推奨バー・非標準バー・廃止バー
    5. 3.5. リファレンス/ガイド/チュートリアルにおいてページをタギングするテンプレート
  4. 4. 汎用テンプレート
    1. 4.1. Template:block-title - ブロックのタイトル
    2. 4.2. Template:Clr - 回り込み解除
    3. 4.3. Template:Note and Template:warning - 注記ブロック・警告ブロック
    4. 4.4. Template:ref and Template:endnote - 参照・ノート (脚注)
    5. 4.5. Template:deprecated_inline - 非推奨マーク
    6. 4.6. Template:non-standard_inline - 非標準マーク
    7. 4.7. Template:obsolete_inline - 廃止マーク
    8. 4.8. Template:unimplemented_inline - 未実装マーク
    9. 4.9. Template:Previous, Template:Next, and Template:PreviousNext - 前後の文書
  5. 5. バージョン情報テンプレート
  6. 6. 参照
目次
  1. 1. 翻訳用テンプレート (日本語版独自)
    1. 1.1. Template:訳語
    2. 1.2. Template:原語併記
    3. 1.3. Template:訳注
  2. 2. ハイパーリンクの作成
    1. 2.1. Template:anch - アンカーへのリンク
    2. 2.2. Template:bug - bug-org へのリンク
    3. 2.3. Template:enter-bug - bug-org のバグ登録画面へのリンク
    4. 2.4. Template:ifmethod - メソッドへのリンク
    5. 2.5. Template:manch - メソッドへのリンク(ページ内)
    6. 2.6. Template:Interwiki
    7. 2.7. Template:LXRSearch - LXR 検索の短縮表示
    8. 2.8. Template:seealso_tag - タグ付けられた関連ページ
    9. 2.9. Template:source - ソースコードリンク
    10. 2.10. Template:source_cvs - ソースコードリンク(CVS)
    11. 2.11. Template:taggedsubpages - タグ付けられたサブページ
    12. 2.12. リファレンスの中のページへのリンク
  3. 3. ページをタギングする
    1. 3.1. Template:disambig - あいまい性除去
    2. 3.2. Template:outdated and Template:NeedsTechnicalReview - 時代遅れ・技術レビューが必要
    3. 3.3. Template:LockedPage - ロックされたページ
    4. 3.4. Template:deprecated_header, non-standard_header, obsolete_header - 非推奨バー・非標準バー・廃止バー
    5. 3.5. リファレンス/ガイド/チュートリアルにおいてページをタギングするテンプレート
  4. 4. 汎用テンプレート
    1. 4.1. Template:block-title - ブロックのタイトル
    2. 4.2. Template:Clr - 回り込み解除
    3. 4.3. Template:Note and Template:warning - 注記ブロック・警告ブロック
    4. 4.4. Template:ref and Template:endnote - 参照・ノート (脚注)
    5. 4.5. Template:deprecated_inline - 非推奨マーク
    6. 4.6. Template:non-standard_inline - 非標準マーク
    7. 4.7. Template:obsolete_inline - 廃止マーク
    8. 4.8. Template:unimplemented_inline - 未実装マーク
    9. 4.9. Template:Previous, Template:Next, and Template:PreviousNext - 前後の文書
  5. 5. バージョン情報テンプレート
  6. 6. 参照

このページには MDC で使うために作られた汎用のテンプレート の一部が掲載されています。完全な一覧はこちらのページにあります。 それらすべての一覧はここにありません。

カスタム CSS クラスの一覧も見てください。

註: マイナス記号("-") を名前に含むテンプレートは特別な構文でなければなりません: {{template("template-name", [param1 [, ..., paramN])}}. なぜなら、マイナス記号は、テンプレート記述者の意図に反して、数学的な計算を行うことを意図しているとスクリプトエンジンに評価されるためです。
日本語版註: MediaWiki では、言語版毎にテンプレートページが用意されていましたが、DekiWiki では、1 ページで全言語共有、というシステムに変更されました。多言語での共有方法については多言語対応のためのテンプレートの定義方法(日本語版のみの草稿ページ)を参照してください。

翻訳用テンプレート (日本語版独自)

Template:訳語

これは訳した際に当てた日本語と元の英単語を対応させるテンプレートです。原語と訳語を積極的に対比させたい場合には Template:原語併記 を使ってください。使いかた : {{wiki.template('訳語', [ "日本語", "元の言語" ])}}。実際の表示 :

要素 を 活性化 する

今のところ、このテンプレートを元にした訳語の自動抽出などは行われていません。どの訳語を当てるかについてはMozilla 訳語決定会 が参考になります。

Template:原語併記

これは訳した際に当てた日本語と元の言語とを積極的に対比するためのテンプレートです。原語と訳語を関連づけたいだけなら Template:訳語 を使ってください。使いかた : {{wiki.template('原語併記', [ "日本語", "元の言語" ])}。実際の表示 :

ここで使われる XML は 妥当 (valid) である必要があります。

同じ目的で利用できる Template:Gengoheiki もあります。このテンプレートは {{template.Gengoheiki("日本語", "元の言語")}} という記述方法で使うことができます。

今のところ、このテンプレートを元にした訳語の自動抽出などは行われていません。どの訳語を当てるかについては Mozilla訳語決定会が参考になります。

Template:訳注

これは原文にない情報を補足するためのテンプレートです。訳者が補足としてコメントを残したい場合には Template:訳語を使ってください。使いかた : {{wiki.template('訳注', [ "補足内容" ])}}。実際の表示 :

Firefox は米国 Mozilla Foundation 【訳注: 日本支部は Mozilla japan】 の登録商標です。

同じ目的で利用できる Template:Yakuchu もあります。このテンプレートは {{template.Yakuchu("補足内容")}} という記述方法で使うことができます。

訳注中にリンクを記述したい場合は、{{web.link("URL", "リンクテキスト")}} (公式リファレンス) を単独で使うか、連結演算子で連結してください。

{{Yakuchu(web.link("http://example.jp","日本語訳"))}}

【訳注: 日本語訳】

{{Yakuchu("日本語特有の情報については、" .. web.link("http://example.jp","記事名") .. "に解説があります。")}}

【訳注: 日本語特有の情報については、記事名に解説があります。】

ハイパーリンクの作成

Template:anch - アンカーへのリンク

Template:anch はアンカーへのリンクを挿入します。 {{template.anch("top")}} は <a href="#top">top</a> (実際の表示 : top) を生成します。 このテンプレートではアンカー名と異なるリンク名の記述はできないことに注意してください。なぜなら、ドキュメント内の他のセクションに簡単にリンクを貼るためにこのテンプレートを作ったからです。

Template:bug - bug-org へのリンク

Template:bug の構文を使って bugzilla.mozilla.org の bug へのリンクを簡単に貼ることが可能になります: {{template.bug(123456)}}. 実際の表示 : bug 123456 .

Template:enter-bug - bug-org のバグ登録画面へのリンク

Template:enter-bug の構文を使って bugzilla.mozilla.org の特定のプロダクト・コンポーネントのバグ新規登録画面へのリンクを張ることができます。 たとえば、{{template.("enter-bug", ["Core","Layout"]}} は次のように表示されます : Core:Testing

Template:ifmethod - メソッドへのリンク

Template:ifmethod の構文を使って、インターフェースドキュメントのための標準書式 を用いて作成されたインタフェースの特定へのメソッドへのリンクを張ることができます。例えば、 {{template.ifmethod("nsIAutoCompleteSearch","stopSearch"}} は nsIAutoCompleteSearch.stopSearch() として表示されます。

Template:manch - メソッドへのリンク(ページ内)

Template:manch は現在のインターフェース内のメソッドへのリンクを挿入します。 これはインターフェースドキュメントのページでの利用のみを意図しています。 {{template.manch("foo")}} は<code><a href="current/path#foo">foo()</a></code> (foo()) を生成します.

Template:Interwiki

Template:Interwiki は Wiki 内部リンクを生成することを容易にします。現在 Wikipedia と Wikimo【訳注: wiki.mozilla.org】 へのリンクをサポートしています。最初の引数は Wiki の名前("wikipedia" もしくは "wikimo")で、2 番目の引数は記事へのパスです。例えば、 {{template.interwiki("wikipedia", "Firefox")}} は Firefox  として表示されます。このテンプレートはページの言語を自動判定し、Wikipedia の同じ言語版にリンクします。

Template:LXRSearch - LXR 検索の短縮表示

Template:LXRSearch を利用することで (ある程度面倒でない方法で) LXR 検索アドレスの URL を生成できます。構文は、{{LXRSearch|type|param|search-string|link-text}} のようになります。

パラメータは、次の意味を表します。

  • type は search (検索語によるソース内検索) 、find (ファイル名検索) もしくは ident (Mozilla ソース内のトークン名検索) の内の一つでなくてはなりません。
  • param は string (検索語・ファイル名検索) 、i (トークンによる検索) のいずれかでなくてはなりません。もし、テンプレートシステムに条件分岐命令があれば、これら二つ以外のパラメータは却下するでしょうけれど、条件分岐は利用できません。いつものように、拡張機能がここで動作してくれるでしょう。
  • search-string は、検索しようとするときに LXR の検索ボックスで入力する検索語になります。ただし、全ての空白は + に変換されるところが異なります。
  • link-text は作成したリンクを張るのに利用する文章です。

Template:seealso_tag - タグ付けられた関連ページ

Template:seealso_tag は特定のタグでタグ付けられた記事の箇条書きリストを挿入します。これは "See also" セクションで潜在的に関連する記事を一覧化することを容易にします。

Template:source - ソースコードリンク

Template:source は、長い LXR の URL を入力することなく Mozilla のソースコードへのリンクを作成できます。たとえば、 {{template.source("browser/Makefile.in)"}} のように。 このように記述することで、 browser/Makefile.in と表示されます。 リンクで表示されるテキストは与えられたパスそのものになります。テキストに何か他の物を表示したい場合は、2 番目の引数を指定してください。{{template.source("browser/Makefile.in", "the browser/ Makefile.in")}} のようにすると、 the browser/ Makefile.in と表示されます。

Template:source_cvs - ソースコードリンク(CVS)

Template:Source_cvs works just like Template:source, except it links to the CVS repository instead of the newer mozilla-central one.

Template:taggedsubpages - タグ付けられたサブページ

Template:taggedsubpages テンプレートは特定のタグを持つページのサブページの箇条書きリストを挿入します。例: {{template.taggedsubpages("foo")}}

リファレンスの中のページへのリンク

ページをタギングする

これらのテンプレートは、ページの最初に配置するために利用できます(ただし、以下の breadcrumbs は、除きます)。 いくつかのテンプレートは、セクションの最初でも利用できます。

Template:disambig - あいまい性除去

Template:disambig は、あいまい性除去のためのページで利用されています。

Template:outdated and Template:NeedsTechnicalReview - 時代遅れ・技術レビューが必要

このテンプレートは、ひどく時代遅れであるということがわかっている(あるいは、そうかもしれない)ページで利用できます。通常、古いページが mozilla.org から MDC に移行されたときに利用されます。

このテンプレートは、オプションの引数によって詳細を追加できます。例:{{template.outdated("最終更新は、1999 年です。")}} は、以下のように表示されます。

Warning: この記事の内容は古くなっている可能性があります。 最終更新は、1999 年です。

同様のテンプレートの、Template:NeedsTechnicalReview は、筆者または編集者が読んだものや書いたものが技術的に正しいかどうか確証を持てず、どうしようもない場合に利用できます。 {{template.NeedsTechnicalReview()}} の結果は次にようになります。: このページは編集者または閲覧者により、技術レビューの必要があると判断されました。全体のレビューが終わるまで、不正確あるいは誤った情報を含む可能性があります。

Template:LockedPage - ロックされたページ

Template:LockedPage は、ページがロックされた理由の説明を提供する、目立つバーを挿入します。2 つの引数があります:1 番目は、ページがロックされる期間、2 番目は、ロックされた理由です。そのページのノートページへのリンクも囲みの中に含まれます。

This page is marked as protected permanently for the following reason: constant spamming.
Please discuss changes that need to be made on the Talk page.

Template:deprecated_header, non-standard_header, obsolete_header - 非推奨バー・非標準バー・廃止バー

Template:deprecated_header は、ページの内容の利用は非推奨であることを示す、目立つバーをページに表示させます。例えば、公式に非推奨とされている関数、メソッドやプロパティなどです。 非推奨のバーは、通常、メインページタイトルの直下に配置されます(もしくは、パンくずナビゲーションが存在すれば、その直下)。使い方: {{template.deprecated_header()}}. 実際の表示:

非推奨

同様に、Template:non-standard_header と Template:obsolete_header は、非標準、あるいは、廃止機能を強調させるために使われます。 使い方: {{non-standard_header}} または {{template.obsolete_header()}}。実際の表示:

非標準

廃止

リファレンス/ガイド/チュートリアルにおいてページをタギングするテンプレート

(DOM リファレンス のような)ページの膨大なコレクションのほぼそれぞれに数多くのテンプレートがあります。これらは、普通、リファレンス/ガイド/チュートリアルのメインページに戻るリンクです(これは、頻繁に必要とされます。なぜなら、我々の breadcrumbs はこのように動作しないからです)。また、記事を特定のカテゴリに入れます。

例: Template:DomRef, Template:CSSRef, Template:jsapi ref header, ... (当然、大文字小文字の不一致は、問題となります)

汎用テンプレート

Template:block-title - ブロックのタイトル

Template:block-title は、記事の一部分に対するタイトルを分かりやすく示すために、太字で表示されます。自動生成される内容一覧には現れませんが、他のタイトルと同じようにリンクターゲットとしては振舞うことができます。{{block-title|タイトル}} のように記述し、タイトル はタイトルをつけた部分へのリンク先として振舞います。Template:block-title は、Template:sidenote や表、画像、コードブロックといった、それ自体から離れたところで参照されるような部分にタイトルをつけるときに利用することを想定しています。

Template:Clr - 回り込み解除

Template:Clr は <br style="clear:both;" /> を挿入するテンプレートで、続く文章をフロートしている画像や図の下に配置するために利用します。利用方法は {{Clr}} です。

  • このテンプレートはページ全体のレイアウトにも影響を与える可能性があることに注意してください。たとえば、既定のスキンにおけるナビゲーションパネルは、左側にフロートするように設定されています。このため、{{template.Clr()}} より後の全てがナビゲーションパネルより下に配置されることになります。

Template:Note and Template:warning - 注記ブロック・警告ブロック

[Template:Note]] は、特別に整形された「注記」ブロックを記事のテキストに挿入します。このテンプレートは、興味深い、もしくは、重要な事実を付記することが目的です。[MDC:Custom CSS Classes#Notes| "ノート" CSS クラス]] を利用しています。クラスを直接利用する代わりにテンプレートを使用することで、注記の見た目により多くの変更をより簡単に行うことが可能になります。使い方: {{template.Note("これは重要な注記です。")}}. 実際の表示:

註: これは重要な注記です。

同様に、Template:warning 特別に整形された「警告」ブロックを挿入します。{{template.warning("Danger, Will Robinson!")}} 実際の表示:

Warning: Danger, Will Robinson!

見ての通り、警告ブロックは、大きなアイコンを含んでいて、記事の冒頭で現在利用されています(Template:outdated 由来)。 代わりに div class="warning" を利用したくなるかもしれません。

Template:ref and Template:endnote - 参照・ノート (脚注)

Template:ref と Template:endnote は記事についての脚注を記述するために利用します。脚注 "番号" は、{{ref("something")}} という形で指定でき、something は脚注がつく部分の適切な説明を入れます。そして、文書の最後に、以下のような脚注の中身が記述された番号付のリストを挿入します。

# {{endnote("something")}} Blah blah, 一つ目の脚注
# {{endnote("something-else")}} 二つ目の脚注
# ...

Template:deprecated_inline - 非推奨マーク

Template:deprecated_inline は公式には非推奨となっている、関数やメソッドあるいはプロパティなどの使用を防ぐためにインラインの非推奨であることを示すマークを挿入します。 使いかた : {{template.deprecated_inline()}}。 実際の表示 :

  • 項目 1
  • 項目 2 非推奨
  • 項目 3

Template:non-standard_inline - 非標準マーク

Template:non-standard_inline は標準化されていない関数やメソッド、プロパティあるいは属性などの使用を防ぐために、インラインの非標準であることを示すマークを挿入します。使いかた : {{template.non-standard_inline()}}。実際の表示 :

  • アイテム 1
  • アイテム 2 非標準
  • アイテム 3

Template:obsolete_inline - 廃止マーク

Template:obsolete_inline は公式に廃止されている関数やメソッドあるいはプロパティなどの使用を防ぐために、インラインの廃止されていることを示すマークを挿入します。使いかた : {{template.obsolete_inline()}}。実際の表示 :

  • 項目 1
  • 項目 2 廃止
  • 項目 3

Template:unimplemented_inline - 未実装マーク

Template:unimplemented_inline はまだ実装されていない関数やメソッドあるいはプロパティの使用を防ぐために、インラインの "未実装" マークを挿入します。
使い方: {{template.unimplemented_inline()}}. 実際の表示:

  • Item 1
  • Item 2 未実装
  • Item 3

Template:Previous, Template:Next, and Template:PreviousNext - 前後の文書

Template:Previous、Template:Next、そして Template:PreviousNext は一連の記事のどこに現在の記事が位置しているかを表現します。片側向きのものについては、必要なパラメータは一つで、次もしくは前の記事を指定します。PreviousNext については、二つのパラメータが必要で、一つ目が前の記事、二つ目が次の記事を示します。

バージョン情報テンプレート

参照

Tags (3)

タグを編集

Attachments (0)

 

添付ファイル