Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

User:Bono/Links to other languages

要英訳

WordPress Codex の各ページから各言語版の(翻訳)ページを見に行けるように、Wikipedia や MediaWiki のサイトのような「言語間リンク」がほしい。 現在は、Codex のトップページにしか他言語版へのリンクが載っていない。

他プロジェクトで実際に使われている方法には次の2種類があるが、MediaWiki の標準機能を使って簡単にリンクできて、他MediaWikiサイト・英語版サイト内・他システム(WP等)のどこにでもリンクできる、方法1 がよいのではないか?

1: Interlanguage link
Wikipedia で使っている方法。例: Wikipedia » Languages
MediaWiki 標準機能。
他言語の prefix とサイトの URI を MediaWiki のテーブルに登録しておいて、各ページに [[その言語のiw_prefix:その言語のページ名]] を書くと、サイドバーにリンクが現れる。
他言語ページが他サイトにあっても codex.wp.org 内でも OK。ページ名が本家と違っても OK。
方法2: テンプレート利用・自動リンク生成 (たぶん×)
翻訳ページが存在する言語リンクだけが自動的に現れる方法。
例: MediaWiki 下部の「Languages:」
Template:Languages のようなテンプレートを作っておき、「ページ/ja」のように、言語名のサブページを作って翻訳。
ページ存在チェックを利用したテンプレートで実現しているので、他言語ページは、少なくとも同サイト内にある必要がある。ページ名も同じじゃないとダメかも。WP は独自サイトを設けている言語が多いので、現状には合わない。
方法3: Linking with Wiki Templates
{{ja|Japanese Article Name}} でリンクできるようにする。リンクは記事内に出る。
  • {{ja}} --> 日本語
  • {{ja|テンプレートタグ}} --> 日本語
  • {{ja|テンプレートタグ|テンプレートタグ}} --> 日本語テンプレートタグ

Interlanguage Link

手順

  1. 各言語版の URI をリストアップ (codex.wordpress.org) --
  2. 上記1 のデータを interwiki テーブルに追加 (codex.wordpress.org, 各言語版サイト)
  3. Codex の各ページに Interwiki Link を追加 --
    実際には、各言語版の担当者が英語版に言語間リンクを追加 -> それを自言語サイトにコピー&ペースト

各言語版 Codex

Codex トップページの「Translations:」と WordPress in Your Language から、実際にドキュメントサイトのある言語をピックアップしてみた。下記のような表を codex.wordpress.org のどこかに用意しておいて、各言語版の担当者に URI を記入してもらうとよいかも。

  • iw_prefix -- MediaWiki の languages/Names.php の言語セレクタと合わせる。
  • $1 -- URL の中の各ページに固有の部分
interwiki table
Language iw_prefix iw_url iw_local iw_trans
Dansk (Danish) da (*1) http://codex.wordpress.org/da:$1 0 0
Deutsch (German) de http://doku.wordpress-deutschland.org/$1 0 0
English en http://codex.wordpress.org/$1 0 0
Español (Spanish) es (*1) http://codex.wordpress.org/es:$1 0 0
Français (French) fr (*1) http://codex.wordpress.org/fr:$1 0 0
עברית (Hebrew) he http://docs.wp.trans.co.il/index.php?title=$1 0 0
Magyar (Hungarian) hu http://dokumentacio.word-press.hu/$1 0 0
Bahasa Indonesia (Indonesian) id http://id.wordpress.net/codex/$1 0 0
Italiano (Italian) it http://www.wordpress-it.it/wiki/Main/$1 0 0
日本語 (Japanese) ja http://wpdocs.sourceforge.jp/$1 1 0
한국어 (Korean) ko http://wordpress.co.kr/codex/$1 0 0
Nederlands (Dutch) nl http://nl.wordpress.net/documentatie/artikelen/$1.html 0 0
Русский (Russian) ru http://codex.wordpress.org/$1 0 0
ไทย (Thai) th http://codex.wordthai.com/$1 0 0
Tiếng Việt (Vietnamese) vi (*1) http://codex.wordpress.org/vi:$1 0 0
中文 ((Zhōng Wén) - Chinese) zh ? http://codex.wordpress.org.cn/$1 0 0
台灣 (Chinese (Taiwan)) zh-tw (*1) http://codex.wptw.org/$1 or http://codex.wordpress.org/tc:$1 ? 0 0
  • Need to check by translators.
  • (*1) es や fr のように、英語版Codex 内に接頭辞付きページ名でドキュメントを作っている言語の場合、interwiki テーブルにデータを追加した途端、サイト内リンクとして [[prefix:ページ名]] と書いていた箇所が全て「言語間リンク」として扱われてしまう。サイト内リンクは [[:prefix:ページ名]] に書き換える必要がある(手修正か、一旦エクスポート・一括置換・インポートする等)。


言語間リンクの書き方

リンク先が MediaWiki のページの場合:

[[iw_prefix:その言語のページ名]]

リンク先が MediaWiki ではない場合:

[[iw_prefix:リンク先ページの URI の $1 に当たる部分]]

Note:

  • 言語間リンクのコードは各ページの一番下(カテゴリの下)に入れる。(Wikipedia に倣って)
  • 英語版では、リンク表示順の統一と挿入時に迷わないようにするため、並び順を決めておくとよい。
    例)言語名の発音順/iw_prefix順/WPの言語コード順、等。例えば Wikipedia では、日本語は ni の位置。
  • MediaWiki の skin を自作している場合、skin に言語間リンクを表示するコードが入っているかを確認(skins/MonoBook.php ファイルの "otherlanguages" section のような)。これがないと表示されない。

Example: Main Page

表示例: Main Page

コード:

[[en:Main Page]]
[[da:Hovedside]]
[[de:Hauptseite]]
[[es:Main Page]]
[[fr:Accueil]]
[[he:עמוד ראשי]]
[[hu:WordPress Codex]]
[[id:Halaman Utama]]
[[it:Home Page]]
[[ko:Main Page]]
[[ru:Заглавная страница]]
[[zh:首页]]
[[zh-tw:首頁]]

Example: Installing WordPress

表示例: Installing WordPress

コード:

[[en:Installing WordPress]]
[[es:Installing WordPress]]
[[da:Installering af WordPress]]
[[de:5 Minuten Installation]]
[[fr:Installer WordPress]]
[[ko:Installing WordPress]]
[[nl:installatie]]
[[ru:Installing WordPress]]

3: Linking with Wiki Templates

Wiki テンプレートを利用して {{ja|Japanese Article Name}} や {{fr|French Article Name}} と書くだけでリンクできるようにする。リンクは記事内に表示される(ページの一番上か下に置く)。

Example: Main Page

{{Languages|
... 
• {{fr|Accueil}}
• ... 
• {{ja}} 
• ... 
}}

Example: "Template Tags" page

{{Languages|
... 
• {{fr|Marqueurs de Modele}}
• ... 
• {{ja|テンプレートタグ}} 
• ... 
}}


Codex:Creating a New Page - Translating the WordPress Codex の書き方:

==Translations of This Article==
* ... 
* {{fr|Marqueurs de Modele|Marqueurs de Modele (French)}}
* ... 
* {{ja|テンプレートタグ}} 
* ... 

Translations of This Article

  • ...
  • 日本語テンプレートタグ (Japanese)
  • ...

(翻訳ページが増えると縦長になるから、インラインに並べるかサイドバーがいいと思う)