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