マークアップ早見表

2016年9月18日 (日) 17:48時点における最新版

テンプレート:Codex 編集ガイド

WIKI_force2で利用できるマークアップの早見表と解説です。記述する位置関係で迷ったら日本語Codex のページ構造を参照。

太字・リンク・署名などといったよく使うマークアップは、編集欄の上に並んだクイックタグが利用できます。練習は sandbox にて。

整形済みテキストは
各行頭を1スペース
空けて書く

[編集] コード表示

<?php
    the_content();
 ?>

<p><?php the_title(); ?></p>

（参考） コードブロックの書き方の注意点

[編集] 用意されている CSS

英語版では本文の中に CSS が埋め込まれていますが、日本語版ではよく使われるスタイルを外部 CSS ファイルに定義済みです。style="～" の部分（例えば style="padding: 10px; width: 50%; border:solid 1px blue"）を class="example" のようにに置き換えられます。表示結果は同じです。

{| class="border"
|-
（後略）
|}

[編集] 解説

[編集] 日本語Codex のページ構造

1ページ全体の構造は次のようになります。

<div id="英語節名"> -- リンク切れ予防の英字id（オプション）
== 日本語節名 1 ==    -- 見出し（翻訳時は日本語に）
</div>

本文
～～～
～～～

<div id="英語節名">
== 日本語節名 2 ==
</div>

本文
～～～
～～～

== 変更履歴 ==   -- WordPress のあるバージョンから仕様が変わった場合に設ける
* [[Version 3.x|3.x]] : 変更内容
* [[Version 2.x|2.x]] : 変更内容

{{原文|英語版ページ名|版番号}} -- 最新英語版・差分表示用リンク 

{{DEFAULTSORT:ソートキー名}}   -- カテゴリのソートキー
[[Category:カテゴリ名]]        -- カテゴリ（翻訳時は日本語カテゴリ名に書き換える）
[[Category:wp2.x]]             -- 仕様が変わった場合、WordPress メジャーバージョン

[[en:英語版ページ名]]          -- 言語間リンク
[[fr:仏語版ページ名]]
...

• カテゴリはページの最下部に表示される。
• 言語間リンクはサイドバーに表示される。

↑ 早見表に戻る

[編集] 目次

ページ内の目次は、見出しが4つ以上になると、自動的に先頭の見出し位置に生成されます。強制表示や位置指定するには __TOC__ と書きます。

[編集] 見出し

ページ名が <h1> なので、本文内の見出しは <h2> 以下を使います。

翻訳下準備済みページには、見出しの前後にリンク切れ防止の <div>タグや <span>タグが付いていることがあります。この部分はいじらず、== 英語節名 == の部分を和訳してください。

<div id="英語節名">
== 英語節名 ==
</div>

== 英語節名 <span id="英語節名"> ==

