# Nucleusポップアップ・ヘルプ

ページがダウンロードされている間はお待ちください（だいたい100KBです）。

# 後で追加/過去に投稿

## 後で追加

アイテム追加フォームの「後で追加」オプションにより、アイテムを指定した時間きっかりに公開することができます。その時が来るまで、アイテムはサイトの公開された部分で見られる事がありません。

この日時は未来のものでなくてはなりません。アイテムを追加するblogの「過去の日時での投稿を許可する」オプションが有効である場合は除いて。

## 過去の日時での投稿を許可する

有効にすると、アイテムが追加された日時を指定できます。加えて、既に存在するアイテムのタイムスタンプ（投稿日時）を編集できます。

# 投稿日時の変更

「タイムスタンプを更新」オプションにより、アイテムの投稿された日付か時間あるいはその両方を変更できます。もしアイテムの内容を変更したのなら、この方法で記事をフロントページのトップに戻せるでしょう。

しかし、そのアイテム独自のIDは変更されません。よって訪問者は、そのアイテムはもともとより低いID値のアイテム群より後に投稿されたことに気がつくことができます。

# ドラフト(Drafts)

ドラフト状態のアイテムはblogの公開されたところではまだみることができません。記事を書いている時役に立つでしょうし、多少の間を取るにもいいでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間のあるときに作業を再開することが可能です。

ドラフトを編集する際、「今すぐ追加」のラジオボタンを選び「保存」ボタンを押すと公開されます。

# 「続き」部分

アイテムには、記事を続けるために用いられるオプションである「続き」部分があります。例えば、記事がblogのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。メインのblogページを閲覧すると、「続きを読む」というリンクを目にすることでしょう。（テンプレートによってリンクの形は定義されます）

もし、導入をアイテムの単なる概略として書きたいのなら、smartbodyというテンプレート変数を用いて、「本文」と「続き」の表示を分けることが可能です。

# Blogの短縮名

「Blogの短縮名」は主に管理領域で、どのアイテムがどのblogと結びついているのか示すために使われます。

また、新規blogを有効にするための代替indexファイルでも用いられます（以下はmyshortblognameが「Blogの短縮名」だった場合の呼び出しファイルの例）：

    <?
    	include('./config.php');
    	selectBlog('myshortblogname');
    	selector();
    ?>

# 標準のスキン

blogごとの「設定」で選択された「標準のスキン」はそのblogが表示されるときに用いられるスキンです。選択できるのは一つだけです。（URLの引数を通して別のスキンで表示させることはできます）

# 通知するメールアドレス

このオプションは、新しくコメントが追加された際に通知するメールアドレスを一つあるいは複数いれるものです。もし通知が不要なら空っぽにしておいてください。メールアドレスは、あたりまえですが、有効なものでなくてはなりません。

もし複数のメールアドレスを利用する場合は、セミコロン(;)で区切ってください。

注意：設定フィールドの最大長は128文字です。リスト可能なメールアドレスの量はそれによってのみ制限されます
注意：メンバー登録に使われているメールアドレスを通知先にした場合、自身で書いたのアイテムとコメントの通知を受け取ることはありません。自分で書いたことは知っているはずですから、問題にはならないでしょう。

# コメントの最大量

メインページに表示するコメントの最大数です。これはコメント可能な最大数を制限するものではありません。詳細のページでは、設定した最大数を超えていても全てのコメントが表示されます。

注意：テンプレート内部では、テンプレート変数commentsのオプションパラメーターによってここでの値は上書きされます。

# サーバ時刻との時差

もしサーバの時刻があなたの生活時刻と一致しなければ、正確な時間を得る為にサーバ時刻との時差を加えたいかもしれません。減らすためには負の値を用いてください（マイナス記号をつける）。参照するために現在のサーバ時刻が表示されています。

## 実例

もしローカル時刻が20:35で表示されているサーバ時刻が14:35であった場合、blogの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定する必要があります。

注意：30分時差のあるタイムゾーンに住む人々のための、分刻みの時差補正もまた同様です。例えば「サーバ時刻との時差」を1.5にすると、1時間30分の補正となります。

# 自動更新するファイル

Nucleusはblogに新しいアイテムが追加されるたびに、ファイルを更新することができます。そのファイルの中身は最終変更時のタイムスタイプとなります。このようなファイルは、定期的に更新が無いかみるためにサーバ上のファイルをチェックして、そこから「weblogの更新状況」を作成するサービスに使うことができます。これらをメインblogに用た特徴は、訪問者がコメントを追加したりスキンやテンプレートに変更を加えたりしたときには更新を知らせることが無いということです。

自動更新されるファイルが必要ないときは、フィールドを空っぽにしておいてください。

自動更新されるファイルの場所は管理領域からの相対となることにご注意ください。なので、（`/path/to/your/website/update.txt` のような）絶対パスを使う方がよいでしょう。また自動更新されるファイルを作成してかつ書き込めるように（パーミッションを0666に）してください。

# Blogの管理者

Blogの管理者は次のような追加権限をもちます：

- チームの操作
- blog設定の変更
- （該当blogの） どの投稿者のアイテムでも編集と削除が可能
- blogの削除

一つのblogは複数の管理者を持つことができます。ただし、いつでも最低一人の管理者がいなくてはなりません。

# 管理者の特権

super-admin（最高管理者）と呼ばれ、全ての機能と全てのweblogにフルアクセスできます。たとえblogのチームに入っていなくてもです。

それに加えて：super-adminは、weblogの作成、一般設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作（メンバーの作成/編集/削除）を行う権限があります。

普通、super-adminとなるのはサイトの管理者ただ一人でしょう。

# 管理者領域へのログイン

super-adminはそれぞれのメンバーの管理領域へのログインを許可しないよう設定できます。

# 既定のBlog

他のblogが要求時に指定されない場合、表示されるblogです。

# 基本のスキン

このオプションは、判定が自動解決されない場合に代用するスキンをNucleusに設定します。これはスキン・パーツが空っぽだったり、blogやskinで明確に指定されていないときにおきます。

ほとんどのユーザーは、この設定を気にする必要がありません。

# Cookie設定

## ログインCookieの有効期間

メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、いつ無効になるか決定されます：

- セッションごと － ブラウザを終了させるとcookieは削除されます
- 一ヶ月 － 一ヶ月続けてサイトか管理領域を訪れないということが無い限り、cookieはコンピュータに残ります。このオプションを使えば、たぶん再ログインする必要はなくなるでしょう。（自分でログアウトしたときや、他のコンピュータからログインするときは別ですが）

## CookieパスとCookieドメイン

これらは上級の設定です。通常は変更する必要はありません。その場合、cookieパスは単純にスラッシュ（'/'）を入れ、cookieドメインは空っぽにしておいてください。

## セキュアCookie

通常は「いいえ」に設定してください。HTTPSのurlを用いておりかつhttps接続を通してのみcookieを送りたい場合でだけ、「はい」にしなければなりません。

## 最終訪問日時Cookieの保存

訪問者が最後に訪れた時間をcookieに含め保存させるよう、Nucleusを設定することが可能です。これによって、新規アイテムの隣にしるしを置くことができます。

# 言語

個々のメンバー用のコンテンツをnucleusが作成するときに用いられる言語を選択することができます。Nucleusによって生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。

言語の選択を行う場所は二ヶ所あります。「一般設定」にはデフォルトで用いられる「既定の言語」が含まれています。次にログイン状態のメンバーは、望むならこの設定を上書きできます。

これら両方の設定が無効なら、英語がデフォルトの言語として用いられます

注意： 追加の言語ファイルはNucleusのウェブサイトからダウンロードできます。（新規ウィンドウが開きます）

# アカウントの作成

訪問者に自身のメンバーアカウント作成を許可するようにも許可しないようにもできます。新規メンバーは（管理者がチームに加えるまでは）blogにアイテムを追加することはできません。しかし、管理領域にログインして設定を変更できます。また自分のコメントを削除したり変更したりも可能です。

# 新規メンバーのログイン許可

もし訪問者によるアカウントの作成を許可するなら、この設定はその方法で作られたアカウントが管理領域にログインできるか否かを明確に定めます。

# メッセージサービス

メンバーのプライバシーのために、全てのメールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージにはどっちにしろ両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。

## メンバー以外

デフォルトでは、非メンバーはメッセージサービスを使えません。なぜなら有効なメールアドレスが入力されたかチェックする方法が無いからです。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、それが受け取ったメールのヘッダー`From:`に表示されることになります。

# サイトの閉鎖

Nucleusのサイト全体を閉じることが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)

