OSDN Git Service

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