提交: fd334432e7a345ef0cbb3b35852f4631a246d7fb - pukiwiki (git)

Commit MetaInfo

• 修訂: fd334432e7a345ef0cbb3b35852f4631a246d7fb (tree)
• 時間: 2007-02-14 00:40:14
• 作者: henoheno <henoheno>
• Commiter: henoheno

Log Message

$autolink

Change Summary

• modified: doc/SETTING.txt

差異

--- a/doc/SETTING.txt
+++ b/doc/SETTING.txt
@@ -1,5 +1,5 @@
 PukiWiki SETTING
-$Id: SETTING.txt,v 1.17 2007/02/13 15:02:05 henoheno Exp $
+$Id: SETTING.txt,v 1.18 2007/02/13 15:40:14 henoheno Exp $
 
 
 設定の調整とカスタマイズ
@@ -405,11 +405,12 @@ PHP
         報が管理者にメールで通知されます。
 
     変数 $nowikiname
-        WikiWordに対するハイパーリンク自動生成機構を _無効に_ します。
+        WikiName(WikiWord)に対するハイパーリンク自動生成機構を _無効に_ し
+        ます。
 
         通常は、テキストの中に「大文字で始まる英単語が二つ以上連結した文字
-        列(これらを "WikiWord" と呼びます)」があった場合、そのページに対す
-        るハイパーリンクが生成されます。
+        列("WikiName" ないし "WikiWord" と呼びます)」があった場合、そのペー
+        ジに対するハイパーリンクが生成されます。
 
         例えば UpperCamelCase という単語があると、そこに "UpperCamelCase"
         というページに対するハイパーリンクが装飾されます。そのページがまだ
@@ -417,9 +418,34 @@ PHP
 
         この機構は、Wikiユーザーに話題の分割(新しいページの作成または閲覧)
         を促します。しかし、利用方法によってはこの機構が邪魔に思える事があ
-        るかもしれません。この設定を有効にする事で、WikiWordに対するハイパ
+        るかもしれません。この設定を有効にする事で、WikiNameに対するハイパ
         ーリンクの生成を止めさせることができます。
 
+    変数 $autolink
+        AutoLink と呼んでいる機構、つまり既存のページに対するハイパーリンク
+        自動生成機構を _有効に_ します。
+
+        通常は WikiName や、 「[[ と ]] で囲んだ文字列("BrackerName"と呼ん
+        でいます)」がテキストにあった場合に、初めてそのページへのハイパー
+        リンクがその場所に生成されるため、ハイパーリンクを駆使したい場合、
+        書き手がこの仕組みを意識する必要があります。
+
+        しかし AutoLink が有効であったなら、既存の(ページの)ページ名が自動
+        的にハイパーリンク生成の対象になるため、要所を除き、書いた文書の中
+        に自動的に(もし合致するページがあれば)ハイパーリンクが出現します。
+
+        この機構は非常に便利ですが、ページを出力したり、ページを更新する時
+        のサーバー負荷を高める原因になります。
+
+        1. 設定としては、「AutoLinkの対象とする既存ページ名の最低限の長さ」
+          をバイト数(例えば8)で指定します。この値は十分に大きな数字であるべ
+          きです。この値が例えば 1であり、"e" という(1バイトの)ページが存在
+          する場合、全てのページに含まれる e という文字に、 "e" というペー
+          ジへのハイパーリンクが修飾される可能性があります!
+
+        2. また、ページ数が増大するにつれ AutoLinkの対象が増えるため、更新
+          時の処理、および出力時の負荷が増大します。
+
 
 設定の修正
     PukiWikiの管理者パスワードは、pukiwiki.ini.php にある変数 $adminpass