ここで設定しなければならないURLは、訪問者がリダイレクトされるURLとなります。

例外：管理領域はそれまで通り利用可能であり、最高管理者はそれまで通りにサイト全体をみることができます。（あとでサイトを再開することを忘れないでください;-)）

# URLモード

このオプションを用いることにより、URLスタイルを切り替え可能です：

- Normal: URLは次のようになります `http://host/index.php?itemid=1234`
- Fancy: URLは次のようになります `http://host/item/1234`

注意：「Fancy URL」モードで動作するようにするためには、いくつか他の作業が必要になります。それらはTips & Suggestionsに記述されています。（新規ウィンドウが開きます）

# テンプレート：アイテム

アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます：

    アイテムのヘッダー
    アイテムの本体
    アイテムのフッター

これら3つのブロックはすべてテンプレートの一部であり、結果どのような見た目になるのか定義します。

## 変数

これらのテンプレート内で、アイテムのデータを挿入するのにテンプレート変数とよばれる系列が利用できます。

## 例

テンプレート：アイテムの例

# テンプレート：アイテムの例

「アイテムの本体」テンプレートの一例です：

    <h1><%title%></h1>

    <p><%body%></p>

    <div class="metadata">
     <a href="<%itemlink%>">link</a> -
     <%date%> <%time%> -
     <a href="<%authorlink%>"><%author%></a> -
     <%comments%>
    </div>

結果はこのようなものになります：

#### ここはアイテムのタイトルです

ここはアイテムのテキスト部分です

link - August 8th 2002 18:51 - karma - no comments

# テンプレート：コメント

コメントブロックは3つの要素で構成されています。

1. コメントが表示されるとき（詳細のページやメインページで許可されているコメントの最大数を下回っているとき）

       コメントのヘッダー
         コメントの本体（繰り返し）
       コメントのフッター

2. コメントがまったく無いとき

       コメントが無い時

3. コメントがあるが、許可されている最大数を上回っているとき（アイテムの詳細のページでのみ表示されます）

       長すぎるコメントの時

これらのテンプレート内部では、いくつかのコメント関連変数が利用できます。

# テンプレート：コメントのヘッダーとフッター

## 特徴

「コメントの本体」はコメント一つごとに繰り返されますが、ヘッダーとフッターは一度しか表示されません。典型的な構成はこのようになります：

    コメントのヘッダー
      コメントの本体 1
      コメントの本体 2
      コメントの本体 3
    コメントのフッター

これらのテンプレート内では、コメント関連変数が利用できます。

## 例

Header:

    <ul>

Body:

    <li><%user%>: <%body%></li>

Footer

    </ul>

Result

- karma: いいね！
- xiffy: ああ、たしかに！

# テンプレート：続きへのリンク

これはアイテムのテンプレートで利用できるテンプレート変数、"morelink"のフォーマットとして用いられるテンプレートです。利用可能な変数はアイテムのテンプレートと同じです。

もしアイテムに「続き」の部分が存在しない場合、テンプレート変数`<%morelink%>`は無効となります。

## 例

    <a href="<%itemlink%>">[続きを読む！]</a>

# テンプレート：アーカイブリスト

過去ログのリストは、以下のようなリスト体裁をとります：

    アーカイブリストヘッダー
      アーカイブリスト本体（アーカイブごとに繰り返される）
    アーカイブリストフッター

利用できる変数：（ヘッダーとフッターでは`blogid`のみが許可されています）

名前 | 説明
--- | ---
blogid | weblogのID
archivelink | アーカイブへのリンク。`<a href="..">`のようなタグとしてはめ込むことができる。
month | 月の数値（01-12の2文字表記）
year | 年（西暦の4文字表記）
day | 月の中での日付（二文字表記。日ごと表示の時のみ）

リストに用いるアーカイブの日付表記をより融通の効くようにする方法は、strftime変数を用いることです。もし複雑すぎると感じたなら、次のを用いてください：

    <a href="<%archivelink%>">%B, %Y</a><br />

言語設定をあなたの住んでいる地域の設定に変更するためには、localeを変更してください。

# テンプレート：カテゴリーリスト

カテゴリーリストは下の表のようにフォーマットされます：

    カテゴリーリストヘッダー
      カテゴリーリストアイテム（繰り返し）
    カテゴリーリストフッター

利用可能な変数：（ヘッダーとフッターでは`blogid`、`blogurl`、`self`のみが許可されています）

名前 | 説明
--- | ---
blogid | weblogのID
blogurl | blogのURL（blogごとの「設定」で定義される）
self | パラメーター無しの現在のページ（例えば`index.php`）
catlink | 該当カテゴリーの新しいアイテムへのリンク。これにより<a href="..">タグを埋め込むことができる。
catid | カテゴリーのID
catname | カテゴリー名
catdesc | カテゴリーの説明

例を見る

# テンプレート：カテゴリーリストの例

（戻る）

## カテゴリーリストヘッダー

    <ul>
      <li><a href="<blogurl%>">まとめて表示</a></li>

## カテゴリーリストアイテム

    <li><a href="<%catlink%>"><%catname%></a></li>

## カテゴリーリストフッター

    </ul>

## 結果はこうなります：

- まとめて表示
- あなたのカテゴリー
- わたしのカテゴリー

# テンプレート：Locale

これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月と日の名前などは要求された言語での表示になるでしょう。

使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと･･･：

- en：英語
- dutch：オランダ語
- ja_JP：日本語
- ...

strftimeに関するより詳しい情報は、Open Group Specificationにあります。（新規ウィンドウが開きます）

localeは日付と時刻のフォーマット、日付ヘッダー、アーカイブリストで利用されます。

# テンプレート：日付と時刻のフォーマット

これらは`<%date%>`と`<%time%>`という変数（テンプレート変数をご覧ください）における日付と時刻のフォーマットに使われます。フォーマットはlocaleにも左右されます。

利用できる変数の詳細な情報はこちらを。もし手っ取り早く始めたいのなら、日付フォーマットに"%x"を、時刻フォーマットに"%X"をお使いください。

# テンプレート：日付ヘッダー/フッター

日付のヘッダーと日付のフッターは日付と時刻の変数を入れることができます。利用できる変数の詳細情報はこちらにあります。もし手早く始めるのなら、"%x"を日付フォーマットとして使ってください。日付フォーマットで使われる言語は、テンプレートのlocale設定で決定されます。

日付ヘッダーにテンプレート変数<%%daylink%%>を含めることによって、その日のアーカイブへのリンクを挿入できます。'%'が二つであることに注意を！月の中での現在日付に展開される%dを無効にするために必要な措置なのです。同様に、もし'%'という文字をここで使いたいなら、二つ重ねて('%%')置かないとサイトには表示されません。

日付ヘッダーのサンプル：

    <div class="day">
    <h1>%d %B</h1>

日付フッターのサンプル：

    </div>

daylinkを用いた日付ヘッダーの例：

    <div class="day">
    <h1>%d %B</h1>
    <a href="<%%daylink%%>">（アーカイブ）</a>

# テンプレート：ハイライト表示

ハイライト表示は検索実行時に使われます。これは規則変化に沿った表現として実際に使われますので、直前にバックスラッシュを置くことによっていくつかの記号をエスケープしたいと望むかもしれません。ハイライトされた単語が当てはめられる場所は"\0"で示されます。

## 例

    <span style='background-color:yellow'>\0</span>

# テンプレート：検索で何も見つからなかった場合

検索が実行され結果何も見つからなかった場合に表示されます。

利用可能な変数：

名前 | 説明
--- | ---
blogid | weblogのID
query | 検索に用いられたクリエー

## 例

    <b><%query%></b>に該当する検索結果はありませんでした

# テンプレート：コメントの本体

このテンプレート・パーツは単独のコメント表示に使われます。このテンプレート部では、コメント関連テンプレート変数が利用できます。

## 例

    <h2><%userlink%>さんによるコメント：</h2>

    <p><%body%></p>

    <div class="metadata">
     （接続元：<%host%> 投稿日時：<%date%> <%time%>）
    </div>

結果はこうなります：

#### karmaさんによるコメント：

ナイス！

(接続元：host.example.org 投稿日時：2003-03-02 13:30)

# テンプレート：メディアとポップアップ

これらのテンプレートは、画像ウィンドウのポップアップへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数を以下に記します：

## ポップアップ画像へのリンクコード

名前 | 説明
--- | ---
popuplink | すぐに使える<a href... といったリンク
rawpopuplink | href="..."内部のurlのみ
popupcode | ウィンドウを開くjavascriptコード
text | 代用テキスト（リンクテキスト）
width | イメージの幅
height | イメージの高さ
popuptext | （textと同じ）