自ページ内の節へのリンク（[[#節名]]）は、id="英語節名" が入っていれば [[#英語節名]] のままでもリンク切れしません。

<div id="英語節名">
== 日本語節名 ==
</div>

↑ 早見表に戻る

[編集] カテゴリ

Codex では各ページをカテゴリで分類しています。編集欄に Categoryタグを書くと、ページの最下部のカテゴリ欄にそのカテゴリページへのリンクが表示されます（表示例）。カテゴリページでは、そのカテゴリに属するページの一覧が見られます。
なお、Categoryタグは本文と言語間リンクの間に置いてください（ページ構造参照）。

（例1） 「テンプレート入門」ページのカテゴリの書き方

{{DEFAULTSORT:てんふれえとにゆうもん}}
[[Category:デザインとレイアウト]]
[[Category:テンプレート]]

カテゴリ名

日本語版ではカテゴリ名を日本語にしています。英語版を翻訳用にコピーしたときや日本語で新規ページを作成するときは、カテゴリ名対応表を参照してください。

{{DEFAULTSORT:}}

デフォルトソートキー（ソートキーの一括指定）

ソートキー

カテゴリページで索引を正しい位置に表示するためのものです。

{{DEFAULTSORT:}} で一括指定しても Categoryタグ毎に指定しても構いません。

ソートキーには通常、ページ名を濁点・長音・促音等なしの平仮名で表したものを記入します。ソートキーを書かないと、カテゴリページで「テ」「日」のようにページ名の頭文字で分類されます。

テンプレートタグ・関数の各ページは、その関数名（先頭大文字）としてください。（例） {{DEFAULTSORT:The_content}}

（例2） ソートキーの書き方

{{DEFAULTSORT:はやみひよう}}
[[Category:Codex ヘルプ|*はやみひよう]]
[[Category:MediaWiki]]

デフォルトソートキーの指定により「Codex ヘルプ」カテゴリページでは「*」の項に、その他のカテゴリページでは「は」の項に、50音順で掲載されます。

関連資料：

• カテゴリ名対応表 -- 日英 Codex カテゴリ名対応表
• カテゴリツリー -- カテゴリの階層をツリー表示
• 当サイトのカテゴリ一覧
• MediaWikiヘルプ » カテゴリ -- コンテンツのカテゴリ分けの方法、カテゴリページへのリンクの書き方
• Wikipediaヘルプ » カテゴリ

↑ 早見表に戻る

[編集] リンク

[編集] サイト内のページへのリンク

[[ページ名]]

[[ページ名|表示テキスト]]

（詳細） MediaWikiヘルプ » リンク - 内部リンク

↑ 早見表に戻る

[編集] 特定の節へのリンク

同ページ内の節へのリンク：

[[#節名|表示テキスト]]

節名は、その節の見出しテキストです。（目次のリンクなどに使われる URLエンコードの文字列ではありません）

他ページの節へのリンク：

[[ページ名#節名|表示テキスト]]

（詳細） MediaWikiヘルプ » リンク - 内部リンク

↑ 早見表に戻る

[編集] 他言語 Codex へのリンク

本文や要約欄において、英語版 Codex やその他の言語の Codex のページにリンクするときに使います。

（注） 先頭にコロン（:）が必要です。コロンがないと言語間リンクとなります。

[[:en:Template Tags]]
[[:en:Template Tags|]]
[[:en:Template Tags/the_excerpt|]]
[[:en:Template Tags|表示テキスト]]

en:Template Tags
Template Tags
Template Tags/the_excerpt
表示テキスト

単語間はスペースで書きます。リンクURI では自動的にアンダーバー（_）に変換されます。ただし、テンプレートタグや関数名などがページ名に使われている場合は、その部分をアンダーバーにしてください。

（詳細）

• Multilingual Codex - Codex in other Languages
• MediaWikiヘルプ » リンク - 言語間リンク

↑ 早見表に戻る

[編集] 言語間リンク

サイドバーの一番下に他言語サイトへのリンクとして表示されます。編集欄の最下部（カテゴリの下）に入れてください。プレビューで表示を確認できます。

[[en:英語版ページ名]]
[[de:ドイツ語版のページ名]]
[[fr:フランス語版のページ名]]

Codex では、英語版への言語間リンクを一番上に書きます。

翻訳用に英語版をコピーしてきたときは、英語版独自の書式から書式に書き換えます。

コピー時：

{{Languages|
{{en|英語版ページ名}}
{{fr|仏語版ページ名}}
{{ja|対応する日本語ページ名}}
{{zh-ch|中国語版ページ名}}
}}

書き換え後：

[[en:英語版ページ名]]
[[fr:仏語版ページ名]]
[[zh-hans:中国語版ページ名]]

（注） zh-ch は zh-hans に書き換える。

（詳細）

• Multilingual Codex - Codex in other Languages
• MediaWikiヘルプ » リンク - 言語間リンク

↑ 早見表に戻る

[編集] 英語版から他言語版への言語間リンク

英語版ではまだ（MediaWiki の）言語間リンクの設定がなされていないため、Wikiテンプレートで代用しています（en:Multilingual Codex を参照）。

英語版から日本語版にリンクするには、英語版の本文の一番上に、次のように挿入します。

{{Languages|
{{en|英語版ページ名}}
{{ja|対応する日本語ページ名}}
}}

他言語版へのリンクが既に記入されているときは、接頭辞のアルファベット順となる位置に挿入します。

{{Languages|
{{en|英語版ページ名}}
{{fr|仏語版ページ名}}
{{ja|対応する日本語ページ名}}
{{zh-hans|中国語版ページ名}}
}}

↑ 早見表に戻る

[編集] 最新英語版・差分表示リンク

原文・最新版の参照、著作権表記、日本語版と最新版との違い（差分）を見るためのリンクを兼ねています。記事下部、本文とカテゴリの間に挿入します。

{{原文|原文のページ名|作業した原文の版番号}}

表示例： 「the_excerpt」の左下

ファイル:Edit-new-link.png

• 版番号 -- 原文の「履歴」（history）ページで、作業対象の版のの日付にポインタを当てる（またはクリック）と、URI に「oldid=54364」というように番号が付いています。この数字が版番号です。
• 最新版との差分は、作業直後は最新版×最新版の比較となるため違いがありませんが、原文が更新されると差分が表示されるようになります。

↑ 早見表に戻る

[編集] 他プロジェクトへのリンク

一般のウェブサイトへのリンクは上記早見表の「外部リンク」のように書きますが、ウィキペディアや日本語フォーラム等、記事中によく登場するサイトへはインターウィキの書き方でリンクできます。

• Wikipedia（日本語版）： [[Wikipedia:ja:ページ名]]
• Wikipedia（英語版）： [[Wikipedia:ページ名]]
• MediaWiki： [[mediawikiwiki:ページ名]]
• WordPress 日本語フォーラム： [[jaforum:ドメイン部分以外の URI]]

[[Wikipedia:ja:WordPress]]
[[Wikipedia:ja:WordPress|ウィキペディア » WordPress]]
[[Wikipedia:WordPress]]
[[mediawikiwiki:Manual:Interwiki/ja]]
[[jaforum:forum/9|ドキュメンテーションフォーラム]]
[[jaforum:topic/155]]
[[jaforum:topic/155|日本語フォーラム » テキストエディタ： 問題なく使えるもの、使ってはいけないもの]]

表示例：

↑ 早見表に戻る

[編集] 英語版と異なるマークアップ

[編集] %%% とコードブロック

テンプレートタグなどのコード表示に %%% というマークアップが使われていますが、これは英語版サイト独自の設定によるものです。日本語版では、%%% の替わりに、行頭1文字を空けるか <pre>～</pre> で囲んでください（詳細）。

[編集] スタイルシートの外部定義化

（参照）用意されている CSS

[編集] 言語間リンク

（参照） 英語版から他言語版への言語間リンク

↑ 早見表に戻る

[編集] その他の資料

• ヘルプ

en:Help:Editing en:Codex:Styles