差分

このページの2つのバージョン間の差分を表示します。

--- ja:interwiki [2009-12-05 14:39] – created kazmiya
+++ ja:interwiki [2014-02-08 04:35] – s.sahara
@@ 行 1: / 行 1: @@
 ====== InterWiki リンク (Wiki 間リンク) ======
-InterWiki リンク (Wiki 間リンク) のもともとの考えは、インターネット全体で 1 つの巨大な分散管理された Wiki を構築するというものでした。今日においては、その意味は「ある Wiki から他の Wiki へ簡単な記法でリンクする機能」へと変化しています。
+InterWiki リンク (Wiki 間リンク) のもともとの考えは、インターネット全体で１つの巨大な分散管理された[[wpjp>ウィキ]]を構築するというものでした。
+今では「ある Wiki から他の Wiki へ簡単な記法でリンクする機能」とその意味は変化しています。
-[[:ja:dokuwiki|DokuWiki]] においては、ショートカット作成用の文字列の後に ''>'' を置き、その後に Wiki の[[:ja:pagenames|ページ名]]を置くと InterWiki リンクとなります。
+[[ja:dokuwiki|DokuWiki]] の場合、Wiki の[[ja:pagename|ページ名]]の前にショートカット用の文字列と区切り文字として ''>'' を配置すると InterWiki リンクになります。
-以下に使用例を示します。
+例：
+| %%[[wp>InterWiki]]%%         | [[wp>InterWiki]]  | 英語 Wikipedia へのリンク |
+| %%[[phpfn>random]]%%         | [[phpfn>random]] | PHP 関数マニュアルへのリンク  |
+| %%[[google>Wiki]]%%          | [[google>Wiki]] | Google search へのリンク  |
+| %%[[doku>interwiki]]%%       | [[doku>interwiki]] | DokuWiki wiki へのリンク  |
+|    |    |
+| %%[[this>feed.php]]%%        | [[this>feed.php]] | ''<dokuwiki_data>'' へのリンク（DokuWiki がインストールされた Web サーバ上のディレクトリ）。この仕組みは相対リンクを作成に利用できます。以下の例は常にその DokuWiki の[[ja:syndication|XML フィード]]にリンクします: [[this>feed.php]]\\ **''注：''** The ''.htaccess'' file may tell the web server to refuse to serve certain files or directories in the ''<dokuwiki_data>''-directory.  |
-  [[wp>Wiki]] は Wikipedia の Wiki の項目にリンクします。
+この例は、画像をクリックして、DokuWikiの data/media ディレクトリ内の任意のファイルにアクセスする方法です。
-  [[Meatball>TourBusStop]] は MeatBall Wiki の TourBusStop のページにリンクします。
+動画やPDFファイルに利用すると便利です。
-  [[google>Wiki]] は Google で "Wiki" を検索するページにリンクします。
-  [[doku>ja:interwiki]] は DokuWiki 公式サイトの ja:interwiki (このページ) にリンクします。
-出力結果は以下のようになります。
+  [[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]
-[[wp>Wiki]] は Wikipedia の Wiki の項目にリンクします。[[Meatball>TourBusStop]] は MeatBall Wiki の TourBusStop のページにリンクします。[[google>Wiki]] は Google で "Wiki" を検索するページにリンクします。[[doku>ja:interwiki]] は DokuWiki 公式サイトの ja:interwiki (このページ) にリンクします。
-また、特別な InterWiki ショートカットとして、**''this''** というものがあります。これは常に DokuWiki がインストールされた Web サーバ上のディレクトリにリンクします。この仕組みは相対リンクを作成する場合に利用できます。例えば、以下の InterWiki リンクは常にその DokuWiki の [[:ja:syndication|XML フィード]]にリンクします (実際の例: [[this>feed.php]])。
-  [[this>feed.php]]
-InterWiki に関するより詳しい情報は、以下のページを参照してください。
-  * [[wp>InterWiki]] (Wikipedia)
-  * [[MeatBall>InterWiki]] (MeatBall)
-  * [[Wiki>InterWiki]] (c2.com Wiki)
 ===== InterWiki ショートカットの設定 =====
-InterWiki ショートカットは ''conf/interwiki.conf'' ファイル内で定義されます。デフォルトの設定ファイルには [[http://usemod.com/intermap.txt]] で提案されているすべてのショートカットを収録しています。もし独自の InterWiki ショートカットを追加する場合は、まず ''conf/interwiki.local.conf'' というファイルを作成してそこにショートカットの設定を追加するようにしてください。こうすることで DokuWiki をバージョンアップする際に独自の InterWiki ショートカットが上書きされるのを避けることができます。
+InterWiki ショートカットは２つのファイル内で定義されます：
+  * ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/interwiki.conf|<dokuwiki_conf>/interwiki.conf]]'' ファイル\\ デフォルトの設定ファイルあり、有益と思われるショートカットを含んでいます（より多くのショーカット例は、[[http://usemod.com/intermap.txt]] を参照してください）。このファイルは DokuWiki のバージョンアップ時に上書きされるので、このファイルに独自の設定を加えるのは避けましょう。
+  * ''<dokuwiki_conf>/interwiki.local.conf'' ファイル\\ 独自の InterWiki リンク定義を追加するファイルです。バージョンアップ時にも上書きされず、独自の設定を維持できます。
-''conf/interwiki.conf'' ファイルを直接編集して設定することもできますが、この方法では DokuWiki のバージョンアップ時に独自の設定が上書きされてしまいます。
+InterWiki ショートカットは小文字である必要があり、[[ja:pagename|ページ名]]と同じルールに従う必要があります。
-InterWiki ショートカットと同じ名前の画像ファイルを ''lib/images/interwiki'' ディレクトリに設置しておくと、デフォルトのリンクアイコンの代わりにその InterWiki ショートカット専用のリンクアイコンを使用することができます。この画像ファイルは 16x16 ピクセルの PNG もしくは GIF 画像である必要があります。画像ファイルを設置したのにリンクアイコンが変わらない場合は、まず[[:ja:caching|キャッシュを削除]]してみてください。
+InterWiki の設定ファイルのフォーマットは以下のようになります：
-InterWiki ショートカットに利用できる文字は[[:ja:pagename|ページ名]]で利用できる文字と同じルールに従います。小文字である必要があります。
+  <ショートカット>      <wiki の URL>
-InterWiki の設定ファイルのフォーマットは以下のようになります。
+「ショートカット」が、設定後にリンク記法の中で利用する文字列となります。
+「URL」の中では、より柔軟にリンクを行うためいくつかの置換文字列を利用することができます。
+もし「URL」内に置換文字列が含まれない場合、リンク先としては設定ファイル内の「URL」の末尾に [[phpfn>rawurlencode|URL エンコード]]済みの Wiki ネームを追加したものが利用されます。
+利用可能な置換文字列は以下の通りです：
-  <ショートカット>  <URL>
+^ 置換文字列 ^ 置換後 ^
+| {URL}       | URL エンコードされた Wiki ネーム（置換文字列が指定されなかった場合に URL に追加されるのはこれです）  |
+| {NAME}      | 何もエンコードされていない Wiki ネーム |
+| {SCHEME}    | Wiki ネームとして URL が与えられた場合のスキーム部分 |
+| {HOST}      | Wiki ネームとして URL が与えられた場合のホスト部分 |
+| {PORT}      | Wiki ネームとして URL が与えられた場合のポート部分 |
+| {PATH}      | Wiki ネームとして URL が与えられた場合のパス部分 |
+| {QUERY}     | Wiki ネームとして URL が与えられた場合のクエリ部分 |
-上記の「ショートカット」が、設定後にリンク記法の中で利用する文字列となります。上記の「URL」の中では、より柔軟にリンクを行うためいくつかの置換文字列を利用することができます。もし「URL」内に置換文字列が含まれない場合、リンク先としては、設定ファイル内の「URL」の末尾に [[phpfn>rawurlencode|URL エンコード]]済みの Wiki ネーム (リンク記法で指定されたページ名) を追加したものが利用されます。利用可能な置換文字列は以下の通りです。
+下の５つの置換文字列は、キャッシュシステムへの InterWiki リンクを作成する場合に便利です。
+同梱されている ''interwiki.conf'' ファイルの ''coral'' というショートカットの設定を参照してください。
+他の置換文字列の利用法も ''<dokuwiki_conf>/interwiki.conf'' ファイルにあります。
-^ 置換文字列       ^ 置換後 ^
+例えば [[https://wiki.ubuntu.com/|Ubuntu's wiki]] で "LaptopTestingTeam/ToshibaPortegeM700" のような名前空間とページ名を使用した場合、スラッシュが %2F に URL エンコードされてしまうために、リンク先で Not Found エラーが発生します。この対策として、InterWiki ショートカットを定義するときに 置換文字列 {NAME} を使用します。具体的には、conf/interwiki.local.conf ファイルで 以下のように設定します：
-| ''%%{URL}%%''    | URL エンコードされた Wiki ネーム (置換文字列が指定されなかった場合に URL に追加されるのはこれです) |
+<code>ubuntu https://wiki.ubuntu.com/{NAME}</code>
-| ''%%{NAME}%%''   | 何もエンコードされていない Wiki ネーム |
+このように定義すると、以下のようなやり方で InterWiki リンクを作成できます：
-| ''%%{SCHEME}%%'' | Wiki ネームとして URL が与えられた場合のスキーム部分 |
+<code>[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]</code>
-| ''%%{HOST}%%''   | Wiki ネームとして URL が与えられた場合のホスト部分 |
-| ''%%{PORT}%%''   | Wiki ネームとして URL が与えられた場合のポート部分 |
-| ''%%{PATH}%%''   | Wiki ネームとして URL が与えられた場合のパス部分 |
-| ''%%{QUERY}%%''  | Wiki ネームとして URL が与えられた場合のクエリ部分 |
-下から 5 つの置換文字列は、インターネットアーカイブや Google キャッシュなどへの InterWiki リンクを作成する場合に便利です。DokuWiki に添付されている ''conf/interwiki.conf'' ファイルの ''coral'' というショートカットの設定を参照してください。その他の置換文字列の利用法についても、''confi/interwiki.conf'' ファイルが参考になります。
+===== InterWiki ショートカットアイコンの設定 =====
-例えば [[https://wiki.ubuntu.com/|Ubuntu Team Wiki]] の "LaptopTestingTeam/ToshibaPortegeM700" という、名前空間とページ名がスラッシュ (/) で区切られたページにリンクする場合、''conf/interwiki.local.conf'' ファイル内で置換文字列 ''%%{NAME}%%'' を使用しないと、リンク先で Not Found エラーが出てしまいます。これはスラッシュが ''%2F'' に URL エンコードされてしまうためです。対処策としては、''conf/interwiki.local.conf'' ファイルに以下のような ''%%{NAME}%%'' を使用した設定を行うこととなります。
+InterWiki アイコンは、16×16ピクセルの大きさ・PNGまたはGIF形式・ショートカットと同じ名前である必要があります。
+  * ''<dokuwiki_root>/lib/images/interwiki''\\ 画像ファイルを置くディレクトリ
-<code>ubuntu  https://wiki.ubuntu.com/{NAME}</code>
+デフォルトアイコンをアップロードしたファイルで置き換えた場合、CSS ファイル同様 [[ja:caching|キャッシュされた]] PNG や GIF 画像を削除する必要があります。
-こうしておくと、以下のようにして Ubuntu の Wiki への InterWiki リンクを作成することができます。
+<code>
+rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}
+</code>
-<code>[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]</code>
+キャッシュされたファイルを無効化する別の簡便な方法として、設定管理の再保存（「再保存」とは何も設定を変更せずに設定管理の保存ボタンを押すこと）があります。
+リンクアイコン表示を無効にするには、[[tips:disabling_link_icons|Disable Link Icons]] を見て下さい。