## インライン画像のコード

名前 | 説明
--- | ---
image | すぐに使えるIMGタグ
link | 画像への直接リンク（URL）
text | 代用テキスト（リンクテキスト）
width | イメージの幅
height | イメージの高さ

## メディアオブジェクトへのリンクコード

名前 | 説明
--- | ---
media | すぐに使えるAタグ
link | ファイルへの直接リンク（URL）
text | 代用テキスト（リンクテキスト）

# テンプレート：登録メンバーからのコメントへの追加表示

これはコメントの著者がメンバーであることをの証を追加するのに利用できるテンプレートです。最終的にはコメントの本体で使われる`<%authtext%>`変数の表示となります。

このテンプレート内部では、いくつかのコメント関連変数が利用できます。

# テンプレート：コメントの続きを読む

このリンク・フォーマットは、コメントの本体で使われる変数`<%short%>`の終わりに追加されます。

このテンプレート内部では、いくつかのコメント関連変数が利用できます（`<%short%>`変数以外）。

例：

     <a href="<%itemlink%>">[続き]</a>

# テンプレート：コメントの数え方

訳注：日本語で使う場合は、単複同型なので両方"コメント"にして問題ないです。

たぶん、"1 comment(s)"よりむしろ"1 comment"と表示したい人が多いのではないでしょうか？「コメントが一つの時」と「コメントが二つ以上の時」のテンプレート部分はそういった目的のために使えます。これらは他の所で使える`<%commentword%>`変数の中身として利用されます。

もし一つしかコメントが無い場合、`<%commentword%>`は「コメントが一つの時」と同じ内容になります。もし1より多い複数のコメントがついているなら、`<%commentword%>`は「コメントが二つ以上の時」と同じ内容になります。

典型的な値は"comment"と"comments"です。ここでは特別な変数は利用できません。

# テンプレート：アイテムを編集するためのリンク

このテンプレートはテンプレート変数editがどのように表示されるかを決めるものです。ここではどのようなテンプレート変数でも使用できます。

## 例：

    <a href="<%editlink%>"
       onclick="<%editpopupcode%>">編集</a>

# スキン：メインの目次ページ

このスキン部品はweblogにおける最新のエントリー（複数）を表示するのに用いられます。通常はサイトのトップページにあたるでしょう。

「メインの目次ページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ</title>
      </head>
      <body>

        <h1>私のウェブログ</h1>
        <%blog(mytemplate,20)%>

      </body>
    </html>

これによりデフォルトweblog（上書きされた場合を除く）の最新アイテム20個が、'mytemplate'というテンプレートを用いて表示されます。

# 個別アイテムページ

これらのページは完全なアイテムを表示するために使われます。付けられた全てのコメントとコメント追加フォームを含めたものです。

「個別アイテムページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ :: アイテム</title>
      </head>
      <body>

        <h1>アイテム</h1>
        <%item(detailed)%>

        <h1>コメント</h1>
        <%comments(detailed)%>

        <h1>コメントを追加</h1>
        <%commentform%>

      </body>
    </html>

これにより'detailed'テンプレートを用いたアイテムとコメントが表示されます。加えて標準のコメントフォームも。

# スキン：月別アーカイブ一覧ページ

アーカイブが存在する全ての月の概略と、それらアーカイブへのリンクです。

「月別アーカイブ一覧ページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ :: アーカイブ集</title>
      </head>
      <body>

        <h1>アーカイブ集</h1>
        <%archivelist(default)%>

      </body>
    </html>

これにより'default'テンプレートを用いた、存在するアーカイブファイル全てのリストが表示されます。

# スキン：月別アーカイブページ

ひと月分のアーカイブ。「メインの目次ページ」と似た振る舞いをしますが、該当月の全てのアイテムを表示します。

「月別アーカイブページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ :: アーカイブ</title>
      </head>
      <body>

        <h1>アーカイブ</h1>
        <%archive(default)%>

      </body>
    </html>

これにより'default'テンプレートを用いて要求されたアーカイブが表示されます。

# スキン：検索ページ

検索結果の表示に使われます。

「検索ページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ :: 検索</title>
      </head>
      <body>

        <h1>検索</h1>
        <%searchform%>

        <h1>検索結果</h1>
        <%searchresults(default)%>

      </body>
    </html>

これにより、'default'テンプレートを用いた検索の結果が表示されます。

# スキン：エラーページ

エラーが発生したときに用いられます。

    <html>
      <head>
        <title>私のウェブログ :: エラー</title>
      </head>
      <body>

        <h1>エラーが発生しました！</h1>
        <%errormessage%>

        <br /><br />

        <a href="javascript:history.back();">戻る</a>

      </body>
    </html>

これによりエラーメッセージと、戻るためのリンクが表示されます。

# スキン：メンバー詳細ページ

メンバーの詳細を表示するのに使われます。

「メンバー詳細ページ」の非常に基本的な形：

    <html>
      <head>
        <title>私のウェブログ :: メンバーの詳細</title>
      </head>
      <body>

        <h1><%member(name)%> の情報</h1>
        ウェブサイト：
        <a href="<%member(url)%>"><%member(url)%></a>

        <h1>メッセージを送る</h1>
        <%membermailform%>

      </body>
    </html>

これにより、メンバー名とウェブサイトのアドレスとメール送信フォームが表示されます。

# スキン：画像ポップアップウィンドウ

メディアファイル（画像）がポップアップウィンドウでの表示を必要とする場合に使われます。このスキンはそのような使われ方をする場合のレイアウトを決定します。

「画像ポップアップウィンドウ」の非常に典型的な形：

    <html>
    <head>
      <title><%imagetext%></title>
      <style type="text/css">
       img { border: none; }
      </style>
    </head>
    <body>
      <a href="javascript:window.close();"><%image%></a>
    </body>
    </html>

# 短縮名と表示される名前

ウェブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。

短縮名はaからzと0か9のみで構成され、かつスペースを含むことはできません。

表示される名前はメンバー名として使われます。aからz、 AからZ,、0から9とスペース（半角）が使用できます。ただし、スペースを名前の最初と最後に付けることはできません。

訳注：テンプレートの名前には'/'が利用できたりするので、実際にはこの限りではないようです。

# テンプレート：新しいアイテムに付けるマーク

最終訪問日時Cookieの保存オプションが有効な時、「新しいアイテムに付けるマーク」テンプレートの内容が、前回訪問時から追加されたアイテムのための変数<%new%>に置き換えられます。変数`<%new%>`は、例えばアイテムの本体テンプレートで利用できます。

「最終訪問日時Cookieの保存」が有効でないか、アイテムが新しくなければ、このテンプレート部品は使われません。

# 時間変数の概要

次の変換記述は文字列フォーマットに基づきます（PHPドキュメントのstrftime関数から持ってきたものです）。より詳しい情報はOpen Group Specificationにあります。

- %a - 現在のロケールに基づく短縮された曜日の名前
- %A - 現在のロケールに基づく完全な曜日の名前
- %b - 現在のロケールに基づく短縮された月の名前
- %B - 現在のロケールに基づく完全な月の名前
- %c - 現在のロケールに基づく適当な日付と時間の表現
- %d - 日付を10進数で(01から31)
- %H - 時間を24時間表示の10進数で(00から23まで)
- %I - 時間を12時間表示の10進数で(01から12までの範囲)
- %j - 年間での日付を10進数で表現 (001から366)
- %m - 月を10進数で表現 (01から12)
- %M - 分を10進数で表現
- %p - 指定した時間により 'am' または 'pm' 、または 現在のロケールに対応した文字列
- %S - 秒を10進数で表現
- %U - 年間で何番目の週であるかを 10 進数で表現。 年間で最初の日曜を最初の週の最初の日として数えます。
- %W - 現在の年で何番目の週であるかを10進数で表現。 年間で最初の月曜を最初の週の最初の日として数えます。
- %w - 曜日を10進数で表現。日曜は0になります。
- %x - 時間を除いた日付を現在のロケールに基づき表現します。
- %X - 日付を除いた時間を現在のロケールに基づき表現します。
- %y - 世紀の部分を除いた年を10進数として表現。(00から99までの範囲)
- %Y - 世紀を含む年を 10進数で表現
- %Z - タイムゾーンまたはその名前または短縮形
- %% - 文字リテラル'%'

# Weblogs.comへのPing

weblogを更新したときに、weblogs.comに更新の通知（ping）を送るという選択ができます。このウェブサイトは要求する人みんなに、近頃更新されたweblogのリストを提供してくれます。多くのウェブサイトがこのデータを用いていますので、このpingを有効にすることでいくらかの新しい訪問者を得る事となるでしょう。

