OSDN Git Service

merged 3.3 beta1
[nucleus-jp/nucleus-jp-ancient.git] / utf8 / nucleus / documentation / help.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja-JP" xml:lang="ja-JP">
3 <head>
4         <!-- $Id: help.html,v 1.8 2006-07-12 07:11:46 kimitake Exp $ -->
5         <!-- $NucleusJP: help.html,v 1.7.2.1 2005/09/09 07:34:11 kimitake Exp $ -->
6
7         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8         <title>Nucleus管理用ヘルプ</title>
9         <style type="text/css">
10         <!--
11                 body {
12                         font-family: verdana, arial;
13                         font-size: small;
14                 }
15
16                 h1 {
17                         font-size: large;
18                         border-bottom: 1px gray dashed;
19                         color: #596d9d;
20                         text-align: left;
21                 }
22
23                 h2 {
24                         font-size: medium;
25                         border: 1px solid #ddd;
26                         background-color: whitesmoke;
27                         text-align: left;
28                 }
29
30                 .page {
31                         height: 800px;
32                         text-align: justify;
33                         margin-bottom: 100px;
34                 }
35
36                 pre {
37                         background-color: #ddd;
38                         padding: 5px;
39                         font-size: small;
40                 }
41
42                 .example {
43                         background-color: #ddd;
44                         padding: 5px;
45                 }
46
47                 ul.templates {
48                         font-size: x-small;
49                         line-height: 1.1;
50                         list-style: none;
51                         text-indent: -20px;
52                         margin-left: 20px;
53                 }
54
55                 ul {
56                         text-align: left;
57                 }
58
59                 a:link, a:visited {
60                         color: #1D3565;
61                         font-weight: bold;
62                         text-decoration: underline;
63                 }
64
65                 a:hover {
66                         background-color: whitesmoke;
67                 }
68
69                 .deprecated {
70                         border: 3px solid red;
71                         padding: 5px;
72                         font-size: medium;
73                 }
74
75                 tt, code {
76                         font-size: small;
77                 }
78
79                 table {
80                         border: 1px solid #ccc;
81                 }
82
83                 th {
84                         background-color: #eee;
85                 }
86
87                 td {
88                         vertical-align: top;
89                 }
90
91                 .note {
92                         background-color: #eee;
93                         padding: 5px;
94                 }
95         -->
96         </style>
97 </head>
98 <body>
99
100 <div class="page">
101 <h1>Nucleusポップアップ・ヘルプ</h1>
102 <p>ページがダウンロードされている間はお待ちください(だいたい100KBです)。</p>
103 </div>
104
105
106 <div class="page">
107 <a name="future"></a>
108 <a name="allowpastposting"></a>
109 <h1>後で追加/過去に投稿</h1>
110 <h2>後で追加</h2>
111 <p>アイテム追加フォームの「後で追加」オプションにより、アイテムを指定した時間きっかりに公開することができます。その時が来るまで、アイテムはサイトの公開された部分で見られる事がありません。</p>
112 <p>この日時は<strong>未来のものでなくてはなりません</strong>。アイテムを追加するblogの「過去の日時での投稿を許可する」オプションが有効である場合は除いて。</p>
113 <h2>過去の日時での投稿を許可する</h2>
114 <p>有効にすると、アイテムが追加された日時を指定できます。加えて、既に存在するアイテムのタイムスタンプ(投稿日時)を編集できます。</p>
115 </div>
116
117 <div class="page"><a name="changedate"></a>
118 <h1>投稿日時の変更</h1>
119 <p>
120 「タイムスタンプを更新」オプションにより、アイテムの投稿された日付か時間あるいはその両方を変更できます。もしアイテムの内容を変更したのなら、この方法で記事をフロントページのトップに戻せるでしょう。</p>
121 <p>しかし、そのアイテム独自のIDは変更されません。よって訪問者は、そのアイテムはもともとより低いID値のアイテム群より後に投稿されたことに気がつくことができます。</p>
122 </div>
123
124
125 <div class="page"><a name="draft"></a>
126 <h1>ドラフト(Drafts)</h1>
127 <p>ドラフト状態のアイテムはblogの公開されたところではまだみることができません。記事を書いている時役に立つでしょうし、多少の間を取るにもいいでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間のあるときに作業を再開することが可能です。</p>
128 <p>ドラフトを編集する際、「<strong>今すぐ追加</strong>」のラジオボタンを選び「保存」ボタンを押すと公開されます。</p>
129 </div>
130
131 <div class="page"><a name="extended"></a>
132 <h1>「続き」部分</h1>
133 <p>アイテムには、記事を続けるために用いられるオプションである「続き」部分があります。例えば、記事がblogのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。メインのblogページを閲覧すると、「続きを読む」というリンクを目にすることでしょう。(テンプレートによってリンクの形は定義されます)</p>
134 <p>もし、導入をアイテムの単なる<em>概略</em>として書きたいのなら、<a href="#templatevar-smartbody">smartbody</a>というテンプレート変数を用いて、「本文」と「続き」の表示を分けることが可能です。
135 </p>
136 </div>
137
138 <div class="page"><a name="shortblogname"></a>
139 <h1>Blogの短縮名</h1>
140 <p>「Blogの短縮名」は主に管理領域で、どのアイテムがどのblogと結びついているのか示すために使われます。</p>
141 <p>また、新規blogを有効にするための代替indexファイルでも用いられます(以下はmyshortblognameが「Blogの短縮名」だった場合の呼び出しファイルの例):</p>
142 <pre>
143 &lt;?
144         include('./config.php');
145         selectBlog('myshortblogname');
146         selector();
147 ?&gt;
148 </pre>
149 </div>
150
151 <div class="page"><a name="blogdefaultskin"></a>
152 <h1>標準のスキン</h1>
153 <p>blogごとの「設定」で選択された「標準のスキン」はそのblogが表示されるときに用いられるスキンです。選択できるのは一つだけです。(URLの引数を通して別のスキンで表示させることはできます)</p>
154 </div>
155
156
157 <div class="page"><a name="blognotify"></a>
158 <h1>通知するメールアドレス</h1>
159 <p>このオプションは、新しくコメントが追加された際に通知するメールアドレスを一つあるいは複数いれるものです。もし通知が不要なら空っぽにしておいてください。メールアドレスは、あたりまえですが、有効なものでなくてはなりません。</p>
160 <p>もし複数のメールアドレスを利用する場合は、セミコロン(<strong>;</strong>)で区切ってください。</p>
161 <div class="note">
162 <b>注意:</b>設定フィールドの最大長は128文字です。リスト可能なメールアドレスの量はそれによってのみ制限されます</div>
163 <div class="note">
164 <b>注意:</b>メンバー登録に使われているメールアドレスを通知先にした場合、自身で書いたのアイテムとコメントの通知を受け取ることはありません。自分で書いたことは知っているはずですから、問題にはならないでしょう。</div>
165 </div>
166
167 <div class="page"><a name="blogmaxcomments"></a>
168 <h1>コメントの最大量</h1>
169 <p><em>メインページ</em>に表示するコメントの最大数です。<strong>これはコメント可能な最大数を制限するものではありません</strong>。詳細のページでは、設定した最大数を超えていても全てのコメントが表示されます。</p>
170 <p class="note"><strong>注意:</strong>テンプレート内部では、テンプレート変数<a href="#templatevar-comments">comments</a>のオプションパラメーターによってここでの値は上書きされます。</p>
171 </div>
172
173 <div class="page"><a name="blogtimeoffset"></a>
174 <h1>サーバ時刻との時差</h1>
175 <p>もしサーバの時刻があなたの生活時刻と一致しなければ、正確な時間を得る為にサーバ時刻との時差を加えたいかもしれません。減らすためには負の値を用いてください(マイナス記号をつける)。参照するために現在のサーバ時刻が表示されています。</p>
176 <h2>実例</h2>
177 <p>もしローカル時刻が20:35で表示されているサーバ時刻が14:35であった場合、blogの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定する必要があります。</p>
178 <p class="note"><strong>注意:</strong>30分時差のあるタイムゾーンに住む人々のための、分刻みの時差補正もまた同様です。例えば「サーバ時刻との時差」を<strong>1.5</strong>にすると、1時間30分の補正となります。</p>
179 </div>
180
181 <div class="page"><a name="blogupdatefile"></a>
182 <h1>自動更新するファイル</h1>
183 <p>Nucleusはblogに新しいアイテムが追加されるたびに、ファイルを更新することができます。そのファイルの中身は最終変更時のタイムスタイプとなります。このようなファイルは、定期的に更新が無いかみるためにサーバ上のファイルをチェックして、そこから「weblogの更新状況」を作成するサービスに使うことができます。これらをメインblogに用た特徴は、訪問者がコメントを追加したりスキンやテンプレートに変更を加えたりしたときには更新を知らせることが無いということです。</p>
184 <p>自動更新されるファイルが必要ないときは、フィールドを空っぽにしておいてください。</p>
185 <p>自動更新されるファイルの場所は管理領域からの相対となることにご注意ください。なので、(<tt>/path/to/your/website/update.txt</tt> のような)絶対パスを使う方がよいでしょう。また自動更新されるファイルを作成してかつ書き込めるように(<a href="tips.html#filepermissions" onclick="window.open(this.href);return false;" class="out" title="quick guide on changing file permissions">パーミッションを0666</a>に)してください。</p>
186 </div>
187
188 <div class="page"><a name="teamadmin"></a>
189 <h1>Blogの管理者</h1>
190 <p>
191 Blogの管理者は次のような追加権限をもちます:
192 </p>
193
194 <ul>
195         <li>チームの操作</li>
196         <li>blog設定の変更</li>
197         <li>(該当blogの) どの投稿者のアイテムでも編集と削除が可能</li>
198         <li>blogの削除</li>
199 </ul>
200
201 <p>一つのblogは複数の管理者を持つことができます。ただし、いつでも最低一人の管理者がいなくてはなりません。</p>
202 </div>
203
204
205 <div class="page"><a name="superadmin"></a>
206 <h1>管理者の特権</h1>
207
208 <p><em>super-admin(最高管理者)</em>と呼ばれ、全ての機能と全てのweblogに<strong>フルアクセス</strong>できます。たとえblogのチームに入っていなくてもです。</p>
209
210 <p>それに加えて:super-adminは、weblogの作成、一般設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作(メンバーの作成/編集/削除)を行う権限があります。</p>
211
212 <p>普通、super-adminとなるのはサイトの管理者ただ一人でしょう。</p>
213
214 </div>
215
216 <div class="page"><a name="canlogin"></a>
217 <h1>管理者領域へのログイン</h1>
218 <p><a href="#superadmin" title="Administrator Privileges">super-admin</a>はそれぞれのメンバーの管理領域へのログインを許可しないよう設定できます。</p>
219 </div>
220
221 <div class="page"><a name="defaultblog"></a>
222 <h1>既定のBlog</h1>
223 <p>他のblogが要求時に指定されない場合、表示されるblogです。</p>
224 </div>
225
226 <div class="page"><a name="baseskin"></a>
227 <h1>基本のスキン</h1>
228 <p>このオプションは、判定が自動解決されない場合に代用するスキンをNucleusに設定します。これはスキン・パーツが空っぽだったり、blogやskinで明確に指定されていないときにおきます。</p>
229 <p>ほとんどのユーザーは、この設定を気にする必要がありません。</p>
230 </div>
231
232 <div class="page"><a name="cookies"></a>
233 <h1>Cookie設定</h1>
234
235 <h2>ログインCookieの有効期間</h2>
236 <p>メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、いつ無効になるか決定されます:</p>
237 <ul>
238         <li><strong>セッションごと</strong> ? ブラウザを終了させるとcookieは削除されます</li>
239         <li><strong>一ヶ月</strong> ? 一ヶ月続けてサイトか管理領域を訪れないということが無い限り、cookieはコンピュータに残ります。このオプションを使えば、たぶん再ログインする必要はなくなるでしょう。(自分でログアウトしたときや、他のコンピュータからログインするときは別ですが)</li>
240 </ul>
241
242 <h2>CookieパスとCookieドメイン</h2>
243 <p>これらは上級の設定です。通常は変更する必要はありません。その場合、cookieパスは単純にスラッシュ('/')を入れ、cookieドメインは空っぽにしておいてください。</p>
244
245 <h2>セキュアCookie</h2>
246 <p>通常は「いいえ」に設定してください。HTTPSのurlを用いておりかつhttps接続を通してのみcookieを送りたい場合でだけ、「はい」にしなければなりません。</p>
247
248 <h2>最終訪問日時Cookieの保存</h2>
249 <p>訪問者が最後に訪れた時間をcookieに含め保存させるよう、Nucleusを設定することが可能です。これによって、<a href="#templatenew">新規アイテム</a>の隣にしるしを置くことができます。</p>
250
251 </div>
252
253
254 <div class="page"><a name="language"></a>
255 <h1>言語</h1>
256 <p>個々のメンバー用のコンテンツをnucleusが作成するときに用いられる言語を選択することができます。Nucleusによって生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。</p>
257
258 <p>言語の選択を行う場所は二ヶ所あります。「一般設定」にはデフォルトで用いられる「既定の言語」が含まれています。次にログイン状態のメンバーは、望むならこの設定を上書きできます。</p>
259
260 <p>これら両方の設定が無効なら、英語がデフォルトの言語として用いられます</p>
261
262 <p class="note"><strong>注意:</strong> 追加の言語ファイルは<a href="http://www.nucleuscms.org/" onclick="window.open(this.href);return false;" class="out" title="Nucleus CMS Website">Nucleusのウェブサイト</a>からダウンロードできます。(新規ウィンドウが開きます)</p>
263
264 </div>
265
266 <div class="page"><a name="allowaccountcreation"></a>
267 <h1>アカウントの作成</h1>
268 <p>訪問者に自身のメンバーアカウント作成を許可するようにも許可しないようにもできます。新規メンバーは(管理者がチームに加えるまでは)blogにアイテムを追加することはできません。しかし、管理領域にログインして設定を変更できます。また自分のコメントを削除したり変更したりも可能です。</p>
269 </div>
270
271 <div class="page"><a name="allownewmemberlogin"></a>
272 <h1>新規メンバーのログイン許可</h1>
273 <p>もし訪問者による<a href="#allowaccountcreation">アカウントの作成</a>を許可するなら、この設定はその方法で作られたアカウントが<a href="#canlogin">管理領域にログイン</a>できるか否かを明確に定めます。</p>
274 </div>
275
276
277 <div class="page"><a name="messageservice"></a>
278 <h1>メッセージサービス</h1>
279
280 <p>メンバーのプライバシーのために、全てのメールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージにはどっちにしろ両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。</p>
281
282 <h2>メンバー以外</h2>
283 <p>デフォルトでは、非メンバーはメッセージサービスを使えません。なぜなら有効なメールアドレスが入力されたかチェックする方法が無いからです。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、それが受け取ったメールのヘッダー<tt>From:</tt>に表示されることになります。</p>
284
285 </div>
286
287 <div class="page"><a name="disablesite"></a>
288 <h1>サイトの閉鎖</h1>
289 <p>Nucleusのサイト全体を閉じることが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)</p>
290 <p>ここで設定しなければならないURLは、訪問者がリダイレクトされるURLとなります。</p>
291 <p>例外:<strong>管理領域</strong>はそれまで通り利用可能であり、<strong><a href="#superadmin">最高管理者</a></strong>はそれまで通りにサイト全体をみることができます。(あとでサイトを再開することを忘れないでください;-))</p>
292 </div>
293
294
295 <div class="page"><a name="urlmode"></a>
296 <h1>URLモード</h1>
297 <p>このオプションを用いることにより、URLスタイルを切り替え可能です:</p>
298 <ul>
299         <li><strong>Normal</strong>: URLは次のようになります <code>http://host/index.php?itemid=1234</code></li>
300         <li><strong>Fancy</strong>: URLは次のようになります <code>http://host/item/1234</code></li>
301 </ul>
302 <p class="note"><strong>注意:</strong>「Fancy URL」モードで動作するようにするためには、いくつか他の作業が必要になります。それらは<a href="tips.html" class="out" onclick="window.open(this.href);return false;">Tips &amp; Suggestions</a>に記述されています。(新規ウィンドウが開きます)</p>
303 </div>
304
305 <div class="page"><a name="templateitems"></a>
306 <h1>テンプレート:アイテム</h1>
307 <p>アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます:
308 </p>
309
310 <pre>
311 アイテムのヘッダー
312 アイテムの本体
313 アイテムのフッター
314 </pre>
315
316 <p>これら3つのブロックはすべてテンプレートの一部であり、結果どのような見た目になるのか定義します。</p>
317
318 <h2>変数</h2>
319
320 <p>これらのテンプレート内で、アイテムのデータを挿入するのに<a href="#templatevars-overview" title="Find out which variables are available">テンプレート変数とよばれる系列が利用できます</a>。</p>
321
322 <h2>例</h2>
323 <p><a href="#templateitemsexample">テンプレート:アイテムの例</a></p>
324
325 </div>
326
327 <div class="page"><a name="templateitemsexample"></a>
328 <h1>テンプレート:アイテムの例</h1>
329 <p>「アイテムの本体」テンプレートの一例です:</p>
330
331 <pre>&lt;h1&gt;&lt;%title%&gt;&lt;/h1&gt;
332
333 &lt;p&gt;&lt;%body%&gt;&lt;/p&gt;
334
335 &lt;div class="metadata"&gt;
336  &lt;a href="&lt;%itemlink%&gt;"&gt;link&lt;/a&gt; -
337  &lt;%date%&gt; &lt;%time%&gt; -
338  &lt;a href="&lt;%authorlink%&gt;"&gt;&lt;%author%&gt;&lt;/a&gt; -
339  &lt;%comments%&gt;
340 &lt;/div&gt;</pre>
341
342 <p>結果はこのようなものになります:</p>
343
344 <div class="example">
345 <h4 style="margin: 2px;">ここはアイテムのタイトルです</h4>
346 <p style="margin: 2px; padding: 0px;">ここはアイテムのテキスト部分です</p>
347 <div style="font-style: italic; margin: 2px;">
348  <a href="#templateitemsexample">link</a> -
349  August 8th 2002 18:51 -
350  <a href="#templateitemsexample">karma</a> -
351  <a href="#templateitemsexample">no comments</a>
352 </div>
353 </div>
354
355 </div>
356
357
358 <div class="page"><a name="templatecomments"></a>
359 <h1>テンプレート:コメント</h1>
360
361 <p>コメントブロックは3つの要素で構成されています。</p>
362
363 <ol>
364         <li>
365                 コメントが表示されるとき(詳細のページやメインページで許可されているコメントの最大数を下回っているとき)
366 <pre>コメントのヘッダー
367   コメントの本体(繰り返し)
368 コメントのフッター</pre>
369         </li>
370         <li>
371                 コメントがまったく無いとき
372 <pre>
373 コメントが無い時
374 </pre>
375         </li>
376         <li>
377                 コメントがあるが、許可されている最大数を上回っているとき(アイテムの詳細のページでのみ表示されます)
378 <pre>
379 長すぎるコメントの時
380 </pre>
381         </li>
382 </ol>
383
384 <p>これらのテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
385
386 </div>
387
388 <div class="page">
389 <a name="templatecommentheaders"></a>
390 <a name="templatecommentfooters"></a>
391 <h1>テンプレート:コメントのヘッダーとフッター</h1>
392
393 <h2>特徴</h2>
394
395 <p>「コメントの本体」はコメント一つごとに繰り返されますが、ヘッダーとフッターは一度しか表示されません。典型的な構成はこのようになります:</p>
396 <pre>コメントのヘッダー
397   コメントの本体 1
398   コメントの本体 2
399   コメントの本体 3
400 コメントのフッター</pre>
401 <p>これらのテンプレート内では、<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
402
403 <h2>例</h2>
404
405 <p>Header:</p>
406 <pre>&lt;ul&gt;</pre>
407 <p>Body:</p>
408 <pre>&lt;li&gt;&lt;%user%&gt;: &lt;%body%&gt;&lt;/li&gt;</pre>
409 <p>Footer</p>
410 <pre>&lt;/ul&gt;</pre>
411 <p>Result</p>
412
413 <ul class="example">
414         <li>karma: いいね!</li>
415         <li>xiffy: ああ、たしかに!</li>
416 </ul>
417
418 </div>
419
420 <div class="page"><a name="templatemorelink"></a>
421 <h1>テンプレート:続きへのリンク</h1>
422 <p>これはアイテムのテンプレートで利用できるテンプレート変数、"morelink"のフォーマットとして用いられるテンプレートです。<a href="#templatevars-overview">利用可能な変数</a>はアイテムのテンプレートと同じです。</p>
423 <p>もしアイテムに「続き」の部分が存在しない場合、テンプレート変数<code>&lt;%morelink%&gt;</code>は無効となります。</p>
424
425 <h2>例</h2>
426 <pre><code>&lt;a href="&lt;%itemlink%&gt;"&gt;[続きを読む!]&lt;/a&gt;</code></pre>
427
428 </div>
429
430 <div class="page"><a name="templatearchivelists"></a>
431
432 <h1>テンプレート:アーカイブリスト</h1>
433
434 <p>過去ログのリストは、以下のようなリスト体裁をとります:</p>
435
436 <pre>アーカイブリストヘッダー
437   アーカイブリスト本体(アーカイブごとに繰り返される)
438 アーカイブリストフッター</pre>
439
440 <p>利用できる変数:(ヘッダーとフッターでは<tt>blogid</tt>のみが許可されています)</p>
441
442 <table><tr>
443         <th>名前</th>
444         <th>説明</th>
445 </tr><tr>
446         <td>blogid</td>
447         <td>weblogのID</td>
448 </tr><tr>
449         <td>archivelink</td>
450         <td>アーカイブへのリンク。<code>&lt;a href=".."&gt;</code>のようなタグとしてはめ込むことができる。</td>
451 </tr><tr>
452         <td>month</td>
453         <td>月の数値(01-12の2文字表記)</td>
454 </tr><tr>
455         <td>year</td>
456         <td>年(西暦の4文字表記)</td>
457 </tr><tr>
458         <td>day</td>
459         <td>月の中での日付(二文字表記。日ごと表示の時のみ)</td>
460 </tr></table>
461
462 <p>リストに用いるアーカイブの日付表記をより融通の効くようにする方法は、<a href="#strftime">strftime</a>変数を用いることです。もし複雑すぎると感じたなら、次のを用いてください:</p>
463
464 <pre><code>&lt;a href="&lt;%archivelink%&gt;"&gt;%B, %Y&lt;/a&gt;&lt;br /&gt;</code></pre>
465
466
467 <p>言語設定をあなたの住んでいる地域の設定に変更するためには、<a href="#templatelocale">locale</a>を変更してください。</p>
468
469 </div>
470
471
472
473
474 <div class="page"><a name="templatecategorylists"></a>
475 <h1>テンプレート:カテゴリーリスト</h1>
476
477 <p>カテゴリーリストは下の表のようにフォーマットされます:</p>
478
479 <pre>カテゴリーリストヘッダー
480   カテゴリーリストアイテム(繰り返し)
481 カテゴリーリストフッター</pre>
482
483 <p>利用可能な変数:(ヘッダーとフッターでは<tt>blogid</tt>、<tt>blogurl</tt>、<tt>self</tt>のみが許可されています)</p>
484
485 <table><tr>
486         <th>名前</th>
487         <th>説明</th>
488 </tr><tr>
489         <td>blogid</td>
490         <td>weblogのID</td>
491 </tr><tr>
492         <td>blogurl</td>
493         <td>blogのURL(blogごとの「設定」で定義される)</td>
494 </tr><tr>
495         <td>self</td>
496         <td>パラメーター無しの現在のページ(例えば<tt>index.php</tt>)</td>
497 </tr><tr>
498         <td>catlink</td>
499         <td>該当カテゴリーの新しいアイテムへのリンク。これにより&lt;a href=".."&gt;タグを埋め込むことができる。</td>
500 </tr><tr>
501         <td>catid</td>
502         <td>カテゴリーのID</td>
503 </tr><tr>
504         <td>catname</td>
505         <td>カテゴリー名</td>
506 </tr><tr>
507         <td>catdesc</td>
508         <td>カテゴリーの説明</td>
509 </tr></table>
510
511 <p><a href="#categorylistexample">例を見る</a></p>
512
513 </div>
514
515 <div class="page"><a name="categorylistexample"></a>
516 <h1>テンプレート:カテゴリーリストの例</h1>
517 <p>
518 <a href="#templatecategorylists">(戻る)</a>
519 </p>
520
521 <h2>カテゴリーリストヘッダー</h2>
522 <pre><code>&lt;ul&gt;
523   &lt;li&gt;&lt;a href="&lt;blogurl%&gt;"&gt;まとめて表示&lt;/a&gt;&lt;/li&gt;</code></pre>
524
525 <h2>カテゴリーリストアイテム</h2>
526 <pre><code>&lt;li&gt;&lt;a href="&lt;%catlink%&gt;"&gt;&lt;%catname%&gt;&lt;/a&gt;&lt;/li&gt;</code></pre>
527
528 <h2>カテゴリーリストフッター</h2>
529 <pre><code>&lt;/ul&gt;</code></pre>
530
531 <h2>結果はこうなります:</h2>
532
533 <ul class="example">
534         <li><a href="#categorylistexample">まとめて表示</a></li>
535         <li><a href="#categorylistexample">あなたのカテゴリー</a></li>
536         <li><a href="#categorylistexample">わたしのカテゴリー</a></li>
537 </ul>
538
539 </div>
540
541
542
543
544
545
546
547 <div class="page"><a name="templatelocale"></a>
548 <h1>テンプレート:Locale</h1>
549 <p>これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月と日の名前などは要求された言語での表示になるでしょう。</p>
550
551 <p>使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと・・・:</p>
552
553 <ul>
554         <li><strong>en</strong>:英語</li>
555         <li><strong>dutch</strong>:オランダ語</li>
556         <li><strong>ja_JP</strong>:日本語</li>
557         <li>...</li>
558 </ul>
559
560 <p>strftimeに関するより詳しい情報は、<a href="http://www.opengroup.org/onlinepubs/7908799/xsh/strftime.html" onclick="window.open(this.href);return false;" class="out" title="Open Group specification">Open Group Specification</a>にあります。(新規ウィンドウが開きます)</p>
561
562 <p>localeは<a href="#templatedatetime">日付と時刻のフォーマット</a>、<a href="#templatedateheads">日付ヘッダー</a>、<a href="#templatearchivelists">アーカイブリスト</a>で利用されます。</p>
563
564 </div>
565
566 <div class="page"><a name="templatedatetime"></a>
567 <h1>テンプレート:日付と時刻のフォーマット</h1>
568 <p>これらは<code>&lt;%date%&gt;</code>と<code>&lt;%time%&gt;</code>という変数(<a href="#templatevars-overview">テンプレート変数</a>をご覧ください)における日付と時刻のフォーマットに使われます。フォーマットは<a href="#templatelocale">locale</a>にも左右されます。</p>
569
570 <p><a href="#strftime">利用できる変数の詳細な情報はこちらを</a>。もし手っ取り早く始めたいのなら、日付フォーマットに"%x"を、時刻フォーマットに"%X"をお使いください。</p>
571
572 </div>
573
574 <div class="page"><a name="templatedateheads"></a>
575 <h1>テンプレート:日付ヘッダー/フッター</h1>
576
577 <p>日付のヘッダーと日付のフッターは日付と時刻の変数を入れることができます。<a href="#strftime">利用できる変数の詳細情報はこちらにあります</a>。もし手早く始めるのなら、"%x"を日付フォーマットとして使ってください。日付フォーマットで使われる言語は、テンプレートの<a href="#templatelocale">locale設定</a>で決定されます。</p>
578
579 <p>日付ヘッダーにテンプレート変数&lt;%%daylink%%&gt;を含めることによって、その日のアーカイブへのリンクを挿入できます。<strong>'%'が二つであることに注意を!月の中での現在日付に展開される%dを無効にするために必要な措置なのです。</strong>同様に、もし'%'という文字をここで使いたいなら、二つ重ねて('%%')置かないとサイトには表示されません。</p>
580
581 <p>日付ヘッダーのサンプル:</p>
582
583 <pre>
584 &lt;div class="day"&gt;
585 &lt;h1&gt;%d %B&lt;/h1&gt;
586 </pre>
587
588 <p>日付フッターのサンプル:</p>
589
590 <pre>
591 &lt;/div&gt;
592 </pre>
593
594 <p>daylinkを用いた日付ヘッダーの例:</p>
595
596 <pre>
597 &lt;div class="day"&gt;
598 &lt;h1&gt;%d %B&lt;/h1&gt;
599 &lt;a href="&lt;%%daylink%%&gt;"&gt;(アーカイブ)&lt;/a&gt;
600 </pre>
601
602 </div>
603
604 <div class="page"><a name="templatehighlight"></a>
605 <h1>テンプレート:ハイライト表示</h1>
606 <p>ハイライト表示は検索実行時に使われます。これは規則変化に沿った表現として実際に使われますので、直前にバックスラッシュを置くことによっていくつかの記号をエスケープしたいと望むかもしれません。ハイライトされた単語が当てはめられる場所は"\0"で示されます。</p>
607
608 <h2>例</h2>
609
610 <pre><code>&lt;span style='background-color:yellow'&gt;\0&lt;/span&gt;</code></pre>
611
612 </div>
613
614 <div class="page"><a name="templatenothingfound"></a>
615 <h1>テンプレート:検索で何も見つからなかった場合</h1>
616
617 <p>検索が実行され結果何も見つからなかった場合に表示されます。</p>
618
619 <p>利用可能な変数:</p>
620
621 <table><tr>
622         <th>名前</th>
623         <th>説明</th>
624 </tr><tr>
625         <td>blogid</td>
626         <td>weblogのID</td>
627 </tr><tr>
628         <td>query</td>
629         <td>検索に用いられたクエリ</td>
630 </tr></table>
631
632 <h2>例</h2>
633
634 <pre><code>&lt;b&gt;&lt;%query%&gt;&lt;/b&gt;に該当する検索結果はありませんでした</code></pre>
635
636 </div>
637
638 <div class="page"><a name="templatecommentbody"></a>
639 <h1>テンプレート:コメントの本体</h1>
640 <p>このテンプレート・パーツは単独のコメント表示に使われます。このテンプレート部では、<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連テンプレート変数</a>が利用できます。</p>
641
642 <h2>例</h2>
643 <pre><code>&lt;h2&gt;&lt;%userlink%&gt;さんによるコメント:&lt;/h2&gt;
644
645 &lt;p&gt;&lt;%body%&gt;&lt;/p&gt;
646
647 &lt;div class="metadata"&gt;
648  (接続元:&lt;%host%&gt; 投稿日時:&lt;%date%&gt; &lt;%time%&gt;)
649 &lt;/div&gt;</code></pre>
650
651 <p>結果はこうなります:</p>
652
653 <div class="example">
654 <h4 style="margin: 2px;"><a href="#templatecommentbody">karma</a>さんによるコメント:</h4>
655 <p style="margin: 2px;">ナイス!</p>
656 <div style="margin:2px;font-size:smaller;">(接続元:host.example.org 投稿日時:2003-03-02 13:30)</div>
657 </div>
658
659 </div>
660
661 <div class="page"><a name="templatepopups"></a>
662 <h1>テンプレート:メディアとポップアップ</h1>
663 <p>これらのテンプレートは、画像ウィンドウのポップアップへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数を以下に記します:</p>
664
665 <h2>ポップアップ画像へのリンクコード</h2>
666
667 <table><tr>
668         <th>名前</th>
669         <th>説明</th>
670 </tr><tr>
671         <td>popuplink</td>
672         <td>すぐに使える&lt;a href... といったリンク</td>
673 </tr><tr>
674         <td>rawpopuplink</td>
675         <td>href="..."内部のurlのみ</td>
676 </tr><tr>
677         <td>popupcode</td>
678         <td>ウィンドウを開くjavascriptコード</td>
679 </tr><tr>
680         <td>text</td>
681         <td>代用テキスト(リンクテキスト)</td>
682 </tr><tr>
683         <td>width</td>
684         <td>イメージの幅</td>
685 </tr><tr>
686         <td>height</td>
687         <td>イメージの高さ</td>
688 </tr><tr>
689         <td>popuptext</td>
690         <td>(textと同じ)</td>
691 </tr><tr>
692         <td>link</td>
693         <td>画像への直接リンク(URL)</td>
694 </tr><tr>
695         <td>media</td>
696         <td>すぐに使える、ポップアップしないイメージのための A タグ</td>
697 </tr></table>
698
699
700 <h2>インライン画像のコード</h2>
701
702 <table><tr>
703         <th>名前</th>
704         <th>説明</th>
705 </tr><tr>
706         <td>image</td>
707         <td>すぐに使えるIMGタグ</td>
708 </tr><tr>
709         <td>link</td>
710         <td>画像への直接リンク(URL)</td>
711 </tr><tr>
712         <td>text</td>
713         <td>代用テキスト(リンクテキスト)</td>
714 </tr><tr>
715         <td>width</td>
716         <td>イメージの幅</td>
717 </tr><tr>
718         <td>height</td>
719         <td>イメージの高さ</td>
720 </tr><tr>
721         <td>media</td>
722         <td>すぐに使える、イメージのための A タグ</td>
723 </tr></table>
724
725 <h2>メディアオブジェクトへのリンクコード</h2>
726
727 <table><tr>
728         <th>名前</th>
729         <th>説明</th>
730 </tr><tr>
731         <td>media</td>
732         <td>すぐに使えるAタグ</td>
733 </tr><tr>
734         <td>link</td>
735         <td>ファイルへの直接リンク(URL)</td>
736 </tr><tr>
737         <td>text</td>
738         <td>代用テキスト(リンクテキスト)</td>
739 </tr></table>
740
741 </div>
742
743 <div class="page"><a name="templatememberextra"></a>
744 <h1>テンプレート:登録メンバーからのコメントへの追加表示</h1>
745 <p>これはコメントの著者がメンバーであることをの証を追加するのに利用できるテンプレートです。最終的には<a href="#templatecommentbody">コメントの本体</a>で使われる<code>&lt;%authtext%&gt;</code>変数の表示となります。</p>
746
747 <p>このテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
748
749 </div>
750
751 <div class="page"><a name="templatecommentcontinued"></a>
752 <h1>テンプレート:コメントの続きを読む</h1>
753 <p>このリンク・フォーマットは、<a href="#templatecommentbody">コメントの本体</a>で使われる変数<code>&lt;%short%&gt;</code>の終わりに追加されます。</p>
754
755 <p>このテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます(<code>&lt;%short%&gt;</code>変数以外)。</p>
756
757 <p>例:</p>
758
759 <pre>
760  &lt;a href="&lt;%itemlink%&gt;"&gt;[続き]&lt;/a&gt;
761 </pre>
762
763 </div>
764
765 <div class="page"><a name="templatecommentwords"></a>
766 <h1>テンプレート:コメントの数え方</h1>
767 <p>訳注:日本語で使う場合は、単複同型なので両方"コメント"にして問題ないです。</p>
768 <p>たぶん、"1 comment(s)"よりむしろ"1 comment"と表示したい人が多いのではないでしょうか?「コメントが一つの時」と「コメントが二つ以上の時」のテンプレート部分はそういった目的のために使えます。これらは他の所で使える<code>&lt;%commentword%&gt;</code>変数の中身として利用されます。</p>
769
770 <p>もし一つしかコメントが無い場合、<code>&lt;%commentword%&gt;</code>は「コメントが一つの時」と同じ内容になります。もし1より多い複数のコメントがついているなら、<code>&lt;%commentword%&gt;</code>は「コメントが二つ以上の時」と同じ内容になります。
771 </p>
772
773 <p>典型的な値は"comment"と"comments"です。<strong>ここでは特別な変数は利用できません</strong>。</p>
774 </div>
775
776
777
778 <div class="page"><a name="templateeditlink"></a>
779 <h1>テンプレート:アイテムを編集するためのリンク </h1>
780 <p>このテンプレートは<a href="#templatevar-edit">テンプレート変数edit</a>がどのように表示されるかを決めるものです。ここではどのような<a href="#templatevars-overview">テンプレート変数</a>でも使用できます。
781 </p>
782
783 <h2>例:</h2>
784
785 <pre><code>&lt;a href="&lt;%editlink%&gt;"
786    onclick="&lt;%editpopupcode%&gt;"&gt;編集&lt;/a&gt;</code></pre>
787
788 </div>
789
790
791
792
793 <div class="page"><a name="skinpartindex"></a>
794 <h1>スキン:メインの目次ページ</h1>
795 <p>このスキン部品はweblogにおける最新のエントリー(複数)を表示するのに用いられます。通常はサイトのトップページにあたるでしょう。</p>
796
797 <p>「メインの目次ページ」の非常に基本的な形:</p>
798
799 <pre>
800 &lt;html&gt;
801   &lt;head&gt;
802     &lt;title&gt;私のウェブログ&lt;/title&gt;
803   &lt;/head&gt;
804   &lt;body&gt;
805
806     &lt;h1&gt;私のウェブログ&lt;/h1&gt;
807     &lt;%blog(mytemplate,20)%&gt;
808
809   &lt;/body&gt;
810 &lt;/html&gt;
811 </pre>
812
813 <p>これによりデフォルトweblog(上書きされた場合を除く)の最新アイテム20個が、'mytemplate'というテンプレートを用いて表示されます。</p>
814 </div>
815
816
817 <div class="page"><a name="skinpartitem"></a>
818 <h1>個別アイテムページ</h1>
819 <p>これらのページは完全なアイテムを表示するために使われます。付けられた全てのコメントとコメント追加フォームを含めたものです。</p>
820
821 <p>「個別アイテムページ」の非常に基本的な形:</p>
822
823 <pre>
824 &lt;html&gt;
825   &lt;head&gt;
826     &lt;title&gt;私のウェブログ :: アイテム&lt;/title&gt;
827   &lt;/head&gt;
828   &lt;body&gt;
829
830     &lt;h1&gt;アイテム&lt;/h1&gt;
831     &lt;%item(detailed)%&gt;
832
833     &lt;h1&gt;コメント&lt;/h1&gt;
834     &lt;%comments(detailed)%&gt;
835
836     &lt;h1&gt;コメントを追加&lt;/h1&gt;
837     &lt;%commentform%&gt;
838
839   &lt;/body&gt;
840 &lt;/html&gt;
841 </pre>
842
843 <p>これにより'detailed'テンプレートを用いたアイテムとコメントが表示されます。加えて標準のコメントフォームも。</p>
844
845
846 </div>
847
848 <div class="page"><a name="skinpartarchivelist"></a>
849 <h1>スキン:月別アーカイブ一覧ページ</h1>
850 <p>アーカイブが存在する全ての月の概略と、それらアーカイブへのリンクです。</p>
851
852 <p>「月別アーカイブ一覧ページ」の非常に基本的な形:</p>
853
854 <pre>
855 &lt;html&gt;
856   &lt;head&gt;
857     &lt;title&gt;私のウェブログ :: アーカイブ集&lt;/title&gt;
858   &lt;/head&gt;
859   &lt;body&gt;
860
861     &lt;h1&gt;アーカイブ集&lt;/h1&gt;
862     &lt;%archivelist(default)%&gt;
863
864   &lt;/body&gt;
865 &lt;/html&gt;
866 </pre>
867
868 <p>これにより'default'テンプレートを用いた、存在するアーカイブファイル全てのリストが表示されます。</p>
869
870 </div>
871
872 <div class="page"><a name="skinpartarchive"></a>
873 <h1>スキン:月別アーカイブページ</h1>
874 <p>ひと月分のアーカイブ。「メインの目次ページ」と似た振る舞いをしますが、該当月の全てのアイテムを表示します。</p>
875
876 <p>「月別アーカイブページ」の非常に基本的な形:</p>
877
878 <pre>
879 &lt;html&gt;
880   &lt;head&gt;
881     &lt;title&gt;私のウェブログ :: アーカイブ&lt;/title&gt;
882   &lt;/head&gt;
883   &lt;body&gt;
884
885     &lt;h1&gt;アーカイブ&lt;/h1&gt;
886     &lt;%archive(default)%&gt;
887
888   &lt;/body&gt;
889 &lt;/html&gt;
890 </pre>
891
892 <p>これにより'default'テンプレートを用いて要求されたアーカイブが表示されます。</p>
893
894
895 </div>
896
897
898 <div class="page"><a name="skinpartsearch"></a>
899 <h1>スキン:検索ページ</h1>
900 <p>検索結果の表示に使われます。</p>
901
902 <p>「検索ページ」の非常に基本的な形:
903 </p>
904
905 <pre>
906 &lt;html&gt;
907   &lt;head&gt;
908     &lt;title&gt;私のウェブログ :: 検索&lt;/title&gt;
909   &lt;/head&gt;
910   &lt;body&gt;
911
912     &lt;h1&gt;検索&lt;/h1&gt;
913     &lt;%searchform%&gt;
914
915     &lt;h1&gt;検索結果&lt;/h1&gt;
916     &lt;%searchresults(default)%&gt;
917
918   &lt;/body&gt;
919 &lt;/html&gt;
920 </pre>
921
922 <p>これにより、'default'テンプレートを用いた検索の結果が表示されます。</p>
923
924 </div>
925
926 <div class="page"><a name="skinparterror"></a>
927 <h1>スキン:エラーページ</h1>
928 <p>エラーが発生したときに用いられます。</p>
929
930 <pre>
931 &lt;html&gt;
932   &lt;head&gt;
933     &lt;title&gt;私のウェブログ :: エラー&lt;/title&gt;
934   &lt;/head&gt;
935   &lt;body&gt;
936
937     &lt;h1&gt;エラーが発生しました!&lt;/h1&gt;
938     &lt;%errormessage%&gt;
939
940     &lt;br /&gt;&lt;br /&gt;
941
942     &lt;a href="javascript:history.back();"&gt;戻る&lt;/a&gt;
943
944   &lt;/body&gt;
945 &lt;/html&gt;
946 </pre>
947
948 <p>これによりエラーメッセージと、戻るためのリンクが表示されます。</p>
949
950 </div>
951
952 <div class="page"><a name="skinpartmember"></a>
953 <h1>スキン:メンバー詳細ページ</h1>
954 <p>メンバーの詳細を表示するのに使われます。</p>
955
956 <p>「メンバー詳細ページ」の非常に基本的な形:</p>
957
958 <pre>
959 &lt;html&gt;
960   &lt;head&gt;
961     &lt;title&gt;私のウェブログ :: メンバーの詳細&lt;/title&gt;
962   &lt;/head&gt;
963   &lt;body&gt;
964
965     &lt;h1&gt;&lt;%member(name)%&gt; の情報&lt;/h1&gt;
966     ウェブサイト:
967     &lt;a href="&lt;%member(url)%&gt;"&gt;&lt;%member(url)%&gt;&lt;/a&gt;
968
969     &lt;h1&gt;メッセージを送る&lt;/h1&gt;
970     &lt;%membermailform%&gt;
971
972   &lt;/body&gt;
973 &lt;/html&gt;
974 </pre>
975
976 <p>これにより、メンバー名とウェブサイトのアドレスとメール送信フォームが表示されます。</p>
977
978 </div>
979
980
981 <div class="page"><a name="skinpartimagepopup"></a>
982 <h1>スキン:画像ポップアップウィンドウ</h1>
983 <p>メディアファイル(画像)がポップアップウィンドウでの表示を必要とする場合に使われます。このスキンはそのような使われ方をする場合のレイアウトを決定します。</p>
984
985 <p>「画像ポップアップウィンドウ」の非常に典型的な形:</p>
986
987 <pre>
988 &lt;html&gt;
989 &lt;head&gt;
990   &lt;title&gt;&lt;%imagetext%&gt;&lt;/title&gt;
991   &lt;style type="text/css"&gt;
992    img { border: none; }
993   &lt;/style&gt;
994 &lt;/head&gt;
995 &lt;body&gt;
996   &lt;a href="javascript:window.close();"&gt;&lt;%image%&gt;&lt;/a&gt;
997 &lt;/body&gt;
998 &lt;/html&gt;
999 </pre>
1000
1001 </div>
1002
1003
1004
1005
1006
1007 <div class="page"><a name="shortnames"></a>
1008 <h1>短縮名と表示される名前</h1>
1009 <p>ウェブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。</p>
1010
1011 <p>短縮名はaからzと0か9<strong>のみ</strong>で構成され、かつスペースを含むことは<strong>できません</strong>。</p>
1012
1013 <p>表示される名前はメンバー名として使われます。aからz、 AからZ,、0から9とスペース(半角)が使用できます。ただし、スペースを名前の最初と最後に付けることはできません。</p>
1014 <p>訳注:テンプレートの名前には'/'が利用できたりするので、実際にはこの限りではないようです。</p>
1015 </div>
1016
1017
1018
1019
1020
1021
1022 <div class="page"><a name="templatenew"></a>
1023 <h1>テンプレート:新しいアイテムに付けるマーク</h1>
1024 <p><a href="#cookies">最終訪問日時Cookieの保存</a>オプションが有効な時、「新しいアイテムに付けるマーク」テンプレートの内容が、前回訪問時から追加されたアイテムのための変数&lt;%new%&gt;に置き換えられます。変数<code>&lt;%new%&gt;</code>は、例えば<a href="#templateitems">アイテムの本体</a>テンプレートで利用できます。</p>
1025
1026 <p>「最終訪問日時Cookieの保存」が有効でないか、アイテムが新しくなければ、このテンプレート部品は使われません。</p>
1027 </div>
1028
1029
1030 <div class="page"><a name="strftime"></a>
1031 <h1>時間変数の概要</h1>
1032
1033 <p>次の変換記述は文字列フォーマットに基づきます<small>(PHPドキュメントの<a href="http://jp.php.net/manual/ja/function.strftime.php" onclick="window.open(this.href);return false;" class="out">strftime関数</a>から持ってきたものです)</small>。より詳しい情報は<a href="http://www.opengroup.org/onlinepubs/7908799/xsh/strftime.html" onclick="window.open(this.href);return false;" class="out" title="Open Group specification">Open Group Specification</a>にあります。</p>
1034
1035 <ul>
1036         <li><strong>%a</strong> - 現在のロケールに基づく短縮された曜日の名前</li>
1037         <li><strong>%A</strong> - 現在のロケールに基づく完全な曜日の名前</li>
1038         <li><strong>%b</strong> - 現在のロケールに基づく短縮された月の名前</li>
1039         <li><strong>%B</strong> - 現在のロケールに基づく完全な月の名前</li>
1040         <li><strong>%c</strong> - 現在のロケールに基づく適当な日付と時間の表現</li>
1041         <li><strong>%d</strong> - 日付を10進数で(01から31) </li>
1042         <li><strong>%H</strong> - 時間を24時間表示の10進数で(00から23まで)</li>
1043         <li><strong>%I</strong> - 時間を12時間表示の10進数で(01から12までの範囲)</li>
1044         <li><strong>%j</strong> - 年間での日付を10進数で表現 (001から366)</li>
1045         <li><strong>%m</strong> - 月を10進数で表現 (01から12)</li>
1046         <li><strong>%M</strong> - 分を10進数で表現</li>
1047         <li><strong>%p</strong> - 指定した時間により 'am' または 'pm' 、または 現在のロケールに対応した文字列</li>
1048         <li><strong>%S</strong> - 秒を10進数で表現</li>
1049         <li><strong>%U</strong> - 年間で何番目の週であるかを 10 進数で表現。 年間で最初の日曜を最初の週の最初の日として数えます。</li>
1050         <li><strong>%W</strong> - 現在の年で何番目の週であるかを10進数で表現。 年間で最初の月曜を最初の週の最初の日として数えます。</li>
1051         <li><strong>%w</strong> - 曜日を10進数で表現。日曜は0になります。</li>
1052         <li><strong>%x</strong> - 時間を除いた日付を現在のロケールに基づき表現します。</li>
1053         <li><strong>%X</strong> - 日付を除いた時間を現在のロケールに基づき表現します。</li>
1054         <li><strong>%y</strong> - 世紀の部分を除いた年を10進数として表現。(00から99までの範囲) </li>
1055         <li><strong>%Y</strong> - 世紀を含む年を 10進数で表現</li>
1056         <li><strong>%Z</strong> - タイムゾーンまたはその名前または短縮形</li>
1057         <li><strong>%%</strong> - 文字リテラル'%' </li>
1058 </ul>
1059
1060 </div>
1061
1062 <div class="page"><a name="pinguserland"></a>
1063 <h1>Weblogs.comへのPing</h1>
1064 <p>weblogを更新したときに、<a href="http://www.weblogs.com/" onclick="window.open(this.href);return false;" class="out">weblogs.com</a>に更新の通知(ping)を送るという選択ができます。このウェブサイトは要求する人みんなに、近頃更新されたweblogのリストを提供してくれます。多くのウェブサイトがこのデータを用いていますので、このpingを有効にすることでいくらかの新しい訪問者を得る事となるでしょう。</p>
1065
1066 <p class="note"><strong>注意:</strong>この機能を正しく動かすために、blogごとの「設定」にあるweblogの「URL」と「Blogの名前」を埋める必要があります。</p>
1067
1068 </div>
1069
1070 <div class="page"><a name="blogsearchable"></a>
1071
1072 <h1>常に検索対象に含める</h1>
1073
1074 <p>「検索対象にする」オプションが選択されていると、対象のweblogは<strong>常に</strong>検索対象に含まれます。たとえ検索が他のweblogで行われたとしても。(訳注:2.5からのオプション)</p>
1075
1076 <p>例として、'lifelog'と'linkdump'という2つのweblogを持ち、'linkdump'の「検索対象にする」が有効になっていると仮定しましょう。そうすると、'lifelog'での検索クエリは'linkdump'も検索するのに対して、'linkdump'の検索クエリは'linkdump'のエントリーしか検索しません。</p>
1077
1078
1079 </div>
1080
1081
1082 <div class="page"><a name="convertbreaks"></a>
1083 <h1>改行を変換する</h1>
1084 <p>デフォルトでは、Nucleusはアイテム内の改行を<code>&lt;br /&gt;</code>タグに変換します。だから改行も(X)HTMLでのアウトプットに現れるのです。</p>
1085 <p>手馴れたユーザーや、Semantic Web(<tt>br</tt>タグは情報を付加せず、ただ記述のためにのみ使われる)のために努力するユーザーは、この機能が迷惑だと感じるかもしれません。そしてこの機能を切るのです。</p>
1086 </div>
1087
1088
1089 <div class="page"><a name="media"></a>
1090 <h1>メディア</h1>
1091 <p>Nucleusはメディアファイル(画像、動画、音楽など等)をウェブサイトにアップロードすることができます。</p>
1092 <p>このためにいくつかの設定が必要となります:</p>
1093 <ul>
1094         <li><strong>メディア(画像・音声)ディレクトリ</strong>:メディアファイルが保存されるサーバー上の場所(ローカルのファイルシステム)</li>
1095         <li><strong>メディアURL</strong>:メディアファイルのURL上の場所</li>
1096         <li><strong>ファイルのアップロードを許可しますか?</strong>:ファイルのアップロードを不許可にすることが可能です</li>
1097         <li><strong>アップロードを許可するファイルタイプ</strong>:アップロードできるファイルの拡張子群(反応が無い場合は、コンマで区切る)</li>
1098         <li><strong>アップロードファイルの最大サイズ</strong>:アップロードファイルのサイズに制限を設ける</li>
1099         <li><strong>アップロードするファイル名の頭に日付を付加する</strong>:もしこのオプションが有効なら、アップロードされたファイルには現在の日付が頭に付加されます。'bunny.jpg'という名前のファイルを2003年4月8日にアップロードしたなら、'20030408-bunny.jpg'というファイル名になります。何故こんな機能があるかというと、大量のファイルをアップロードしているときについ同じ名前を用いてしまう問題を避けるためです。</li>
1100 </ul>
1101
1102 <p>メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。あとは、メディア・ディレクトリ下のサブディレクトリがグローバルなコレクション(メンバー間で共有)とみなされます。</p>
1103
1104 <p>アップロードは、少なくとも一つのblogチームに入っているメンバーでなくては行えません。悪用を予防するためです。</p>
1105 </div>
1106
1107
1108 <div class="page"><a name="protectmemnames"></a>
1109 <h1>メンバー名の保護</h1>
1110 <p>このオプションが有効なら、ログインしていないメンバーは登録済みメンバーと同じ名前を使ってコメントを加えることができません。このようにする理由は、ゲストによるメンバーへのなりすましを避けるためです。</p>
1111 </div>
1112
1113
1114 <div class="page"><a name="pluginurl"></a>
1115 <h1>プラグインURL</h1>
1116 <p>この設定はプラグイン管理領域のベースURLです。通常次のようになります。</p>
1117 <pre>http://hostname.com/nucleus/plugins/</pre>
1118 </div>
1119
1120 <div class="page"><a name="skinsurl"></a>
1121 <h1>スキンURL</h1>
1122 <p>この設定はNucleusスキン・ディレクトリのベースURLです。通常次のようになります。</p>
1123 <pre>http://hostname.com/skins/</pre>
1124 </div>
1125
1126 <div class="page"><a name="actionurl"></a>
1127 <h1>action.phpへのフルURL</h1>
1128 <p>この設定はNucleus付属のスクリプト<code>action.php</code>の絶対URLです。通常次のようになります。</p>
1129 <pre>http://hostname.com/actions.php</pre>
1130 </div>
1131
1132
1133
1134 <div class="page"><a name="additem"></a>
1135 <h1>アイテムの追加</h1>
1136 <p>weblogにアイテムを追加する際、「本文」「タイトル」「続き」にて4種類のテンプレート変数を利用することができます:</p>
1137 <ul>
1138         <li><a href="#templatevar-popup">&lt;%popup(...)%&gt;</a> ポップアップ画像の挿入</li>
1139         <li><a href="#templatevar-image">&lt;%image(...)%&gt;</a> インライン画像の挿入</li>
1140         <li><a href="#templatevar-media">&lt;%media(...)%&gt;</a> メディアオブジェクトの挿入</li>
1141 </ul>
1142 <p>普通、これらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。</p>
1143
1144
1145 </div>
1146
1147
1148
1149
1150 <div class="page">
1151 <a name="skinvar-referer"></a>
1152 <h1>スキン変数:referer</h1>
1153 <p>参照もとのURLを挿入(空っぽになりえます)。</p>
1154 <h2>引数</h2>
1155 <p>なし</p>
1156 <h2>スキンタイプ</h2>
1157 <p>全て</p>
1158 <h2>例</h2>
1159 <pre>
1160 &lt;a href="&lt;%referer%&gt;"&gt;戻る&lt;/a&gt;
1161 </pre>
1162 </div>
1163
1164
1165 <div class="page">
1166 <a name="skinvar-itemid"></a>
1167 <h1>スキン変数:itemid</h1>
1168 <p>現在選択しているアイテムのIDを挿入</p>
1169 <h2>引数</h2>
1170 <p>None</p>
1171 <h2>スキンタイプ</h2>
1172 <p>個別アイテム</p>
1173 <h2>例</h2>
1174 <pre>
1175 &lt;%itemid%&gt;
1176 </pre>
1177 </div>
1178
1179
1180 <div class="page">
1181 <a name="skinvar-itemlink"></a>
1182
1183 <h1>スキン変数:itemlink</h1>
1184
1185 <p>アイテムへの永続リンク(permanent link)を追加</p>
1186
1187 <h2>引数</h2>
1188
1189 <p>
1190         オプション(2.5から)
1191         <ul>
1192                 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code>&lt;a href...</code>タグがアウトプットされる</li>
1193         </ul>
1194 </p>
1195 <h2>スキンタイプ</h2>
1196
1197 <p>個別アイテム</p>
1198
1199 <h2>例</h2>
1200
1201 <pre>
1202 &lt;%itemlink%&gt;
1203 </pre>
1204 </div>
1205
1206 <div class="page">
1207 <a name="skinvar-itemtitle"></a>
1208 <h1>スキン変数:itemtitle</h1>
1209 <p>アイテムのタイトルを挿入。HTMLは除去され、エンティティはエンコードされる。</p>
1210 <h2>引数</h2>
1211 <p>なし</p>
1212 <h2>スキンタイプ</h2>
1213 <p>個別アイテム</p>
1214 <h2>例</h2>
1215 <pre>
1216 &lt;%itemtitle%&gt;
1217 </pre>
1218 </div>
1219
1220
1221 <div class="page">
1222 <a name="skinvar-archivedate"></a>
1223 <h1>スキン変数:archivedate</h1>
1224 <p>アーカイブの日付としてフォーマット済みの日付を挿入。パラメーターなしで使うと、例えばアーカイブが2002年8月のものなら、'15 august 2002'か'august 2002'のどちらかが挿入されることになるでしょう。</p>
1225 <h2>引数</h2>
1226 <ul>
1227         <li>オプション
1228                 <table><tr>
1229                         <th>名前</th>
1230                         <th>値</th>
1231                 </tr><tr>
1232                         <td>Locale</td>
1233                         <td>日付がフォーマットされるときに用いられる<a href="#templatelocale">Locale</a></td>
1234                 </tr><tr>
1235                         <td>Format</td>
1236                         <td>日付のフォーマット(<a href="#strftime">strftime変数</a>)</td>
1237                 </tr></table>
1238         </li>
1239 </ul>
1240 <h2>スキンタイプ</h2>
1241 <p>月別アーカイブ</p>
1242 <h2>例</h2>
1243 <pre>
1244 Archive for &lt;%archivedate%&gt;
1245 Archive for &lt;%archivedate(dutch)%&gt;
1246 Archive for &lt;%archivedate(en,%B %Y)%&gt;
1247 </pre>
1248 </div>
1249
1250
1251
1252 <div class="page">
1253 <a name="skinvar-blog"></a>
1254 <h1>スキン変数:blog</h1>
1255
1256 <p>現在動いているblog(通常はデフォルトのもの)の一番新しいアイテム群を、スキンに挿入。</p>
1257
1258 <h2>引数</h2>
1259 <p>
1260         必須:
1261         <ul>
1262                 <li><strong>template</strong>:使用するテンプレート名</li>
1263         </ul>
1264         オプション
1265         <ul>
1266                 <li><strong><em>amount</em></strong>:表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば<code>10(5)</code>と記述すると5番目から始めて10個のアイテムを表示する。</li>
1267                 <li><strong><em>category</em></strong>:表示するカテゴリーの名前</li>
1268         </ul>
1269 </p>
1270
1271 <h2>スキンタイプ</h2>
1272
1273 <p>メインの目次、個別アイテム、月別アーカイブ、月別アーカイブ一覧、検索</p>
1274
1275 <h2>例</h2>
1276
1277 <pre>
1278 &lt;%blog(default,15)%&gt;
1279 &lt;%blog(default,5(15))%&gt;
1280 &lt;%blog(mytemplate)%&gt;
1281 &lt;%blog(mytemplate,5,mycategory)%&gt;
1282 </pre>
1283
1284 </div>
1285
1286
1287
1288
1289 <div class="page">
1290 <a name="skinvar-otherblog"></a>
1291 <h1>スキン変数:otherblog</h1>
1292
1293 <p>指定されたblogの最新アイテム群をスキンに挿入。</p>
1294
1295 <h2>引数</h2>
1296 <p>
1297         必須:
1298         <ul>
1299                 <li><strong>blogname</strong>:表示するblogの名前(短縮名)</li>
1300                 <li><strong>template</strong>:使用するテンプレート名</li>
1301         </ul>
1302         オプション:
1303         <ul>
1304                 <li><strong><em>amount</em></strong>:表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば<code>10(5)</code>と記述すると5番目から始めて10個のアイテムを表示する。</li>
1305                 <li><strong><em>category</em></strong>:表示するカテゴリーの名前</li>
1306         </ul>
1307 </p>
1308
1309 <h2>スキンタイプ</h2>
1310
1311 <p>すべて</p>
1312
1313 <h2>例</h2>
1314
1315 <pre>
1316 &lt;%otherblog(myblog,default,15)%&gt;
1317 &lt;%otherblog(yourblog,mytemplate)%&gt;
1318 &lt;%otherblog(yourblog,mytemplate,15,mycategory)%&gt;
1319 &lt;%otherblog(yourblog,mytemplate,5(15),mycategory)%&gt;
1320 </pre>
1321
1322 </div>
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332 <div class="page">
1333 <a name="skinvar-item"></a>
1334 <h1>スキン変数:item</h1>
1335
1336 <p>現在選択されているアイテムを、指定されたテンプレートを用いて表示(コメントは除く)。</p>
1337
1338 <h2>引数</h2>
1339 <ul>
1340         <li><strong>template</strong>:使用するテンプレート名</li>
1341 </ul>
1342
1343 <h2>スキンタイプ</h2>
1344
1345 <p>個別アイテム</p>
1346
1347 <h2>例</h2>
1348
1349 <pre>
1350 &lt;%item(mytemplate)%&gt;
1351 </pre>
1352
1353 </div>
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363 <div class="page">
1364 <a name="skinvar-comments"></a>
1365 <h1>スキン変数:comments</h1>
1366
1367 <p>現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて表示。</p>
1368
1369 <h2>引数</h2>
1370 <ul>
1371         <li><strong>template</strong>:使用するテンプレート名</li>
1372 </ul>
1373
1374 <h2>スキンタイプ</h2>
1375
1376 <p>個別アイテム</p>
1377
1378 <h2>例</h2>
1379
1380 <pre>
1381 &lt;%comments(mytemplate)%&gt;
1382 </pre>
1383
1384 </div>
1385
1386
1387
1388
1389
1390
1391
1392 <div class="page">
1393 <a name="skinvar-archive"></a>
1394 <h1>スキン変数:archive</h1>
1395
1396 <p>選択された月と選択されているblog(普通はデフォルトのもの)のアーカイブを、指定されたテンプレートを用いて表示。</p>
1397
1398 <h2>引数</h2>
1399 <p>
1400         必須:
1401         <ul>
1402                 <li><strong>template</strong>:使用するテンプレート名</li>
1403         </ul>
1404         オプション:
1405         <ul>
1406                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1407         </ul>
1408 </p>
1409
1410 <h2>スキンタイプ</h2>
1411
1412 <p>月別アーカイブ</p>
1413
1414 <h2>例</h2>
1415
1416 <pre>
1417 &lt;%archive(mytemplate)%&gt;
1418 &lt;%archive(mytemplate,mycategory)%&gt;
1419 </pre>
1420
1421 </div>
1422
1423
1424
1425
1426 <div class="page">
1427 <a name="skinvar-otherarchive"></a>
1428 <h1>スキン変数:otherarchive</h1>
1429
1430 <p>選択された月のアーカイブを、指定されたblogとテンプレートを用いて表示。</p>
1431
1432 <h2>引数</h2>
1433 <p>
1434         必須:
1435         <ul>
1436                 <li><strong>blogname</strong>:使用するblogの名前(短縮名)</li>
1437                 <li><strong>template</strong>:使用するテンプレート名</li>
1438         </ul>
1439         オプション:
1440         <ul>
1441                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1442         </ul>
1443 </p>
1444
1445 <h2>スキンタイプ</h2>
1446
1447 <p>月別アーカイブ</p>
1448
1449 <h2>例</h2>
1450
1451 <pre>
1452 &lt;%otherarchive(myblog,mytemplate)%&gt;
1453 &lt;%otherarchive(myblog,mytemplate,mycategory)%&gt;
1454 </pre>
1455
1456 </div>
1457
1458
1459
1460
1461
1462
1463
1464 <div class="page">
1465 <a name="skinvar-archivelist"></a>
1466 <h1>スキン変数:archivelist</h1>
1467
1468 <p>現在選択しているblog(通常はデフォルトのもの)の存在するアーカイブのリストを、指定されたテンプレートを用いて表示。</p>
1469
1470 <h2>引数</h2>
1471 <p>
1472         必須:
1473         <ul>
1474                 <li><strong>template</strong>:使用するテンプレート名</li>
1475         </ul>
1476         オプション:
1477         <ul>
1478                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1479                 <li><strong><em>limit</em></strong>:表示するリンク数の制限(例えば、過去3ヶ月分へのリンクしか表示させたくないときなど)</li>
1480         </ul>
1481 </p>
1482
1483 <h2>スキンタイプ</h2>
1484
1485 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1486
1487 <h2>例</h2>
1488
1489 <pre>
1490 &lt;%archivelist(mytemplate)%&gt;
1491 &lt;%archivelist(mytemplate,mycategory)%&gt;
1492 </pre>
1493
1494 </div>
1495
1496 <div class="page">
1497 <a name="skinvar-archivedaylist"></a>
1498 <h1>スキン変数:archivedaylist</h1>
1499
1500 <p>スキン変数<a href="#skinvar-archivelist">archivelist</a>と同様ですが、<em>月</em>ごとの代わりに<em>日</em>ごとのエントリーを表示。</p>
1501
1502 <h2>引数</h2>
1503 <p>
1504         必須:
1505         <ul>
1506                 <li><strong>template</strong>:使用するテンプレート名</li>
1507         </ul>
1508         オプション:
1509         <ul>
1510                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1511                 <li><strong><em>limit</em></strong>表示するリンク数の制限(例えば、過去3日分へのリンクしか表示させたくないときなど)</li>
1512         </ul>
1513 </p>
1514
1515 <h2>スキンタイプ</h2>
1516
1517 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1518
1519
1520 <h2>例</h2>
1521
1522 <pre>
1523 &lt;%archivedaylist(mytemplate)%&gt;
1524 &lt;%archivedaylist(mytemplate,mycategory)%&gt;
1525 </pre>
1526
1527 </div>
1528
1529
1530 <div class="page">
1531 <a name="skinvar-otherarchivedaylist"></a>
1532 <h1>スキン変数:otherarchivedaylist</h1>
1533
1534 <p>スキン変数<a href="#skinvar-otherarchivelist">otherarchivelist</a>と同様ですが、<em>月</em>ごとの代わりに<em>日</em>ごとのエントリーを表示。</p>
1535
1536 <h2>引数</h2>
1537 <p>
1538         必須:
1539         <ul>
1540                 <li><strong>blogname</strong>:blogの名前(短縮名)</li>
1541                 <li><strong>template</strong>:使用するテンプレート名</li>
1542         </ul>
1543         Optional
1544         <ul>
1545                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1546         </ul>
1547 </p>
1548
1549 <h2>スキンタイプ</h2>
1550
1551 <p>すべて</p>
1552
1553 <h2>例</h2>
1554
1555 <pre>
1556 &lt;%otherarchivedaylist(yourblog,mytemplate)%&gt;
1557 &lt;%otherarchivedaylist(yourblog,mytemplate,mycategory)%&gt;
1558 </pre>
1559
1560 </div>
1561
1562
1563
1564 <div class="page">
1565 <a name="skinvar-otherarchivelist"></a>
1566 <h1>スキン変数:otherarchivelist</h1>
1567
1568 <p>指定されたblogの存在するアーカイブのリストを、指定されたテンプレートを用いて表示。</p>
1569
1570 <h2>引数</h2>
1571 <p>
1572         必須:
1573         <ul>
1574                 <li><strong>blogname</strong>:blogの名前(短縮名)</li>
1575                 <li><strong>template</strong>:使用するテンプレート名</li>
1576         </ul>
1577         Optional
1578         <ul>
1579                 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1580         </ul>
1581 </p>
1582
1583 <h2>スキンタイプ</h2>
1584
1585 <p>すべて</p>
1586
1587 <h2>例</h2>
1588
1589 <pre>
1590 &lt;%otherarchivelist(yourblog,mytemplate)%&gt;
1591 &lt;%otherarchivelist(yourblog,mytemplate,mycategory)%&gt;
1592 </pre>
1593
1594 </div>
1595
1596
1597
1598 <div class="page">
1599 <a name="skinvar-categorylist"></a>
1600 <h1>スキン変数:categorylist</h1>
1601
1602 <p>blog(デフォルトは選択されているblog)のカテゴリーリストを、指定されたテンプレートを用いて挿入。</p>
1603
1604 <h2>引数</h2>
1605 <p>
1606         必須:
1607         <ul>
1608                 <li><strong>template</strong>:使用するテンプレート名</li>
1609         </ul>
1610         オプション:
1611         <ul>
1612                 <li><strong><em>blogname</em></strong>:使用するblogの短縮名</li>
1613         </ul>
1614 </p>
1615
1616 <h2>スキンタイプ</h2>
1617
1618 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1619
1620 <h2>例</h2>
1621
1622 <pre>
1623 &lt;%categorylist(mytemplate)%&gt;
1624 &lt;%categorylist(mytemplate,myweblog)%&gt;
1625 </pre>
1626
1627 </div>
1628
1629
1630
1631 <div class="page">
1632 <a name="skinvar-category"></a>
1633 <h1>スキン変数:category</h1>
1634
1635 <p>現在選択されているカテゴリーに関するいくつかの情報を挿入。カテゴリーが選択されていないときは何も表示しない。</p>
1636
1637 <h2>引数</h2>
1638 <p>
1639         オプション:
1640         <ul>
1641                 <li><strong><em>type</em></strong>:どの情報を内包させるのか。<b>name</b>-カテゴリー名(デフォルト)、<b>desc</b>-カテゴリーの説明、<b>id</b>-カテゴリーのID、のどれかとなる。</li>
1642         </ul>
1643 </p>
1644
1645 <h2>スキンタイプ</h2>
1646
1647 <p>すべて</p>
1648
1649 <h2>例</h2>
1650
1651 <pre>
1652 &lt;%category%&gt;
1653 &lt;%category(id)%&gt;
1654 &lt;%category(desc)%&gt;
1655 &lt;%category(name)%&gt;
1656 </pre>
1657
1658 </div>
1659
1660
1661 <div class="page">
1662 <a name="skinvar-ifcat"></a>
1663 <h1>スキン変数:ifcat</h1>
1664
1665 <p class="deprecated">Nucleusのバージョン2.0以降では使いません。<a href="#skinvar-if">&lt;%if(category)%&gt;</a>を代わりに使ってください。</p>
1666
1667 <h2>引数</h2>
1668 <p>
1669         なし
1670         <ul>
1671                 <li><em>text</em>:表示するテキスト</li>
1672         </ul>
1673 </p>
1674
1675 <h2>スキンタイプ</h2>
1676
1677 <p>すべて</p>
1678
1679 <h2>例</h2>
1680
1681 <pre>
1682 &lt;%ifcat(Current Category: )%&gt;&lt;%category%&gt;
1683 </pre>
1684
1685 </div>
1686
1687
1688
1689
1690 <div class="page">
1691 <a name="skinvar-searchresults"></a>
1692 <h1>スキン変数:searchresults</h1>
1693
1694 <p>現在のクエリに対する検索結果を表示。</p>
1695
1696 <h2>引数</h2>
1697 <p>
1698         必須:
1699         <ul>
1700                 <li><strong>template</strong>:使用するテンプレート名</li>
1701         </ul>
1702         オプション:
1703         <ul>
1704                 <li><strong><em>maxresults</em></strong>:表示する結果の最大数</li>
1705         </ul>
1706 </p>
1707
1708 <h2>スキンタイプ</h2>
1709
1710 <p>検索</p>
1711
1712 <h2>例</h2>
1713
1714 <pre>
1715 &lt;%searchresults(mytemplate)%&gt;
1716 </pre>
1717
1718 </div>
1719
1720
1721
1722
1723 <div class="page">
1724 <a name="skinvar-othersearchresults"></a>
1725 <h1>スキン変数:othersearchresults</h1>
1726
1727 <p>指定されたblogの現在のクエリに対する検索結果を、指定されたテンプレートを用いて表示。</p>
1728
1729 <h2>引数</h2>
1730 <p>
1731         必須:
1732         <ul>
1733                 <li><strong>blogname</strong>:使用するblogの名前(短縮名)</li>
1734                 <li><strong>template</strong>:使用するテンプレート名</li>
1735         </ul>
1736         Optional:
1737         <ul>
1738                 <li><strong><em>maxresults</em></strong>:表示する結果の最大数</li>
1739         </ul>
1740 </p>
1741
1742 <h2>スキンタイプ</h2>
1743
1744 <p>検索</p>
1745
1746 <h2>例</h2>
1747
1748 <pre>
1749 &lt;%othersearchresults(myblog,mytemplate)%&gt;
1750 </pre>
1751
1752 </div>
1753
1754
1755
1756
1757
1758
1759
1760 <div class="page">
1761 <a name="skinvar-query"></a>
1762 <h1>スキン変数:query</h1>
1763
1764 <p>現在の検索クエリを挿入。</p>
1765
1766 <h2>引数</h2>
1767 <p>なし</p>
1768
1769 <h2>スキンタイプ</h2>
1770
1771 <p>検索</p>
1772
1773 <h2>例</h2>
1774
1775 <pre>
1776 &lt;%query%&gt;
1777 </pre>
1778
1779 </div>
1780
1781
1782
1783
1784
1785
1786
1787
1788 <div class="page">
1789 <a name="skinvar-version"></a>
1790 <h1>スキン変数:version</h1>
1791
1792 <p>現在使用しているNucleusのバージョンを挿入。</p>
1793
1794 <h2>引数</h2>
1795
1796 <p>なし</p>
1797
1798 <h2>スキンタイプ</h2>
1799
1800 <p>すべて</p>
1801
1802 <h2>例</h2>
1803
1804 <pre>
1805 &lt;%version%&gt;
1806 </pre>
1807
1808 </div>
1809
1810
1811
1812
1813
1814
1815
1816
1817 <div class="page">
1818 <a name="skinvar-previtem"></a>
1819 <h1>スキン変数:previtem</h1>
1820
1821 <p>そのblogにおける一つ前のアイテムのIDを挿入。</p>
1822
1823 <h2>引数</h2>
1824 <p>なし</p>
1825
1826 <h2>スキンタイプ</h2>
1827
1828 <p>個別アイテム</p>
1829
1830 <h2>例</h2>
1831
1832 <pre>
1833 &lt;%previtem%&gt;
1834 </pre>
1835
1836 </div>
1837
1838
1839
1840
1841
1842
1843 <div class="page">
1844 <a name="skinvar-nextitem"></a>
1845 <h1>スキン変数:nextitem</h1>
1846
1847 <p>そのblogにおける一つ先のアイテムのIDを挿入。</p>
1848
1849 <h2>引数</h2>
1850 <p>なし</p>
1851
1852 <h2>スキンタイプ</h2>
1853
1854 <p>個別アイテム</p>
1855
1856 <h2>例</h2>
1857
1858 <pre>
1859 &lt;%nextitem%&gt;
1860 </pre>
1861
1862 </div>
1863
1864
1865 <div class="page">
1866 <a name="skinvar-nextitemtitle"></a>
1867 <h1>スキン変数:nextitemtitle</h1>
1868
1869 <p>そのblogにおける一つ先のアイテムのタイトルを挿入。</p>
1870
1871 <h2>引数</h2>
1872 <p>なし</p>
1873
1874 <h2>スキンタイプ</h2>
1875
1876 <p>個別アイテム</p>
1877
1878 <h2>例</h2>
1879
1880 <pre>
1881 &lt;%nextitemtitle%&gt;
1882 </pre>
1883
1884 </div>
1885
1886
1887 <div class="page">
1888 <a name="skinvar-previtemtitle"></a>
1889 <h1>スキン変数:previtemtitle</h1>
1890
1891 <p>そのblogにおける一つ前のアイテムのタイトルを挿入。</p>
1892
1893 <h2>引数</h2>
1894 <p>なし</p>
1895
1896 <h2>スキンタイプ</h2>
1897
1898 <p>個別アイテム</p>
1899
1900 <h2>例</h2>
1901
1902 <pre>
1903 &lt;%previtemtitle%&gt;
1904 </pre>
1905
1906 </div>
1907
1908
1909
1910
1911 <div class="page">
1912 <a name="skinvar-prevarchive"></a>
1913 <h1>スキン変数:prevarchive</h1>
1914
1915 <p>一日前か一ヶ月前かどちらかのアーカイブに相当する、<code>アーカイブ</code>標識を挿入。この値はアーカイブを選択するURL内で利用することができる。</p>
1916
1917 <ul>
1918         <li>もし表示されているアーカイブが一日単位なら、値は<code>YYYY-MM-DD</code>という形をとる</li>
1919         <li>もし表示されているアーカイブが一ヶ月単位なら、値は<code>YYYY-MM</code>という形を取る</li>
1920 </ul>
1921
1922 <h2>引数</h2>
1923 <p>なし</p>
1924
1925 <h2>スキンタイプ</h2>
1926
1927 <p>月別アーカイブ</p>
1928
1929 <h2>例</h2>
1930
1931 <pre><code>&lt;a href="index.php?archive=&lt;%prevarchive%&gt;"&gt;....</code></pre>
1932
1933 </div>
1934
1935
1936
1937
1938
1939
1940 <div class="page">
1941 <a name="skinvar-nextarchive"></a>
1942 <h1>スキン変数:nextarchive</h1>
1943
1944 <p>一日先か一ヶ月先かどちらかのアーカイブに相当する、<code>アーカイブ</code>標識を挿入。この値はアーカイブを選択するURL内で利用することができる。
1945 </p>
1946
1947 <ul>
1948         <li>もし表示されているアーカイブが一日単位なら、値は<code>YYYY-MM-DD</code>という形をとる</li>
1949         <li>もし表示されているアーカイブが一ヶ月単位なら、値は<code>YYYY-MM</code>という形を取る</li>
1950 </ul>
1951
1952 <h2>引数</h2>
1953 <p>なし</p>
1954
1955 <h2>スキンタイプ</h2>
1956
1957 <p>月別アーカイブ</p>
1958
1959 <h2>例</h2>
1960
1961 <pre><code>&lt;a href="index.php?archive=&lt;%nextarchive%&gt;"&gt;....</code></pre>
1962
1963 </div>
1964
1965
1966 <div class="page">
1967 <a name="skinvar-archivetype"></a>
1968 <h1>スキン変数:archivetype</h1>
1969
1970 <p><tt>日単位</tt>か<tt>月単位</tt>、どちらのアーカイブタイプが現在表示されているのか示す。</p>
1971
1972 <h2>引数</h2>
1973 <p>なし</p>
1974
1975 <h2>スキンタイプ</h2>
1976
1977 <p>月別アーカイブ</p>
1978
1979 </div>
1980
1981
1982
1983
1984
1985 <div class="page">
1986 <a name="skinvar-todaylink"></a>
1987 <h1>スキン変数:todaylink</h1>
1988
1989 <p>weblogのメインページへのリンクを挿入。現在選択されているblogとカテゴリーが考慮される。</p>
1990
1991 <h2>引数</h2>
1992 <p>
1993         オプション:(2.5からです)
1994         <ul>
1995                 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code>&lt;a href...</code>タグがアウトプットされる</li>
1996         </ul>
1997 </p>
1998
1999
2000 <h2>スキンタイプ</h2>
2001
2002 <p>すべて</p>
2003
2004 <h2>例</h2>
2005
2006 <pre>
2007 &lt;%todaylink%&gt;
2008 </pre>
2009
2010 </div>
2011
2012
2013
2014
2015
2016
2017
2018 <div class="page">
2019 <a name="skinvar-archivelink"></a>
2020 <h1>スキン変数:archivelink</h1>
2021
2022 <p>現在選択しているblogとカテゴリー(blogが選択されていないときはデフォルトのblog)のアーカイブへのリンクを挿入。</p>
2023
2024 <h2>引数</h2>
2025
2026 <p>
2027         オプション:(2.5から)
2028         <ul>
2029                 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code>&lt;a href...</code>タグがアウトプットされる</li>
2030         </ul>
2031 </p>
2032
2033
2034 <h2>スキンタイプ</h2>
2035
2036 <p>すべて</p>
2037
2038 <h2>例</h2>
2039
2040 <pre>
2041 &lt;%archivelink%&gt;
2042 </pre>
2043
2044 </div>
2045
2046
2047
2048
2049
2050
2051 <div class="page">
2052 <a name="skinvar-nextlink"></a>
2053 <h1>スキン変数:nextlink</h1>
2054
2055 <p>アイテムページにおいては一つ先のアイテムへの、アーカイブページにおいては一つ先のアーカイブへのリンクを挿入。</p>
2056
2057 <h2>引数</h2>
2058 <p>
2059         オプション:(2.5から)
2060         <ul>
2061                 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code>&lt;a href...</code>タグがアウトプットされる</li>
2062                 <li><strong><em>amount</em></strong>:「検索」と「メインの目次」において:前または先のページに進んだときに表示されるアイテムの数</li>
2063         </ul>
2064 </p>
2065
2066
2067 <h2>スキンタイプ</h2>
2068
2069 <p>個別アイテム、月別アーカイブ、検索、メインの目次</p>
2070
2071 <h2>例</h2>
2072
2073 <pre>
2074 &lt;%nextlink%&gt;
2075 </pre>
2076
2077 </div>
2078
2079
2080
2081
2082
2083
2084
2085
2086 <div class="page">
2087 <a name="skinvar-prevlink"></a>
2088 <h1>スキン変数:prevlink</h1>
2089
2090 <p>アイテムページにおいては一つ前のアイテムへの、アーカイブページにおいては一つ前のアーカイブへのリンクを挿入。「検索」と「メインの目次」でも使える。</p>
2091
2092 <h2>引数</h2>
2093 <p>
2094         オプション:(2.5から)
2095         <ul>
2096                 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code>&lt;a href...</code>タグがアウトプットされる</li>
2097                 <li><strong><em>amount</em></strong>:「検索」と「メインの目次」において:前または先のページに進んだときに表示されるアイテムの数</li>
2098         </ul>
2099 </p>
2100
2101 <h2>スキンタイプ</h2>
2102
2103 <p>個別アイテム、月別アーカイブ、検索、メインの目次</p>
2104
2105 <h2>例</h2>
2106
2107 <pre>
2108 &lt;%prevlink%&gt;
2109 </pre>
2110
2111 </div>
2112
2113
2114
2115
2116
2117
2118
2119
2120 <div class="page">
2121 <a name="skinvar-errormessage"></a>
2122 <h1>スキン変数:errormessage</h1>
2123
2124 <p>エラーが発生したときに、それに相当するメッセージを挿入。</p>
2125
2126 <h2>引数</h2>
2127 <p>なし</p>
2128
2129 <h2>スキンタイプ</h2>
2130
2131 <p>エラー</p>
2132
2133 <h2>例</h2>
2134
2135 <pre>
2136 &lt;%errormessage%&gt;
2137 </pre>
2138
2139 </div>
2140
2141
2142
2143
2144
2145
2146
2147
2148 <div class="page">
2149 <a name="skinvar-imagetext"></a>
2150 <h1>スキン変数:imagetext</h1>
2151
2152 <p class="deprecated">このスキン変数はNucleusバージョン2.0以降使いません。代わりに<a href="#skinvar-image"><code>&lt;%image(caption)%&gt;</code></a>を使ってください。</p>
2153
2154 <p>ポップアップ画像に見出しテキストをつける</p>
2155
2156 <h2>引数</h2>
2157 <p>なし</p>
2158
2159 <h2>スキンタイプ</h2>
2160
2161 <p>画像ポップアップウィンドウ</p>
2162
2163 <h2>例</h2>
2164
2165 <pre>
2166 &lt;%imagetext%&gt;
2167 </pre>
2168
2169 </div>
2170
2171
2172
2173 <div class="page">
2174 <a name="skinvar-image"></a>
2175 <h1>スキン変数:image</h1>
2176
2177 <p>選択された画像を挿入(画像ポップアップ用)</p>
2178
2179 <h2>引数</h2>
2180
2181 <p>オプション:</p>
2182 <ul>
2183         <li>
2184                 <em>タイプ</em>
2185                 <table><tr>
2186                         <td><strong>imgtag</strong>(デフォルト)</td>
2187                         <td>完全なXHTMLタグ <code>&lt;img ... /&gt;</code></td>
2188                 </tr><tr>
2189                         <td><strong>url</strong></td>
2190                         <td>画像ファイルへのURL</td>
2191                 </tr><tr>
2192                         <td><strong>width</strong></td>
2193                         <td>イメージの幅</td>
2194                 </tr><tr>
2195                         <td><strong>height</strong></td>
2196                         <td>イメージの高さ</td>
2197                 </tr><tr>
2198                         <td><strong>caption</strong></td>
2199                         <td>画像の見出し(画像と共に表示されるテキスト)</td>
2200                 </tr></table>
2201         </li>
2202 </ul>
2203
2204 <h2>スキンタイプ</h2>
2205
2206 <p>画像ポップアップウィンドウ</p>
2207
2208 <h2>例</h2>
2209
2210 <pre>
2211 &lt;%image%&gt;
2212 </pre>
2213
2214 </div>
2215
2216
2217 <div class="page">
2218 <a name="skinvar-vars"></a>
2219 <h1>スキン変数:vars</h1>
2220
2221 <p class="deprecated">このスキン変数はNucleusバージョン2.0以降使いません。<a href="#skinvar-itemid">スキン変数:itemid</a>を使ってこのHTMLをあなた自身で挿入することはたいした手間ではないでしょう。</p>
2222
2223 <p>itemidの入り隠しフォームのインプット欄を挿入。</p>
2224
2225 <code>&lt;input type="hidden" name="itemid" value="<strong>1234</strong>" /&gt;</code>
2226
2227 <h2>引数</h2>
2228 <p>なし</p>
2229
2230 <h2>スキンタイプ</h2>
2231
2232 <p>個別アイテム</p>
2233
2234
2235 </div>
2236
2237
2238
2239
2240
2241
2242 <div class="page">
2243 <a name="skinvar-sitevar"></a>
2244 <h1>スキン変数:sitevar</h1>
2245
2246 <p>サイト変数をインクルードする。</p>
2247
2248 <h2>引数</h2>
2249 <ul>
2250         <li><strong>タイプ</strong>:表示される変数の名前
2251         <ul>
2252                 <li><em>url</em>:サイトのURL</li>
2253                 <li><em>name</em>:サイトの名前</li>
2254                 <li><em>admin</em>:管理者のメールアドレス</li>
2255         </ul>
2256         </li>
2257 </ul>
2258
2259 <h2>スキンタイプ</h2>
2260
2261 <p>すべて</p>
2262
2263 <h2>例</h2>
2264
2265 <pre>
2266 &lt;%sitevar(name)%&gt;
2267 &lt;%sitevar(url)%&gt;
2268 &lt;a href="mailto:&lt;%sitevar(email)%&gt;"&gt;管理人&lt;/a&gt;
2269 </pre>
2270
2271 </div>
2272
2273
2274
2275
2276
2277
2278 <div class="page">
2279 <a name="skinvar-blogsetting"></a>
2280 <h1>スキン変数:blogsetting</h1>
2281
2282 <p>現在選択しているblog(普通はデフォルトのもの)の詳細な設定を挿入。</p>
2283
2284 <h2>引数</h2>
2285 <ul>
2286         <li><strong>タイプ</strong>:どの設定が入れられるか
2287             <ul>
2288                 <li><em>id</em>:該当blogのID</li>
2289                 <li><em>url</em>:該当blogのURL</li>
2290                 <li><em>name</em>:該当blogの名前(長い名前)</li>
2291                 <li><em>desc</em>:該当blogの説明</li>
2292                 <li><em>short</em>:該当blogの短縮名</li> 
2293             </ul>
2294         </li>
2295 </ul>
2296
2297 <h2>スキンタイプ</h2>
2298
2299 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細</p>
2300
2301 <h2>例</h2>
2302
2303 <pre>
2304 &lt;%blogsetting(name)%&gt;
2305 &lt;%blogsetting(id)%&gt;
2306 &lt;%blogsetting(desc)%&gt;
2307 &lt;a href="&lt;%blogsetting(url)%&gt;"&gt;...&lt;/a&gt;
2308 </pre>
2309
2310 </div>
2311
2312
2313
2314
2315
2316
2317 <div class="page">
2318 <a name="skinvar-member"></a>
2319 <h1>スキン変数:member</h1>
2320
2321 <p>現在ログインしているメンバーに関する情報を挿入。メンバーの詳細ページにおいては、要求されたメンバーについての同じ情報を表示する追加オプションがある。</p>
2322
2323 <p>ログインしていない訪問者の場合は、<em>your...</em>のパラメーターは何も挿入しない。</p>
2324
2325 <h2>引数</h2>
2326 <ul>
2327         <li><strong>タイプ</strong>:表示される情報
2328                 <p>ログインしたメンバーの情報:</p>
2329             <ul>
2330                 <li><em>yourname</em>:メンバーのニックネーム(ログインに使うもの)</li>
2331                 <li><em>yourrealname</em>:メンバーのフルネーム</li>
2332                 <li><em>yournotes</em>:メンバーが自身のために設定できるその他の情報(備考欄)</li>
2333                 <li><em>yoururl</em>:メンバーのウェブサイトURL</li>
2334                 <li><em>youremail</em>:メンバーのメールアドレス</li>
2335                 <li><em>yourid</em>:メンバーのID</li>
2336             </ul>
2337             <p>要求されたメンバーの情報(「メンバー詳細」のページでのみ利用可):</p>
2338             <ul>
2339                 <li><em>name</em>:メンバーのニックネーム(ログインに使うもの)</li>
2340                 <li><em>realname</em>:メンバーのフルネーム</li>
2341                 <li><em>notes</em>:メンバーが自身のために設定できるその他の情報(備考欄)</li>
2342                 <li><em>url</em>:メンバーのウェブサイトURL</li>
2343                 <li><em>email</em>:メンバーのメールアドレス</li>
2344                 <li><em>id</em>:メンバーのID</li>
2345             </ul>
2346         </li>
2347 </ul>
2348
2349 <h2>スキンタイプ</h2>
2350
2351 <p>すべて</p>
2352
2353 <h2>例</h2>
2354
2355 <pre><code>
2356 &lt;%if(loggedin)%&gt;
2357 こんにちは&lt;%member(yourrealname)%&gt;さん
2358 &lt;%endif%&gt;
2359 </code></pre>
2360
2361 </div>
2362
2363
2364
2365
2366
2367
2368 <div class="page">
2369 <a name="skinvar-preview"></a>
2370 <h1>スキン変数:preview</h1>
2371
2372 <p>指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入。(<a href="#skinvar-additemform">additemform</a>に関連して使われる)</p>
2373
2374 <h2>引数</h2>
2375 <ul>
2376         <li><strong>template</strong>:使用されるテンプレート名</li>
2377 </ul>
2378
2379 <h2>スキンタイプ</h2>
2380
2381 <p>メインの目次</p>
2382
2383 <h2>例</h2>
2384
2385 <pre>
2386 &lt;%preview(mytemplate)%&gt;
2387 </pre>
2388
2389 </div>
2390
2391
2392
2393 <div class="page">
2394 <a name="skinvar-adminurl"></a>
2395 <h1>スキン変数:adminurl</h1>
2396
2397 <p>管理領域への完全なURLを挿入。</p>
2398
2399 <h2>引数</h2>
2400 <p>なし</p>
2401
2402 <h2>スキンタイプ</h2>
2403
2404 <p>すべて</p>
2405
2406 <h2>例</h2>
2407
2408 <pre>
2409 &lt;a href="&lt;%adminurl%&gt;"&gt;管理領域&lt;/a&gt;
2410 </pre>
2411
2412 </div>
2413
2414
2415
2416
2417 <div class="page">
2418 <a name="skinvar-additemform"></a>
2419 <h1>スキン変数:additemform</h1>
2420
2421 <p>現在選択しているblog(普通はデフォルトのもの)へのアイテム追加フォームを表示。ほとんどの場合、<a href="#skinvar-preview">preview</a>と共に使われる。</p>
2422
2423 <h2>引数</h2>
2424 <p>なし</p>
2425
2426 <h2>スキンタイプ</h2>
2427
2428 <p>メインの目次</p>
2429
2430 <h2>例</h2>
2431
2432 <pre>
2433 &lt;%additemform%&gt;
2434 </pre>
2435
2436 </div>
2437
2438
2439
2440
2441
2442
2443 <div class="page">
2444 <a name="skinvar-include"></a>
2445 <h1>スキン/テンプレート変数:include</h1>
2446
2447 <p>テキストファイルをアウトプット時に取り込む。ファイルの中身はなんらかの構文解析にかけられることは無いので、スキン/テンプレート変数やPHPコードを使うことはできない。(もしインクルード時に展開させたいなら、<a href="#skinvar-parsedinclude">parsedinclude</a>と<a href="#skinvar-phpinclude">phpinclude</a>をみること)</p>
2448
2449 <h2>引数</h2>
2450 <ul>
2451         <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。ここでURLを使うこともできることに注目を。</li>
2452 </ul>
2453
2454 <h2>注意</h2>
2455 <ul>
2456         <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2457 </ul>
2458
2459 <h2>スキンタイプ</h2>
2460
2461 <p>すべて</p>
2462
2463 <h2>例</h2>
2464
2465 <pre>
2466 &lt;%include(filename.txt)%&gt;
2467 &lt;%include(/home/user/myself/filename.txt)%&gt;
2468 &lt;%include(http://mydomain.com/filename.html)%&gt;
2469 </pre>
2470
2471 </div>
2472
2473
2474
2475
2476
2477
2478
2479 <div class="page">
2480 <a name="skinvar-phpinclude"></a>
2481 <h1>スキン/テンプレート変数:phpinclude</h1>
2482
2483 <p>PHPファイルをアウトプット時にインクルードする。ファイルの中身はPHPとして解釈されるので注意すること。Nucleusのスキン/テンプレート変数は展開<b>されない</b>。(他のインクルードオプションとして、<a href="#skinvar-parsedinclude">parsedinclude</a>と<a href="#skinvar-include">include</a>をみること)</p>
2484
2485 <h2>引数</h2>
2486 <ul>
2487         <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。</li>
2488 </ul>
2489
2490 <h2>注意</h2>
2491 <ul>
2492         <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2493         <li>ファイルはスタンダードなphpのコマンド<code>include()</code>を使ってインクルードされます。このコマンドは<em>内部の</em>クラス・メソッドから呼び出されるので、自身で<strong>アクセスしたいグローバル変数を宣言する必要があります</strong>。多くの<a href="#skinvar-phpinclude-vars">標準的な変数</a>はNucleusによって自動的にグローバルが宣言されます。</li>
2494 </ul>
2495
2496 <h2>スキンタイプ</h2>
2497
2498 <p>すべて</p>
2499
2500 <h2>例</h2>
2501
2502 <pre><code>&lt;%phpinclude(filename.php)%&gt;
2503 &lt;%phpinclude(/home/user/myself/filename.php)%&gt;</code></pre>
2504
2505 </div>
2506
2507
2508
2509 <div class="page">
2510 <a name="skinvar-phpinclude-vars"></a>
2511 <h1>スキン/テンプレート変数:phpinclude:vars</h1>
2512
2513 <p>次のグローバル変数は、スキン/テンプレート変数の<a href="#skinvar-phpinclude">phpinclude</a>によってインクルードされたファイルからアクセスできるものです:</p>
2514
2515 <p>
2516 $GATEWAY_INTERFACE, $SERVER_NAME, $SERVER_SOFTWARE
2517 <br />$SERVER_PROTOCOL, $REQUEST_METHOD, $QUERY_STRING
2518 <br />$DOCUMENT_ROOT, $HTTP_ACCEPT, $HTTP_ACCEPT_CHARSET
2519 <br />$HTTP_ACCEPT_ENCODING, $HTTP_ACCEPT_LANGUAGE
2520 <br />$HTTP_CONNECTION, $HTTP_HOST, $HTTP_REFERER
2521 <br />$HTTP_USER_AGENT, $REMOTE_ADDR, $REMOTE_PORT
2522 <br />$SCRIPT_FILENAME, $SERVER_ADMIN, $SERVER_PORT
2523 <br />$SERVER_SIGNATURE, $PATH_TRANSLATED, $SCRIPT_NAME
2524 <br />$REQUEST_URI, $argv, $argc, $PHP_SELF
2525 <br />$HTTP_COOKIE_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS
2526 <br />$HTTP_POST_FILES, $HTTP_ENV_VARS, $HTTP_SERVER_VARS
2527 <br />$HTTP_SESSION_VARS, $PATH_INFO, $HTTPS
2528 <br />$HTTP_RAW_POST_DATA, $HTTP_X_FORWARDED_FOR
2529 </p>
2530
2531 <p>他の変数に関しては、'<tt>global $varname;</tt>'をきっちりとコードに加える必要があります。</p>
2532
2533 </div>
2534
2535
2536
2537 <div class="page">
2538 <a name="skinvar-parsedinclude"></a>
2539 <h1>スキン/テンプレート変数:parsedinclude</h1>
2540
2541 <p>ファイルをアウトプット時に取り込む。ファイルの中身はNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数を使うことができる。(他のインクルードオプションとして、<a href="#skinvar-phpinclude">phpinclude</a>と<a href="#skinvar-include">include</a>をみること)</p>
2542
2543 <h2>引数</h2>
2544 <ul>
2545         <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。</li>
2546 </ul>
2547
2548 <h2>注意</h2>
2549 <ul>
2550         <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2551         <li>インクルードしたファイルの中からでも、再び<code>&lt;%parsedinclude(filename)%&gt;</code>を呼び出すことができます。無限ループを避けるため、行えるのは最大で3段階となります。</li>
2552 </ul>
2553
2554
2555 <h2>スキンタイプ</h2>
2556
2557 <p>すべて</p>
2558
2559 <h2>例</h2>
2560
2561 <pre>
2562 &lt;%parsedinclude(filename.txt)%&gt;
2563 &lt;%parsedinclude(/home/user/myself/filename.txt)%&gt;
2564 </pre>
2565
2566 </div>
2567
2568
2569
2570
2571
2572
2573 <div class="page">
2574 <a name="skinvar-plugin"></a>
2575 <h1>スキン/テンプレート変数:plugin</h1>
2576
2577 <p>プラグインを呼び出す。</p>
2578
2579 <h2>引数</h2>
2580 <ul>
2581         <li>
2582                 <p>必須:</p>
2583                 <table><tr>
2584                         <th>名前</th>
2585                         <th>内容</th>
2586                 </tr><tr>
2587                         <td>PlugName</td>
2588                         <td>呼び出されるプラグインの名前。<strong>この名前は注意をはらうべき部分</strong></td>
2589                 </tr></table>
2590         </li>
2591         <li><p>プラグインによっては、その他のパラメーターが追加される。</p></li>
2592 </ul>
2593
2594 <h2>注意</h2>
2595 <ul>
2596         <li>プラグイン名が既存の変数とぶつからない場合、<code>&lt;%PluginName(parameters)%&gt;</code>を用いて直接呼び出すことができます。</li>
2597 </ul>
2598
2599 <h2>スキンタイプ</h2>
2600
2601 <p>すべて</p>
2602
2603 <h2>例</h2>
2604
2605 <pre>
2606 &lt;%plugin(Calendar)%&gt;
2607 &lt;%plugin(LastComments,myweblog)%&gt;
2608 &lt;%LastComments(myweblog)%&gt;
2609 </pre>
2610
2611 </div>
2612
2613
2614
2615
2616 <div class="page">
2617 <a name="skinvar-loginform"></a>
2618 <h1>スキン変数:loginform</h1>
2619
2620 <p>ログインフォームを加えるか、"ログイン中:karma !(ログアウト)"メッセージを表示する</p>
2621
2622 <h2>引数</h2>
2623 <p>なし</p>
2624
2625 <h2>スキンタイプ</h2>
2626
2627 <p>すべて</p>
2628
2629 <h2>例</h2>
2630
2631 <pre><code>&lt;%loginform%&gt;</code></pre>
2632
2633 </div>
2634
2635
2636
2637
2638 <div class="page">
2639 <a name="skinvar-commentform"></a>
2640 <h1>スキン変数:commentform</h1>
2641
2642 <p>アイテムページにコメントフォームを加える。</p>
2643
2644 <h2>引数</h2>
2645 <p>
2646         オプション:
2647         <ul>
2648                 <li><strong><em>destinationurl</em></strong>:コメント追加後にリダイレクトさせるURLを設定(デフォルトでは、投稿したアイテムの「アイテム詳細」ページにリダイレクトされる)</li>
2649         </ul>
2650 </p>
2651
2652 <h2>スキンタイプ</h2>
2653
2654 <p>個別アイテム</p>
2655
2656 <h2>例</h2>
2657
2658 <pre>
2659 &lt;%commentform%&gt;
2660 &lt;%commentform(http://host/thanks.html)%&gt;
2661 </pre>
2662
2663 </div>
2664
2665
2666
2667 <div class="page">
2668 <a name="skinvar-set"></a>
2669 <h1>スキン/テンプレート変数 set</h1>
2670
2671 <p><a href="#parser-properties" title="A list of available parser properties">パーサーのプロパティ</a>を設定する。</p>
2672
2673 <h2>引数</h2>
2674 <p>
2675         <ul>
2676                 <li><strong>property</strong>:プロパティの名前</li>
2677                 <li><strong>value</strong>:プロパティの値</li>
2678         </ul>
2679 </p>
2680
2681 <h2>スキンタイプ</h2>
2682
2683 <p>すべて</p>
2684
2685 <h2>例</h2>
2686
2687 <pre>
2688 &lt;%set(IncludeMode,skindir)%&gt;
2689 &lt;%set(IncludePrefix,somedir/)%&gt;
2690 </pre>
2691
2692 </div>
2693
2694
2695 <div class="page">
2696 <a name="skinvar-skinfile"></a>
2697 <h1>スキン/テンプレート変数:skinfile</h1>
2698
2699 <p>インポートされたスキンから、スキンのURLに相対リンクを張るときに使う。最良の結果を得るためには、<a href="#parser-properties">パーサーのプロパティ</a><tt>IncludePrefix</tt>と共に使うこと。</p>
2700
2701 <h2>引数</h2>
2702 <p>
2703         <ul>
2704                 <li><strong>filename</strong>:ファイルの名前(正確なURLに変換される)</li>
2705         </ul>
2706 </p>
2707
2708 <h2>スキンタイプ</h2>
2709
2710 <p>すべて</p>
2711
2712 <h2>例</h2>
2713
2714 <pre>
2715 &lt;%skinfile(mystyle.css)%&gt;
2716 </pre>
2717
2718 </div>
2719
2720
2721
2722 <div class="page">
2723 <a name="skinvar-skinname"></a>
2724 <h1>スキン/テンプレート変数:skinname</h1>
2725
2726 <p>現在使用しているスキンの名前を挿入。</p>
2727
2728 <h2>引数</h2>
2729 <p>なし</p>
2730
2731 <h2>スキンタイプ</h2>
2732
2733 <p>すべて</p>
2734
2735 <h2>例</h2>
2736
2737 <pre>
2738 &lt;%skinname%&gt;
2739 </pre>
2740
2741 </div>
2742
2743
2744
2745 <div class="page">
2746 <a name="skinvar-if"></a>
2747 <a name="skinvar-else"></a>
2748 <a name="skinvar-endif"></a>
2749 <h1>スキン変数:if/else/endif</h1>
2750
2751 <p>決まった条件を満たしているときのみ、コンテンツ・ブロックを挿入。</p>
2752
2753 <h2>引数</h2>
2754 <p>スキン変数<code>if</code>のみオプションがある</p>
2755
2756
2757 <ul>
2758         <li><strong>type</strong>:条件の種類</li>
2759         <li><em>name</em>:オプションの名前(必須ではない)</li>
2760         <li><em>value</em>:チェックする値(必須ではない)</li>
2761 </ul>
2762
2763 <h2>条件の種類</h2>
2764
2765 <ul>
2766         <li><strong>category</strong>:カテゴリーを選択しているとき、条件は満たされる
2767                 <ul>
2768                   <li><strong>category</strong>:カテゴリが選択いるか調べる</li>
2769                   <li><strong>category,catname,<em>CategoryName</em></strong>:現在のカテゴリが <em>CategoryName</em> と一致するか調べる</li>
2770                   <li><strong>category,catid,<em>CategoryID</em></strong>:現在のカテゴリが <em>CategoryId</em> と一致するか調べる</li>
2771                 </ul>
2772         </li>
2773         <li><strong>blogsetting</strong>:blog設定の<em>name</em>項目の値が<em>value</em>と一致しているか調べる(nameはSQLテーブルnucleus_blogにあるカラム名)</li>
2774         <li><strong>loggedin</strong>:訪問中のメンバーが現在ログインしていれば、条件は満たされる</li>
2775         <li><strong>onteam</strong>:訪問中のメンバーがログインしており、かつ現在いるblog(あるいは<em>name</em>パラメーターで指示されたblog)のチームに入っていれば、条件は満たされる</li>
2776         <li><strong>previtem</strong>:もし現在のweblogにより新しいアイテムがあるのなら真となる(スキンタイプは個別アイテム 2.5から) (item skintype)</li>
2777         <li><strong>nextitem</strong>:もし現在のweblogにより古いアイテムがあるのなら真となる(スキンタイプは個別アイテム 2.5から)</li>
2778         <li><strong>skintype</strong>:現在のスキンタイプが<em>value</em>(index, search, item, archive, archivelist, ...)と一致するか調べる(URLでの表記となることに注意 2.5から)</li>
2779         <li><strong>hasplugin</strong>:プラグインがインストールされているか、またはプラグインのオプションが特定の値をとっているか調べる
2780                 <ul>
2781                         <li><strong>hasplugin,<em>PluginName</em></strong>:該当プラグインが存在すれば、条件は満たされる</li>
2782                         <li><strong>hasplugin,<em>PluginName</em>,<em>OptionName</em></strong>:プラグインのオプションが「いいえ」に設定されてなければ、条件は満たされる</li>
2783                         <li><strong>hasplugin,<em>PluginName</em>,<em>OptionName=value</em></strong>:プラグインのオプションが特定の値に設定されていれば、条件は満たされる</li>
2784                 </ul>
2785         </li>
2786 </ul>
2787
2788 <h2>スキンタイプ</h2>
2789
2790 <p>すべて</p>
2791
2792 <h2>例</h2>
2793
2794 <pre>
2795 &lt;%if(loggedin)%&gt;
2796 おかえりなさい!
2797 &lt;%else%&gt;
2798 ようこそ!
2799 &lt;%endif%&gt;
2800 </pre>
2801
2802 <pre>
2803 &lt;%if(category,catname,Off Topic)%&gt;
2804 'Off Topic' カテゴリへようこそ。
2805 &lt;%endif%&gt;
2806 </pre>
2807
2808 <h2>注意</h2>
2809
2810 <p>条件が満たされない時にだけ何らかの表示を行いたい場合は、次のようにすることができます:</p>
2811
2812 <pre>
2813 &lt;%if(skintype,error)%&gt;&lt;%else%&gt;
2814 &lt;%blogsetting(name)%&gt;
2815 &lt;%endif%&gt;
2816 </pre>
2817
2818 </div>
2819
2820
2821
2822
2823
2824
2825 <div class="page">
2826 <a name="skinvar-membermailform"></a>
2827 <h1>スキン変数:membermailform</h1>
2828
2829 <p>(メンバー詳細のページで)詳細が表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを表示。</p>
2830
2831 <h2>引数</h2>
2832 <p>
2833         オプション:
2834         <ul>
2835                 <li><strong><em>rows</em></strong>:ボックスの横列の数値(デフォルトは10)</li>
2836                 <li><strong><em>cols</em></strong>:ボックスの縦列の数値(デフォルトは40)</li>
2837                 <li><strong><em>destination url</em></strong>:メッセージが送信された後リダイレクトするURL</li>
2838         </ul>
2839 </p>
2840
2841 <h2>スキンタイプ</h2>
2842
2843 <p>メンバー詳細</p>
2844
2845 <h2>例</h2>
2846
2847 <pre>
2848 &lt;%membermailform%&gt;
2849 </pre>
2850
2851 </div>
2852
2853
2854
2855
2856
2857
2858 <div class="page">
2859 <a name="skinvar-searchform"></a>
2860 <h1>スキン変数:searchform</h1>
2861
2862 <p>現在のblogに対する検索フォームを表示。</p>
2863
2864 <h2>引数</h2>
2865 <p>
2866         オプション:
2867         <ul>
2868                 <li><strong><em>blogname</em></strong>:検索を実行するblogの名前(短縮名)</li>
2869         </ul>
2870 </p>
2871
2872 <h2>スキンタイプ</h2>
2873
2874 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム</p>
2875
2876 <h2>例</h2>
2877
2878 <pre>
2879 &lt;%searchform%&gt;
2880 &lt;%searchform(otherweblog)%&gt;
2881 </pre>
2882
2883 </div>
2884
2885
2886
2887
2888
2889
2890 <div class="page">
2891 <a name="skinvar-nucleusbutton"></a>
2892 <h1>スキン変数:nucleusbutton</h1>
2893
2894 <p><a href="http://nucleuscms.org/" class="out" onclick="window.open(this.href);return false;" title="Nucleus website (opens in new window)">Nucleusウェブサイト</a>へのリンクが付いた、ボタン(あるいはバナー)を挿入。</p>
2895
2896 <h2>引数</h2>
2897 <p>
2898         オプション:
2899         <ul>
2900                 <li><strong><em>imgurl</em></strong>:画像のURL(デフォルトのものを使わない場合)</li>
2901                 <li><strong><em>imgwidth</em></strong>:画像の横幅(ピクセル単位)</li>
2902                 <li><strong><em>imgheight</em></strong>: 画像の高さ(ピクセル単位)</li>
2903         </ul>
2904 </p>
2905
2906 <h2>注意</h2>
2907 <ul>
2908         <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2909 </ul>
2910
2911 <h2>スキンタイプ</h2>
2912
2913 <p>すべて</p>
2914
2915 <h2>例</h2>
2916
2917 <pre>
2918 &lt;%nucleusbutton%&gt;
2919 &lt;%nucleusbutton(nucleus/nucleus.gif,46,43)%&gt;
2920 </pre>
2921
2922 </div>
2923
2924
2925
2926
2927 <div class="page">
2928 <a name="skinvar-self"></a>
2929 <h1>スキン変数:self</h1>
2930
2931 <p>現在表示しているページのファイル名を挿入(index.phpか変更しているならそのファイル名)</p>
2932
2933 <h2>引数</h2>
2934 <p>なし</p>
2935
2936 <h2>スキンタイプ</h2>
2937
2938 <p>すべて</p>
2939
2940 <h2>例</h2>
2941
2942 <pre>
2943 &lt;%self%&gt;
2944 </pre>
2945
2946 </div>
2947
2948
2949
2950
2951
2952
2953
2954
2955 <div class="page">
2956 <a name="templatevars-overview"></a>
2957 <h1>テンプレート変数:概略</h1>
2958
2959 <h2>どういったものなのか?</h2>
2960
2961 <p>テンプレート変数は、厳密にいうならスキン変数と同じ方法で広く働きます。唯一の違いはテンプレート内部で利用できることでしょう。変数は<code>&lt;%<i>varname</i>%&gt;</code>という形を用いて呼び出され、変数の機能によってはテキストをインクルードします。また、その他のオプションパラメーターを持つ変数もあります。</p>
2962
2963 <h2>利用可能な変数</h2>
2964
2965 <p>これらテンプレート変数は、次のテンプレート部品で使われます:<tt>「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」</tt>。(変数<tt>image</tt>、<tt>popup</tt>、<tt>media</tt>もまたweblogアイテムの中で使われます。)</p>
2966
2967 <ul>
2968         <li><a href="#templatevars-basic">基本の変数・・・</a>(title、bodyなど...)</li>
2969         <li><a href="#templatevars-advanced">上級の変数・・・</a>(include、pluginなど...)</li>
2970 </ul>
2971
2972 <p>コメント関連のテンプレート部品(<tt>「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」</tt>)は利用可能な変数のセットが異なります:</p>
2973
2974 <ul>
2975         <li><a href="#templatevars-comments">コメント関連の変数・・・</a></li>
2976 </ul>
2977
2978
2979 </div>
2980
2981
2982
2983 <div class="page">
2984 <a name="templatevars-basic"></a>
2985 <h1>テンプレート変数:基本の変数</h1>
2986
2987 <p>これらすべての変数は、そのときパースされているアイテムに関わる値となります。</p>
2988
2989 <table><tr>
2990         <th>名前</th>
2991         <th>説明</th>
2992 </tr><tr>
2993         <td>title</td>
2994         <td>アイテムのタイトル</td>
2995 </tr><tr>
2996         <td>body</td>
2997         <td>本文のテキスト</td>
2998 </tr><tr>
2999         <td>more</td>
3000         <td>続きのテキスト</td>
3001 </tr><tr>
3002         <td>category</td>
3003         <td>カテゴリーの名前</td>
3004 </tr><tr>
3005         <td>categorylink</td>
3006         <td>カテゴリーへの未加工のリンク</td>
3007 </tr><tr>
3008         <td><a href="#templatevar-karma">karma</a></td>
3009         <td>カルマ投票の得点</td>
3010 </tr><tr>
3011         <td>authorlink</td>
3012         <td>作者への未加工のリンク</td>
3013 </tr><tr>
3014         <td>itemlink</td>
3015         <td>アイテムへの未加工のリンク(permanent)</td>
3016 </tr><tr>
3017         <td><a href="#templatevar-author">author</a></td>
3018         <td>作者の名前</td>
3019 </tr><tr>
3020         <td><a href="#templatevar-smartbody">smartbody</a></td>
3021         <td>本文か続きのどちらか</td>
3022 </tr><tr>
3023         <td><a href="#templatevar-morelink">morelink</a></td>
3024         <td>続きを読む為のリンク</td>
3025 </tr><tr>
3026         <td><a href="#templatevar-date">date</a></td>
3027         <td>フォーマット済みの日付</td>
3028 </tr><tr>
3029         <td><a href="#templatevar-time">time</td>
3030         <td>フォーマット済みの時刻</td>
3031 </tr><tr>
3032         <td>daylink</td>
3033         <td>その日のアーカイブへの未加工のリンク</td>
3034 </tr><tr>
3035         <td><a href="#templatevar-comments">comments</td>
3036         <td>コメント・ブロックかコメント数</td>
3037 </tr><tr>
3038         <td>itemid</td>
3039         <td>アイテムのID</td>
3040 </tr><tr>
3041         <td>blogurl</td>
3042         <td>blogのURL</td>
3043 </tr></table>
3044
3045 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3046
3047
3048 </div>
3049
3050
3051
3052 <div class="page">
3053 <a name="templatevars-advanced"></a>
3054 <h1>テンプレート変数:上級の変数</h1>
3055
3056
3057 <table><tr>
3058         <th>名前</th>
3059         <th>説明</th>
3060 </tr><tr>
3061         <td>authorid</td>
3062         <td>現在のアイテムの作者ID</td>
3063 </tr><tr>
3064         <td>blogid</td>
3065         <td>blogのID</td>
3066 </tr><tr>
3067         <td>catid</td>
3068         <td>現在のアイテムが属するカテゴリーのID</td>
3069 </tr><tr>
3070         <td>query</td>
3071         <td>検索のクエリ(もし存在するなら)</td>
3072 </tr><tr>
3073         <td><a href="#templatevar-syndicate_title">syndicate_title</a></td>
3074         <td>配信用のタイトル</td>
3075 </tr><tr>
3076         <td><a href="#templatevar-syndicate_description">syndicate_description</a></td>
3077         <td>配信用の本文テキスト</td>
3078 </tr><tr>
3079         <td>karmaposlink</td>
3080         <td>投票用の未加工リンク</td>
3081 </tr><tr>
3082         <td>karmaneglink</td>
3083         <td>投票用の未加工リンク</td>
3084 </tr><tr>
3085         <td>new</td>
3086         <td>新しいアイテムを示すテキスト</td>
3087 </tr><tr>
3088         <td><a href="#skinvar-include">include</a></td>
3089         <td>パース無しでファイルをインクルード</td>
3090 </tr><tr>
3091         <td><a href="#skinvar-parsedinclude">parsedinclude</a></td>
3092         <td>パースしてファイルをインクルード</td>
3093 </tr><tr>
3094         <td><a href="#skinvar-phpinclude">phpinclude</a></td>
3095         <td>PHPでパースしてファイルをインクルード</td>
3096 </tr><tr>
3097         <td><a href="#skinvar-plugin">plugin</a></td>
3098         <td>プラグインを実行</td>
3099 </tr><tr>
3100         <td><a href="#templatevar-edit">edit</a></td>
3101         <td>アイテム編集のリンクを挿入</td>
3102 </tr><tr>
3103         <td><a href="#templatevar-editlink">editlink</a></td>
3104         <td>アイテム編集の未加工リンク(bookmarkletへのリンク)</td>
3105 </tr><tr>
3106         <td><a href="#templatevar-editpopupcode">editpopupcode</a></td>
3107         <td>editlink用のウィンドウをポップアップするjavascriptコード</td>
3108 </tr><tr>
3109         <td><a href="#skinvar-skinfile">skinfile</a></td>
3110         <td>インポートされたスキンに属しているファイル用の正確なURLの取り込み</td>
3111 </tr><tr>
3112         <td><a href="#skinvar-set">set</a></td>
3113         <td>パーサーのプロパティを設定</td>
3114 </tr><tr>
3115         <td><a href="#templatevar-image">image</a></td>
3116         <td>メディア書庫へのインライン画像</td>
3117 </tr><tr>
3118         <td><a href="#templatevar-popup">popup</a></td>
3119         <td>メディア・ディレクトリの画像をポップアップ</td>
3120 </tr><tr>
3121         <td><a href="#templatevar-media">media</a></td>
3122         <td>メディア・ディレクトリからの他のメディア・オブジェクト</td>
3123 </tr><tr>
3124         <td>relevance</td>
3125         <td>検索結果を表示するテンプレートに'search hit relevance'をインクルードする(2.5より)</td>
3126 </tr></table>
3127
3128 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3129
3130 </div>
3131
3132
3133
3134
3135 <div class="page">
3136 <a name="templatevars-comments"></a>
3137 <h1>テンプレート変数:コメント関連</h1>
3138
3139
3140 <table><tr>
3141         <th>名前</th>
3142         <th>説明</th>
3143 </tr><tr>
3144         <td>body</td>
3145         <td>コメントの本体</td>
3146 </tr><tr>
3147         <td>user</td>
3148         <td>ユーザー名</td>
3149 </tr><tr>
3150         <td>userid</td>
3151         <td>ユーザーのURLかメールアドレス</td>
3152 </tr><tr>
3153         <td>userlink</td>
3154         <td>非メンバーにはメールアドレスかURLに対して、メンバーにはメンバー詳細ページに対してリンクを行う(自動で切り替えるスマートなリンク)。注意:このリンクは&lt;a href="..."&gt;と&lt;/a&gt;タグを既に含んでいる。(有効なURLかメールアドレスが無い場合は、ユーザーの名前のみが表示される)</td>
3155 </tr><tr>
3156         <td>userlinkraw</td>
3157         <td>上と同じだが&lt;a href..の部分を除く。有効なURLかメールアドレスが存在しないときは空っぽになる。</td>
3158 </tr><tr>
3159         <td>useremail</td>
3160         <td>ユーザーのメールアドレス。もしユーザーによって提供されていない場合は空っぽ</td>
3161 </tr><tr>
3162         <td>userwebsite</td>
3163         <td>ユーザーのwebsiteのURL。もしユーザーによって提供されていない場合は空っぽ</td>
3164 </tr><tr>
3165         <td>memberid</td>
3166         <td>メンバーのID(非メンバーは0となる)</td>
3167 </tr><tr>
3168         <td>commentcount</td>
3169         <td>該当アイテムに付けられたコメントの総数</td>
3170 </tr><tr>
3171         <td><a href="#templatecommentwords" title="commentword()">commentword</a></td>
3172         <td>1 'comment'、2 'comments'</td>
3173 </tr><tr>
3174         <td><a href="#templatevar-date" title="date([format])">date</a></td>
3175         <td>コメントが追加された時の日付</td>
3176 </tr><tr>
3177         <td><a href="#templatevar-time" title="time([format])">time</a></td>
3178         <td>コメントが追加された時の時刻</td>
3179 </tr><tr>
3180         <td>host</td>
3181         <td>コメントがどこのホストから投稿されたか</td>
3182 </tr><tr>
3183         <td>ip</td>
3184         <td>コメントがどこのIPアドレスから投稿されたか</td>
3185 </tr><tr>
3186         <td>commentid</td>
3187         <td>現在のコメントのID</td>
3188 </tr><tr>
3189         <td>itemid</td>
3190         <td>現在のアイテムのID</td>
3191 </tr><tr>
3192         <td>itemlink</td>
3193         <td>アイテムの詳細ページへのリンク</td>
3194 </tr><tr>
3195         <td><a href="#templateitemtitle" title="itemtitle([maxlength])">itemtitle</a></td>
3196         <td>現在のアイテムのタイトル</td>
3197 </tr><tr>
3198         <td>blogid</td>
3199         <td>weblogのID</td>
3200 </tr><tr>
3201         <td>blogurl</td>
3202         <td>weblogのURL</td>
3203 </tr><tr>
3204         <td><a href="#templatememberextra" title="authtext()">authtext</a></td>
3205         <td>メンバーなら証となるテキストを表示し、非メンバーなら空っぽ</td>
3206 </tr><tr>
3207         <td>short</td>
3208         <td>最初の改行部分から先が省略されたコメントの本体。テンプレートによっては末尾に<a href="#templatecommentcontinued">リンクが追加</a>される。</td>
3209 </tr><tr>
3210         <td>excerpt</td>
3211         <td>コメントの本体。60文字でカットし'...'を追加</td>
3212 </tr><tr>
3213         <td>timestamp</td>
3214         <td>コメントが追加された時のタイムスタンプ</td>
3215 </tr><tr>
3216         <td><a href="#skinvar-include" title="include(filename)">include</a></td>
3217         <td>パース無しでファイルをインクルード</td>
3218 </tr><tr>
3219         <td><a href="#skinvar-parsedinclude" title="parsedinclude(filename)">parsedinclude</a></td>
3220         <td>パースしてファイルをインクルード</td>
3221 </tr><tr>
3222         <td><a href="#skinvar-phpinclude" title="phpinclude(filename)">phpinclude</a></td>
3223         <td>PHPでパースしてファイルをインクルード</td>
3224 </tr><tr>
3225         <td><a href="#skinvar-plugin" title="plugin(name,[options...])">plugin</a></td>
3226         <td>プラグインを実行</td>
3227 </tr><tr>
3228         <td><a href="#skinvar-skinfile" title="skinfile(filename)">skinfile</a></td>
3229         <td>インポートされたスキンに属しているファイル用の正確なURLの取り込み</td>
3230 </tr><tr>
3231         <td><a href="#skinvar-set" title="set(property,value)">set</a></td>
3232         <td>パーサーのプロパティを設定</td>
3233 </tr></table>
3234
3235
3236
3237 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3238
3239 </div>
3240
3241
3242
3243 <div class="page">
3244 <a name="templatevar-karma"></a>
3245 <h1>テンプレート変数:karma</h1>
3246
3247 <p>カルマ投票のデータを挿入。カルマ投票は、アイテムの'カルマ'を投票する方法。一回のクリックで、訪問者は正にでも負にでも投票できる。これら投票の総計が、該当記事が訪問者にどのように思われているのか知らしめてくれるだろう。</p>
3248
3249 <h2>引数</h2>
3250
3251 <ul>オプション:
3252         <ul>
3253                 <li><strong><em>どういったものか?</em></strong>:表示される情報の種類を選択:
3254                         <ul>
3255                                 <li><strong>totalscore</strong>:カルマ投票の総合得点(正の投票数から負の投票数を引いたもの)<em>(デフォルト)</em></li>
3256                                 <li><strong>pos</strong>:正の投票の総計</li>
3257                                 <li><strong>neg</strong>:負の投票の総計</li>
3258                                 <li><strong>votes</strong>:投票数の総計</li>
3259                                 <li><strong>posp</strong>:正に投じられたパーセンテージ</li>
3260                                 <li><strong>negp</strong>:負に投じられたパーセンテージ</li>
3261                         </ul>
3262                 </li>
3263         </ul>
3264 </ul>
3265
3266 <h2>例</h2>
3267 <pre><code>&lt;%karma(posp)%&gt;がよい記事だと評価しました(総計&lt;%votes%&gt;票)</code></pre>
3268
3269
3270 </div>
3271
3272
3273
3274 <div class="page">
3275 <a name="templateitemtitle"></a>
3276 <h1>テンプレート変数:templateitemtitle</h1>
3277
3278 <p>コメント関連テンプレート変数において、元記事のタイトルを挿入する。</p>
3279
3280 <h2>引数</h2>
3281
3282 <ul>オプション:
3283         <ul>
3284                 <li><strong><em>maxlength</em></strong>:指定されると、<a href="#templatevar-syndicate_title">テンプレート変数syndicate_title</a>のような振る舞いでアイテムのタイトルを加工する。</li>
3285         </ul>
3286 </ul>
3287
3288 </div>
3289
3290
3291
3292
3293
3294
3295 <div class="page">
3296 <a name="templatevar-author"></a>
3297 <h1>テンプレート変数:author</h1>
3298
3299 <p>作者の名前を挿入</p>
3300
3301 <h2>引数</h2>
3302 <ul>オプション:
3303         <ul>
3304                 <li><strong><em>どういったものか?</em></strong>:表示される情報の種類を選択:
3305                         <ul>
3306                                 <li><strong>name</strong>:名前を表示<em>(デフォルト)</em></li>
3307                                 <li><strong>realname</strong>:作者の「本名」欄を表示名の代わりに</li>
3308                                 <li><strong>id</strong>:そのNucleusでのメンバーID</li>
3309                                 <li><strong>url</strong>:メンバーのウェブサイトのURL</li>
3310                                 <li><strong>email</strong>:メンバーのメールアドレス(使うのは避けるべき)</li>
3311                         </ul>
3312                 </li>
3313         </ul>
3314 </ul>
3315
3316 <h2>例</h2>
3317
3318 <pre><code>&lt;%author%&gt;
3319 &lt;%author(realname)%&gt;
3320 &lt;a href="&lt;%author(url)%&gt;"&gt;&lt;%author%&gt;&lt;/a&gt;</code></pre>
3321
3322 </div>
3323
3324
3325
3326
3327 <div class="page">
3328 <a name="templatevar-smartbody"></a>
3329 <h1>テンプレート変数:smartbody</h1>
3330
3331 <p>現在のアイテムを調べ、本文テキストか続きテキストのどちらを表示するか決定する。</p>
3332
3333 <p>続き部分が空っぽなら、本文部分が選択される。そうでなければ続き部分が表示される。</p>
3334
3335 <table style="text-align: center;"><tr>
3336         <th>部分名</th><th colspan="2">空っぽか否か?</th>
3337 </tr><tr>
3338         <td>本文</td><td>いいえ</td><td>いいえ</td>
3339 </tr></tr>
3340         <td>続き</td><td>はい</td><td>いいえ</td>
3341 </tr></tr>
3342         <th>smartbodyの表示=</th><th>「本文部分」</th><th>「続き部分」</th>
3343 </tr></table>
3344
3345 <h2>使用例</h2>
3346
3347 <p>本文のテキストが完全なテキストと判断され、続きの部分はフロントページに表示される「紹介」や「抜粋」と判断されます。</p>
3348 <p>フロントページで使われているテンプレートには<tt>&lt;%smartbody%&gt;</tt>を使い、抜粋が存在するときにはそれを、無い場合は完全なテキストを挿入します。アイテムの詳細テンプレートには、<tt>&lt;%body%&gt;</tt> + <tt>&lt;%more%&gt;</tt>のかわりに<tt>&lt;%body%&gt;</tt>を使います。<tt>&lt%body%&gt;</tt>は少なくとも完全なアイテムが入っているのですから。</p>
3349
3350
3351
3352
3353 </div>
3354
3355
3356 <div class="page">
3357 <a name="templatevar-morelink"></a>
3358 <h1>テンプレート変数:morelink</h1>
3359
3360 <p>アイテムの詳細ページへの、テンプレート(<a href="#templatemorelink">続きへのリンク</a>)で定義されているリンクを挿入。「続き」部分が無いときは空っぽとなる。</p>
3361
3362 <p>テンプレート部品'続きへのリンク'の中身もまたパースされるので、同様に<a href="#templatevars-overview">テンプレート変数</a>を含むことができることに注意。</p>
3363 </div>
3364
3365
3366 <div class="page">
3367 <a name="templatevar-date"></a>
3368 <h1>テンプレート変数:date</h1>
3369
3370 <p><a href="#templatedatetime">テンプレートにおける日付の詳細なフォーマット</a>を用いた日付の挿入。オプションとして、与えられたパラメーターによる日付フォーマットのカスタムが可能。</p>
3371
3372 <h2>引数</h2>
3373 <ul>オプション:
3374         <ul>
3375                 <li><strong><i>format</i></strong>:日付のフォーマットに用いる形式</li>
3376         </ul>
3377 </ul>
3378
3379 <h2>特別</h2>
3380
3381 <p>4つの特別なパラメーターが利用可能:(下の二つは2.5から)</p>
3382 <ol>
3383  <li><code>rfc822</code>:ローカルにあわせたRFC822フォーマットの日付</li>
3384  <li><code>rfc822GMT</code>:GMTにあわせたRFCフォーマットの日付</li>
3385  <li><code>iso8601</code>:ISO-8601フォーマットの日付(<a href="http://www.w3.org/TR/NOTE-datetime">W3Cの時刻と日付フォーマット</a>に概略)。例:2002-10-02T10:00:00-05:00</li>
3386  <li><code>utc</code>:iso8601と同じだが、日付にはタイムゾーンの表示として"Z"を使うUTCで表現される。</li>
3387 </ol>
3388
3389 <h2>例</h2>
3390 <pre>
3391 &lt;%date%&gt;
3392 &lt;%date(%x)%&gt;
3393 &lt;%date(rfc822)%&gt;
3394 &lt;%date(rfc822GMT)%&gt;
3395 </pre>
3396
3397
3398 </div>
3399
3400 <div class="page">
3401 <a name="templatevar-time"></a>
3402 <h1>テンプレート変数:time</h1>
3403
3404 <p><a href="#templatedatetime">テンプレートにおける時刻の詳細なフォーマット</a>を用いた時刻の挿入。オプションとして、与えられたパラメーターによる時刻フォーマットのカスタムが可能。</p>
3405
3406 <h2>引数</h2>
3407 <ul>オプション:
3408         <ul>
3409                 <li><strong><i>format</i></strong>:時刻のフォーマットに用いる形式</li>
3410         </ul>
3411 </ul>
3412
3413 <h2>例</h2>
3414 <pre>
3415 &lt;%time%&gt;
3416 &lt;%time(%X)%&gt;
3417 </pre>
3418
3419 </div>
3420
3421
3422 <div class="page">
3423 <a name="templatevar-comments"></a>
3424 <h1>テンプレート変数:comments</h1>
3425
3426 <p>コメント・ブロックを挿入。<a href="#templatecomments">このブロックの構成に関するさらなる情報</a>。</p>
3427
3428 <h2>引数</h2>
3429 <ul><p>オプション:</p>
3430         <table><tr>
3431                 <th>名前</th>
3432                 <th>内容</th>
3433         </tr><tr>
3434                 <td>MaxToShow</td>
3435                 <td>表示するコメントの数(設定されていれば、a href="#blogmaxcomments">blogごとの設定にあるコメントの最大量</a>を上書きする)</td>
3436         </tr></table>
3437 </ul>
3438
3439 <h2>例</h2>
3440
3441 <pre>
3442 &lt;%comments%&gt;
3443 &lt;%comments(5)%&gt;
3444 </pre>
3445
3446 </div>
3447
3448
3449 <div class="page">
3450 <a name="templatevar-syndicate_title"></a>
3451 <h1>テンプレート変数:syndicate_title</h1>
3452
3453 <p>HTMLタグを取り除き、100文字にまで縮めたアイテムのタイトルを挿入。テキストが縮められた場合は、末尾に"..."が追加される。</p>
3454
3455 <p>この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。</p>
3456
3457 <h2>引数</h2>
3458 <ul>
3459         <li>
3460                 <p>オプション:</p>
3461                 <table><tr>
3462                         <th>名前</th>
3463                         <th>内容</th>
3464                 </tr><tr>
3465                         <td>MaxChars</td>
3466                         <td>保持する文字数の最大値(デフォルトは100)</td>
3467                 </tr></table>
3468         </li>
3469 </ul>
3470
3471 <h2>例</h2>
3472
3473 <pre>
3474 &lt;%syndicate_title%&gt;
3475 &lt;%syndicate_title(25)%&gt;
3476 </pre>
3477
3478 </div>
3479
3480 <div class="page">
3481 <a name="templatevar-syndicate_description"></a>
3482 <h1>テンプレート変数:syndicate_description</h1>
3483
3484 <p>HTMLタグを取り除き、250文字にまで縮めたアイテムの本文を挿入。テキストが縮められた場合は、末尾に"..."が追加される。</p>
3485
3486 <p>この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。</p>
3487
3488 <h2>引数</h2>
3489 <ul>
3490         <li>
3491                 <p>オプション:</p>
3492                 <table><tr>
3493                         <th>名前</th>
3494                         <th>内容</th>
3495                 </tr><tr>
3496                         <td>MaxChars</td>
3497                         <td>保持する文字数の最大値(デフォルトは250)</td>
3498                 </tr></table>
3499         </li>
3500 </ul>
3501
3502 <h2>例</h2>
3503
3504 <pre>
3505 &lt;%syndicate_description%&gt;
3506 &lt;%syndicate_description(25)%&gt;
3507 </pre>
3508
3509 </div>
3510
3511
3512 <div class="page">
3513 <a name="templatevar-image"></a>
3514 <h1>テンプレート変数:image</h1>
3515
3516 <p>アイテム本体やテンプレートにインライン画像を挿入。</p>
3517
3518 <p>通常、テンプレート変数imageはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。</p>
3519
3520 <h2>引数</h2>
3521 <ul>
3522         <li>
3523                 <p>必須:</p>
3524                 <table><tr>
3525                         <th>名前</th>
3526                         <th>内容</th>
3527                 </tr><tr>
3528                         <td>filename</td>
3529                         <td>画像ファイルの名前</td>
3530                 </tr><tr>
3531                         <td>width</td>
3532                         <td>画像の横幅(ピクセルかパーセンテージ)</td>
3533                 </tr><tr>
3534                         <td>height</td>
3535                         <td>画像の高さ(ピクセルかパーセンテージ)</td>
3536                 </tr><tr>
3537                         <td>text</td>
3538                         <td>画像の代用テキスト</td>
3539                 </tr></table>
3540         </li>
3541         <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3542 </ul>
3543
3544 <h2>例</h2>
3545
3546 <pre>
3547 &lt;%image(myphoto.jpg|100|200|これが私です)%&gt;
3548 &lt;%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%&gt;
3549 </pre>
3550
3551 </div>
3552
3553
3554
3555 <div class="page">
3556 <a name="templatevar-popup"></a>
3557 <h1>テンプレート変数:popup</h1>
3558
3559 <p>アイテム本体やテンプレートにポップアップ画像を挿入。</p>
3560
3561 <p>通常、テンプレート変数popupはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。</p>
3562
3563 <h2>引数</h2>
3564 <ul>
3565         <li>
3566                 <p>必須:</p>
3567                 <table><tr>
3568                         <th>名前</th>
3569                         <th>内容</th>
3570                 </tr><tr>
3571                         <td>filename</td>
3572                         <td>画像ファイルの名前</td>
3573                 </tr><tr>
3574                         <td>width</td>
3575                         <td>画像の横幅(ピクセルかパーセンテージ)</td>
3576                 </tr><tr>
3577                         <td>height</td>
3578                         <td>画像の高さ(ピクセルかパーセンテージ)</td>
3579                 </tr><tr>
3580                         <td>text</td>
3581                         <td>画像の代用テキスト</td>
3582                 </tr></table>
3583         </li>
3584         <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3585 </ul>
3586
3587 <h2>例</h2>
3588
3589 <pre>
3590 &lt;%popup(myphoto.jpg|100|200|これが私です)%&gt;
3591 &lt;%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%&gt;
3592 </pre>
3593
3594 </div>
3595
3596
3597
3598 <div class="page">
3599 <a name="templatevar-media"></a>
3600 <h1>テンプレート変数:media</h1>
3601
3602 <p>アイテム本体やテンプレートにメディアオブジェクトを挿入。</p>
3603
3604 <p>通常、テンプレート変数mediaはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリからオブジェクトが持ってこられることに注意すること。</p>
3605
3606 <h2>引数</h2>
3607 <ul>
3608         <li>
3609                 <p>必須:</p>
3610                 <table><tr>
3611                         <th>名前</th>
3612                         <th>内容</th>
3613                 </tr><tr>
3614                         <td>filename</td>
3615                         <td>メディアオブジェクトのファイル名</td>
3616                 </tr><tr>
3617                         <td>text</td>
3618                         <td>メディアオブジェクトの説明テキスト</td>
3619                 </tr></table>
3620         </li>
3621         <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3622 </ul>
3623
3624 <h2>例</h2>
3625
3626 <pre><code>&lt;%media(mysong.mp3|新曲を聞いてみてください)%&gt;</code></pre>
3627
3628 </div>
3629
3630
3631 <div class="page">
3632 <a name="templatevar-edit"></a>
3633 <h1>テンプレート変数:edit</h1>
3634
3635 <p>テンプレートの内部にて、このテンプレート変数を使えば'アイテムの編集'リンクを加えることが出来る。デフォルトでは、ポップアップするbookmarkletウィンドウへのリンクとなるが、<a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>を通して振る舞いを変更することが可能。</p>
3636
3637 <p><strong>注意:</strong>アイテムの編集が許可されたログイン状態のメンバーのみが、このリンクを目に出来ます。他の場合は、テンプレート変数editは何も表示しません。</p>
3638
3639 <h2>例</h2>
3640 <p>「アイテムの本体」テンプレートの一例</p>
3641 <pre><code>&lt;h1&gt;&lt;%title%&gt;&lt;/h1&gt;
3642 &lt;p&gt;&lt;%body%&gt; &lt;%morelink%&gt;&lt;/p&gt;
3643 &lt;div class="metadata"&gt;
3644         &lt;%edit%&gt; &lt;%comments%&gt;
3645 &lt;/div&gt;</code></pre>
3646
3647 <h2>Results in</h2>
3648
3649 <div class="example">
3650 <h4 style="margin:2px;">タイトル</h4>
3651 <p style="margin:2px;">アイテムの本文</p>
3652 <div style="margin:2px;"><a href="#templatevar-edit">編集</a> - <a href="#templatevar-edit">5 comments</a></div>
3653 </div>
3654
3655 </div>
3656
3657
3658 <div class="page">
3659 <a name="templatevar-editlink"></a>
3660 <h1>テンプレート変数:editlink</h1>
3661
3662 <p>'アイテムの編集'bookmarkletへのリンクを挿入。これは<a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>内で単純に使うことが出来る。</p>
3663
3664 <h2>例</h2>
3665
3666 <p><a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>はこんな感じになる:</p>
3667 <pre>
3668 &lt;a href="&lt;%editlink%&gt;"
3669    onclick="&lt;%editpopupcode%&gt;"&gt;編集&lt;/a&gt; -
3670 </pre>
3671
3672 </div>
3673
3674
3675 <div class="page">
3676 <a name="templatevar-editpopupcode"></a>
3677 <h1>テンプレート変数:editpopupcode</h1>
3678
3679 <p>'アイテムリンクの編集'ウィンドウをポップアップで開くためには、リンクにいくつかのjavascriptコードを追加する必要がある。このコードを「テンプレート:アイテムリンクの編集」に置く手間を省くために、テンプレート変数editpopupcodeを用いてそれを挿入することが出来る。</p>
3680
3681 <h2>例</h2>
3682 <p><a href="#templatevar-editlink">テンプレート変数:editlink</a>の例をみること。</p>
3683 </div>
3684
3685
3686
3687 <div class="page">
3688 <a name="plugins"></a>
3689 <h1>プラグイン</h1>
3690 <p>Nucleusでは特別な機能を追加するために、カスタムしたプラグインをインストールすることができる。プラグインはまったく違う事柄を実行できる:
3691 </p>
3692 <ol>
3693         <li>スキン変数のように振舞う</li>
3694         <li>テンプレート変数のように振舞う</li>
3695         <li>Nucleusによって生成されたイベントのフック。「プラグインの管理」画面での「上へ」と「下へ」リンクは、イベント発生時にプラグインを呼び出す順番を決定するために用いられる。最初のプラグインは最初に呼び出され、最後のプラグインは最後に呼び出される。</li>
3696         <li><tt>action.php</tt>を通して呼び出されたときにアクタのように振舞う</li>
3697 </ol>
3698 <p>プラグインに対する責任は、完全にプラグインの作者にあることを心にとめておくこと。彼または彼女は、すべてが問題なく動くようきっちりと作らなければならない。</p>
3699 </div>
3700
3701 <div class="page">
3702 <a name="parser-properties"></a>
3703 <a name="includemode"></a>
3704 <a name="includeprefix"></a>
3705 <h1>パーサーのプロパティ</h1>
3706
3707 <p>利用可能なパーサーオプションを以下に記述する。</p>
3708
3709 <table>
3710  <caption>パーサーのプロパティ</caption>
3711  <tr>
3712         <th>オプション名</th>
3713         <th>値</th>
3714  </tr><tr>
3715         <td>Includeモード</td>
3716         <td>
3717                 <ul>
3718                         <li><strong>normal</strong>:通常の動作;ページを作成する.phpファイルのディレクトリ/URLから相対位置のファイルを取り出しインクルード。</li>
3719                         <li><strong>skindir</strong>:スキンディレクトリ/スキンURLから相対位置のファイルを取り出しインクルード。</li>
3720                 </ul>
3721                 <p>このプロパティは次のスキン変数に影響を与えます:<a href="#skinvar-include">include</a>、<a href="#skinvar-phpinclude">phpinclude</a>、<a href="#skinvar-parsedinclude">parsedinclude</a>、<a href="#skinvar-nucleusbutton">nucleusbutton</a></p>
3722         </td>
3723  </tr><tr>
3724         <td>Includeプリフィックス</td>
3725         <td>
3726                 <p>このプロパティはインクルードするファイルそれぞれの頭に追加されるプリフィックスです。例えば、プリフィックスが<tt>base/</tt>でインクルードするファイルが<tt>somefile.txt</tt>なら、最終的には<tt>base/somefile.txt</tt>をインクルードすることになります。</tt></p>
3727                 <p>このプロパティはIncludeModeのプロパティと共に使われることが意図されています。この方法で、<tt><em>skindir/</em>somename/</tt>にインポートされたスキンは、<tt>IncludeMode</tt>を<tt>skindirを使う</tt>に<tt>IncludePrefix</tt>を<tt>somename/</tt>に設定しておくことができます。</p>
3728                 <p>このプロパティは次のスキン変数に影響を与えます:<a href="#skinvar-include">include</a>、<a href="#skinvar-phpinclude">phpinclude</a>、<a href="#skinvar-parsedinclude">parsedinclude</a>、<a href="#skinvar-nucleusbutton">nucleusbutton</a></p>
3729         </td>
3730   </tr>
3731 </table>
3732
3733 <p><tt>Includeプリフィックス</tt>と<tt>Includeモード</tt>のプロパティは、「スキンの一般的設定」において該当スキンでの包括的な設定が可能です。なお、プロパティが設定されてしまうと、例えばテンプレートも含めたすべてのパースデータにそれが適用されることを心にとめておいてください。</p>
3734
3735 </div>
3736
3737 </body>
3738 </html>
3739