DokuWiki

It's better when it's simple

ユーザ用ツール

サイト用ツール


ja:interwiki

差分

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

この比較画面へのリンク

次のリビジョン
前のリビジョン
ja:interwiki [2009-12-05 14:39] – created kazmiyaja:interwiki [2014-02-08 14:34] (現在) s.sahara
行 1: 行 1:
- 
 ====== InterWiki リンク (Wiki 間リンク) ====== ====== InterWiki リンク (Wiki 間リンク) ======
  
-InterWiki リンク (Wiki 間リンク) のもともとの考えは、インターネット全体で つの巨大な分散管理された 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]]\\ **注:** ''<dokuwiki_data>''ディレクトリ内へのアクセス可否を決める要因には、ウェブサーバー側の制約(''.htaccess'' ファイルに記述内容)もあることに注意しましょう。  |
  
-  [[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 ショートカットの設定 =====
  
-InterWiki ショートカットは ''conf/interwiki.conf'' ファイル内で定義されます。デフォルトの設定ファイルは [[http://usemod.com/intermap.txt]] で提案されているすべてのショートカット収録していますもし独自の InterWiki ショトカ場合ず ''conf/interwiki.local.conf'' というファイルを作成してそこにショートカット定を追加するようにしてくださいこうすることで DokuWiki をバージョンアップする際独自の InterWiki ショートカットが上書きされのを避けることができます。 +InterWiki ショートカットは2つのファイル内で定義されます: 
 +  * ''[[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 ネーム (リンク記法で指されたページ名) 追加たものが利用れます利用可能な置換文字列は以下す。+5つ置換文字列は、キャッシュシステムへの 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]] を見て下さい。
ja/interwiki.1260020370.txt.gz · 最終更新: 2009-12-05 14:39 by kazmiya

特に明示されていない限り、本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