注意：この機能を正しく動かすために、blogごとの「設定」にあるweblogの「URL」と「Blogの名前」を埋める必要があります。

# 常に検索対象に含める

「検索対象にする」オプションが選択されていると、対象のweblogは常に検索対象に含まれます。たとえ検索が他のweblogで行われたとしても。（訳注：2.5からのオプション）

例として、'lifelog'と'linkdump'という2つのweblogを持ち、'linkdump'の「検索対象にする」が有効になっていると仮定しましょう。そうすると、'lifelog'での検索クリエーは'linkdump'も検索するのに対して、'linkdump'の検索クリエーは'linkdump'のエントリーしか検索しません。

# 改行を変換する

デフォルトでは、Nucleusはアイテム内の改行を`<br />`タグに変換します。だから改行も(X)HTMLでのアウトプットに現れるのです。

手馴れたユーザーや、Semantic Web（`br`タグは情報を付加せず、ただ記述のためにのみ使われる）のために努力するユーザーは、この機能が迷惑だと感じるかもしれません。そしてこの機能を切るのです。

# メディア

Nucleusはメディアファイル（画像、動画、音楽など等）をウェブサイトにアップロードすることができます。

このためにいくつかの設定が必要となります：

- メディア(画像・音声)ディレクトリ：メディアファイルが保存されるサーバー上の場所（ローカルのファイルシステム）
- メディアURL：メディアファイルのURL上の場所
- ファイルのアップロードを許可しますか?：ファイルのアップロードを不許可にすることが可能です
- アップロードを許可するファイルタイプ：アップロードできるファイルの拡張子群（反応が無い場合は、コンマで区切る）
- アップロードファイルの最大サイズ：アップロードファイルのサイズに制限を設ける
- アップロードするファイル名の頭に日付を付加する：もしこのオプションが有効なら、アップロードされたファイルには現在の日付が頭に付加されます。'bunny.jpg'という名前のファイルを2003年4月8日にアップロードしたなら、'20030408-bunny.jpg'というファイル名になります。何故こんな機能があるかというと、大量のファイルをアップロードしているときについ同じ名前を用いてしまう問題を避けるためです。

メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。あとは、メディア・ディレクトリ下のサブディレクトリがグローバルなコレクション（メンバー間で共有）とみなされます。

アップロードは、少なくとも一つのblogチームに入っているメンバーでなくては行えません。悪用を予防するためです。

# メンバー名の保護

このオプションが有効なら、ログインしていないメンバーは登録済みメンバーと同じ名前を使ってコメントを加えることができません。このようにする理由は、ゲストによるメンバーへのなりすましを避けるためです。

# プラグインURL

この設定はプラグイン管理領域のベースURLです。通常次のようになります。

    http://hostname.com/nucleus/plugins/

# スキンURL

この設定はNucleusスキン・ディレクトリのベースURLです。通常次のようになります。

    http://hostname.com/skins/

# action.phpへのフルURL

この設定はNucleus付属のスクリプト`action.php`の絶対URLです。通常次のようになります。

    http://hostname.com/actions.php

# アイテムの追加

weblogにアイテムを追加する際、「本文」「タイトル」「続き」にて4種類のテンプレート変数を利用することができます：

- <%popup(...)%> ポップアップ画像の挿入
- <%image(...)%> インライン画像の挿入
- <%media(...)%> メディアオブジェクトの挿入

普通、これらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。

# スキン変数：referer

参照もとのURLを挿入（空っぽになりえます）。

## 引数

なし

## スキンタイプ

全て

## 例

    <a href="<%referer%>">戻る</a>

# スキン変数：itemid

現在選択しているアイテムのIDを挿入

## 引数

None

## スキンタイプ

個別アイテム

## 例

    <%itemid%>

# スキン変数：itemlink

アイテムへの永続リンク（permanent link）を追加

## 引数

オプション（2.5から）

- linktext：記述されていると、未加工のリンクの代わりに完全な`<a href...`タグがアウトプットされる

## スキンタイプ

個別アイテム

## 例

    <%itemlink%>

# スキン変数：itemtitle

アイテムのタイトルを挿入。HTMLは除去され、エンティティはエンコードされる。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%itemtitle%>

# スキン変数：archivedate

アーカイブの日付としてフォーマット済みの日付を挿入。パラメーターなしで使うと、例えばアーカイブが2002年8月のものなら、'15 august 2002'か'august 2002'のどちらかが挿入されることになるでしょう。

## 引数

- オプション

  名前 | 値
  --- | ---
  Locale | 日付がフォーマットされるときに用いられるLocale
  Format | 日付のフォーマット（strftime変数）

## スキンタイプ

月別アーカイブ

## 例

    Archive for <%archivedate%>
    Archive for <%archivedate(dutch)%>
    Archive for <%archivedate(en,%B %Y)%>

# スキン変数：blog

現在動いているblog（通常はデフォルトのもの）の一番新しいアイテム群を、スキンに挿入。

## 引数

必須：

- template：使用するテンプレート名

オプション

- amount：表示するアイテムの数（デフォルトは10）。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば`10(5)`と記述すると5番目から始めて10個のアイテムを表示する。
- category：表示するカテゴリーの名前

## スキンタイプ

メインの目次、個別アイテム、月別アーカイブ、月別アーカイブ一覧、検索

## 例

    <%blog(default,15)%>
    <%blog(default,5(15))%>
    <%blog(mytemplate)%>
    <%blog(mytemplate,5,mycategory)%>

# スキン変数：otherblog

指定されたblogの最新アイテム群をスキンに挿入。

## 引数

必須：

- blogname：表示するblogの名前（短縮名）
- template：使用するテンプレート名

オプション：

- amount：表示するアイテムの数（デフォルトは10）。何番目のアイテムから始めるかというオフセットをNucleusに伝えるべく含めることもできる。例えば`10(5)`と記述すると5番目から始めて10個のアイテムを表示する。
- category：表示するカテゴリーの名前

## スキンタイプ

すべて

## 例

    <%otherblog(myblog,default,15)%>
    <%otherblog(yourblog,mytemplate)%>
    <%otherblog(yourblog,mytemplate,15,mycategory)%>
    <%otherblog(yourblog,mytemplate,5(15),mycategory)%>

# スキン変数：item

現在選択されているアイテムを、指定されたテンプレートを用いて表示（コメントは除く）。

## 引数

- template：使用するテンプレート名

## スキンタイプ

個別アイテム

## 例

    <%item(mytemplate)%>

# スキン変数：comments

現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて表示。

## 引数

- template：使用するテンプレート名

## スキンタイプ

個別アイテム

## 例

    <%comments(mytemplate)%>

# スキン変数：archive

選択された月と選択されているblog（普通はデフォルトのもの）のアーカイブを、指定されたテンプレートを用いて表示。

## 引数

必須：

- template：使用するテンプレート名

オプション：

- category：表示するカテゴリー名

## スキンタイプ

月別アーカイブ

## 例

    <%archive(mytemplate)%>
    <%archive(mytemplate,mycategory)%>

# スキン変数：otherarchive

選択された月のアーカイブを、指定されたblogとテンプレートを用いて表示。

## 引数

必須：

- blogname：使用するblogの名前（短縮名）
- template：使用するテンプレート名

オプション：

- category：表示するカテゴリー名

## スキンタイプ

月別アーカイブ

## 例

    <%otherarchive(myblog,mytemplate)%>
    <%otherarchive(myblog,mytemplate,mycategory)%>

# スキン変数：archivelist

現在選択しているblog（通常はデフォルトのもの）の存在するアーカイブのリストを、指定されたテンプレートを用いて表示。

## 引数

必須：

- template：使用するテンプレート名

オプション：

- category：表示するカテゴリー名
- limit：表示するリンク数の制限（例えば、過去3ヶ月分へのリンクしか表示させたくないときなど）

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

## 例

    <%archivelist(yourblog,mytemplate)%>
    <%archivelist(yourblog,mytemplate,mycategory)%>

# スキン変数：archivedaylist

スキン変数archivelistと同様ですが、月ごとの代わりに日ごとのエントリーを表示。

## 引数

必須：

- template：使用するテンプレート名

オプション：

- category：表示するカテゴリー名
- limit表示するリンク数の制限（例えば、過去3日分へのリンクしか表示させたくないときなど）

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

## 例

    <%archivedaylist(mytemplate)%>
    <%archivedaylist(mytemplate,mycategory)%>

# スキン変数：otherarchivedaylist

スキン変数otherarchivelistと同様ですが、月ごとの代わりに日ごとのエントリーを表示。

