DokuWiki

文書の過去の版を開いています。もしこのまま保存すると、この文書が最新となります。

====== InterWiki リンク (Wiki 間リンク) ======

InterWiki リンク (Wiki 間リンク) のもともとの考えは、インターネット全体で１つの巨大な分散管理された[[wpjp>ウィキ]]を構築するというものでした。
今では「ある Wiki から他の Wiki へ簡単な記法でリンクする機能」とその意味は変化しています。

[[ja:dokuwiki|DokuWiki]] の場合、Wiki の[[ja:pagename|ページ名]]の前にショートカット用の文字列と区切り文字として ''>'' を配置すると InterWiki リンクになります。

この例は、画像をクリックして、DokuWikiの data/media ディレクトリ内の任意のファイルにアクセスする方法です。
動画やPDFファイルに利用すると便利です。

[[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]

===== InterWiki ショートカットの設定 =====

InterWiki ショートカットは２つのファイル内で定義されます：
  * ''<dokuwiki_conf>/interwiki.conf'' ファイル\\ [[http://usemod.com/intermap.txt]] で提案されているすべてのショートカットを収録した、デフォルトの設定ファイルです。このファイルを直接編集することもできますが、この方法では DokuWiki のバージョンアップ時に独自の設定が上書きされてしまいます。. 
  * ''<dokuwiki_conf>/interwiki.local.conf'' ファイル\\ 独自の InterWiki リンクを追加するファイルです。バージョンアップ時の上書きを避けることができます。

InterWiki ショートカットは小文字である必要があり、[[ja:pagename|ページ名]]と同じルールに従う必要があります。

InterWiki の設定ファイルのフォーマットは以下のようになります：

<ショートカット>      <wiki の URL>

「ショートカット」が、設定後にリンク記法の中で利用する文字列となります。
「URL」の中では、より柔軟にリンクを行うためいくつかの置換文字列を利用することができます。
もし「URL」内に置換文字列が含まれない場合、リンク先としては設定ファイル内の「URL」の末尾に [[phpfn>rawurlencode|URL エンコード]]済みの Wiki ネームを追加したものが利用されます。
利用可能な置換文字列は以下の通りです：

^ 置換文字列 ^ 置換後 ^
| {URL}       | URL エンコードされた Wiki ネーム（置換文字列が指定されなかった場合に URL に追加されるのはこれです）  |
| {NAME}      | 何もエンコードされていない Wiki ネーム |
| {SCHEME}    | Wiki ネームとして URL が与えられた場合のスキーム部分 |
| {HOST}      | Wiki ネームとして URL が与えられた場合のホスト部分 |
| {PORT}      | Wiki ネームとして URL が与えられた場合のポート部分 |
| {PATH}      | Wiki ネームとして URL が与えられた場合のパス部分 |
| {QUERY}     | Wiki ネームとして URL が与えられた場合のクエリ部分 |

下の５つの置換文字列は、キャッシュシステムへの InterWiki リンクを作成する場合に便利です。
同梱されている ''interwiki.conf'' ファイルの ''coral'' というショートカットの設定を参照してください。
他の置換文字列の利用法も ''<dokuwiki_conf>/interwiki.conf'' ファイルにあります。
例えば [[https://wiki.ubuntu.com/|Ubuntu's wiki]] で "LaptopTestingTeam/ToshibaPortegeM700" のような名前空間とページ名を使用した場合、interwiki.local.conf ファイル内で置換文字列 {NAME} を使用しないと、リンク先で Not Found エラーが発生します。
スラッシュが %2F に URL エンコードされてしまうためです。
対策として conf/interwiki.local.conf ファイルに以下のような設定をします：
<code>ubuntu https://wiki.ubuntu.com/{NAME}</code>
それから、以下のようにリンクを作成します：
<code>[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]</code>

===== InterWiki ショートカットアイコンの設定 =====

InterWiki アイコンは、16×16ピクセルの大きさ・PNGまたはGIF形式・ショートカットと同じ名前である必要があります。
  * ''<dokuwiki_root>/lib/images/interwiki''\\ 画像ファイルを置くディレクトリ

アップロードしたアイコンの替わりにデフォルト画像がある場合、CSS ファイル同様 [[ja:caching|キャッシュされた]] PNG や GIF 画像を削除する必要があります。

<code>
rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}
</code>

CSS のキャッシュを無効にするのは、設定管理の再保存（「再保存」とは何も設定をへんこうすることなく設定管理の保存ボタンを押すこと）で実際には充分でしょう。

リンクアイコン表示を無効にするには、[[tips:disabling_link_icons|Disable Link Icons]] を見て下さい。

人間の証明として、ボックス内の全ての文字を入力してください。 U W F Y V この項目は空のままにして下さい：

編集の概要

注意：本ページを編集した場合、あなたの編集した内容が次のライセンスに従うことに同意したものとみなします： CC Attribution-Share Alike 4.0 International