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