## 引数

必須：

- blogname：blogの名前（短縮名）
- template：使用するテンプレート名

Optional

- category：表示するカテゴリー名

## スキンタイプ

すべて

## 例

    <%otherarchivedaylist(yourblog,mytemplate)%>
    <%otherarchivedaylist(yourblog,mytemplate,mycategory)%>

# スキン変数：otherarchivelist

指定されたblogの存在するアーカイブのリストを、指定されたテンプレートを用いて表示。

## 引数

必須：

- blogname：blogの名前（短縮名）
- template：使用するテンプレート名

Optional

- category：表示するカテゴリー名

## スキンタイプ

すべて

## 例

    <%otherarchivelist(yourblog,mytemplate)%>
    <%otherarchivelist(yourblog,mytemplate,mycategory)%>

# スキン変数：categorylist

blog（デフォルトは選択されているblog）のカテゴリーリストを、指定されたテンプレートを用いて挿入。

## 引数

必須：

- template：使用するテンプレート名

オプション：

- blogname：使用するblogの短縮名

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

## 例

    <%categorylist(mytemplate)%>
    <%categorylist(mytemplate,myweblog)%>

# スキン変数：category

現在選択されているカテゴリーに関するいくつかの情報を挿入。カテゴリーが選択されていないときは何も表示しない。

## 引数

オプション：

- type：どの情報を内包させるのか。name-カテゴリー名（デフォルト）、desc-カテゴリーの説明、id-カテゴリーのID、のどれかとなる。

## スキンタイプ

すべて

## 例

    <%category%>
    <%category(id)%>
    <%category(desc)%>
    <%category(name)%>

# スキン変数：ifcat

Nucleusのバージョン2.0以降では使いません。<%if(category)%>を代わりに使ってください。

## 引数

なし

- text：表示するテキスト

## スキンタイプ

すべて

## 例

    <%ifcat(Current Category: )%><%category%>

# スキン変数：searchresults

現在のクリエーに対する検索結果を表示。

## 引数

必須：

- template：使用するテンプレート名

オプション：

- maxresults：表示する結果の最大数

## スキンタイプ

検索

## 例

    <%searchresults(mytemplate)%>

# スキン変数：othersearchresults

指定されたblogの現在のクリエーに対する検索結果を、指定されたテンプレートを用いて表示。

## 引数

必須：

- blogname：使用するblogの名前（短縮名）
- template：使用するテンプレート名

Optional:

- maxresults：表示する結果の最大数

## スキンタイプ

検索

## 例

    <%othersearchresults(myblog,mytemplate)%>

# スキン変数：query

現在の検索クリエーを挿入。

## 引数

なし

## スキンタイプ

検索

## 例

    <%query%>

# スキン変数：version

現在使用しているNucleusのバージョンを挿入。

## 引数

なし

## スキンタイプ

すべて

## 例

    <%version%>

# スキン変数：previtem

そのblogにおける一つ前のアイテムのIDを挿入。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%previtem%>

# スキン変数：nextitem

そのblogにおける一つ先のアイテムのIDを挿入。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%nextitem%>

# スキン変数：nextitemtitle

そのblogにおける一つ先のアイテムのタイトルを挿入。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%nextitemtitle%>

# スキン変数：previtemtitle

そのblogにおける一つ前のアイテムのタイトルを挿入。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%previtemtitle%>

# スキン変数：prevarchive

一日前か一ヶ月前かどちらかのアーカイブに相当する、`アーカイブ`標識を挿入。この値はアーカイブを選択するURL内で利用することができる。

- もし表示されているアーカイブが一日単位なら、値は`YYYY-MM-DD`という形をとる
- もし表示されているアーカイブが一ヶ月単位なら、値は`YYYY-MM`という形を取る

## 引数

なし

## スキンタイプ

月別アーカイブ

## 例

    <a href="index.php?archive=<%prevarchive%>">....

# スキン変数：nextarchive

一日先か一ヶ月先かどちらかのアーカイブに相当する、`アーカイブ`標識を挿入。この値はアーカイブを選択するURL内で利用することができる。

- もし表示されているアーカイブが一日単位なら、値は`YYYY-MM-DD`という形をとる
- もし表示されているアーカイブが一ヶ月単位なら、値は`YYYY-MM`という形を取る

## 引数

なし

## スキンタイプ

月別アーカイブ

## 例

    <a href="index.php?archive=<%nextarchive%>">....

# スキン変数：archivetype

`日単位`か`月単位`、どちらのアーカイブタイプが現在表示されているのか示す。

## 引数

なし

## スキンタイプ

月別アーカイブ

# スキン変数：todaylink

weblogのメインページへのリンクを挿入。現在選択されているblogとカテゴリーが考慮される。

## 引数

オプション：（2.5からです）

- linktext：記述されていると、未加工のリンクの代わりに完全な`<a href...`タグがアウトプットされる

## スキンタイプ

すべて

## 例

    <%todaylink%>

# スキン変数：archivelink

現在選択しているblogとカテゴリー（blogが選択されていないときはデフォルトのblog）のアーカイブへのリンクを挿入。

## 引数

オプション：（2.5から）

- linktext：記述されていると、未加工のリンクの代わりに完全な`<a href...`タグがアウトプットされる

## スキンタイプ

すべて

## 例

    <%archivelink%>

# スキン変数：nextlink

アイテムページにおいては一つ先のアイテムへの、アーカイブページにおいては一つ先のアーカイブへのリンクを挿入。

## 引数

オプション：（2.5から）

- linktext：記述されていると、未加工のリンクの代わりに完全な`<a href...`タグがアウトプットされる
- amount：「検索」と「メインの目次」において：前または先のページに進んだときに表示されるアイテムの数

## スキンタイプ

個別アイテム、月別アーカイブ、検索、メインの目次

## 例

    <%nextlink%>

# スキン変数：prevlink

アイテムページにおいては一つ前のアイテムへの、アーカイブページにおいては一つ前のアーカイブへのリンクを挿入。「検索」と「メインの目次」でも使える。

## 引数

オプション：（2.5から）

- linktext：記述されていると、未加工のリンクの代わりに完全な`<a href...`タグがアウトプットされる
- amount：「検索」と「メインの目次」において：前または先のページに進んだときに表示されるアイテムの数

## スキンタイプ

個別アイテム、月別アーカイブ、検索、メインの目次

## 例

    <%prevlink%>

# スキン変数：errormessage

エラーが発生したときに、それに相当するメッセージを挿入。

## 引数

なし

## スキンタイプ

エラー

## 例

    <%errormessage%>

# スキン変数：imagetext

このスキン変数はNucleusバージョン2.0以降使いません。代わりに`<%image(caption)%>`を使ってください。

ポップアップ画像に見出しテキストをつける

## 引数

なし

## スキンタイプ

画像ポップアップウィンドウ

## 例

    <%imagetext%>

# スキン変数：image

選択された画像を挿入（画像ポップアップ用）

## 引数

オプション：

- タイプ

  imgtag（デフォルト） | 完全なXHTMLタグ `<img ... />`
  url | 画像ファイルへのURL
  width | イメージの幅
  height | イメージの高さ
  caption | 画像の見出し（画像と共に表示されるテキスト）

## スキンタイプ

画像ポップアップウィンドウ

## 例

    <%image%>

# スキン変数：vars

このスキン変数はNucleusバージョン2.0以降使いません。スキン変数：itemidを使ってこのHTMLをあなた自身で挿入することはたいした手間ではないでしょう。

itemidの入り隠しフォームのインプット欄を挿入。

`<input type="hidden" name="itemid" value="1234" />`

## 引数

なし

## スキンタイプ

個別アイテム

# スキン変数：sitevar

サイト変数をインクルードする。

## 引数

- タイプ：表示される変数の名前
  - url：サイトのURL
  - name：サイトの名前
  - admin：管理者のメールアドレス

## スキンタイプ

すべて

## 例

    <%sitevar(name)%>
    <%sitevar(url)%>
    <a href="mailto:<%sitevar(email)%>">管理人</a>

# スキン変数：blogsetting

現在選択しているblog（普通はデフォルトのもの）の詳細な設定を挿入。

## 引数

- タイプ：どの設定が入れられるか
  - id：該当blogのID
  - url：該当blogのURL
  - name：該当blogの名前（長い名前）
  - desc：該当blogの説明

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細

## 例

    <%blogsetting(name)%>
    <%blogsetting(id)%>
    <%blogsetting(desc)%>
    <a href="<%blogsetting(url)%>">...</a>

# スキン変数：member

