DokuWiki

It's better when it's simple

ユーザ用ツール

サイト用ツール


ja:interwiki

文書の過去の版を表示しています。


InterWiki リンク (Wiki 間リンク)

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

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

例:

[[wp>InterWiki]] InterWiki 英語 Wikipedia へのリンク
[[Meatball>InterWiki]] InterWiki MeatBall wiki InterWiki へのリンク
[[google>Wiki]] Wiki Google search へのリンク
[[doku>interwiki]] interwiki DokuWiki wiki へのリンク
[[this>feed.php]] feed.php <dokuwiki_data> へのリンク(DokuWiki がインストールされた Web サーバ上のディレクトリ)。この仕組みは相対リンクを作成する場合に利用できます。以下の例は常にその DokuWiki のXML フィードにリンクします: feed.php
注: The .htaccess file may tell the web server to refuse to serve certain files or directories in the <dokuwiki_data>-directory.

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

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

InterWiki ショートカットの設定

InterWiki ショートカットは2つのファイル内で定義されます:

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

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

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

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

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

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

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

ubuntu https://wiki.ubuntu.com/{NAME}

それから、以下のようにリンクを作成します:

[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]

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

InterWiki アイコンは、16×16ピクセルの大きさ・PNGまたはGIF形式・ショートカットと同じ名前である必要があります。

  • <dokuwiki_root>/lib/images/interwiki
    画像ファイルを置くディレクトリ

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

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

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

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

ja/interwiki.1373644944.txt.gz · 最終更新: 2013-07-12 18:02 by 125.55.214.60

特に明示されていない限り、本Wikiの内容は次のライセンスに従います: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki