マークアップ早見表

提供: WIKI_force2
2016年9月18日 (日) 17:48時点におけるNima (トーク | 投稿記録)による版

(差分) ←前の版 | 最新版 (差分) | 次の版→ (差分)
移動: 案内, 検索

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

目次

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

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

早見表

種類 入力方法 表示例
本文のどこでも有効
斜字体 ''弱い強調'' 弱い強調
太字 '''強調''' 強調
太字＋斜字体 '''''強い強調''''' 強い強調
マークアップを無効に （wiki と HTML 両方） <nowiki><li> も ''マークアップ''されません</nowiki> <li> も ''マークアップ''されません
他言語 Codex へのリンク （本文・要約欄） [[:en:英語版のページ名]]
[[:en:英語版のページ名#節名|リンクテキスト]] 		en:英語版のページ名
リンクテキスト
言語間リンク
（本文の最下部に書く） 		[[en:英語版のページ名]]
[[de:独語版のページ名]] 		（サイドバーに表示されます）
他プロジェクトへのリンク
（インターウィキ） 		[[wikipedia:ja:マルチバイト文字]]
[[wikipedia:ja:マルチバイト文字|マルチバイト文字（ウィキペディア）]]
[[jaforum:forum/9|ドキュメンテーションフォーラム]]
[[jaforum:topic/155|リンクテキスト]] 		wikipedia:ja:マルチバイト文字
マルチバイト文字（ウィキペディア）
ドキュメンテーションフォーラム
リンクテキスト
外部リンク [http://example.org]
[http://example.org リンクテキスト]
http://example.org 		[1]
リンクテキスト
http://example.org
画像 [[Image:Example.jpg|alt テキスト]]
[[Image:Example.jpg|配置|thumb|100px|キャプション]] 		（注） サムネイルは、実際にページ内で初めてサムネイルが表示されるときに、マークアップで指定したサイズで生成されます。サイズ指定を変えると変更後のサイズでもう一つサムネイルが作られます。
カテゴリ
（本文と言語間リンクの間に書く） 		{{DEFAULTSORT:はやみひよう}}
[[Category:Codex ヘルプ|*はやみひよう]]
[[Category:MediaWiki]] 		（ページ最下部のカテゴリの欄に表示されます。
ソートキーの指定により、「Codex ヘルプ」カテゴリページでは「*」の項に、その他のカテゴリでは「は」の項に、50音順で掲載されます。）
テンプレート {{テンプレート名|変数}}
{{:標準名前空間のページ名}} （先頭にコロン）
{{subst:テンプレート名}} （テンプレートの中身をペースト）
[[Template:テンプレート名]] （テンプレートページにリンク） 		→ 利用できるテンプレートと表示例も参照
署名 （談話室・ノートで使用） ~~~~
--~~~~ 		利用者名 20xx年x月xx日 (金) 00:00 (UTC)
--利用者名 20xx年x月xx日 (金) 00:00 (UTC)
リダイレクト（転送） #REDIRECT [[記事名]] （ページ表示時に「記事名」のページに自動転送されます）
コメントアウト <!-- コメントアウトしたいテキスト --> （コメントアウトしたテキストはサイト表示時に見えません。HTMLソースには出ます）
使える HTMLタグ <code>、<span>、<div>、<p>、<pre>、<blockquote> など
マジックワード（変数） （目次の強制表示／非表示、各種変数など）
条件文
脚注 <ref>脚注の文章</ref>
<ref name="参照名">脚注の文章</ref>
<ref name="参照名" />

（脚注表示部分）
== 脚注 ==
<reference />

ブロック要素の整形 - 行頭でのみ有効
段落

間に空の1行を入れます。
（空行）
すると、次の段落になります。

間に空の1行を入れます。

すると、次の段落になります。

テキストのインデント（字下げ）
注： 談話室やノートでのみ使用 		:テキストのインデント     テキストのインデント
見出し

==見出し 2==
===見出し 3===
====見出し 4====
=====見出し 5=====
======見出し 6======

（目次は見出し4つ以上で自動生成。強制表示／非表示も可能）

（左記は <h2>～<h6> に相当。ページ名が h1 なので本文では h2 から使うこと。）

水平線

----

箇条書き（番号なし）

* いち
* に
* さん
** さん の いち
** さん の に
  • いち
  • に
  • さん
    • さん の いち
    • さん の に
箇条書き（番号あり）

# いち
# に<br />採番を崩さずに<br />複数行書く
# さん
## さん の いち
## さん の に
  1. いち
  2. に
    採番を崩さずに
    複数行書く
  3. さん
    1. さん の いち
    2. さん の に
箇条書き 番号あり／なし混在

# いち
# に
#* さん の いち
#* さん の に
  1. いち
  2. に
    • さん の いち
    • さん の に
定義リスト

;いち
:いちの説明 1
:いちの説明 2
;に
:にの説明
いち
いちの説明 1
いちの説明 2
に
にの説明
整形済みテキスト

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

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

コード表示

種類 入力方法 表示例
インライン <code>the_content()</code> the_content()
インライン （実体参照） <code><nowiki><li></nowiki></code> <li>
ブロック （行頭1字空け）  <?php
     the_content();
 ?> 
<?php
    the_content();
 ?>
（注）Wikiマークアップや本文内で利用できるHTMLタグは有効（本文と同様に変換して表示）。
ブロック （<pre> タグ利用） <pre>
<p><?php the_title(); ?></p>
</pre> 
<p><?php the_title(); ?></p>
（注）Wikiマークアップや本文内で利用できるHTMLタグは無効（書いたとおりに表示）。コード内の <pre> タグは <nowiki> で囲む必要あり。

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

用意されている CSS

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

種類 入力方法 表示例
出力例

<p class="example">出力例</p>

出力例

重要な段落

<p class="important">重要な段落</p>

重要な段落

重要なブロック

<div class="important">重要なブロック
* 箇条書き
* など
</div>

重要なブロック
  • 箇条書き
  • など
注目ラベル <span class="attn">注目</span> 注目
表の装飾

罫線（この表で使っているもの） 

{| 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=""> <span id=""> について：

この項はたいてい作業済みです。翻訳ページを自分で作成する場合も、後日慣れた人が必要に応じて作業するので読み飛ばして構いません。

あるページから別のページへの節へ直接リンクしていることがあり、見出しを和訳するだけだとリンク切れしてしまいます（和訳しようとしているページは直リンクされる側なので、普通は気づけません）。上述の id は、このリンク切れ防止のために入れています。 

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

id の英語節名は、通常は、スペースがアンダーバー（_）に置き換わるだけです。括弧など id 属性に使えない文字が含まれるときは、英文の目次のリンク URL を参考にしてください。

（注） これは暫定サイトから実験的に行なってきた方法で、現在は id 付けに慣れた人が作業しています。しかし、作業者が替わると負担が大きいかもしれません。参加者で検討して、使いやすいように変えていってください。リンク切れに気づいたときに直す、でもよいかと思います。

↑ 早見表に戻る

カテゴリ

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

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

{{DEFAULTSORT:てんふれえとにゆうもん}}
[[Category:デザインとレイアウト]]
[[Category:テンプレート]]
カテゴリ名
日本語版ではカテゴリ名を日本語にしています。英語版を翻訳用にコピーしたときや日本語で新規ページを作成するときは、カテゴリ名対応表を参照してください。
{{DEFAULTSORT:}}
デフォルトソートキー（ソートキーの一括指定）
ソートキー
カテゴリページで索引を正しい位置に表示するためのものです。
{{DEFAULTSORT:}} で一括指定しても Categoryタグ毎に指定しても構いません。
ソートキーには通常、ページ名を濁点・長音・促音等なしの平仮名で表したものを記入します。ソートキーを書かないと、カテゴリページで「テ」「日」のようにページ名の頭文字で分類されます。
テンプレートタグ・関数の各ページは、その関数名（先頭大文字）としてください。（例） {{DEFAULTSORT:The_content}}

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

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

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

関連資料：

↑ 早見表に戻る

リンク

サイト内のページへのリンク 

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

（詳細） 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 では自動的にアンダーバー（_）に変換されます。ただし、テンプレートタグや関数名などがページ名に使われている場合は、その部分をアンダーバーにしてください。

（詳細）

↑ 早見表に戻る

言語間リンク

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

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

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

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

コピー時： 

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

書き換え後： 

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

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

（詳細）

↑ 早見表に戻る

英語版から他言語版への言語間リンク

英語版ではまだ（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|日本語フォーラム » テキストエディタ： 問題なく使えるもの、使ってはいけないもの]]

表示例：

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

↑ 早見表に戻る

英語版と異なるマークアップ

%%% とコードブロック

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

スタイルシートの外部定義化

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

言語間リンク

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

↑ 早見表に戻る

その他の資料

en:Help:Editing en:Codex:Styles

「http://www.iforce.co.jp/mediawiki/index.php?title=%E3%83%9E%E3%83%BC%E3%82%AF%E3%82%A2%E3%83%83%E3%83%97%E6%97%A9%E8%A6%8B%E8%A1%A8&oldid=513」から取得
個人用ツール
名前空間

変種
操作
メニュー
管理
参考情報(CTRL+)
ツール