現在ログインしているメンバーに関する情報を挿入。メンバーの詳細ページにおいては、要求されたメンバーについての同じ情報を表示する追加オプションがある。

ログインしていない訪問者の場合は、your...のパラメーターは何も挿入しない。

## 引数

- タイプ：表示される情報

  ログインしたメンバーの情報：

  - yourname：メンバーのニックネーム（ログインに使うもの）
  - yourrealname：メンバーのフルネーム
  - yournotes：メンバーが自身のために設定できるその他の情報（備考欄）
  - yoururl：メンバーのウェブサイトURL
  - youremail：メンバーのメールアドレス
  - yourid：メンバーのID

  要求されたメンバーの情報（「メンバー詳細」のページでのみ利用可）：

  - name：メンバーのニックネーム（ログインに使うもの）
  - realname：メンバーのフルネーム
  - notes：メンバーが自身のために設定できるその他の情報（備考欄）
  - url：メンバーのウェブサイトURL
  - email：メンバーのメールアドレス
  - id：メンバーのID

## スキンタイプ

すべて

## 例

    <%if(loggedin)%>
    こんにちは<%member(yourrealname)%>さん
    <%endif%>

# スキン変数：preview

指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入。（additemformに関連して使われる）

## 引数

- template：使用されるテンプレート名

## スキンタイプ

メインの目次

## 例

    <%preview(mytemplate)%>

# スキン変数：adminurl

管理領域への完全なURLを挿入。

## 引数

なし

## スキンタイプ

すべて

## 例

    <a href="<%adminurl%>">管理領域</a>

# スキン変数：additemform

現在選択しているblog（普通はデフォルトのもの）へのアイテム追加フォームを表示。ほとんどの場合、previewと共に使われる。

## 引数

なし

## スキンタイプ

メインの目次

## 例

    <%additemform%>

# スキン/テンプレート変数：include

テキストファイルをアウトプット時に取り込む。ファイルの中身はなんらかの構文解析にかけられることは無いので、スキン/テンプレート変数やPHPコードを使うことはできない。（もしインクルード時に展開させたいなら、parsedincludeとphpincludeをみること）

## 引数

- filename：取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもよい）。ここでURLを使うこともできることに注目を。

## 注意

- このタグはパーサー設定の`IncludeMode`と`IncludePrefix`に影響されます。

## スキンタイプ

すべて

