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">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5 <!-- $Id: help.html,v 1.1.1.1 2005-02-28 07:14:33 kimitake Exp $ -->
6 <title>Nucleus管理用ヘルプ</title>
7 <style type="text/css">
10 font-family: verdana, arial;
16 border-bottom: 1px gray dashed;
23 border: 1px solid #ddd;
24 background-color: whitesmoke;
35 background-color: #ddd;
41 background-color: #ddd;
60 text-decoration: underline;
64 background-color: whitesmoke;
68 border: 3px solid red;
78 border: 1px solid #ccc;
82 background-color: #eee;
90 background-color: #eee;
99 <h1>Nucleusポップアップ・ヘルプ</h1>
100 <p>ページがダウンロードされている間はお待ちください(だいたい100KBです)。</p>
105 <a name="future"></a>
106 <a name="allowpastposting"></a>
109 <p>アイテム追加フォームの「後で追加」オプションにより、アイテムを指定した時間きっかりに公開することができます。その時が来るまで、アイテムはサイトの公開された部分で見られる事がありません。</p>
110 <p>この日時は<strong>未来のものでなくてはなりません</strong>。アイテムを追加するblogの「過去の日時での投稿を許可する」オプションが有効である場合は除いて。</p>
111 <h2>過去の日時での投稿を許可する</h2>
112 <p>有効にすると、アイテムが追加された日時を指定できます。加えて、既に存在するアイテムのタイムスタンプ(投稿日時)を編集できます。</p>
115 <div class="page"><a name="changedate"></a>
118 「タイムスタンプを更新」オプションにより、アイテムの投稿された日付か時間あるいはその両方を変更できます。もしアイテムの内容を変更したのなら、この方法で記事をフロントページのトップに戻せるでしょう。</p>
119 <p>しかし、そのアイテム独自のIDは変更されません。よって訪問者は、そのアイテムはもともとより低いID値のアイテム群より後に投稿されたことに気がつくことができます。</p>
123 <div class="page"><a name="draft"></a>
124 <h1>ドラフト(Drafts)</h1>
125 <p>ドラフト状態のアイテムはblogの公開されたところではまだみることができません。記事を書いている時役に立つでしょうし、多少の間を取るにもいいでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間のあるときに作業を再開することが可能です。</p>
126 <p>ドラフトを編集する際、「<strong>今すぐ追加</strong>」のラジオボタンを選び「保存」ボタンを押すと公開されます。</p>
129 <div class="page"><a name="extended"></a>
131 <p>アイテムには、記事を続けるために用いられるオプションである「続き」部分があります。例えば、記事がblogのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。メインのblogページを閲覧すると、「続きを読む」というリンクを目にすることでしょう。(テンプレートによってリンクの形は定義されます)</p>
132 <p>もし、導入をアイテムの単なる<em>概略</em>として書きたいのなら、<a href="#templatevar-smartbody">smartbody</a>というテンプレート変数を用いて、「本文」と「続き」の表示を分けることが可能です。
136 <div class="page"><a name="shortblogname"></a>
138 <p>「Blogの短縮名」は主に管理領域で、どのアイテムがどのblogと結びついているのか示すために使われます。</p>
139 <p>また、新規blogを有効にするための代替indexファイルでも用いられます(以下はmyshortblognameが「Blogの短縮名」だった場合の呼び出しファイルの例):</p>
142 include('./config.php');
143 selectBlog('myshortblogname');
149 <div class="page"><a name="blogdefaultskin"></a>
151 <p>blogごとの「設定」で選択された「標準のスキン」はそのblogが表示されるときに用いられるスキンです。選択できるのは一つだけです。(URLの引数を通して別のスキンで表示させることはできます)</p>
155 <div class="page"><a name="blognotify"></a>
157 <p>このオプションは、新しくコメントが追加された際に通知するメールアドレスを一つあるいは複数いれるものです。もし通知が不要なら空っぽにしておいてください。メールアドレスは、あたりまえですが、有効なものでなくてはなりません。</p>
158 <p>もし複数のメールアドレスを利用する場合は、セミコロン(<strong>;</strong>)で区切ってください。</p>
160 <b>注意:</b>設定フィールドの最大長は128文字です。リスト可能なメールアドレスの量はそれによってのみ制限されます</div>
162 <b>注意:</b>メンバー登録に使われているメールアドレスを通知先にした場合、自身で書いたのアイテムとコメントの通知を受け取ることはありません。自分で書いたことは知っているはずですから、問題にはならないでしょう。</div>
165 <div class="page"><a name="blogmaxcomments"></a>
167 <p><em>メインページ</em>に表示するコメントの最大数です。<strong>これはコメント可能な最大数を制限するものではありません</strong>。詳細のページでは、設定した最大数を超えていても全てのコメントが表示されます。</p>
168 <p class="note"><strong>注意:</strong>テンプレート内部では、テンプレート変数<a href="#templatevar-comments">comments</a>のオプションパラメーターによってここでの値は上書きされます。</p>
171 <div class="page"><a name="blogtimeoffset"></a>
173 <p>もしサーバの時刻があなたの生活時刻と一致しなければ、正確な時間を得る為にサーバ時刻との時差を加えたいかもしれません。減らすためには負の値を用いてください(マイナス記号をつける)。参照するために現在のサーバ時刻が表示されています。</p>
175 <p>もしローカル時刻が20:35で表示されているサーバ時刻が14:35であった場合、blogの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定する必要があります。</p>
176 <p class="note"><strong>注意:</strong>30分時差のあるタイムゾーンに住む人々のための、分刻みの時差補正もまた同様です。例えば「サーバ時刻との時差」を<strong>1.5</strong>にすると、1時間30分の補正となります。</p>
179 <div class="page"><a name="blogupdatefile"></a>
181 <p>Nucleusはblogに新しいアイテムが追加されるたびに、ファイルを更新することができます。そのファイルの中身は最終変更時のタイムスタイプとなります。このようなファイルは、定期的に更新が無いかみるためにサーバ上のファイルをチェックして、そこから「weblogの更新状況」を作成するサービスに使うことができます。これらをメインblogに用た特徴は、訪問者がコメントを追加したりスキンやテンプレートに変更を加えたりしたときには更新を知らせることが無いということです。</p>
182 <p>自動更新されるファイルが必要ないときは、フィールドを空っぽにしておいてください。</p>
183 <p>自動更新されるファイルの場所は管理領域からの相対となることにご注意ください。なので、(<tt>/path/to/your/website/update.txt</tt> のような)絶対パスを使う方がよいでしょう。また自動更新されるファイルを作成してかつ書き込めるように(<a href="tips.html#filepermissions" onclick="window.open(this.href);return false;" class="out" title="quick guide on changing file permissions">パーミッションを0666</a>に)してください。</p>
186 <div class="page"><a name="teamadmin"></a>
189 Blogの管理者は次のような追加権限をもちます:
195 <li>(該当blogの) どの投稿者のアイテムでも編集と削除が可能</li>
199 <p>一つのblogは複数の管理者を持つことができます。ただし、いつでも最低一人の管理者がいなくてはなりません。</p>
203 <div class="page"><a name="superadmin"></a>
206 <p><em>super-admin(最高管理者)</em>と呼ばれ、全ての機能と全てのweblogに<strong>フルアクセス</strong>できます。たとえblogのチームに入っていなくてもです。</p>
208 <p>それに加えて:super-adminは、weblogの作成、一般設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作(メンバーの作成/編集/削除)を行う権限があります。</p>
210 <p>普通、super-adminとなるのはサイトの管理者ただ一人でしょう。</p>
214 <div class="page"><a name="canlogin"></a>
216 <p><a href="#superadmin" title="Administrator Privileges">super-admin</a>はそれぞれのメンバーの管理領域へのログインを許可しないよう設定できます。</p>
219 <div class="page"><a name="defaultblog"></a>
221 <p>他のblogが要求時に指定されない場合、表示されるblogです。</p>
224 <div class="page"><a name="baseskin"></a>
226 <p>このオプションは、判定が自動解決されない場合に代用するスキンをNucleusに設定します。これはスキン・パーツが空っぽだったり、blogやskinで明確に指定されていないときにおきます。</p>
227 <p>ほとんどのユーザーは、この設定を気にする必要がありません。</p>
230 <div class="page"><a name="cookies"></a>
233 <h2>ログインCookieの有効期間</h2>
234 <p>メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、いつ無効になるか決定されます:</p>
236 <li><strong>セッションごと</strong> - ブラウザを終了させるとcookieは削除されます</li>
237 <li><strong>一ヶ月</strong> - 一ヶ月続けてサイトか管理領域を訪れないということが無い限り、cookieはコンピュータに残ります。このオプションを使えば、たぶん再ログインする必要はなくなるでしょう。(自分でログアウトしたときや、他のコンピュータからログインするときは別ですが)</li>
240 <h2>CookieパスとCookieドメイン</h2>
241 <p>これらは上級の設定です。通常は変更する必要はありません。その場合、cookieパスは単純にスラッシュ('/')を入れ、cookieドメインは空っぽにしておいてください。</p>
244 <p>通常は「いいえ」に設定してください。HTTPSのurlを用いておりかつhttps接続を通してのみcookieを送りたい場合でだけ、「はい」にしなければなりません。</p>
246 <h2>最終訪問日時Cookieの保存</h2>
247 <p>訪問者が最後に訪れた時間をcookieに含め保存させるよう、Nucleusを設定することが可能です。これによって、<a href="#templatenew">新規アイテム</a>の隣にしるしを置くことができます。</p>
252 <div class="page"><a name="language"></a>
254 <p>個々のメンバー用のコンテンツをnucleusが作成するときに用いられる言語を選択することができます。Nucleusによって生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。</p>
256 <p>言語の選択を行う場所は二ヶ所あります。「一般設定」にはデフォルトで用いられる「既定の言語」が含まれています。次にログイン状態のメンバーは、望むならこの設定を上書きできます。</p>
258 <p>これら両方の設定が無効なら、英語がデフォルトの言語として用いられます</p>
260 <p class="note"><strong>注意:</strong> 追加の言語ファイルは<a href="http://www.nucleuscms.org/" onclick="window.open(this.href);return false;" class="out" title="Nucleus CMS Website">Nucleusのウェブサイト</a>からダウンロードできます。(新規ウィンドウが開きます)</p>
264 <div class="page"><a name="allowaccountcreation"></a>
266 <p>訪問者に自身のメンバーアカウント作成を許可するようにも許可しないようにもできます。新規メンバーは(管理者がチームに加えるまでは)blogにアイテムを追加することはできません。しかし、管理領域にログインして設定を変更できます。また自分のコメントを削除したり変更したりも可能です。</p>
269 <div class="page"><a name="allownewmemberlogin"></a>
270 <h1>新規メンバーのログイン許可</h1>
271 <p>もし訪問者による<a href="#allowaccountcreation">アカウントの作成</a>を許可するなら、この設定はその方法で作られたアカウントが<a href="#canlogin">管理領域にログイン</a>できるか否かを明確に定めます。</p>
275 <div class="page"><a name="messageservice"></a>
278 <p>メンバーのプライバシーのために、全てのメールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージにはどっちにしろ両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。</p>
281 <p>デフォルトでは、非メンバーはメッセージサービスを使えません。なぜなら有効なメールアドレスが入力されたかチェックする方法が無いからです。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、それが受け取ったメールのヘッダー<tt>From:</tt>に表示されることになります。</p>
285 <div class="page"><a name="disablesite"></a>
287 <p>Nucleusのサイト全体を閉じることが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)</p>
288 <p>ここで設定しなければならないURLは、訪問者がリダイレクトされるURLとなります。</p>
289 <p>例外:<strong>管理領域</strong>はそれまで通り利用可能であり、<strong><a href="#superadmin">最高管理者</a></strong>はそれまで通りにサイト全体をみることができます。(あとでサイトを再開することを忘れないでください;-))</p>
293 <div class="page"><a name="urlmode"></a>
295 <p>このオプションを用いることにより、URLスタイルを切り替え可能です:</p>
297 <li><strong>Normal</strong>: URLは次のようになります <code>http://host/index.php?itemid=1234</code></li>
298 <li><strong>Fancy</strong>: URLは次のようになります <code>http://host/item/1234</code></li>
300 <p class="note"><strong>注意:</strong>「Fancy URL」モードで動作するようにするためには、いくつか他の作業が必要になります。それらは<a href="tips.html" class="out" onclick="window.open(this.href);return false;">Tips & Suggestions</a>に記述されています。(新規ウィンドウが開きます)</p>
303 <div class="page"><a name="templateitems"></a>
305 <p>アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます:
314 <p>これら3つのブロックはすべてテンプレートの一部であり、結果どのような見た目になるのか定義します。</p>
318 <p>これらのテンプレート内で、アイテムのデータを挿入するのに<a href="#templatevars-overview" title="Find out which variables are available">テンプレート変数とよばれる系列が利用できます</a>。</p>
321 <p><a href="#templateitemsexample">テンプレート:アイテムの例</a></p>
325 <div class="page"><a name="templateitemsexample"></a>
326 <h1>テンプレート:アイテムの例</h1>
327 <p>「アイテムの本体」テンプレートの一例です:</p>
329 <pre><h1><%title%></h1>
331 <p><%body%></p>
333 <div class="metadata">
334 <a href="<%itemlink%>">link</a> -
335 <%date%> <%time%> -
336 <a href="<%authorlink%>"><%author%></a> -
340 <p>結果はこのようなものになります:</p>
342 <div class="example">
343 <h4 style="margin: 2px;">ここはアイテムのタイトルです</h4>
344 <p style="margin: 2px; padding: 0px;">ここはアイテムのテキスト部分です</p>
345 <div style="font-style: italic; margin: 2px;">
346 <a href="#templateitemsexample">link</a> -
347 August 8th 2002 18:51 -
348 <a href="#templateitemsexample">karma</a> -
349 <a href="#templateitemsexample">no comments</a>
356 <div class="page"><a name="templatecomments"></a>
359 <p>コメントブロックは3つの要素で構成されています。</p>
363 コメントが表示されるとき(詳細のページやメインページで許可されているコメントの最大数を下回っているとき)
375 コメントがあるが、許可されている最大数を上回っているとき(アイテムの詳細のページでのみ表示されます)
382 <p>これらのテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
387 <a name="templatecommentheaders"></a>
388 <a name="templatecommentfooters"></a>
389 <h1>テンプレート:コメントのヘッダーとフッター</h1>
393 <p>「コメントの本体」はコメント一つごとに繰り返されますが、ヘッダーとフッターは一度しか表示されません。典型的な構成はこのようになります:</p>
399 <p>これらのテンプレート内では、<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
404 <pre><ul></pre>
406 <pre><li><%user%>: <%body%></li></pre>
408 <pre></ul></pre>
413 <li>xiffy: ああ、たしかに!</li>
418 <div class="page"><a name="templatemorelink"></a>
419 <h1>テンプレート:続きへのリンク</h1>
420 <p>これはアイテムのテンプレートで利用できるテンプレート変数、"morelink"のフォーマットとして用いられるテンプレートです。<a href="#templatevars-overview">利用可能な変数</a>はアイテムのテンプレートと同じです。</p>
421 <p>もしアイテムに「続き」の部分が存在しない場合、テンプレート変数<code><%morelink%></code>は無効となります。</p>
424 <pre><code><a href="<%itemlink%>">[続きを読む!]</a></code></pre>
428 <div class="page"><a name="templatearchivelists"></a>
430 <h1>テンプレート:アーカイブリスト</h1>
432 <p>過去ログのリストは、以下のようなリスト体裁をとります:</p>
435 アーカイブリスト本体(アーカイブごとに繰り返される)
438 <p>利用できる変数:(ヘッダーとフッターでは<tt>blogid</tt>のみが許可されています)</p>
448 <td>アーカイブへのリンク。<code><a href=".."></code>のようなタグとしてはめ込むことができる。</td>
451 <td>月の数値(01-12の2文字表記)</td>
457 <td>月の中での日付(二文字表記。日ごと表示の時のみ)</td>
460 <p>リストに用いるアーカイブの日付表記をより融通の効くようにする方法は、<a href="#strftime">strftime</a>変数を用いることです。もし複雑すぎると感じたなら、次のを用いてください:</p>
462 <pre><code><a href="<%archivelink%>">%B, %Y</a><br /></code></pre>
465 <p>言語設定をあなたの住んでいる地域の設定に変更するためには、<a href="#templatelocale">locale</a>を変更してください。</p>
472 <div class="page"><a name="templatecategorylists"></a>
473 <h1>テンプレート:カテゴリーリスト</h1>
475 <p>カテゴリーリストは下の表のようにフォーマットされます:</p>
481 <p>利用可能な変数:(ヘッダーとフッターでは<tt>blogid</tt>、<tt>blogurl</tt>、<tt>self</tt>のみが許可されています)</p>
491 <td>blogのURL(blogごとの「設定」で定義される)</td>
494 <td>パラメーター無しの現在のページ(例えば<tt>index.php</tt>)</td>
497 <td>該当カテゴリーの新しいアイテムへのリンク。これにより<a href="..">タグを埋め込むことができる。</td>
509 <p><a href="#categorylistexample">例を見る</a></p>
513 <div class="page"><a name="categorylistexample"></a>
514 <h1>テンプレート:カテゴリーリストの例</h1>
516 <a href="#templatecategorylists">(戻る)</a>
519 <h2>カテゴリーリストヘッダー</h2>
520 <pre><code><ul>
521 <li><a href="<blogurl%>">まとめて表示</a></li></code></pre>
523 <h2>カテゴリーリストアイテム</h2>
524 <pre><code><li><a href="<%catlink%>"><%catname%></a></li></code></pre>
526 <h2>カテゴリーリストフッター</h2>
527 <pre><code></ul></code></pre>
532 <li><a href="#categorylistexample">まとめて表示</a></li>
533 <li><a href="#categorylistexample">あなたのカテゴリー</a></li>
534 <li><a href="#categorylistexample">わたしのカテゴリー</a></li>
545 <div class="page"><a name="templatelocale"></a>
546 <h1>テンプレート:Locale</h1>
547 <p>これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月と日の名前などは要求された言語での表示になるでしょう。</p>
549 <p>使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと・・・:</p>
552 <li><strong>en</strong>:英語</li>
553 <li><strong>dutch</strong>:オランダ語</li>
554 <li><strong>ja_JP</strong>:日本語</li>
558 <p>strftimeに関するより詳しい情報は、<a href="http://www.opengroup.org/onlinepubs/7908799/xsh/strftime.html" onclick="window.open(this.href);return false;" class="out" title="Open Group specification">Open Group Specification</a>にあります。(新規ウィンドウが開きます)</p>
560 <p>localeは<a href="#templatedatetime">日付と時刻のフォーマット</a>、<a href="#templatedateheads">日付ヘッダー</a>、<a href="#templatearchivelists">アーカイブリスト</a>で利用されます。</p>
564 <div class="page"><a name="templatedatetime"></a>
565 <h1>テンプレート:日付と時刻のフォーマット</h1>
566 <p>これらは<code><%date%></code>と<code><%time%></code>という変数(<a href="#templatevars-overview">テンプレート変数</a>をご覧ください)における日付と時刻のフォーマットに使われます。フォーマットは<a href="#templatelocale">locale</a>にも左右されます。</p>
568 <p><a href="#strftime">利用できる変数の詳細な情報はこちらを</a>。もし手っ取り早く始めたいのなら、日付フォーマットに"%x"を、時刻フォーマットに"%X"をお使いください。</p>
572 <div class="page"><a name="templatedateheads"></a>
573 <h1>テンプレート:日付ヘッダー/フッター</h1>
575 <p>日付のヘッダーと日付のフッターは日付と時刻の変数を入れることができます。<a href="#strftime">利用できる変数の詳細情報はこちらにあります</a>。もし手早く始めるのなら、"%x"を日付フォーマットとして使ってください。日付フォーマットで使われる言語は、テンプレートの<a href="#templatelocale">locale設定</a>で決定されます。</p>
577 <p>日付ヘッダーにテンプレート変数<%%daylink%%>を含めることによって、その日のアーカイブへのリンクを挿入できます。<strong>'%'が二つであることに注意を!月の中での現在日付に展開される%dを無効にするために必要な措置なのです。</strong>同様に、もし'%'という文字をここで使いたいなら、二つ重ねて('%%')置かないとサイトには表示されません。</p>
582 <div class="day">
583 <h1>%d %B</h1>
592 <p>daylinkを用いた日付ヘッダーの例:</p>
595 <div class="day">
596 <h1>%d %B</h1>
597 <a href="<%%daylink%%>">(アーカイブ)</a>
602 <div class="page"><a name="templatehighlight"></a>
603 <h1>テンプレート:ハイライト表示</h1>
604 <p>ハイライト表示は検索実行時に使われます。これは規則変化に沿った表現として実際に使われますので、直前にバックスラッシュを置くことによっていくつかの記号をエスケープしたいと望むかもしれません。ハイライトされた単語が当てはめられる場所は"\0"で示されます。</p>
608 <pre><code><span style='background-color:yellow'>\0</span></code></pre>
612 <div class="page"><a name="templatenothingfound"></a>
613 <h1>テンプレート:検索で何も見つからなかった場合</h1>
615 <p>検索が実行され結果何も見つからなかった場合に表示されます。</p>
627 <td>検索に用いられたクリエー</td>
632 <pre><code><b><%query%></b>に該当する検索結果はありませんでした</code></pre>
636 <div class="page"><a name="templatecommentbody"></a>
637 <h1>テンプレート:コメントの本体</h1>
638 <p>このテンプレート・パーツは単独のコメント表示に使われます。このテンプレート部では、<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連テンプレート変数</a>が利用できます。</p>
641 <pre><code><h2><%userlink%>さんによるコメント:</h2>
643 <p><%body%></p>
645 <div class="metadata">
646 (接続元:<%host%> 投稿日時:<%date%> <%time%>)
647 </div></code></pre>
651 <div class="example">
652 <h4 style="margin: 2px;"><a href="#templatecommentbody">karma</a>さんによるコメント:</h4>
653 <p style="margin: 2px;">ナイス!</p>
654 <div style="margin:2px;font-size:smaller;">(接続元:host.example.org 投稿日時:2003-03-02 13:30)</div>
659 <div class="page"><a name="templatepopups"></a>
660 <h1>テンプレート:メディアとポップアップ</h1>
661 <p>これらのテンプレートは、画像ウィンドウのポップアップへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数を以下に記します:</p>
663 <h2>ポップアップ画像へのリンクコード</h2>
670 <td>すぐに使える<a href... といったリンク</td>
672 <td>rawpopuplink</td>
673 <td>href="..."内部のurlのみ</td>
676 <td>ウィンドウを開くjavascriptコード</td>
679 <td>代用テキスト(リンクテキスト)</td>
702 <td>画像への直接リンク(URL)</td>
705 <td>代用テキスト(リンクテキスト)</td>
714 <h2>メディアオブジェクトへのリンクコード</h2>
724 <td>ファイルへの直接リンク(URL)</td>
727 <td>代用テキスト(リンクテキスト)</td>
732 <div class="page"><a name="templatememberextra"></a>
733 <h1>テンプレート:登録メンバーからのコメントへの追加表示</h1>
734 <p>これはコメントの著者がメンバーであることをの証を追加するのに利用できるテンプレートです。最終的には<a href="#templatecommentbody">コメントの本体</a>で使われる<code><%authtext%></code>変数の表示となります。</p>
736 <p>このテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます。</p>
740 <div class="page"><a name="templatecommentcontinued"></a>
741 <h1>テンプレート:コメントの続きを読む</h1>
742 <p>このリンク・フォーマットは、<a href="#templatecommentbody">コメントの本体</a>で使われる変数<code><%short%></code>の終わりに追加されます。</p>
744 <p>このテンプレート内部では、いくつかの<a href="#templatevars-comments" title="Overview of comments-related template variables">コメント関連変数</a>が利用できます(<code><%short%></code>変数以外)。</p>
749 <a href="<%itemlink%>">[続き]</a>
754 <div class="page"><a name="templatecommentwords"></a>
755 <h1>テンプレート:コメントの数え方</h1>
756 <p>訳注:日本語で使う場合は、単複同型なので両方"コメント"にして問題ないです。</p>
757 <p>たぶん、"1 comment(s)"よりむしろ"1 comment"と表示したい人が多いのではないでしょうか?「コメントが一つの時」と「コメントが二つ以上の時」のテンプレート部分はそういった目的のために使えます。これらは他の所で使える<code><%commentword%></code>変数の中身として利用されます。</p>
759 <p>もし一つしかコメントが無い場合、<code><%commentword%></code>は「コメントが一つの時」と同じ内容になります。もし1より多い複数のコメントがついているなら、<code><%commentword%></code>は「コメントが二つ以上の時」と同じ内容になります。
762 <p>典型的な値は"comment"と"comments"です。<strong>ここでは特別な変数は利用できません</strong>。</p>
767 <div class="page"><a name="templateeditlink"></a>
768 <h1>テンプレート:アイテムを編集するためのリンク </h1>
769 <p>このテンプレートは<a href="#templatevar-edit">テンプレート変数edit</a>がどのように表示されるかを決めるものです。ここではどのような<a href="#templatevars-overview">テンプレート変数</a>でも使用できます。
774 <pre><code><a href="<%editlink%>"
775 onclick="<%editpopupcode%>">編集</a></code></pre>
782 <div class="page"><a name="skinpartindex"></a>
783 <h1>スキン:メインの目次ページ</h1>
784 <p>このスキン部品はweblogにおける最新のエントリー(複数)を表示するのに用いられます。通常はサイトのトップページにあたるでしょう。</p>
786 <p>「メインの目次ページ」の非常に基本的な形:</p>
791 <title>私のウェブログ</title>
795 <h1>私のウェブログ</h1>
796 <%blog(mytemplate,20)%>
802 <p>これによりデフォルトweblog(上書きされた場合を除く)の最新アイテム20個が、'mytemplate'というテンプレートを用いて表示されます。</p>
806 <div class="page"><a name="skinpartitem"></a>
808 <p>これらのページは完全なアイテムを表示するために使われます。付けられた全てのコメントとコメント追加フォームを含めたものです。</p>
810 <p>「個別アイテムページ」の非常に基本的な形:</p>
815 <title>私のウェブログ :: アイテム</title>
819 <h1>アイテム</h1>
820 <%item(detailed)%>
822 <h1>コメント</h1>
823 <%comments(detailed)%>
825 <h1>コメントを追加</h1>
826 <%commentform%>
832 <p>これにより'detailed'テンプレートを用いたアイテムとコメントが表示されます。加えて標準のコメントフォームも。</p>
837 <div class="page"><a name="skinpartarchivelist"></a>
838 <h1>スキン:月別アーカイブ一覧ページ</h1>
839 <p>アーカイブが存在する全ての月の概略と、それらアーカイブへのリンクです。</p>
841 <p>「月別アーカイブ一覧ページ」の非常に基本的な形:</p>
846 <title>私のウェブログ :: アーカイブ集</title>
850 <h1>アーカイブ集</h1>
851 <%archivelist(default)%>
857 <p>これにより'default'テンプレートを用いた、存在するアーカイブファイル全てのリストが表示されます。</p>
861 <div class="page"><a name="skinpartarchive"></a>
862 <h1>スキン:月別アーカイブページ</h1>
863 <p>ひと月分のアーカイブ。「メインの目次ページ」と似た振る舞いをしますが、該当月の全てのアイテムを表示します。</p>
865 <p>「月別アーカイブページ」の非常に基本的な形:</p>
870 <title>私のウェブログ :: アーカイブ</title>
874 <h1>アーカイブ</h1>
875 <%archive(default)%>
881 <p>これにより'default'テンプレートを用いて要求されたアーカイブが表示されます。</p>
887 <div class="page"><a name="skinpartsearch"></a>
889 <p>検索結果の表示に使われます。</p>
897 <title>私のウェブログ :: 検索</title>
901 <h1>検索</h1>
904 <h1>検索結果</h1>
905 <%searchresults(default)%>
911 <p>これにより、'default'テンプレートを用いた検索の結果が表示されます。</p>
915 <div class="page"><a name="skinparterror"></a>
917 <p>エラーが発生したときに用いられます。</p>
922 <title>私のウェブログ :: エラー</title>
926 <h1>エラーが発生しました!</h1>
927 <%errormessage%>
929 <br /><br />
931 <a href="javascript:history.back();">戻る</a>
937 <p>これによりエラーメッセージと、戻るためのリンクが表示されます。</p>
941 <div class="page"><a name="skinpartmember"></a>
942 <h1>スキン:メンバー詳細ページ</h1>
943 <p>メンバーの詳細を表示するのに使われます。</p>
945 <p>「メンバー詳細ページ」の非常に基本的な形:</p>
950 <title>私のウェブログ :: メンバーの詳細</title>
954 <h1><%member(name)%> の情報</h1>
956 <a href="<%member(url)%>"><%member(url)%></a>
958 <h1>メッセージを送る</h1>
959 <%membermailform%>
965 <p>これにより、メンバー名とウェブサイトのアドレスとメール送信フォームが表示されます。</p>
970 <div class="page"><a name="skinpartimagepopup"></a>
971 <h1>スキン:画像ポップアップウィンドウ</h1>
972 <p>メディアファイル(画像)がポップアップウィンドウでの表示を必要とする場合に使われます。このスキンはそのような使われ方をする場合のレイアウトを決定します。</p>
974 <p>「画像ポップアップウィンドウ」の非常に典型的な形:</p>
979 <title><%imagetext%></title>
980 <style type="text/css">
981 img { border: none; }
985 <a href="javascript:window.close();"><%image%></a>
996 <div class="page"><a name="shortnames"></a>
998 <p>ウェブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。</p>
1000 <p>短縮名はaからzと0か9<strong>のみ</strong>で構成され、かつスペースを含むことは<strong>できません</strong>。</p>
1002 <p>表示される名前はメンバー名として使われます。aからz、 AからZ,、0から9とスペース(半角)が使用できます。ただし、スペースを名前の最初と最後に付けることはできません。</p>
1003 <p>訳注:テンプレートの名前には'/'が利用できたりするので、実際にはこの限りではないようです。</p>
1011 <div class="page"><a name="templatenew"></a>
1012 <h1>テンプレート:新しいアイテムに付けるマーク</h1>
1013 <p><a href="#cookies">最終訪問日時Cookieの保存</a>オプションが有効な時、「新しいアイテムに付けるマーク」テンプレートの内容が、前回訪問時から追加されたアイテムのための変数<%new%>に置き換えられます。変数<code><%new%></code>は、例えば<a href="#templateitems">アイテムの本体</a>テンプレートで利用できます。</p>
1015 <p>「最終訪問日時Cookieの保存」が有効でないか、アイテムが新しくなければ、このテンプレート部品は使われません。</p>
1019 <div class="page"><a name="strftime"></a>
1022 <p>次の変換記述は文字列フォーマットに基づきます<small>(PHPドキュメントの<a href="http://jp.php.net/manual/ja/function.strftime.php" onclick="window.open(this.href);return false;" class="out">strftime関数</a>から持ってきたものです)</small>。より詳しい情報は<a href="http://www.opengroup.org/onlinepubs/7908799/xsh/strftime.html" onclick="window.open(this.href);return false;" class="out" title="Open Group specification">Open Group Specification</a>にあります。</p>
1025 <li><strong>%a</strong> - 現在のロケールに基づく短縮された曜日の名前</li>
1026 <li><strong>%A</strong> - 現在のロケールに基づく完全な曜日の名前</li>
1027 <li><strong>%b</strong> - 現在のロケールに基づく短縮された月の名前</li>
1028 <li><strong>%B</strong> - 現在のロケールに基づく完全な月の名前</li>
1029 <li><strong>%c</strong> - 現在のロケールに基づく適当な日付と時間の表現</li>
1030 <li><strong>%d</strong> - 日付を10進数で(01から31) </li>
1031 <li><strong>%H</strong> - 時間を24時間表示の10進数で(00から23まで)</li>
1032 <li><strong>%I</strong> - 時間を12時間表示の10進数で(01から12までの範囲)</li>
1033 <li><strong>%j</strong> - 年間での日付を10進数で表現 (001から366)</li>
1034 <li><strong>%m</strong> - 月を10進数で表現 (01から12)</li>
1035 <li><strong>%M</strong> - 分を10進数で表現</li>
1036 <li><strong>%p</strong> - 指定した時間により 'am' または 'pm' 、または 現在のロケールに対応した文字列</li>
1037 <li><strong>%S</strong> - 秒を10進数で表現</li>
1038 <li><strong>%U</strong> - 年間で何番目の週であるかを 10 進数で表現。 年間で最初の日曜を最初の週の最初の日として数えます。</li>
1039 <li><strong>%W</strong> - 現在の年で何番目の週であるかを10進数で表現。 年間で最初の月曜を最初の週の最初の日として数えます。</li>
1040 <li><strong>%w</strong> - 曜日を10進数で表現。日曜は0になります。</li>
1041 <li><strong>%x</strong> - 時間を除いた日付を現在のロケールに基づき表現します。</li>
1042 <li><strong>%X</strong> - 日付を除いた時間を現在のロケールに基づき表現します。</li>
1043 <li><strong>%y</strong> - 世紀の部分を除いた年を10進数として表現。(00から99までの範囲) </li>
1044 <li><strong>%Y</strong> - 世紀を含む年を 10進数で表現</li>
1045 <li><strong>%Z</strong> - タイムゾーンまたはその名前または短縮形</li>
1046 <li><strong>%%</strong> - 文字リテラル'%' </li>
1051 <div class="page"><a name="pinguserland"></a>
1052 <h1>Weblogs.comへのPing</h1>
1053 <p>weblogを更新したときに、<a href="http://www.weblogs.com/" onclick="window.open(this.href);return false;" class="out">weblogs.com</a>に更新の通知(ping)を送るという選択ができます。このウェブサイトは要求する人みんなに、近頃更新されたweblogのリストを提供してくれます。多くのウェブサイトがこのデータを用いていますので、このpingを有効にすることでいくらかの新しい訪問者を得る事となるでしょう。</p>
1055 <p class="note"><strong>注意:</strong>この機能を正しく動かすために、blogごとの「設定」にあるweblogの「URL」と「Blogの名前」を埋める必要があります。</p>
1059 <div class="page"><a name="blogsearchable"></a>
1063 <p>「検索対象にする」オプションが選択されていると、対象のweblogは<strong>常に</strong>検索対象に含まれます。たとえ検索が他のweblogで行われたとしても。(訳注:2.5からのオプション)</p>
1065 <p>例として、'lifelog'と'linkdump'という2つのweblogを持ち、'linkdump'の「検索対象にする」が有効になっていると仮定しましょう。そうすると、'lifelog'での検索クリエーは'linkdump'も検索するのに対して、'linkdump'の検索クリエーは'linkdump'のエントリーしか検索しません。</p>
1071 <div class="page"><a name="convertbreaks"></a>
1073 <p>デフォルトでは、Nucleusはアイテム内の改行を<code><br /></code>タグに変換します。だから改行も(X)HTMLでのアウトプットに現れるのです。</p>
1074 <p>手馴れたユーザーや、Semantic Web(<tt>br</tt>タグは情報を付加せず、ただ記述のためにのみ使われる)のために努力するユーザーは、この機能が迷惑だと感じるかもしれません。そしてこの機能を切るのです。</p>
1078 <div class="page"><a name="media"></a>
1080 <p>Nucleusはメディアファイル(画像、動画、音楽など等)をウェブサイトにアップロードすることができます。</p>
1081 <p>このためにいくつかの設定が必要となります:</p>
1083 <li><strong>メディア(画像・音声)ディレクトリ</strong>:メディアファイルが保存されるサーバー上の場所(ローカルのファイルシステム)</li>
1084 <li><strong>メディアURL</strong>:メディアファイルのURL上の場所</li>
1085 <li><strong>ファイルのアップロードを許可しますか?</strong>:ファイルのアップロードを不許可にすることが可能です</li>
1086 <li><strong>アップロードを許可するファイルタイプ</strong>:アップロードできるファイルの拡張子群(反応が無い場合は、コンマで区切る)</li>
1087 <li><strong>アップロードファイルの最大サイズ</strong>:アップロードファイルのサイズに制限を設ける</li>
1088 <li><strong>アップロードするファイル名の頭に日付を付加する</strong>:もしこのオプションが有効なら、アップロードされたファイルには現在の日付が頭に付加されます。'bunny.jpg'という名前のファイルを2003年4月8日にアップロードしたなら、'20030408-bunny.jpg'というファイル名になります。何故こんな機能があるかというと、大量のファイルをアップロードしているときについ同じ名前を用いてしまう問題を避けるためです。</li>
1091 <p>メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。あとは、メディア・ディレクトリ下のサブディレクトリがグローバルなコレクション(メンバー間で共有)とみなされます。</p>
1093 <p>アップロードは、少なくとも一つのblogチームに入っているメンバーでなくては行えません。悪用を予防するためです。</p>
1097 <div class="page"><a name="protectmemnames"></a>
1099 <p>このオプションが有効なら、ログインしていないメンバーは登録済みメンバーと同じ名前を使ってコメントを加えることができません。このようにする理由は、ゲストによるメンバーへのなりすましを避けるためです。</p>
1103 <div class="page"><a name="pluginurl"></a>
1105 <p>この設定はプラグイン管理領域のベースURLです。通常次のようになります。</p>
1106 <pre>http://hostname.com/nucleus/plugins/</pre>
1109 <div class="page"><a name="skinsurl"></a>
1111 <p>この設定はNucleusスキン・ディレクトリのベースURLです。通常次のようになります。</p>
1112 <pre>http://hostname.com/skins/</pre>
1115 <div class="page"><a name="actionurl"></a>
1116 <h1>action.phpへのフルURL</h1>
1117 <p>この設定はNucleus付属のスクリプト<code>action.php</code>の絶対URLです。通常次のようになります。</p>
1118 <pre>http://hostname.com/actions.php</pre>
1123 <div class="page"><a name="additem"></a>
1125 <p>weblogにアイテムを追加する際、「本文」「タイトル」「続き」にて4種類のテンプレート変数を利用することができます:</p>
1127 <li><a href="#templatevar-popup"><%popup(...)%></a> ポップアップ画像の挿入</li>
1128 <li><a href="#templatevar-image"><%image(...)%></a> インライン画像の挿入</li>
1129 <li><a href="#templatevar-media"><%media(...)%></a> メディアオブジェクトの挿入</li>
1131 <p>普通、これらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。</p>
1140 <a name="skinvar-referer"></a>
1141 <h1>スキン変数:referer</h1>
1142 <p>参照もとのURLを挿入(空っぽになりえます)。</p>
1149 <a href="<%referer%>">戻る</a>
1155 <a name="skinvar-itemid"></a>
1156 <h1>スキン変数:itemid</h1>
1157 <p>現在選択しているアイテムのIDを挿入</p>
1170 <a name="skinvar-itemlink"></a>
1172 <h1>スキン変数:itemlink</h1>
1174 <p>アイテムへの永続リンク(permanent link)を追加</p>
1181 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code><a href...</code>タグがアウトプットされる</li>
1196 <a name="skinvar-itemtitle"></a>
1197 <h1>スキン変数:itemtitle</h1>
1198 <p>アイテムのタイトルを挿入。HTMLは除去され、エンティティはエンコードされる。</p>
1211 <a name="skinvar-archivedate"></a>
1212 <h1>スキン変数:archivedate</h1>
1213 <p>アーカイブの日付としてフォーマット済みの日付を挿入。パラメーターなしで使うと、例えばアーカイブが2002年8月のものなら、'15 august 2002'か'august 2002'のどちらかが挿入されることになるでしょう。</p>
1222 <td>日付がフォーマットされるときに用いられる<a href="#templatelocale">Locale</a></td>
1225 <td>日付のフォーマット(<a href="#strftime">strftime変数</a>)</td>
1233 Archive for <%archivedate%>
1234 Archive for <%archivedate(dutch)%>
1235 Archive for <%archivedate(en,%B %Y)%>
1242 <a name="skinvar-blog"></a>
1245 <p>現在動いているblog(通常はデフォルトのもの)の一番新しいアイテム群を、スキンに挿入。</p>
1251 <li><strong>template</strong>:使用するテンプレート名</li>
1255 <li><strong><em>amount</em></strong>:表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば<code>10(5)</code>と記述すると5番目から始めて10個のアイテムを表示する。</li>
1256 <li><strong><em>category</em></strong>:表示するカテゴリーの名前</li>
1262 <p>メインの目次、個別アイテム、月別アーカイブ、月別アーカイブ一覧、検索</p>
1267 <%blog(default,15)%>
1268 <%blog(default,5(15))%>
1269 <%blog(mytemplate)%>
1270 <%blog(mytemplate,5,mycategory)%>
1279 <a name="skinvar-otherblog"></a>
1280 <h1>スキン変数:otherblog</h1>
1282 <p>指定されたblogの最新アイテム群をスキンに挿入。</p>
1288 <li><strong>blogname</strong>:表示するblogの名前(短縮名)</li>
1289 <li><strong>template</strong>:使用するテンプレート名</li>
1293 <li><strong><em>amount</em></strong>:表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば<code>10(5)</code>と記述すると5番目から始めて10個のアイテムを表示する。</li>
1294 <li><strong><em>category</em></strong>:表示するカテゴリーの名前</li>
1305 <%otherblog(myblog,default,15)%>
1306 <%otherblog(yourblog,mytemplate)%>
1307 <%otherblog(yourblog,mytemplate,15,mycategory)%>
1308 <%otherblog(yourblog,mytemplate,5(15),mycategory)%>
1322 <a name="skinvar-item"></a>
1325 <p>現在選択されているアイテムを、指定されたテンプレートを用いて表示(コメントは除く)。</p>
1329 <li><strong>template</strong>:使用するテンプレート名</li>
1339 <%item(mytemplate)%>
1353 <a name="skinvar-comments"></a>
1354 <h1>スキン変数:comments</h1>
1356 <p>現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて表示。</p>
1360 <li><strong>template</strong>:使用するテンプレート名</li>
1370 <%comments(mytemplate)%>
1382 <a name="skinvar-archive"></a>
1383 <h1>スキン変数:archive</h1>
1385 <p>選択された月と選択されているblog(普通はデフォルトのもの)のアーカイブを、指定されたテンプレートを用いて表示。</p>
1391 <li><strong>template</strong>:使用するテンプレート名</li>
1395 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1406 <%archive(mytemplate)%>
1407 <%archive(mytemplate,mycategory)%>
1416 <a name="skinvar-otherarchive"></a>
1417 <h1>スキン変数:otherarchive</h1>
1419 <p>選択された月のアーカイブを、指定されたblogとテンプレートを用いて表示。</p>
1425 <li><strong>blogname</strong>:使用するblogの名前(短縮名)</li>
1426 <li><strong>template</strong>:使用するテンプレート名</li>
1430 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1441 <%otherarchive(myblog,mytemplate)%>
1442 <%otherarchive(myblog,mytemplate,mycategory)%>
1454 <a name="skinvar-archivelist"></a>
1455 <h1>スキン変数:archivelist</h1>
1457 <p>現在選択しているblog(通常はデフォルトのもの)の存在するアーカイブのリストを、指定されたテンプレートを用いて表示。</p>
1463 <li><strong>template</strong>:使用するテンプレート名</li>
1467 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1468 <li><strong><em>limit</em></strong>:表示するリンク数の制限(例えば、過去3ヶ月分へのリンクしか表示させたくないときなど)</li>
1474 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1479 <%archivelist(yourblog,mytemplate)%>
1480 <%archivelist(yourblog,mytemplate,mycategory)%>
1486 <a name="skinvar-archivedaylist"></a>
1487 <h1>スキン変数:archivedaylist</h1>
1489 <p>スキン変数<a href="#skinvar-archivelist">archivelist</a>と同様ですが、<em>月</em>ごとの代わりに<em>日</em>ごとのエントリーを表示。</p>
1495 <li><strong>template</strong>:使用するテンプレート名</li>
1499 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1500 <li><strong><em>limit</em></strong>表示するリンク数の制限(例えば、過去3日分へのリンクしか表示させたくないときなど)</li>
1506 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1512 <%archivedaylist(mytemplate)%>
1513 <%archivedaylist(mytemplate,mycategory)%>
1520 <a name="skinvar-otherarchivedaylist"></a>
1521 <h1>スキン変数:otherarchivedaylist</h1>
1523 <p>スキン変数<a href="#skinvar-otherarchivelist">otherarchivelist</a>と同様ですが、<em>月</em>ごとの代わりに<em>日</em>ごとのエントリーを表示。</p>
1529 <li><strong>blogname</strong>:blogの名前(短縮名)</li>
1530 <li><strong>template</strong>:使用するテンプレート名</li>
1534 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1545 <%otherarchivedaylist(yourblog,mytemplate)%>
1546 <%otherarchivedaylist(yourblog,mytemplate,mycategory)%>
1554 <a name="skinvar-otherarchivelist"></a>
1555 <h1>スキン変数:otherarchivelist</h1>
1557 <p>指定されたblogの存在するアーカイブのリストを、指定されたテンプレートを用いて表示。</p>
1563 <li><strong>blogname</strong>:blogの名前(短縮名)</li>
1564 <li><strong>template</strong>:使用するテンプレート名</li>
1568 <li><strong><em>category</em></strong>:表示するカテゴリー名</li>
1579 <%otherarchivelist(yourblog,mytemplate)%>
1580 <%otherarchivelist(yourblog,mytemplate,mycategory)%>
1588 <a name="skinvar-categorylist"></a>
1589 <h1>スキン変数:categorylist</h1>
1591 <p>blog(デフォルトは選択されているblog)のカテゴリーリストを、指定されたテンプレートを用いて挿入。</p>
1597 <li><strong>template</strong>:使用するテンプレート名</li>
1601 <li><strong><em>blogname</em></strong>:使用するblogの短縮名</li>
1607 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム</p>
1612 <%categorylist(mytemplate)%>
1613 <%categorylist(mytemplate,myweblog)%>
1621 <a name="skinvar-category"></a>
1622 <h1>スキン変数:category</h1>
1624 <p>現在選択されているカテゴリーに関するいくつかの情報を挿入。カテゴリーが選択されていないときは何も表示しない。</p>
1630 <li><strong><em>type</em></strong>:どの情報を内包させるのか。<b>name</b>-カテゴリー名(デフォルト)、<b>desc</b>-カテゴリーの説明、<b>id</b>-カテゴリーのID、のどれかとなる。</li>
1642 <%category(id)%>
1643 <%category(desc)%>
1644 <%category(name)%>
1651 <a name="skinvar-ifcat"></a>
1652 <h1>スキン変数:ifcat</h1>
1654 <p class="deprecated">Nucleusのバージョン2.0以降では使いません。<a href="#skinvar-if"><%if(category)%></a>を代わりに使ってください。</p>
1660 <li><em>text</em>:表示するテキスト</li>
1671 <%ifcat(Current Category: )%><%category%>
1680 <a name="skinvar-searchresults"></a>
1681 <h1>スキン変数:searchresults</h1>
1683 <p>現在のクリエーに対する検索結果を表示。</p>
1689 <li><strong>template</strong>:使用するテンプレート名</li>
1693 <li><strong><em>maxresults</em></strong>:表示する結果の最大数</li>
1704 <%searchresults(mytemplate)%>
1713 <a name="skinvar-othersearchresults"></a>
1714 <h1>スキン変数:othersearchresults</h1>
1716 <p>指定されたblogの現在のクリエーに対する検索結果を、指定されたテンプレートを用いて表示。</p>
1722 <li><strong>blogname</strong>:使用するblogの名前(短縮名)</li>
1723 <li><strong>template</strong>:使用するテンプレート名</li>
1727 <li><strong><em>maxresults</em></strong>:表示する結果の最大数</li>
1738 <%othersearchresults(myblog,mytemplate)%>
1750 <a name="skinvar-query"></a>
1751 <h1>スキン変数:query</h1>
1753 <p>現在の検索クリエーを挿入。</p>
1778 <a name="skinvar-version"></a>
1779 <h1>スキン変数:version</h1>
1781 <p>現在使用しているNucleusのバージョンを挿入。</p>
1807 <a name="skinvar-previtem"></a>
1808 <h1>スキン変数:previtem</h1>
1810 <p>そのblogにおける一つ前のアイテムのIDを挿入。</p>
1833 <a name="skinvar-nextitem"></a>
1834 <h1>スキン変数:nextitem</h1>
1836 <p>そのblogにおける一つ先のアイテムのIDを挿入。</p>
1855 <a name="skinvar-nextitemtitle"></a>
1856 <h1>スキン変数:nextitemtitle</h1>
1858 <p>そのblogにおける一つ先のアイテムのタイトルを挿入。</p>
1870 <%nextitemtitle%>
1877 <a name="skinvar-previtemtitle"></a>
1878 <h1>スキン変数:previtemtitle</h1>
1880 <p>そのblogにおける一つ前のアイテムのタイトルを挿入。</p>
1892 <%previtemtitle%>
1901 <a name="skinvar-prevarchive"></a>
1902 <h1>スキン変数:prevarchive</h1>
1904 <p>一日前か一ヶ月前かどちらかのアーカイブに相当する、<code>アーカイブ</code>標識を挿入。この値はアーカイブを選択するURL内で利用することができる。</p>
1907 <li>もし表示されているアーカイブが一日単位なら、値は<code>YYYY-MM-DD</code>という形をとる</li>
1908 <li>もし表示されているアーカイブが一ヶ月単位なら、値は<code>YYYY-MM</code>という形を取る</li>
1920 <pre><code><a href="index.php?archive=<%prevarchive%>">....</code></pre>
1930 <a name="skinvar-nextarchive"></a>
1931 <h1>スキン変数:nextarchive</h1>
1933 <p>一日先か一ヶ月先かどちらかのアーカイブに相当する、<code>アーカイブ</code>標識を挿入。この値はアーカイブを選択するURL内で利用することができる。
1937 <li>もし表示されているアーカイブが一日単位なら、値は<code>YYYY-MM-DD</code>という形をとる</li>
1938 <li>もし表示されているアーカイブが一ヶ月単位なら、値は<code>YYYY-MM</code>という形を取る</li>
1950 <pre><code><a href="index.php?archive=<%nextarchive%>">....</code></pre>
1956 <a name="skinvar-archivetype"></a>
1957 <h1>スキン変数:archivetype</h1>
1959 <p><tt>日単位</tt>か<tt>月単位</tt>、どちらのアーカイブタイプが現在表示されているのか示す。</p>
1975 <a name="skinvar-todaylink"></a>
1976 <h1>スキン変数:todaylink</h1>
1978 <p>weblogのメインページへのリンクを挿入。現在選択されているblogとカテゴリーが考慮される。</p>
1984 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code><a href...</code>タグがアウトプットされる</li>
2008 <a name="skinvar-archivelink"></a>
2009 <h1>スキン変数:archivelink</h1>
2011 <p>現在選択しているblogとカテゴリー(blogが選択されていないときはデフォルトのblog)のアーカイブへのリンクを挿入。</p>
2018 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code><a href...</code>タグがアウトプットされる</li>
2030 <%archivelink%>
2041 <a name="skinvar-nextlink"></a>
2042 <h1>スキン変数:nextlink</h1>
2044 <p>アイテムページにおいては一つ先のアイテムへの、アーカイブページにおいては一つ先のアーカイブへのリンクを挿入。</p>
2050 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code><a href...</code>タグがアウトプットされる</li>
2051 <li><strong><em>amount</em></strong>:「検索」と「メインの目次」において:前または先のページに進んだときに表示されるアイテムの数</li>
2058 <p>個別アイテム、月別アーカイブ、検索、メインの目次</p>
2076 <a name="skinvar-prevlink"></a>
2077 <h1>スキン変数:prevlink</h1>
2079 <p>アイテムページにおいては一つ前のアイテムへの、アーカイブページにおいては一つ前のアーカイブへのリンクを挿入。「検索」と「メインの目次」でも使える。</p>
2085 <li><strong><em>linktext</em></strong>:記述されていると、未加工のリンクの代わりに完全な<code><a href...</code>タグがアウトプットされる</li>
2086 <li><strong><em>amount</em></strong>:「検索」と「メインの目次」において:前または先のページに進んだときに表示されるアイテムの数</li>
2092 <p>個別アイテム、月別アーカイブ、検索、メインの目次</p>
2110 <a name="skinvar-errormessage"></a>
2111 <h1>スキン変数:errormessage</h1>
2113 <p>エラーが発生したときに、それに相当するメッセージを挿入。</p>
2125 <%errormessage%>
2138 <a name="skinvar-imagetext"></a>
2139 <h1>スキン変数:imagetext</h1>
2141 <p class="deprecated">このスキン変数はNucleusバージョン2.0以降使いません。代わりに<a href="#skinvar-image"><code><%image(caption)%></code></a>を使ってください。</p>
2143 <p>ポップアップ画像に見出しテキストをつける</p>
2150 <p>画像ポップアップウィンドウ</p>
2163 <a name="skinvar-image"></a>
2164 <h1>スキン変数:image</h1>
2166 <p>選択された画像を挿入(画像ポップアップ用)</p>
2175 <td><strong>imgtag</strong>(デフォルト)</td>
2176 <td>完全なXHTMLタグ <code><img ... /></code></td>
2178 <td><strong>url</strong></td>
2179 <td>画像ファイルへのURL</td>
2181 <td><strong>width</strong></td>
2184 <td><strong>height</strong></td>
2187 <td><strong>caption</strong></td>
2188 <td>画像の見出し(画像と共に表示されるテキスト)</td>
2195 <p>画像ポップアップウィンドウ</p>
2207 <a name="skinvar-vars"></a>
2210 <p class="deprecated">このスキン変数はNucleusバージョン2.0以降使いません。<a href="#skinvar-itemid">スキン変数:itemid</a>を使ってこのHTMLをあなた自身で挿入することはたいした手間ではないでしょう。</p>
2212 <p>itemidの入り隠しフォームのインプット欄を挿入。</p>
2214 <code><input type="hidden" name="itemid" value="<strong>1234</strong>" /></code>
2232 <a name="skinvar-sitevar"></a>
2233 <h1>スキン変数:sitevar</h1>
2235 <p>サイト変数をインクルードする。</p>
2239 <li><strong>タイプ</strong>:表示される変数の名前
2241 <li><em>url</em>:サイトのURL</li>
2242 <li><em>name</em>:サイトの名前</li>
2243 <li><em>admin</em>:管理者のメールアドレス</li>
2255 <%sitevar(name)%>
2256 <%sitevar(url)%>
2257 <a href="mailto:<%sitevar(email)%>">管理人</a>
2268 <a name="skinvar-blogsetting"></a>
2269 <h1>スキン変数:blogsetting</h1>
2271 <p>現在選択しているblog(普通はデフォルトのもの)の詳細な設定を挿入。</p>
2275 <li><strong>タイプ</strong>:どの設定が入れられるか
2277 <li><em>id</em>:該当blogのID</li>
2278 <li><em>url</em>:該当blogのURL</li>
2279 <li><em>name</em>:該当blogの名前(長い名前)</li>
2280 <li><em>desc</em>:該当blogの説明</li>
2287 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細</p>
2292 <%blogsetting(name)%>
2293 <%blogsetting(id)%>
2294 <%blogsetting(desc)%>
2295 <a href="<%blogsetting(url)%>">...</a>
2306 <a name="skinvar-member"></a>
2307 <h1>スキン変数:member</h1>
2309 <p>現在ログインしているメンバーに関する情報を挿入。メンバーの詳細ページにおいては、要求されたメンバーについての同じ情報を表示する追加オプションがある。</p>
2311 <p>ログインしていない訪問者の場合は、<em>your...</em>のパラメーターは何も挿入しない。</p>
2315 <li><strong>タイプ</strong>:表示される情報
2316 <p>ログインしたメンバーの情報:</p>
2318 <li><em>yourname</em>:メンバーのニックネーム(ログインに使うもの)</li>
2319 <li><em>yourrealname</em>:メンバーのフルネーム</li>
2320 <li><em>yournotes</em>:メンバーが自身のために設定できるその他の情報(備考欄)</li>
2321 <li><em>yoururl</em>:メンバーのウェブサイトURL</li>
2322 <li><em>youremail</em>:メンバーのメールアドレス</li>
2323 <li><em>yourid</em>:メンバーのID</li>
2325 <p>要求されたメンバーの情報(「メンバー詳細」のページでのみ利用可):</p>
2327 <li><em>name</em>:メンバーのニックネーム(ログインに使うもの)</li>
2328 <li><em>realname</em>:メンバーのフルネーム</li>
2329 <li><em>notes</em>:メンバーが自身のために設定できるその他の情報(備考欄)</li>
2330 <li><em>url</em>:メンバーのウェブサイトURL</li>
2331 <li><em>email</em>:メンバーのメールアドレス</li>
2332 <li><em>id</em>:メンバーのID</li>
2344 <%if(loggedin)%>
2345 こんにちは<%member(yourrealname)%>さん
2357 <a name="skinvar-preview"></a>
2358 <h1>スキン変数:preview</h1>
2360 <p>指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入。(<a href="#skinvar-additemform">additemform</a>に関連して使われる)</p>
2364 <li><strong>template</strong>:使用されるテンプレート名</li>
2374 <%preview(mytemplate)%>
2382 <a name="skinvar-adminurl"></a>
2383 <h1>スキン変数:adminurl</h1>
2385 <p>管理領域への完全なURLを挿入。</p>
2397 <a href="<%adminurl%>">管理領域</a>
2406 <a name="skinvar-additemform"></a>
2407 <h1>スキン変数:additemform</h1>
2409 <p>現在選択しているblog(普通はデフォルトのもの)へのアイテム追加フォームを表示。ほとんどの場合、<a href="#skinvar-preview">preview</a>と共に使われる。</p>
2421 <%additemform%>
2432 <a name="skinvar-include"></a>
2433 <h1>スキン/テンプレート変数:include</h1>
2435 <p>テキストファイルをアウトプット時に取り込む。ファイルの中身はなんらかの構文解析にかけられることは無いので、スキン/テンプレート変数やPHPコードを使うことはできない。(もしインクルード時に展開させたいなら、<a href="#skinvar-parsedinclude">parsedinclude</a>と<a href="#skinvar-phpinclude">phpinclude</a>をみること)</p>
2439 <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。ここでURLを使うこともできることに注目を。</li>
2444 <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2454 <%include(filename.txt)%>
2455 <%include(/home/user/myself/filename.txt)%>
2456 <%include(http://mydomain.com/filename.html)%>
2468 <a name="skinvar-phpinclude"></a>
2469 <h1>スキン/テンプレート変数:phpinclude</h1>
2471 <p>PHPファイルをアウトプット時にインクルードする。ファイルの中身はPHPとして解釈されるので注意すること。Nucleusのスキン/テンプレート変数は展開<b>されない</b>。(他のインクルードオプションとして、<a href="#skinvar-parsedinclude">parsedinclude</a>と<a href="#skinvar-include">include</a>をみること)</p>
2475 <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。</li>
2480 <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2481 <li>ファイルはスタンダードなphpのコマンド<code>include()</code>を使ってインクルードされます。このコマンドは<em>内部の</em>クラス・メソッドから呼び出されるので、自身で<strong>アクセスしたいグローバル変数を宣言する必要があります</strong>。多くの<a href="#skinvar-phpinclude-vars">標準的な変数</a>はNucleusによって自動的にグローバルが宣言されます。</li>
2490 <pre><code><%phpinclude(filename.php)%>
2491 <%phpinclude(/home/user/myself/filename.php)%></code></pre>
2498 <a name="skinvar-phpinclude-vars"></a>
2499 <h1>スキン/テンプレート変数:phpinclude:vars</h1>
2501 <p>次のグローバル変数は、スキン/テンプレート変数の<a href="#skinvar-phpinclude">phpinclude</a>によってインクルードされたファイルからアクセスできるものです:</p>
2504 $GATEWAY_INTERFACE, $SERVER_NAME, $SERVER_SOFTWARE
2505 <br />$SERVER_PROTOCOL, $REQUEST_METHOD, $QUERY_STRING
2506 <br />$DOCUMENT_ROOT, $HTTP_ACCEPT, $HTTP_ACCEPT_CHARSET
2507 <br />$HTTP_ACCEPT_ENCODING, $HTTP_ACCEPT_LANGUAGE
2508 <br />$HTTP_CONNECTION, $HTTP_HOST, $HTTP_REFERER
2509 <br />$HTTP_USER_AGENT, $REMOTE_ADDR, $REMOTE_PORT
2510 <br />$SCRIPT_FILENAME, $SERVER_ADMIN, $SERVER_PORT
2511 <br />$SERVER_SIGNATURE, $PATH_TRANSLATED, $SCRIPT_NAME
2512 <br />$REQUEST_URI, $argv, $argc, $PHP_SELF
2513 <br />$HTTP_COOKIE_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS
2514 <br />$HTTP_POST_FILES, $HTTP_ENV_VARS, $HTTP_SERVER_VARS
2515 <br />$HTTP_SESSION_VARS, $PATH_INFO, $HTTPS
2516 <br />$HTTP_RAW_POST_DATA, $HTTP_X_FORWARDED_FOR
2519 <p>他の変数に関しては、'<tt>global $varname;</tt>'をきっちりとコードに加える必要があります。</p>
2526 <a name="skinvar-parsedinclude"></a>
2527 <h1>スキン/テンプレート変数:parsedinclude</h1>
2529 <p>ファイルをアウトプット時に取り込む。ファイルの中身はNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数を使うことができる。(他のインクルードオプションとして、<a href="#skinvar-phpinclude">phpinclude</a>と<a href="#skinvar-include">include</a>をみること)</p>
2533 <li><strong>filename</strong>:取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもよい)。</li>
2538 <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2539 <li>インクルードしたファイルの中からでも、再び<code><%parsedinclude(filename)%></code>を呼び出すことができます。無限ループを避けるため、行えるのは最大で3段階となります。</li>
2550 <%parsedinclude(filename.txt)%>
2551 <%parsedinclude(/home/user/myself/filename.txt)%>
2562 <a name="skinvar-plugin"></a>
2563 <h1>スキン/テンプレート変数:plugin</h1>
2576 <td>呼び出されるプラグインの名前。<strong>この名前は注意をはらうべき部分</strong></td>
2579 <li><p>プラグインによっては、その他のパラメーターが追加される。</p></li>
2584 <li>プラグイン名が既存の変数とぶつからない場合、<code><%PluginName(parameters)%></code>を用いて直接呼び出すことができます。</li>
2594 <%plugin(Calendar)%>
2595 <%plugin(LastComments,myweblog)%>
2596 <%LastComments(myweblog)%>
2605 <a name="skinvar-loginform"></a>
2606 <h1>スキン変数:loginform</h1>
2608 <p>ログインフォームを加えるか、"ログイン中:karma !(ログアウト)"メッセージを表示する</p>
2619 <pre><code><%loginform%></code></pre>
2627 <a name="skinvar-commentform"></a>
2628 <h1>スキン変数:commentform</h1>
2630 <p>アイテムページにコメントフォームを加える。</p>
2636 <li><strong><em>destinationurl</em></strong>:コメント追加後にリダイレクトさせるURLを設定(デフォルトでは、投稿したアイテムの「アイテム詳細」ページにリダイレクトされる)</li>
2647 <%commentform%>
2648 <%commentform(http://host/thanks.html)%>
2656 <a name="skinvar-set"></a>
2657 <h1>スキン/テンプレート変数 set</h1>
2659 <p><a href="#parser-properties" title="A list of available parser properties">パーサーのプロパティ</a>を設定する。</p>
2664 <li><strong>property</strong>:プロパティの名前</li>
2665 <li><strong>value</strong>:プロパティの値</li>
2676 <%set(IncludeMode,skindir)%>
2677 <%set(IncludePrefix,somedir/)%>
2684 <a name="skinvar-skinfile"></a>
2685 <h1>スキン/テンプレート変数:skinfile</h1>
2687 <p>インポートされたスキンから、スキンのURLに相対リンクを張るときに使う。最良の結果を得るためには、<a href="#parser-properties">パーサーのプロパティ</a><tt>IncludePrefix</tt>と共に使うこと。</p>
2692 <li><strong>filename</strong>:ファイルの名前(正確なURLに変換される)</li>
2703 <%skinfile(mystyle.css)%>
2711 <a name="skinvar-skinname"></a>
2712 <h1>スキン/テンプレート変数:skinname</h1>
2714 <p>現在使用しているスキンの名前を挿入。</p>
2734 <a name="skinvar-if"></a>
2735 <a name="skinvar-else"></a>
2736 <a name="skinvar-endif"></a>
2737 <h1>スキン変数:if/else/endif</h1>
2739 <p>決まった条件を満たしているときのみ、コンテンツ・ブロックを挿入。</p>
2742 <p>スキン変数<code>if</code>のみオプションがある</p>
2746 <li><strong>type</strong>:条件の種類</li>
2747 <li><em>name</em>:オプションの名前(必須ではない)</li>
2748 <li><em>value</em>:チェックする値(必須ではない)</li>
2754 <li><strong>category</strong>:カテゴリーを選択しているとき、条件は満たされる</li>
2755 <li><strong>blogsetting</strong>:blog設定の<em>name</em>項目の値が<em>value</em>と一致しているか調べる(nameはSQLテーブルnucleus_blogにあるカラム名)</li>
2756 <li><strong>loggedin</strong>:訪問中のメンバーが現在ログインしていれば、条件は満たされる</li>
2757 <li><strong>onteam</strong>:訪問中のメンバーがログインしており、かつ現在いるblog(あるいは<em>name</em>パラメーターで指示されたblog)のチームに入っていれば、条件は満たされる</li>
2758 <li><strong>previtem</strong>:もし現在のweblogにより新しいアイテムがあるのなら真となる(スキンタイプは個別アイテム 2.5から) (item skintype)</li>
2759 <li><strong>nextitem</strong>:もし現在のweblogにより古いアイテムがあるのなら真となる(スキンタイプは個別アイテム 2.5から)</li>
2760 <li><strong>skintype</strong>:現在のスキンタイプが<em>value</em>(index, search, item, archive, archivelist, ...)と一致するか調べる(URLでの表記となることに注意 2.5から)</li>
2761 <li><strong>hasplugin</strong>:プラグインがインストールされているか、またはプラグインのオプションが特定の値をとっているか調べる
2763 <li><strong>hasplugin,PluginName</strong>:該当プラグインが存在すれば、条件は満たされる</li>
2764 <li><strong>hasplugin,PluginName,OptionName</strong>:プラグインのオプションが「いいえ」に設定されてなければ、条件は満たされる</li>
2765 <li><strong>hasplugin,PluginName,OptionName=value</strong>:プラグインのオプションが特定の値に設定されていれば、条件は満たされる</li>
2777 <%if(loggedin)%>
2792 <a name="skinvar-membermailform"></a>
2793 <h1>スキン変数:membermailform</h1>
2795 <p>(メンバー詳細のページで)詳細が表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを表示。</p>
2801 <li><strong><em>rows</em></strong>:ボックスの横列の数値(デフォルトは10)</li>
2802 <li><strong><em>cols</em></strong>:ボックスの縦列の数値(デフォルトは40)</li>
2803 <li><strong><em>destination url</em></strong>:メッセージが送信された後リダイレクトするURL</li>
2814 <%membermailform%>
2825 <a name="skinvar-searchform"></a>
2826 <h1>スキン変数:searchform</h1>
2828 <p>現在のblogに対する検索フォームを表示。</p>
2834 <li><strong><em>blogname</em></strong>:検索を実行するblogの名前(短縮名)</li>
2840 <p>メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム</p>
2845 <%searchform%>
2846 <%searchform(otherweblog)%>
2857 <a name="skinvar-nucleusbutton"></a>
2858 <h1>スキン変数:nucleusbutton</h1>
2860 <p><a href="http://nucleuscms.org/" class="out" onclick="window.open(this.href);return false;" title="Nucleus website (opens in new window)">Nucleusウェブサイト</a>へのリンクが付いた、ボタン(あるいはバナー)を挿入。</p>
2866 <li><strong><em>imgurl</em></strong>:画像のURL(デフォルトのものを使わない場合)</li>
2867 <li><strong><em>imgwidth</em></strong>:画像の横幅(ピクセル単位)</li>
2868 <li><strong><em>imgheight</em></strong>: 画像の高さ(ピクセル単位)</li>
2874 <li>このタグは<a href="#parser-properties">パーサー設定の<code>IncludeMode</code>と<code>IncludePrefix</code></a>に影響されます。</li>
2884 <%nucleusbutton%>
2885 <%nucleusbutton(nucleus/nucleus.gif,46,43)%>
2894 <a name="skinvar-self"></a>
2897 <p>現在表示しているページのファイル名を挿入(index.phpか変更しているならそのファイル名)</p>
2922 <a name="templatevars-overview"></a>
2923 <h1>テンプレート変数:概略</h1>
2925 <h2>どういったものなのか?</h2>
2927 <p>テンプレート変数は、厳密にいうならスキン変数と同じ方法で広く働きます。唯一の違いはテンプレート内部で利用できることでしょう。変数は<code><%<i>varname</i>%></code>という形を用いて呼び出され、変数の機能によってはテキストをインクルードします。また、その他のオプションパラメーターを持つ変数もあります。</p>
2931 <p>これらテンプレート変数は、次のテンプレート部品で使われます:<tt>「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」</tt>。(変数<tt>image</tt>、<tt>popup</tt>、<tt>media</tt>もまたweblogアイテムの中で使われます。)</p>
2934 <li><a href="#templatevars-basic">基本の変数・・・</a>(title、bodyなど...)</li>
2935 <li><a href="#templatevars-advanced">上級の変数・・・</a>(include、pluginなど...)</li>
2938 <p>コメント関連のテンプレート部品(<tt>「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」</tt>)は利用可能な変数のセットが異なります:</p>
2941 <li><a href="#templatevars-comments">コメント関連の変数・・・</a></li>
2950 <a name="templatevars-basic"></a>
2951 <h1>テンプレート変数:基本の変数</h1>
2953 <p>これらすべての変数は、そのときパースされているアイテムに関わる値となります。</p>
2971 <td>categorylink</td>
2972 <td>カテゴリーへの未加工のリンク</td>
2974 <td><a href="#templatevar-karma">karma</a></td>
2978 <td>作者への未加工のリンク</td>
2981 <td>アイテムへの未加工のリンク(permanent)</td>
2983 <td><a href="#templatevar-author">author</a></td>
2986 <td><a href="#templatevar-smartbody">smartbody</a></td>
2989 <td><a href="#templatevar-morelink">morelink</a></td>
2992 <td><a href="#templatevar-date">date</a></td>
2993 <td>フォーマット済みの日付</td>
2995 <td><a href="#templatevar-time">time</a></td>
2996 <td>フォーマット済みの時刻</td>
2999 <td>その日のアーカイブへの未加工のリンク</td>
3001 <td><a href="#templatevar-comments">comments</a></td>
3002 <td>コメント・ブロックかコメント数</td>
3011 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3019 <a name="templatevars-advanced"></a>
3020 <h1>テンプレート変数:上級の変数</h1>
3028 <td>現在のアイテムの作者ID</td>
3034 <td>現在のアイテムが属するカテゴリーのID</td>
3037 <td>検索のクリエー(もし存在するなら)</td>
3039 <td><a href="#templatevar-syndicate_title">syndicate_title</a></td>
3042 <td><a href="#templatevar-syndicate_description">syndicate_description</a></td>
3045 <td>karmaposlink</td>
3048 <td>karmaneglink</td>
3052 <td>新しいアイテムを示すテキスト</td>
3054 <td><a href="#skinvar-include">include</a></td>
3055 <td>パース無しでファイルをインクルード</td>
3057 <td><a href="#skinvar-parsedinclude">parsedinclude</a></td>
3058 <td>パースしてファイルをインクルード</td>
3060 <td><a href="#skinvar-phpinclude">phpinclude</a></td>
3061 <td>PHPでパースしてファイルをインクルード</td>
3063 <td><a href="#skinvar-plugin">plugin</a></td>
3066 <td><a href="#templatevar-edit">edit</a></td>
3067 <td>アイテム編集のリンクを挿入</td>
3069 <td><a href="#templatevar-editlink">editlink</a></td>
3070 <td>アイテム編集の未加工リンク(bookmarkletへのリンク)</td>
3072 <td><a href="#templatevar-editpopupcode">editpopupcode</a></td>
3073 <td>editlink用のウィンドウをポップアップするjavascriptコード</td>
3075 <td><a href="#skinvar-skinfile">skinfile</a></td>
3076 <td>インポートされたスキンに属しているファイル用の正確なURLの取り込み</td>
3078 <td><a href="#skinvar-set">set</a></td>
3079 <td>パーサーのプロパティを設定</td>
3081 <td><a href="#templatevar-image">image</a></td>
3082 <td>メディア書庫へのインライン画像</td>
3084 <td><a href="#templatevar-popup">popup</a></td>
3085 <td>メディア・ディレクトリの画像をポップアップ</td>
3087 <td><a href="#templatevar-media">media</a></td>
3088 <td>メディア・ディレクトリからの他のメディア・オブジェクト</td>
3091 <td>検索結果を表示するテンプレートに'search hit relevance'をインクルードする(2.5より)</td>
3094 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3102 <a name="templatevars-comments"></a>
3103 <h1>テンプレート変数:コメント関連</h1>
3117 <td>ユーザーのURLかメールアドレス</td>
3120 <td>非メンバーにはメールアドレスかURLに対して、メンバーにはメンバー詳細ページに対してリンクを行う(自動で切り替えるスマートなリンク)。注意:このリンクは<a href="...">と</a>タグを既に含んでいる。(有効なURLかメールアドレスが無い場合は、ユーザーの名前のみが表示される)</td>
3122 <td>userlinkraw</td>
3123 <td>上と同じだが<a href..の部分を除く。有効なURLかメールアドレスが存在しないときは空っぽになる。</td>
3126 <td>メンバーのID(非メンバーは0となる)</td>
3128 <td>commentcount</td>
3129 <td>該当アイテムに付けられたコメントの総数</td>
3131 <td><a href="#templatecommentwords" title="commentword()">commentword</a></td>
3132 <td>1 'comment'、2 'comments'</td>
3134 <td><a href="#templatevar-date" title="date([format])">date</a></td>
3135 <td>コメントが追加された時の日付</td>
3137 <td><a href="#templatevar-time" title="time([format])">time</a></td>
3138 <td>コメントが追加された時の時刻</td>
3141 <td>コメントがどこのホストから投稿されたか</td>
3144 <td>コメントがどこのIPアドレスから投稿されたか</td>
3153 <td>アイテムの詳細ページへのリンク</td>
3155 <td><a href="#templateitemtitle" title="itemtitle([maxlength])">itemtitle</a></td>
3156 <td>現在のアイテムのタイトル</td>
3161 <td><a href="#templatememberextra" title="authtext()">authtext</a></td>
3162 <td>メンバーなら証となるテキストを表示し、非メンバーなら空っぽ</td>
3165 <td>最初の改行部分から先が省略されたコメントの本体。テンプレートによっては末尾に<a href="#templatecommentcontinued">リンクが追加</a>される。</td>
3168 <td>コメントが追加された時のタイムスタンプ</td>
3170 <td><a href="#skinvar-include" title="include(filename)">include</a></td>
3171 <td>パース無しでファイルをインクルード</td>
3173 <td><a href="#skinvar-parsedinclude" title="parsedinclude(filename)">parsedinclude</a></td>
3174 <td>パースしてファイルをインクルード</td>
3176 <td><a href="#skinvar-phpinclude" title="phpinclude(filename)">phpinclude</a></td>
3177 <td>PHPでパースしてファイルをインクルード</td>
3179 <td><a href="#skinvar-plugin" title="plugin(name,[options...])">plugin</a></td>
3182 <td><a href="#skinvar-skinfile" title="skinfile(filename)">skinfile</a></td>
3183 <td>インポートされたスキンに属しているファイル用の正確なURLの取り込み</td>
3185 <td><a href="#skinvar-set" title="set(property,value)">set</a></td>
3186 <td>パーサーのプロパティを設定</td>
3191 <p><a href="#templatevars-overview">テンプレート変数の概略...</a></p>
3198 <a name="templatevar-karma"></a>
3199 <h1>テンプレート変数:karma</h1>
3201 <p>カルマ投票のデータを挿入。カルマ投票は、アイテムの'カルマ'を投票する方法。一回のクリックで、訪問者は正にでも負にでも投票できる。これら投票の総計が、該当記事が訪問者にどのように思われているのか知らしめてくれるだろう。</p>
3207 <li><strong><em>どういったものか?</em></strong>:表示される情報の種類を選択:
3209 <li><strong>totalscore</strong>:カルマ投票の総合得点(正の投票数から負の投票数を引いたもの)<em>(デフォルト)</em></li>
3210 <li><strong>pos</strong>:正の投票の総計</li>
3211 <li><strong>neg</strong>:負の投票の総計</li>
3212 <li><strong>votes</strong>:投票数の総計</li>
3213 <li><strong>posp</strong>:正に投じられたパーセンテージ</li>
3214 <li><strong>negp</strong>:負に投じられたパーセンテージ</li>
3221 <pre><code><%karma(posp)%>がよい記事だと評価しました(総計<%votes%>票)</code></pre>
3229 <a name="templateitemtitle"></a>
3230 <h1>テンプレート変数:templateitemtitle</h1>
3232 <p>コメント関連テンプレート変数において、元記事のタイトルを挿入する。</p>
3238 <li><strong><em>maxlength</em></strong>:指定されると、<a href="#templatevar-syndicate_title">テンプレート変数syndicate_title</a>のような振る舞いでアイテムのタイトルを加工する。</li>
3250 <a name="templatevar-author"></a>
3251 <h1>テンプレート変数:author</h1>
3258 <li><strong><em>どういったものか?</em></strong>:表示される情報の種類を選択:
3260 <li><strong>name</strong>:名前を表示<em>(デフォルト)</em></li>
3261 <li><strong>realname</strong>:作者の「本名」欄を表示名の代わりに</li>
3262 <li><strong>id</strong>:そのNucleusでのメンバーID</li>
3263 <li><strong>url</strong>:メンバーのウェブサイトのURL</li>
3264 <li><strong>email</strong>:メンバーのメールアドレス(使うのは避けるべき)</li>
3272 <pre><code><%author%>
3273 <%author(realname)%>
3274 <a href="<%author(url)%>"><%author%></a></code></pre>
3282 <a name="templatevar-smartbody"></a>
3283 <h1>テンプレート変数:smartbody</h1>
3285 <p>現在のアイテムを調べ、本文テキストか続きテキストのどちらを表示するか決定する。</p>
3287 <p>続き部分が空っぽなら、本文部分が選択される。そうでなければ続き部分が表示される。</p>
3289 <table style="text-align: center;"><tr>
3290 <th>部分名</th><th colspan="2">空っぽか否か?</th>
3292 <td>本文</td><td>いいえ</td><td>いいえ</td>
3294 <td>続き</td><td>はい</td><td>いいえ</td>
3296 <th>smartbodyの表示=</th><th>「本文部分」</th><th>「続き部分」</th>
3301 <p>本文のテキストが完全なテキストと判断され、続きの部分はフロントページに表示される「紹介」や「抜粋」と判断されます。</p>
3302 <p>フロントページで使われているテンプレートには<tt><%smartbody%></tt>を使い、抜粋が存在するときにはそれを、無い場合は完全なテキストを挿入します。アイテムの詳細テンプレートには、<tt><%body%></tt> + <tt><%more%></tt>のかわりに<tt><%body%></tt>を使います。<tt><%body%></tt>は少なくとも完全なアイテムが入っているのですから。</p>
3311 <a name="templatevar-morelink"></a>
3312 <h1>テンプレート変数:morelink</h1>
3314 <p>アイテムの詳細ページへの、テンプレート(<a href="#templatemorelink">続きへのリンク</a>)で定義されているリンクを挿入。「続き」部分が無いときは空っぽとなる。</p>
3316 <p>テンプレート部品'続きへのリンク'の中身もまたパースされるので、同様に<a href="#templatevars-overview">テンプレート変数</a>を含むことができることに注意。</p>
3321 <a name="templatevar-date"></a>
3322 <h1>テンプレート変数:date</h1>
3324 <p><a href="#templatedatetime">テンプレートにおける日付の詳細なフォーマット</a>を用いた日付の挿入。オプションとして、与えられたパラメーターによる日付フォーマットのカスタムが可能。</p>
3329 <li><strong><i>format</i></strong>:日付のフォーマットに用いる形式</li>
3335 <p>4つの特別なパラメーターが利用可能:(下の二つは2.5から)</p>
3337 <li><code>rfc822</code>:ローカルにあわせたRFC822フォーマットの日付</li>
3338 <li><code>rfc822GMT</code>:GMTにあわせたRFCフォーマットの日付</li>
3339 <li><code>iso8601</code>:ISO-8601フォーマットの日付(<a href="http://www.w3.org/TR/NOTE-datetime">W3Cの時刻と日付フォーマット</a>に概略)。例:2002-10-02T10:00:00-05:00</li>
3340 <li><code>utc</code>:iso8601と同じだが、日付にはタイムゾーンの表示として"Z"を使うUTCで表現される。</li>
3347 <%date(rfc822)%>
3348 <%date(rfc822GMT)%>
3355 <a name="templatevar-time"></a>
3356 <h1>テンプレート変数:time</h1>
3358 <p><a href="#templatedatetime">テンプレートにおける時刻の詳細なフォーマット</a>を用いた時刻の挿入。オプションとして、与えられたパラメーターによる時刻フォーマットのカスタムが可能。</p>
3363 <li><strong><i>format</i></strong>:時刻のフォーマットに用いる形式</li>
3377 <a name="templatevar-comments"></a>
3378 <h1>テンプレート変数:comments</h1>
3380 <p>コメント・ブロックを挿入。<a href="#templatecomments">このブロックの構成に関するさらなる情報</a>。</p>
3389 <td>表示するコメントの数(設定されていれば、a href="#blogmaxcomments">blogごとの設定にあるコメントの最大量</a>を上書きする)</td>
3397 <%comments(5)%>
3404 <a name="templatevar-syndicate_title"></a>
3405 <h1>テンプレート変数:syndicate_title</h1>
3407 <p>HTMLタグを取り除き、100文字にまで縮めたアイテムのタイトルを挿入。テキストが縮められた場合は、末尾に"..."が追加される。</p>
3409 <p>この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。</p>
3420 <td>保持する文字数の最大値(デフォルトは100)</td>
3428 <%syndicate_title%>
3429 <%syndicate_title(25)%>
3435 <a name="templatevar-syndicate_description"></a>
3436 <h1>テンプレート変数:syndicate_description</h1>
3438 <p>HTMLタグを取り除き、250文字にまで縮めたアイテムの本文を挿入。テキストが縮められた場合は、末尾に"..."が追加される。</p>
3440 <p>この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。</p>
3451 <td>保持する文字数の最大値(デフォルトは250)</td>
3459 <%syndicate_description%>
3460 <%syndicate_description(25)%>
3467 <a name="templatevar-image"></a>
3468 <h1>テンプレート変数:image</h1>
3470 <p>アイテム本体やテンプレートにインライン画像を挿入。</p>
3472 <p>通常、テンプレート変数imageはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。</p>
3486 <td>画像の横幅(ピクセルかパーセンテージ)</td>
3489 <td>画像の高さ(ピクセルかパーセンテージ)</td>
3495 <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3501 <%image(myphoto.jpg|100|200|これが私です)%>
3502 <%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
3510 <a name="templatevar-popup"></a>
3511 <h1>テンプレート変数:popup</h1>
3513 <p>アイテム本体やテンプレートにポップアップ画像を挿入。</p>
3515 <p>通常、テンプレート変数popupはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。</p>
3529 <td>画像の横幅(ピクセルかパーセンテージ)</td>
3532 <td>画像の高さ(ピクセルかパーセンテージ)</td>
3538 <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3544 <%popup(myphoto.jpg|100|200|これが私です)%>
3545 <%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
3553 <a name="templatevar-media"></a>
3554 <h1>テンプレート変数:media</h1>
3556 <p>アイテム本体やテンプレートにメディアオブジェクトを挿入。</p>
3558 <p>通常、テンプレート変数mediaはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリからオブジェクトが持ってこられることに注意すること。</p>
3569 <td>メディアオブジェクトのファイル名</td>
3572 <td>メディアオブジェクトの説明テキスト</td>
3575 <li><strong>注意:</strong>画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマでは<em>ありませんよ</em>!</li>
3580 <pre><code><%media(mysong.mp3|新曲を聞いてみてください)%></code></pre>
3586 <a name="templatevar-edit"></a>
3587 <h1>テンプレート変数:edit</h1>
3589 <p>テンプレートの内部にて、このテンプレート変数を使えば'アイテムの編集'リンクを加えることが出来る。デフォルトでは、ポップアップするbookmarkletウィンドウへのリンクとなるが、<a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>を通して振る舞いを変更することが可能。</p>
3591 <p><strong>注意:</strong>アイテムの編集が許可されたログイン状態のメンバーのみが、このリンクを目に出来ます。他の場合は、テンプレート変数editは何も表示しません。</p>
3594 <p>「アイテムの本体」テンプレートの一例</p>
3595 <pre><code><h1><%title%></h1>
3596 <p><%body%> <%morelink%></p>
3597 <div class="metadata">
3598 <%edit%> <%comments%>
3599 </div></code></pre>
3603 <div class="example">
3604 <h4 style="margin:2px;">タイトル</h4>
3605 <p style="margin:2px;">アイテムの本文</p>
3606 <div style="margin:2px;"><a href="#templatevar-edit">編集</a> - <a href="#templatevar-edit">5 comments</a></div>
3613 <a name="templatevar-editlink"></a>
3614 <h1>テンプレート変数:editlink</h1>
3616 <p>'アイテムの編集'bookmarkletへのリンクを挿入。これは<a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>内で単純に使うことが出来る。</p>
3620 <p><a href="#templateeditlink">テンプレート:アイテムリンクの編集</a>はこんな感じになる:</p>
3622 <a href="<%editlink%>"
3623 onclick="<%editpopupcode%>">編集</a> -
3630 <a name="templatevar-editpopupcode"></a>
3631 <h1>テンプレート変数:editpopupcode</h1>
3633 <p>'アイテムリンクの編集'ウィンドウをポップアップで開くためには、リンクにいくつかのjavascriptコードを追加する必要がある。このコードを「テンプレート:アイテムリンクの編集」に置く手間を省くために、テンプレート変数editpopupcodeを用いてそれを挿入することが出来る。</p>
3636 <p><a href="#templatevar-editlink">テンプレート変数:editlink</a>の例をみること。</p>
3642 <a name="plugins"></a>
3644 <p>Nucleusでは特別な機能を追加するために、カスタムしたプラグインをインストールすることができる。プラグインはまったく違う事柄を実行できる:
3647 <li>スキン変数のように振舞う</li>
3648 <li>テンプレート変数のように振舞う</li>
3649 <li>Nucleusによって生成されたイベントのフック。「プラグインの管理」画面での「上へ」と「下へ」リンクは、イベント発生時にプラグインを呼び出す順番を決定するために用いられる。最初のプラグインは最初に呼び出され、最後のプラグインは最後に呼び出される。</li>
3650 <li><tt>action.php</tt>を通して呼び出されたときにアクタのように振舞う</li>
3652 <p>プラグインに対する責任は、完全にプラグインの作者にあることを心にとめておくこと。彼または彼女は、すべてが問題なく動くようきっちりと作らなければならない。</p>
3656 <a name="parser-properties"></a>
3657 <a name="includemode"></a>
3658 <a name="includeprefix"></a>
3661 <p>利用可能なパーサーオプションを以下に記述する。</p>
3664 <caption>パーサーのプロパティ</caption>
3672 <li><strong>normal</strong>:通常の動作;ページを作成する.phpファイルのディレクトリ/URLから相対位置のファイルを取り出しインクルード。</li>
3673 <li><strong>skindir</strong>:スキンディレクトリ/スキンURLから相対位置のファイルを取り出しインクルード。</li>
3675 <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>
3678 <td>Includeプリフィックス</td>
3680 <p>このプロパティはインクルードするファイルそれぞれの頭に追加されるプリフィックスです。例えば、プリフィックスが<tt>base/</tt>でインクルードするファイルが<tt>somefile.txt</tt>なら、最終的には<tt>base/somefile.txt</tt>をインクルードすることになります。</tt></p>
3681 <p>このプロパティはIncludeModeのプロパティと共に使われることが意図されています。この方法で、<tt><em>skindir/</em>somename/</tt>にインポートされたスキンは、<tt>IncludeMode</tt>を<tt>skindirを使う</tt>に<tt>IncludePrefix</tt>を<tt>somename/</tt>に設定しておくことができます。</p>
3682 <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>
3687 <p><tt>Includeプリフィックス</tt>と<tt>Includeモード</tt>のプロパティは、「スキンの一般的設定」において該当スキンでの包括的な設定が可能です。なお、プロパティが設定されてしまうと、例えばテンプレートも含めたすべてのパースデータにそれが適用されることを心にとめておいてください。</p>