## 例

    <%include(filename.txt)%>
    <%include(/home/user/myself/filename.txt)%>
    <%include(http://mydomain.com/filename.html)%>

# スキン/テンプレート変数：phpinclude

PHPファイルをアウトプット時にインクルードする。ファイルの中身はPHPとして解釈されるので注意すること。Nucleusのスキン/テンプレート変数は展開されない。（他のインクルードオプションとして、parsedincludeとincludeをみること）

## 引数

- filename：取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもよい）。

## 注意

- このタグはパーサー設定の`IncludeMode`と`IncludePrefix`に影響されます。
- ファイルはスタンダードなphpのコマンド`include()`を使ってインクルードされます。このコマンドは内部のクラス・メソッドから呼び出されるので、自身でアクセスしたいグローバル変数を宣言する必要があります。多くの標準的な変数はNucleusによって自動的にグローバルが宣言されます。

## スキンタイプ

すべて

## 例

    <%phpinclude(filename.php)%>
    <%phpinclude(/home/user/myself/filename.php)%>

# スキン/テンプレート変数：phpinclude：vars

次のグローバル変数は、スキン/テンプレート変数のphpincludeによってインクルードされたファイルからアクセスできるものです：

$GATEWAY_INTERFACE, $SERVER_NAME, $SERVER_SOFTWARE
$SERVER_PROTOCOL, $REQUEST_METHOD, $QUERY_STRING
$DOCUMENT_ROOT, $HTTP_ACCEPT, $HTTP_ACCEPT_CHARSET
$HTTP_ACCEPT_ENCODING, $HTTP_ACCEPT_LANGUAGE
$HTTP_CONNECTION, $HTTP_HOST, $HTTP_REFERER
$HTTP_USER_AGENT, $REMOTE_ADDR, $REMOTE_PORT
$SCRIPT_FILENAME, $SERVER_ADMIN, $SERVER_PORT
$SERVER_SIGNATURE, $PATH_TRANSLATED, $SCRIPT_NAME
$REQUEST_URI, $argv, $argc, $PHP_SELF
$HTTP_COOKIE_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS
$HTTP_POST_FILES, $HTTP_ENV_VARS, $HTTP_SERVER_VARS
$HTTP_SESSION_VARS, $PATH_INFO, $HTTPS
$HTTP_RAW_POST_DATA, $HTTP_X_FORWARDED_FOR

他の変数に関しては、'`global $varname;`'をきっちりとコードに加える必要があります。

# スキン/テンプレート変数：parsedinclude

ファイルをアウトプット時に取り込む。ファイルの中身はNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数を使うことができる。（他のインクルードオプションとして、phpincludeとincludeをみること）

## 引数

- filename：取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもよい）。

## 注意

- このタグはパーサー設定の`IncludeMode`と`IncludePrefix`に影響されます。
- インクルードしたファイルの中からでも、再び`<%parsedinclude(filename)%>`を呼び出すことができます。無限ループを避けるため、行えるのは最大で3段階となります。

## スキンタイプ

すべて

## 例

    <%parsedinclude(filename.txt)%>
    <%parsedinclude(/home/user/myself/filename.txt)%>

# スキン/テンプレート変数：plugin

プラグインを呼び出す。

## 引数

- 必須：

  名前 | 内容
  --- | ---
  PlugName | 呼び出されるプラグインの名前。この名前は注意をはらうべき部分

- プラグインによっては、その他のパラメーターが追加される。

## 注意

- プラグイン名が既存の変数とぶつからない場合、`<%PluginName(parameters)%>`を用いて直接呼び出すことができます。

## スキンタイプ

すべて

## 例

    <%plugin(Calendar)%>
    <%plugin(LastComments,myweblog)%>
    <%LastComments(myweblog)%>

# スキン変数：loginform

ログインフォームを加えるか、"ログイン中:karma !(ログアウト)"メッセージを表示する

## 引数

なし

## スキンタイプ

すべて

## 例

    <%loginform%>

# スキン変数：commentform

アイテムページにコメントフォームを加える。

## 引数

オプション：

- destinationurl：コメント追加後にリダイレクトさせるURLを設定（デフォルトでは、投稿したアイテムの「アイテム詳細」ページにリダイレクトされる）

## スキンタイプ

個別アイテム

## 例

    <%commentform%>
    <%commentform(http://host/thanks.html)%>

# スキン/テンプレート変数 set

パーサーのプロパティを設定する。

## 引数

- property：プロパティの名前
- value：プロパティの値

## スキンタイプ

すべて

## 例

    <%set(IncludeMode,skindir)%>
    <%set(IncludePrefix,somedir/)%>

# スキン/テンプレート変数：skinfile

インポートされたスキンから、スキンのURLに相対リンクを張るときに使う。最良の結果を得るためには、パーサーのプロパティ `IncludePrefix`と共に使うこと。

## 引数

- filename：ファイルの名前（正確なURLに変換される）

## スキンタイプ

すべて

## 例

    <%skinfile(mystyle.css)%>

# スキン/テンプレート変数：skinname

現在使用しているスキンの名前を挿入。

## 引数

なし

## スキンタイプ

すべて

## 例

    <%skinname%>

# スキン変数：if/else/endif

決まった条件を満たしているときのみ、コンテンツ・ブロックを挿入。

## 引数

スキン変数`if`のみオプションがある

- type：条件の種類
- name：オプションの名前（必須ではない）
- value：チェックする値（必須ではない）

## 条件の種類

- category：カテゴリーを選択しているとき、条件は満たされる
- blogsetting：blog設定のname項目の値がvalueと一致しているか調べる（nameはSQLテーブルnucleus_blogにあるカラム名）
- loggedin：訪問中のメンバーが現在ログインしていれば、条件は満たされる
- onteam：訪問中のメンバーがログインしており、かつ現在いるblog（あるいはnameパラメーターで指示されたblog）のチームに入っていれば、条件は満たされる
- previtem：もし現在のweblogにより新しいアイテムがあるのなら真となる（スキンタイプは個別アイテム 2.5から） (item skintype)
- nextitem：もし現在のweblogにより古いアイテムがあるのなら真となる（スキンタイプは個別アイテム 2.5から）
- skintype：現在のスキンタイプがvalue（index, search, item, archive, archivelist, ...）と一致するか調べる（URLでの表記となることに注意 2.5から）
- hasplugin：プラグインがインストールされているか、またはプラグインのオプションが特定の値をとっているか調べる
  - hasplugin,PluginName：該当プラグインが存在すれば、条件は満たされる
  - hasplugin,PluginName,OptionName：プラグインのオプションが「いいえ」に設定されてなければ、条件は満たされる
  - hasplugin,PluginName,OptionName=value：プラグインのオプションが特定の値に設定されていれば、条件は満たされる

## スキンタイプ

すべて

## 例

    <%if(loggedin)%>
    おかえりなさい！
    <%else%>
    ようこそ！
    <%endif%>

# スキン変数：membermailform

（メンバー詳細のページで）詳細が表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを表示。

## 引数

オプション：

- rows：ボックスの横列の数値（デフォルトは10）
- cols：ボックスの縦列の数値（デフォルトは40）
- destination url：メッセージが送信された後リダイレクトするURL

## スキンタイプ

メンバー詳細

## 例

    <%membermailform%>

# スキン変数：searchform

現在のblogに対する検索フォームを表示。

## 引数

オプション：

- blogname：検索を実行するblogの名前（短縮名）

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム

## 例

    <%searchform%>
    <%searchform(otherweblog)%>

# スキン変数：nucleusbutton

Nucleusウェブサイトへのリンクが付いた、ボタン（あるいはバナー）を挿入。

## 引数

オプション：

- imgurl：画像のURL（デフォルトのものを使わない場合）
- imgwidth：画像の横幅（ピクセル単位）
- imgheight: 画像の高さ（ピクセル単位）

## 注意

- このタグはパーサー設定の`IncludeMode`と`IncludePrefix`に影響されます。

## スキンタイプ

すべて

## 例

    <%nucleusbutton%>
    <%nucleusbutton(nucleus/nucleus.gif,46,43)%>

# スキン変数：self

現在表示しているページのファイル名を挿入（index.phpか変更しているならそのファイル名）

## 引数

なし

## スキンタイプ

すべて

## 例

    <%self%>

# テンプレート変数：概略

## どういったものなのか？

テンプレート変数は、厳密にいうならスキン変数と同じ方法で広く働きます。唯一の違いはテンプレート内部で利用できることでしょう。変数は`<%varname%>`という形を用いて呼び出され、変数の機能によってはテキストをインクルードします。また、その他のオプションパラメーターを持つ変数もあります。

## 利用可能な変数

これらテンプレート変数は、次のテンプレート部品で使われます：`「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」`。（変数`image`、`popup`、`media`もまたweblogアイテムの中で使われます。）

- 基本の変数･･･（title、bodyなど...）
- 上級の変数･･･（include、pluginなど...）

コメント関連のテンプレート部品（`「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」`）は利用可能な変数のセットが異なります：

- コメント関連の変数･･･

# テンプレート変数：基本の変数

これらすべての変数は、そのときパースされているアイテムに関わる値となります。

名前 | 説明
--- | ---
title | アイテムのタイトル
body | 本文のテキスト
more | 続きのテキスト
category | カテゴリーの名前
categorylink | カテゴリーへの未加工のリンク
karma | カルマ投票の得点
authorlink | 作者への未加工のリンク
itemlink | アイテムへの未加工のリンク（permanent）
author | 作者の名前
smartbody | 本文か続きのどちらか
morelink | 続きを読む為のリンク
date | フォーマット済みの日付
time | フォーマット済みの時刻
daylink | その日のアーカイブへの未加工のリンク
comments | コメント・ブロックかコメント数
itemid | アイテムのID
blogurl | blogのURL

テンプレート変数の概略...

# テンプレート変数：上級の変数

名前 | 説明
--- | ---
authorid | 現在のアイテムの作者ID
blogid | blogのID
catid | 現在のアイテムが属するカテゴリーのID
query | 検索のクリエー（もし存在するなら）
syndicate_title | 配信用のタイトル
syndicate_description | 配信用の本文テキスト
karmaposlink | 投票用の未加工リンク
karmaneglink | 投票用の未加工リンク
new | 新しいアイテムを示すテキスト
include | パース無しでファイルをインクルード
parsedinclude | パースしてファイルをインクルード
phpinclude | PHPでパースしてファイルをインクルード
plugin | プラグインを実行
edit | アイテム編集のリンクを挿入
editlink | アイテム編集の未加工リンク（bookmarkletへのリンク）
editpopupcode | editlink用のウィンドウをポップアップするjavascriptコード
skinfile | インポートされたスキンに属しているファイル用の正確なURLの取り込み
set | パーサーのプロパティを設定
image | メディア書庫へのインライン画像
popup | メディア・ディレクトリの画像をポップアップ
media | メディア・ディレクトリからの他のメディア・オブジェクト
relevance | 検索結果を表示するテンプレートに'search hit relevance'をインクルードする（2.5より）

テンプレート変数の概略...

# テンプレート変数：コメント関連

名前 | 説明
--- | ---
body | コメントの本体
user | ユーザー名
userid | ユーザーのURLかメールアドレス
userlink | 非メンバーにはメールアドレスかURLに対して、メンバーにはメンバー詳細ページに対してリンクを行う（自動で切り替えるスマートなリンク）。注意：このリンクは<a href="...">と</a>タグを既に含んでいる。（有効なURLかメールアドレスが無い場合は、ユーザーの名前のみが表示される）
userlinkraw | 上と同じだが<a href..の部分を除く。有効なURLかメールアドレスが存在しないときは空っぽになる。
memberid | メンバーのID（非メンバーは0となる）
commentcount | 該当アイテムに付けられたコメントの総数
commentword | 1 'comment'、2 'comments'
date | コメントが追加された時の日付
time | コメントが追加された時の時刻
host | コメントがどこのホストから投稿されたか
ip | コメントがどこのIPアドレスから投稿されたか
commentid | 現在のコメントのID
itemid | 現在のアイテムのID
itemlink | アイテムの詳細ページへのリンク
itemtitle | 現在のアイテムのタイトル
blogid | weblogのID
authtext | メンバーなら証となるテキストを表示し、非メンバーなら空っぽ
short | 最初の改行部分から先が省略されたコメントの本体。テンプレートによっては末尾にリンクが追加される。
timestamp | コメントが追加された時のタイムスタンプ
include | パース無しでファイルをインクルード
parsedinclude | パースしてファイルをインクルード
phpinclude | PHPでパースしてファイルをインクルード
plugin | プラグインを実行
skinfile | インポートされたスキンに属しているファイル用の正確なURLの取り込み
set | パーサーのプロパティを設定

テンプレート変数の概略...

# テンプレート変数：karma

カルマ投票のデータを挿入。カルマ投票は、アイテムの'カルマ'を投票する方法。一回のクリックで、訪問者は正にでも負にでも投票できる。これら投票の総計が、該当記事が訪問者にどのように思われているのか知らしめてくれるだろう。

## 引数

オプション：

- どういったものか？：表示される情報の種類を選択：
  - totalscore：カルマ投票の総合得点（正の投票数から負の投票数を引いたもの）（デフォルト）
  - pos：正の投票の総計
  - neg：負の投票の総計
  - votes：投票数の総計
  - posp：正に投じられたパーセンテージ
  - negp：負に投じられたパーセンテージ

## 例

    <%karma(posp)%>がよい記事だと評価しました（総計<%votes%>票）

# テンプレート変数：templateitemtitle

コメント関連テンプレート変数において、元記事のタイトルを挿入する。

## 引数

オプション：

- maxlength：指定されると、テンプレート変数syndicate_titleのような振る舞いでアイテムのタイトルを加工する。

# テンプレート変数：author

作者の名前を挿入

## 引数

オプション：

- どういったものか？：表示される情報の種類を選択：
  - name：名前を表示（デフォルト）
  - realname：作者の「本名」欄を表示名の代わりに
  - id：そのNucleusでのメンバーID
  - url：メンバーのウェブサイトのURL
  - email：メンバーのメールアドレス（使うのは避けるべき）

## 例

    <%author%>
    <%author(realname)%>
    <a href="<%author(url)%>"><%author%></a>

# テンプレート変数：smartbody

現在のアイテムを調べ、本文テキストか続きテキストのどちらを表示するか決定する。

続き部分が空っぽなら、本文部分が選択される。そうでなければ続き部分が表示される。

部分名 | 空っぽか否か？
--- | ---
本文 | いいえ | いいえ
続き | はい | いいえ
smartbodyの表示＝ | 「本文部分」 | 「続き部分」

## 使用例

本文のテキストが完全なテキストと判断され、続きの部分はフロントページに表示される「紹介」や「抜粋」と判断されます。

フロントページで使われているテンプレートには`<%smartbody%>`を使い、抜粋が存在するときにはそれを、無い場合は完全なテキストを挿入します。アイテムの詳細テンプレートには、`<%body%>` + `<%more%>`のかわりに`<%body%>`を使います。`<%body%>`は少なくとも完全なアイテムが入っているのですから。

# テンプレート変数：morelink

アイテムの詳細ページへの、テンプレート(続きへのリンク)で定義されているリンクを挿入。「続き」部分が無いときは空っぽとなる。

テンプレート部品'続きへのリンク'の中身もまたパースされるので、同様にテンプレート変数を含むことができることに注意。

# テンプレート変数：date

テンプレートにおける日付の詳細なフォーマットを用いた日付の挿入。オプションとして、与えられたパラメーターによる日付フォーマットのカスタムが可能。

## 引数

オプション：

- format：日付のフォーマットに用いる形式

## 特別

4つの特別なパラメーターが利用可能：（下の二つは2.5から）

1. `rfc822`：ローカルにあわせたRFC822フォーマットの日付
2. `rfc822GMT`：GMTにあわせたRFCフォーマットの日付
3. `iso8601`：ISO-8601フォーマットの日付（W3Cの時刻と日付フォーマットに概略）。例：2002-10-02T10:00:00-05:00
4. `utc`：iso8601と同じだが、日付にはタイムゾーンの表示として"Z"を使うUTCで表現される。

## 例

    <%date%>
    <%date(%x)%>
    <%date(rfc822)%>
    <%date(rfc822GMT)%>

# テンプレート変数：time

テンプレートにおける時刻の詳細なフォーマットを用いた時刻の挿入。オプションとして、与えられたパラメーターによる時刻フォーマットのカスタムが可能。

## 引数

オプション：

- format：時刻のフォーマットに用いる形式

## 例

    <%time%>
    <%time(%X)%>

# テンプレート変数：comments

コメント・ブロックを挿入。このブロックの構成に関するさらなる情報。

## 引数

オプション：

名前 | 内容
--- | ---
MaxToShow | 表示するコメントの数（設定されていれば、a href="#blogmaxcomments">blogごとの設定にあるコメントの最大量を上書きする）

## 例

    <%comments%>
    <%comments(5)%>

# テンプレート変数：syndicate_title

HTMLタグを取り除き、100文字にまで縮めたアイテムのタイトルを挿入。テキストが縮められた場合は、末尾に"..."が追加される。

この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。

## 引数

- オプション：

  名前 | 内容
  --- | ---
  MaxChars | 保持する文字数の最大値（デフォルトは100）

## 例

    <%syndicate_title%>
    <%syndicate_title(25)%>

# テンプレート変数：syndicate_description

HTMLタグを取り除き、250文字にまで縮めたアイテムの本文を挿入。テキストが縮められた場合は、末尾に"..."が追加される。

この変数はもともとNucleusで用いるXML-RSSスキンで使うことを意図していたが、他の状況でも利用することも可能。

## 引数

- オプション：

  名前 | 内容
  --- | ---
  MaxChars | 保持する文字数の最大値（デフォルトは250）

## 例

    <%syndicate_description%>
    <%syndicate_description(25)%>

# テンプレート変数：image

アイテム本体やテンプレートにインライン画像を挿入。

通常、テンプレート変数imageはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。

## 引数

- 必須：

  名前 | 内容
  --- | ---
  filename | 画像ファイルの名前
  width | 画像の横幅（ピクセルかパーセンテージ）
  height | 画像の高さ（ピクセルかパーセンテージ）
  text | 画像の代用テキスト

- 注意：画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマではありませんよ！

## 例

    <%image(myphoto.jpg|100|200|これが私です)%>
    <%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>

# テンプレート変数：popup

アイテム本体やテンプレートにポップアップ画像を挿入。

通常、テンプレート変数popupはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリから画像が持ってこられることに注意すること。

## 引数

- 必須：

  名前 | 内容
  --- | ---
  filename | 画像ファイルの名前
  width | 画像の横幅（ピクセルかパーセンテージ）
  height | 画像の高さ（ピクセルかパーセンテージ）
  text | 画像の代用テキスト

- 注意：画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマではありませんよ！

## 例

    <%popup(myphoto.jpg|100|200|これが私です)%>
    <%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>

# テンプレート変数：media

アイテム本体やテンプレートにメディアオブジェクトを挿入。

通常、テンプレート変数mediaはメディア書庫内の画像を追加するとき自動的に生成される。とはいえ、テンプレート内部で呼び出すことも出来る。その場合は、現在のアイテム作者のメディア・ディレクトリからオブジェクトが持ってこられることに注意すること。

## 引数

- 必須：

  名前 | 内容
  --- | ---
  filename | メディアオブジェクトのファイル名
  text | メディアオブジェクトの説明テキスト

- 注意：画像、ポップアップ、メディアタグにおいては、パラメーターは'|'で区切られなければなりません。コンマではありませんよ！

## 例

    <%media(mysong.mp3|新曲を聞いてみてください)%>

# テンプレート変数：edit

テンプレートの内部にて、このテンプレート変数を使えば'アイテムの編集'リンクを加えることが出来る。デフォルトでは、ポップアップするbookmarkletウィンドウへのリンクとなるが、テンプレート：アイテムリンクの編集を通して振る舞いを変更することが可能。

注意：アイテムの編集が許可されたログイン状態のメンバーのみが、このリンクを目に出来ます。他の場合は、テンプレート変数editは何も表示しません。

## 例

「アイテムの本体」テンプレートの一例

    <h1><%title%></h1>
    <p><%body%> <%morelink%></p>
    <div class="metadata">
    	<%edit%> <%comments%>
    </div>

## Results in

#### タイトル

アイテムの本文

編集 - 5 comments

# テンプレート変数：editlink

'アイテムの編集'bookmarkletへのリンクを挿入。これはテンプレート：アイテムリンクの編集内で単純に使うことが出来る。

## 例

テンプレート：アイテムリンクの編集はこんな感じになる：

    <a href="<%editlink%>"
       onclick="<%editpopupcode%>">編集</a> -

# テンプレート変数：editpopupcode

'アイテムリンクの編集'ウィンドウをポップアップで開くためには、リンクにいくつかのjavascriptコードを追加する必要がある。このコードを「テンプレート：アイテムリンクの編集」に置く手間を省くために、テンプレート変数editpopupcodeを用いてそれを挿入することが出来る。

## 例

テンプレート変数：editlinkの例をみること。

# プラグイン

Nucleusでは特別な機能を追加するために、カスタムしたプラグインをインストールすることができる。プラグインはまったく違う事柄を実行できる：

1. スキン変数のように振舞う
2. テンプレート変数のように振舞う
3. Nucleusによって生成されたイベントのフック。「プラグインの管理」画面での「上へ」と「下へ」リンクは、イベント発生時にプラグインを呼び出す順番を決定するために用いられる。最初のプラグインは最初に呼び出され、最後のプラグインは最後に呼び出される。
4. `action.php`を通して呼び出されたときにアクタのように振舞う

プラグインに対する責任は、完全にプラグインの作者にあることを心にとめておくこと。彼または彼女は、すべてが問題なく動くようきっちりと作らなければならない。

# パーサーのプロパティ

利用可能なパーサーオプションを以下に記述する。

パーサーのプロパティ
オプション名 | 値
--- | ---
Includeモード | normal：通常の動作；ページを作成する.phpファイルのディレクトリ/URLから相対位置のファイルを取り出しインクルード。 skindir：スキンディレクトリ/スキンURLから相対位置のファイルを取り出しインクルード。 このプロパティは次のスキン変数に影響を与えます：include、phpinclude、parsedinclude、nucleusbutton
Includeプリフィックス | このプロパティはインクルードするファイルそれぞれの頭に追加されるプリフィックスです。例えば、プリフィックスが`base/`でインクルードするファイルが`somefile.txt`なら、最終的には`base/somefile.txt`をインクルードすることになります。 このプロパティはIncludeModeのプロパティと共に使われることが意図されています。この方法で、`skindir/somename/`にインポートされたスキンは、`IncludeMode`を`skindirを使う`に`IncludePrefix`を`somename/`に設定しておくことができます。 このプロパティは次のスキン変数に影響を与えます：include、phpinclude、parsedinclude、nucleusbutton

`Includeプリフィックス`と`Includeモード`のプロパティは、「スキンの一般的設定」において該当スキンでの包括的な設定が可能です。なお、プロパティが設定されてしまうと、例えばテンプレートも含めたすべてのパースデータにそれが適用されることを心にとめておいてください。