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

ファイル読み込み中、しばらくお待ちください（ファイルサイズはおよそ180KBです）。

# action.phpへのフルURL

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

    http://example.jp/actions.php

内容について気がついた事があればご連絡ください。

# アイテムの追加

ブログにアイテムを追加する際、「本文」「タイトル」「続き」に4種類の変数を利用することができます：

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

<%plugin%>以外のこれらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。

内容について気がついた事があればご連絡ください。

# アカウントの作成

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

内容について気がついた事があればご連絡ください。

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

この設定は、訪問者によるアカウントの作成を許可している場合に、その方法で作られたアカウントを使用して管理領域にログインできるかどうかを設定します。

内容について気がついた事があればご連絡ください。

# 自動保存

最後に変更を加えてから10分後に、自動的にドラフトとして保存する機能です。投稿、または編集途中に他の用事が出来て、記事を保存するのを忘れてしまった時などに、不用意に編集内容を失わずにすみます。

もし、10分待たずに下書きを保存したくなったら、フォームの下の方にある｢ドラフト保存｣ボタンをクリックします。

この機能は、メンバーごとの設定でオン、オフを切り替える事が出来ます。

内容について気がついた事があればご連絡ください。

# 基本のスキン

適用すべきスキンが見つからなかった時に代用するスキンを設定します。これはスキン・パーツが設定されていなかったり、スキンが明確に指定されていなかったりした時に起こります。

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

内容について気がついた事があればご連絡ください。

# 標準のスキン

ブログが表示される時には、ブログごとの「設定」で選択された「標準のスキン」が使用されます。選択できるのは一つだけです。（URLの引数として指定することで、別のスキンで表示させることは可能です）

内容について気がついた事があればご連絡ください。

# テンプレート：ブログリストの例

「テンプレート：ブログリスト」の解説に戻る

## ブログリストヘッダー

    <ul>
    <li><a href="<%siteurl%>"><%sitename%></a></li>

## ブログリストアイテム

    <li><a href="<%bloglink%>" title="<%blogdesc%>"><%blogname%></a></li>

## ブログリストフッター

    </ul>

## 表示は次のようになります

- あなたのサイト
- あなたのブログ
- わたしのブログ

内容について気がついた事があればご連絡ください。

# コメントの最大量

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

注意： テンプレート内部では、テンプレート変数commentsの引数によってここでの値が上書きされます。

内容について気がついた事があればご連絡ください。

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

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

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

注意：設定フィールドの最大長は128文字です。セミコロン(;)を含んだ合計の文字数が128文字を超えない限り、メールアドレスはいくつでも設定することができます。
注意：通知先に、メンバー登録に使われているメールアドレスを設定した場合、自分で書いたアイテムやコメントの通知はされません。自分で書いたことは知っているはずですから、問題にはならないでしょう。

内容について気がついた事があればご連絡ください。

# 常に検索対象に含める

「常に検索対象にする」オプションが選択されていると、同一のNucleus内で行われたすべてのブログ内検索において、常に検索対象に含まれます。

例として、"lifelog"と"linkdump"という2つのブログを持ち、"linkdump"の「常に検索対象にする」が「はい」、"lifelog"は「いいえ」にになっていると仮定しましょう。そうすると、"lifelog"で検索した場合は"linkdump"も検索するのに対して、"linkdump"での検索では、"linkdump"のエントリーしか検索しません。

内容について気がついた事があればご連絡ください。

# サーバ時刻との時差

もしサーバの時刻とあなたの住んでいる地域の時刻とが一致していなければ、ここにサーバとの時差を入力することで、Nucleus内部の時刻をあなたの住んでいる地域の時刻に合わせることができます（マイナス時差の地域に住んでいる場合は、マイナス記号付きで入力します）。参考のために現在のサーバの時刻が表示されています。

## 実例

あなたの住んでいる地域の時刻が20:35で、表示されているサーバの時刻が14:35のとき、ブログの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定します。

注意：30分刻みでの時差のある地域のために、0.5刻みで設定することができます。例えば「サーバ時刻との時差」を1.5に設定すると、1時間30分の補正となります。

内容について気がついた事があればご連絡ください。

# 自動更新するファイル

ブログに新しいアイテムが追加された時に、上書きするファイルのパスを入力します。このファイルは、新しいアイテムが追加されるたびに最終変更時のタイムスタンプが上書きされ、外部からはこのファイルを参照することで、ブログに更新があったかどうかをチェックすることができます。このファイルは訪問者によるコメントが追加された時や、スキン/テンプレートに変更を加えた時には更新されません。アイテムが追加されてブログの記事に変更があったときに更新されるので、「Weblogの更新状況」等を作成するサービスに使うことができます。

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

自動更新されるファイルの場所は管理領域からの相対パスでも指定することが可能ですが、`/path/to/your/website/update.txt` のようにより確実な絶対パスを使った方が良いでしょう。また自動更新されるファイルを作成し、かつそのファイルに書き込みができるように、自動更新ファイルとそれを作成するディレクトリのパーミッションを0666にしてください。

内容について気がついた事があればご連絡ください。

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

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

内容について気がついた事があればご連絡ください。

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

「テンプレート：カテゴリーリスト」の解説に戻る

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

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

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

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

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

    </ul>

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

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

内容について気がついた事があればご連絡ください。

# 改行を変換する

Nucleusはアイテム内の改行を、デフォルトで`<br/>`タグに変換します。この設定によって、アイテム内の改行箇所を出力後の(X)HTMLに反映させることができます。

手馴れたユーザーや、Semantic Web（`br`タグは情報を付加せず、ただ記述のためにのみ使われる）のために努力するユーザーの中には、この機能が迷惑だと感じるかもしれません。その場合はこのオプションを「いいえ」に設定してください。

内容について気がついた事があればご連絡ください。

# Cookie設定

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

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

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

## CookieパスとCookieドメイン

これらは高度な設定です。通常は、cookieパスは単純にスラッシュ（"/"）、cookieドメインは空っぽの状態から変更する必要はありません。

## セキュアCookie

通常は「いいえ」に設定してください。HTTPSのurlを用いており、cookieの送受信をhttps接続を通してのみに限定したい時だけ、この設定を「はい」にします。

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

訪問者が最後に訪れた時間をcookieに保存させるように設定することができます。これによって、新規アイテムの隣にマークを付けることができます。

内容について気がついた事があればご連絡ください。

# デバッグモード

｢はい｣に設定すると、システム情報を表示したり、対応しているプラグインをデバッグモードにしたりできます。

内容について気がついた事があればご連絡ください。

# 既定のBlog

サイトへの接続時にブログが指定されていない場合に表示されるブログです。

内容について気がついた事があればご連絡ください。

# 一覧の既定の表示数

一覧表示画面で一度に表示するブログ、アイテム、コメントの数を入力します。初期値は｢10｣です。

内容について気がついた事があればご連絡ください。

# サイトの閉鎖

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

チェックボックスを「はい」に設定した場合に、訪問者はここで設定したURLにリダイレクトされます。

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

内容について気がついた事があればご連絡ください。

# ドラフト(Drafts/草稿)

ドラフト状態のアイテムはブログの公開されたところでは閲覧することができません。推敲に時間をかけたい時や、、実際に投稿するまでに、少し時間を空けたいときなどに役に立つでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間があるときに、いつでも作業を再開することが可能です。

ドラフト状態のアイテムを編集する際に、「今すぐ追加」のラジオボタンを選んで「保存」ボタンを押すと、ドラフト状態が解除されてブログに公開されます。

内容について気がついた事があればご連絡ください。

# 「続き」部分

アイテムには、長文記事を分割して表示するために、オプションとして「続き」部分があります。例えば、記事がブログのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。テンプレートによって、表示の形態は変わってきますが、ブログのメインページを閲覧すると「続きを読む」というリンクが出現します。

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

内容について気がついた事があればご連絡ください。

# 後で追加/過去の日時での投稿

## 後で追加

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

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

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

この設定を有効にすると、アイテムを追加する時に、アイテムの投稿日時を過去に指定することができるようになります。また、既存のアイテムの投稿日時を編集することもできるようになります。

内容について気がついた事があればご連絡ください。

# 言語

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

言語の選択を行う場所は二ヶ所あります。一箇所目は「グローバル設定」で、デフォルトで用いられる「既定の言語」を設定します。もう一箇所は、各「メンバーの編集」ページの設定でメンバー毎ログイン時の使用言語を設定することができます。

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

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

内容について気がついた事があればご連絡ください。

# メディア

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

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

- メディア(画像・音声)ディレクトリ：メディアファイルが保存されるサーバー上の場所（サーバのファイルシステム上のパス）
- メディアURL：メディアファイルのURL上の場所
- ファイルのアップロードを許可しますか?：ファイルのアップロードを不許可にすることができます
- アップロードを許可するファイルタイプ：アップロードできるファイルの拡張子（複数必要な場合は、コンマで区切る）
- アップロードファイルの最大サイズ：ここで設定したものよりファイルサイズの大きなものはアップロードすることができません。
- アップロードするファイル名の頭に日付を付加する：アップロードされたファイルのファイル名の先頭に、現在の日付を付加するかどうかを選択します。このオプションで「はい」を選んでいると、例えば "bunny.jpg"という名前のファイルを2008年9月5日にアップロードしたなら、"20080905-bunny.jpg"というファイル名になります。何故こんな機能があるかというと、大量のファイルをアップロードしているときについ同じ名前を用いてしまう問題を避けるためです。

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

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

内容について気がついた事があればご連絡ください。

# メッセージサービス

## メンバー間メッセージサービス

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

## メンバー以外のメッセージサービス

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

内容について気がついた事があればご連絡ください。

# パーサーのプロパティ

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

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

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

内容について気がついた事があればご連絡ください。

# プラグイン

Nucleusでは機能を追加するために、プラグインをインストールすることができます。プラグインは次のリストの様に働き、Nucleus本体だけでは実現できな様々な機能を提供してくれるでしょう。

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

プラグインに対する責任は、完全にプラグインの作者にあることをお忘れなく。プラグイン作者は、プラグインが問題なく動くように作らなければなりません。

NucleusCMSのプラグインの主だったものは、以下の二つのページから見つけ出すことが出来ます。

- 本家プラグインリスト
- 日本公式プラグインWiki

どちらのページも全てのプラグインを網羅しているわけではありませんが、これらのページのどちらかであなたが必要としているプラグインを見つけることが出来るでしょう。 インターネット上には無料の翻訳サービスがあるので、｢読めない｣と恐れることはありません。

あなたがプラグインを開発したり、機能を検索するその他のリソースとして、本家フォーラムやNucleus日本語フォーラムがあります。 これらのフォーラムの中でも、プラグインリストに掲載されていない小さなプラグインを見つけることが出来るでしょう。

内容について気がついた事があればご連絡ください。

# プラグインURL

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

    http://example.jp/nucleus/plugins/

内容について気がついた事があればご連絡ください。

# メンバー名の保護

訪問者によるメンバーへの成りすましを防止するために、メンバーとして登録済みの名前を使ってのゲストコメントはできないようになっています。このオプションを「いいえ」に設定することで、この規制を緩和することができます。

内容について気がついた事があればご連絡ください。

# Pingサーバに更新通知を送信する

ブログを更新した時に、ブログ検索サイト等の公開している複数のpingサーバに更新pingを送信することができます。これらのpingサーバを用意しているサイﾄでは、リクエストに応じて最近更新されたブログのリストを提示してくれます。このデータを利用した新着記事のリスト等のサービスを、数多くのウェブサイトが提供していますので、このオプションを「はい」に設定することで、あなたのブログは新しい訪問者を得ることになるでしょう。

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

内容について気がついた事があればご連絡ください。

# Blogの短縮名

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

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

    <?php
    include("./config.php"),
    selectBlog("myshortblogname"),
    selector(),
    ?>

内容について気がついた事があればご連絡ください。

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

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

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

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

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

内容について気がついた事があればご連絡ください。

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

このスキンパーツは「メインの目次ページ」と似た振る舞いをしますが、該当月の全てのアイテムを表示します。

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

    <html>
    <head>
    <title>私のウェブログ :: アーカイブ</title>
    </head>
    <body>
    <h1>アーカイブ</h1>
    <%archive(default)%>
    </body>
    </html>

このスキンでは、"default"テンプレートを使用して、選択中のブログの要求されたアーカイブが表示されます。

内容について気がついた事があればご連絡ください。

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

このスキンパーツはアーカイブが存在する全ての月の概略と、それらアーカイブへのリンクを表示します。

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

    <html>
    <head>
    <title>私のウェブログ :: アーカイブ集</title>
    </head>
    <body>
    <h1>アーカイブ集</h1>
    <%archivelist(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><%imagetext%></title>
    <style type="text/css">
    img { border: none; }
    </style>
    </head>
    <body>
    <a href="javascript:window.close(),"><%image%></a>
    </body>
    </html>

内容について気がついた事があればご連絡ください。

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

このスキンパーツはブログ内の最新のエントリーを表示するのに用いられます。通常はサイト、またはブログのトップページにあたる場所になります。

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

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

このスキンでは、選択中のブログのアイテムが、タイムスタンプの新しいものから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><%member(name)%> の情報</h1>
    ウェブサイト：
    <a href="<%member(url)%>"><%member(url)%></a>
    <h1>メッセージを送る</h1>
    <%membermailform%>
    </body>
    </html>

このスキンでは、メンバー名とメンバーのウェブサイトのアドレス、そしてメール送信フォームが表示されます。

内容について気がついた事があればご連絡ください。

# スキン：検索ページ

このスキンパーツは検索結果の表示に使われます。

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

    <html>
    <head>
    <title>私のウェブログ :: 検索</title>
    </head>
    <body>
    <h1>検索</h1>
    <%searchform%>
    <h1>検索結果</h1>
    <%searchresults(default)%>
    </body>
    </html>

このスキンでは、"default"テンプレートを使用して検索の結果が表示されます。

内容について気がついた事があればご連絡ください。

# 投稿日時の変更

「タイムスタンプを更新」オプションにより、アイテムの投稿された日付や時間を変更することができます。アイテムの内容を変更した時に、「タイムスタンプを更新」することで記事をブログののトップに戻すことができます。

しかし、そのアイテム独自のIDは変更されませんので、訪問者はアイテムのIDから、そのアイテムが編集後に投稿時間が変更されたものだと気づくことができます。

内容について気がついた事があればご連絡ください。

# スキン：スペシャルスキンパーツ

このスキンパーツは、特別な見せ方をしたいコンテンツやブログの内容以外のコンテンツ、例えばフォームや静的なコンテンツ、もしくはNucleusとは切り離された動的なコンテンツ等を表示する為に使用します。 スペシャルスキンパーツは次のようにして表示します。 (`fred`という名前でスペシャルスキンパーツを作った場合)

`http://www.yoursite.tld/index.php?special=fred`

このスキンタイプに関するさらなる議論は、NucleusCMS本家サポートフォーラムで行われています。: Nucleus 3.31 and Static Pages

標準的なスペシャルスキンパーツ:

    <html>
    <head>
    <title>私のブログ</title>
    </head>
    <body>
    <h1>このサイトについて</h1>
    <p>This page was published in order
    to provide a platform to publicize the plight
    of the peeping-polly parrot whose present
    prognosis is perturbingly pessimistic.</p>
    </body>
    </html>

この例は、ごく一般的なHTML文書として表示されます。 また、標準的なスキン変数が使えるので、ブログとの連系を持たせた静的ページを持たせたいときなどに役立つでしょう。

内容について気がついた事があればご連絡ください。

# スキンURL

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

    http://example.jp/skins/

内容について気がついた事があればご連絡ください。

# スキン変数：additemform

現在選択しているブログへのアイテムの追加フォームを挿入します。多くの場合、previewと共に使用されます。

## 引数

なし

## スキンタイプ

メインの目次

## 例

    <%additemform%>

内容について気がついた事があればご連絡ください。

# スキン変数：addlink

表示中のブログにアイテムを追加するためのブックマークレットのURLを出力します

## 引数

なし

## スキンタイプ

全て

## 例

    <dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>

内容について気がついた事があればご連絡ください。

# スキン変数：addpopupcode

アイテムを追加するブックマークレットをポップアップさせるためのJavascriptコードを出力します

## 引数

なし

## スキンタイプ

全て

## 例

    <dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>

内容について気がついた事があればご連絡ください。

# スキン変数：adminurl

管理領域のURLを挿入します。

## 引数

なし

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：archive

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

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション：

  名前 | 値
  --- | ---
  category | 表示するカテゴリー名

## スキンタイプ

月別アーカイブ

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：archivedate

アーカイブの日付としてフォーマット済みの日付を挿入します。パラメーターなしで使うと、例えばアーカイブが2008年9月のものなら、"05 september 2008"か"september 2008"のどちらかが挿入されることになります。

## 引数

- オプション：

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

## スキンタイプ

月別アーカイブ

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：archivedaylist

スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに日ごとのアーカイブのリストを挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

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

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：archivelink

選択中のブログ、あるいはカテゴリーのアーカイブへのリンクを挿入します。

## 引数

- オプション

  名前 | 値
  --- | ---
  linktext | 記述されていると、URLの代わりに`<a href...`タグによるリンクが挿入されます。

## スキンタイプ

全て

## 例

    <%archivelink%>

内容について気がついた事があればご連絡ください。

# スキン変数：archivelist

現在選択しているブログに存在するアーカイブの月ごとのリストを、指定されたテンプレートを使って挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

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

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：archivetype

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

## 引数

なし

## スキンタイプ

月別アーカイブ

内容について気がついた事があればご連絡ください。

# スキン変数：archiveyearlist

スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに年ごとのアーカイブのリストを挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

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

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：blog

選択中のブログの、タイムスタンプの新しいアイテム群を挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

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

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：bloglist

Nucleusで管理しているブログのリストを、指定されたテンプレートを用いて挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

  名前 | 値 | 初期値
  --- | --- | ---
  bnametype | 「shortname」を指定することで、ブログ名の変わりにブログの短縮名を挿入します | bname
  orderby | 並べ替えのキーを指定します。指定可能なキーは「number(ブログID)」「name(ブログ名)」「shortnameブログの短縮名)」「description(ブログの説明)」です。 | number
  direction | orderbyで指定したキーを使って「asc」で昇順、「desc」で降順に並べ替えます。 | asc

  途中の引数を省略する時は｢,(カンマ)｣のみ記述します。

## スキンタイプ

全て

## 例

    <%bloglist(mytemplate)%>

標準。「mytemplate」を使って、ブログの一覧を｢ブログ名｣で表示します。

    <%bloglist(mytemplate,shortname)%>

「mytemplate」を使って、ブログの一覧を｢ブログの短縮名｣で表示します。

    <%bloglist(default/index,name,description)%>

「default/index」を使って、ブログの一覧を｢ブログの説明｣で並べ替えて｢ブログ名｣で表示します。

    <%bloglist(default/index,shortname,,desc)%>

「default/index」を使って、ブログの一覧を｢ブログ名｣の降順で並べ替えて｢ブログ短縮名｣で表示します。

内容について気がついた事があればご連絡ください。

# スキン変数：blogsetting

選択中のブログの設定を挿入します。

## 引数

- 必須：

  名前 | 挿入される設定
  --- | ---
  id | ブログのID
  url | ブログのURL
  name | ブログの名前
  desc | ブログの説明
  short | ブログの短縮名

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：category

現在選択されているカテゴリーに関する情報を挿入します。カテゴリーが選択されていないときは何も挿入されません。

## 引数

- オプション

  名前 | 挿入される設定
  --- | ---
  name | カテゴリー名（デフォルト）
  desc | カテゴリーの説明L
  id | カテゴリーのID

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：categorylist

選択中のブログのカテゴリーリストを、指定されたテンプレートを用いて挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名

## スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
（※blogname が指定されている場合、エラーページ・メンバー詳細ページ・スペシャルスキンパーツでも利用できます。）

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：charset

グローバル設定の既定の言語で設定した言語に基づいたキャラクターセットのコードを挿入します。日本語版では、"UTF-8"か、"EUC-JP"の何れかになります

## 引数

なし

## スキンタイプ

全て

## 例

    <meta http-equiv="Content-Type" content="text/html; charset=<%charset%>" />

内容について気がついた事があればご連絡ください。

# スキン変数：commentform

アイテムページにコメントフォームを挿入します。

## 引数

- オプション：

  名前 | 値
  --- | ---
  destinationurl | コメント追加後にリダイレクトさせるURL（デフォルトでは、投稿したアイテムの「個別アイテムページ」にリダイレクトされます）

## スキンタイプ

個別アイテム

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：comments

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

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

## スキンタイプ

個別アイテム

## 例

    <%comments(mytemplate)%>

内容について気がついた事があればご連絡ください。

# スキン変数：errormessage

エラーが発生したときにエラーメッセージを挿入します。

## 引数

なし

## スキンタイプ

エラー

## 例

    <%errormessage%>

内容について気がついた事があればご連絡ください。

# スキン変数：ifcat

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

## 引数

なし

- text：表示するテキスト

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：image

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

## 引数

- オプション

  名前 | 値
  --- | ---
  imgtag（デフォルト） | (x)htmlのimgタグ `<img ... />`
  url | 画像ファイルへのURL
  width | イメージの幅
  height | イメージの高さ
  caption | 画像の見出し（画像と共に表示されるテキスト）

## スキンタイプ

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

## 例

    <%image%>

内容について気がついた事があればご連絡ください。

# スキン変数：imagetext

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

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

## 引数

なし

## スキンタイプ

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

## 例

    <%imagetext%>

内容について気がついた事があればご連絡ください。

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

Webページ出力時に、指定されたテキストファイルを取り込んで挿入します。ファイルの中身がそのまま出力されるので、スキン/テンプレート変数やPHPコードを使っても反映されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、PHPコードを実行するphpincludeがあります。

## 引数

- 必須：

  名前 | 値
  --- | ---
  filename | 取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます）

## 注意

- この変数はパーサー設定の`IncludeMode` と`IncludePrefix`に影響を受けます。

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：item

現在選択されているアイテムを、指定されたテンプレートを用いて挿入します（コメントは挿入されません）。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

## スキンタイプ

個別アイテム

## 例

    <%item(mytemplate)%>

内容について気がついた事があればご連絡ください。

# スキン変数：itemid

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

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%itemid%>

内容について気がついた事があればご連絡ください。

# スキン変数：itemlink

アイテムのURL（permanent link）を挿入します。

## 引数

- オプション：

  名前 | 適用
  --- | ---
  linktext | 記述されていると、URLの代わりに`<a href...`タグによるリンクが挿入されます。

## スキンタイプ

個別アイテム

## 例

    <%itemlink%>

内容について気がついた事があればご連絡ください。

# スキン変数：itemtitle

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

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%itemtitle%>

内容について気がついた事があればご連絡ください。

# スキン変数：loginform

ログインフォームまたは、ログイン中メッセージ（"ログイン中:ketsunet (ログアウト)"）を挿入します

## 引数

なし

## スキンタイプ

全て

## 例

    <%loginform%>

内容について気がついた事があればご連絡ください。

# スキン変数：member

訪問者がログイン中のメンバーの場合、そのメンバーに関する情報を挿入します。メンバーの詳細ページにおいては、指定されたメンバーについての同じ情報を表示する追加オプションがあります。

訪問者がログイン中のメンバーではない場合は、your...のパラメーターは何も挿入しません。

## 引数

- 必須：
  - ログインしたメンバーの情報（全てのスキンタイプで使用可能）：

    名前 | 挿入される設定
    --- | ---
    yourname | 訪問メンバーの表示される名前（ログインID）
    yourrealname | 訪問メンバーのハンドルネーム(本名)
    yournotes | 訪問メンバーが自身のために設定できるその他の情報（備考欄）
    yoururl | 訪問メンバーのウェブサイトURL
    youremail | 訪問メンバーのメールアドレス
    yourid | 訪問メンバーのID
    yourprofileurl | 訪問メンバーの「メンバーの詳細ページ」アドレス

  - 指定されたメンバーの情報（「メンバーの詳細ページ」でのみ使用可能）：

    名前 | 挿入される設定
    --- | ---
    name | 指定されたメンバーの表示される名前（ログインID）
    realname | 指定されたメンバーのハンドルネーム(本名)
    notes | 指定されたメンバーが自身のために設定できるその他の情報（備考欄）
    url | 指定されたメンバーのウェブサイトURL
    email | 指定されたメンバーのメールアドレス
    id | 指定されたメンバーのID

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：membermailform

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

## 引数

- オプション：

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

## スキンタイプ

メンバー詳細

## 例

    <%membermailform%>

内容について気がついた事があればご連絡ください。

# スキン変数：nextarchive

表示中のアーカイブの形式に応じて、一つ新しいアーカイブの月、または日を挿入します。

表示中の形式 | 挿入される日付のフォーマット
--- | ---
日単位で表示している時 | `YYYY-MM-DD`
月単位で表示している時 | `YYYY-MM`

## 引数

なし

## スキンタイプ

月別アーカイブ

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：nextitem

そのブログにおける一つ新しいアイテムのIDを挿入します 。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%nextitem%>

内容について気がついた事があればご連絡ください。

# スキン変数：nextitemtitle

そのブログにおける一つ新しいアイテムのタイトルを挿入します。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%nextitemtitle%>

内容について気がついた事があればご連絡ください。

# スキン変数：nucleusbutton

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

## 引数

- オプション：

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

## 注意

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

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：otherarchive

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

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  category | 表示するカテゴリーの名前

## スキンタイプ

月別アーカイブ

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：otherarchivedaylist

スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに日ごとのアーカイブを挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  category | 表示するカテゴリーの名前

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：otherarchivelist

指定されたブログに存在するアーカイブ月ごとのリストを、指定されたテンプレートを用いて表示します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  category | 表示するカテゴリーの名前

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：otherarchiveyearlist

スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに年ごとのアーカイブを挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  category | 表示するカテゴリーの名前

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：otherblog

指定されたブログの、タイムスタンプの新しいアイテム群を挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | 表示するブログの短縮名
  template | 使用するテンプレート名

- オプション

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

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：othersearchresults

指定されたブログの、現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  blogname | ブログの短縮名
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  maxresults | 表示する結果の最大数

## スキンタイプ

検索

## 例

    <%othersearchresults(myblog,mytemplate)%>

内容について気がついた事があればご連絡ください。

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

Webページ出力時に、指定されたスペシャルスキンもしくはファイルを取り込んで挿入します。スペシャルスキンが優先されます。このファイルのは、取り込み時にNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数が使用できます。同じような変数に、取り込んだファイルのPHPを実行するphpincludeや、ファイルの中身をそのまま表示するincludeがあります。

## 引数

- 必須：

  名前 | 値
  --- | ---
  filename | 取り込むスペシャルスキンもしくはファイルの名前（index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます）

## 注意

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

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

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

Webページ出力時に、指定されたPHPファイルを実行し、その結果を挿入します。ファイルの中身はPHPとして解釈され、実行されるので注意が必要です。また、Nucleusのスキン/テンプレート変数は展開されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、ファイルの中身をそのまま表示するincludeがあります。

## 引数

- 必須：

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

## 注意

- この変数はパーサー設定の`IncludeMode` と`IncludePrefix`に影響を受けます。
- ファイルはphpのコマンド`include()`を使ってインクルードされます。このコマンドは内部のクラス・メソッドから呼び出されるので、Nucleus内部やプラグインで使用されているグローバル変数にアクセスしたい時は、自身でグローバル変数を宣言する必要があります。多くの標準的な変数は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;`"をきっちりとコードに加える必要があります。

内容について気がついた事があればご連絡ください。

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

プラグインを呼び出します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  PluginName | 呼び出されるプラグインの名前。大文字小文字が区別されるので注意が必要です。

- この他、プラグインごとに引数が定義・追加されます。

## 注意

- プラグイン名が既存の変数とぶつからない場合、`<%PluginName (parameters)%>`と記述することで、プラグインを直接呼び出すこともできます。現在はそのようにプラグイン名で呼び出す方法が主流ですが、プラグイン呼び出しであることをあえて明示したい場合は`<%plugin(parameters)%>`のほうを利用するといいでしょう。

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：prevarchive

表示中のアーカイブの形式に応じて、一つ古いアーカイブの月、または日を挿入します。

表示中の形式 | 挿入される日付のフォーマット
--- | ---
日単位で表示している時 | `YYYY-MM-DD`
月単位で表示している時 | `YYYY-MM`

## 引数

なし

## スキンタイプ

月別アーカイブ

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：if/ifnot/else/elseif/elseifnot/endif

決まった条件を満たしている時にのみ、コンテンツ・ブロックを挿入します。3.6以降では、テンプレートの「アイテムの本体」と「コメントの本体」でも同じ様に使う事ができます。

## 引数

スキン変数 `if/ifnot/elseif/elseifnot` に対してのみ、引数が必須になります

- 必須：

  名前 | 値
  --- | ---
  type | 条件の種類
  typeによって、以下のオプションをとることがあります
  | name | 条件の名前
  | value | 条件の名前の値

## 条件の種類

- category：カテゴリーを選択しているか、また、カテゴリの設定と比較した結果を返します。
  - category：カテゴリが選択されているか調べます。
  - category,catname,CategoryName ：現在のカテゴリ名と CategoryName が一致するかどうかを返します。
  - category,catid,CategoryID：現在のカテゴリのIDと CategoryId が一致するかどうかを返します。
- blogsetting：Blog設定の name 項目の値と value を 比較します。
  - blogsetting,name,value ： name (SQLテーブル nucleus_blogにあるカラム名）が value と一致するかどうかを返します。
- loggedin：訪問者がログインしているか調べます。
- onteam：訪問者がログインし、現在のブログ、または、name で指示されたブログのチームに入っているか調べます。
- admin：訪問者がログインし、現在のブログ、またはname で指示されたブログの管理権限があるか調べます。
- nextitem：個別アイテムページにおいて、現在のブログにより古いアイテムがあるか調べます。
- previtem：個別アイテムページにおいて、現在のブログにより新しいアイテムがあるか調べます。
- archivenextexists：月別アーカイブページにおいて、現在のブログに、現在表示しているものより古い月、または古い日のアーカイブがあるか調べます。
- archiveprevexists：月別アーカイブページにおいて、現在のブログに、現在表示しているものより新しい月、または新しい日のアーカイブがあるか調べます。
- skintype：現在のスキンタイプが value （index, search, item, archive, archivelist など…）と一致するか、URLによって判別します。
  スペシャルスキンパーツの場合は、スペシャルスキンパーツの名前が value と一致するか、URLによって判別します。
- hasplugin：PluginName で指定されたプラグインがインストールされているか、または、プラグインのオプションの値と一致するかどうかを返します。
  - hasplugin,PluginName：PluginName で指定されたプラグインが存在するか調べます。
  - hasplugin,PluginName, OptionName：PluginName で指定されたプラグインの OptionName の値の存在を確認した結果を返します。
  - hasplugin,PluginName, OptionName=value：PluginName で指定されたプラグインの OptionName の値と、 value が一致するかどうかを返します。
- if拡張対応プラグイン名：第1引数には、"NP_"を取ったプラグイン名を指定します。第1引数で指定したプラグインに、第2引数、第3引数を渡し確認した結果を返します。
  - プラグイン名,属性名: プラグイン名 で指定されたプラグインが 属性名 で指定した属性の存在を確認した結果を返します。
  - プラグイン名,属性名,属性値: プラグイン名 で指定されたプラグインの 属性名 の値と 属性値 が一致するかどうかを返します。
- itemcategory: テンプレートの「アイテム本体」と「コメント本体」において、現在のアイテムのカテゴリを調べます。
  - itemcategory: 現在のアイテムがカテゴリに属しているかどうか調べます。常にtrueを返します。
  - itemcategory,catname,CategoryName: 現在のアイテムのカテゴリが CategoryName と一致するかどうかを返します。
  - itemcategory,catid,CategoryId: 現在のアイテムのカテゴリIDが CategoryId と一致するかどうかを返します。
- itemblogsetting：テンプレートの「アイテム本体」と「コメント本体」において、現在のアイテムのBlog設定の name 項目の値と value を 比較します。
  - itemblogsetting,name: 現在のアイテムの属するウェブログの名前がnameと一致するかどうかを返します
  - itemblogsetting,name,value ： name (SQLテーブル nucleus_blogにあるカラム名）が value と一致するかどうかを返します。
- author：テンプレートの「アイテム本体」と「コメント本体」において、現在のアイテムの投稿者について調べます。
  - author：訪問者が現在のアイテムの投稿者かどうかを調べます。
  - author,isadmin：アイテムの投稿者がブログの管理権限、またはsuper-admin権限があるか調べます。
  - author,name,AuthorName：アイテムの投稿者のユーザー名がAuthorNameと一致するかどうかを返します。
  - author,isauthor：テンプレートの「コメント本体」において、コメントの投稿者が、アイテムの投稿者と一致するかどうかを調べます。
  - author,isonteam：テンプレートの「コメント本体」において、コメントの投稿者が、現在のアイテムのブログチームのメンバーであるかどうか調べます。
  - loggedin：訪問者がログインしているか調べます。
  - onteam：訪問者がログインし、現在のブログ、または、name で指示されたブログのチームに入っているか調べます。
  - admin：訪問者がログインし、現在のブログ、またはname で指示されたブログの管理権限があるか調べます。

## スキンタイプ

全て

## 例

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

    <%if(category,catname,Off Topic)%>
    "Off Topic" カテゴリへようこそ。
    <%endif%>

    <%if(category,catid,1)%>
    "ID１"のカテゴリです。
    <%endif%>

    <%ifnot(loggedin)%>
    アクセス禁止！
    <%elseif(admin)%>
    管理者さんようこそ！
    <%elseif(onteam)%>
    チームメンバーさんようこそ！
    <%else%>
    サイトメンバーさんようこそ！
    <%endif%>

## 注意

条件が満たされない時にだけ何らかの表示を行いたい場合は、次のようにすることができます

    <%ifnot(skintype,error)%>
    <%blogsetting(name)%>
    <%endif%>

内容について気がついた事があればご連絡ください。

# スキン変数：preview

指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入します。（additemformと一緒に使われることが多いようです）

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

## スキンタイプ

メインの目次

## 例

    <%preview(mytemplate)%>

内容について気がついた事があればご連絡ください。

# スキン変数：previtem

そのブログにおける一つ古いアイテムのIDを挿入します。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%previtem%>

内容について気がついた事があればご連絡ください。

# スキン変数：previtemtitle

そのブログにおける一つ古いアイテムのタイトルを挿入します。

## 引数

なし

## スキンタイプ

個別アイテム

## 例

    <%previtemtitle%>

内容について気がついた事があればご連絡ください。

# スキン変数：prevlink

アイテムページでは一つ古いアイテムへの、アーカイブページでは一つ古いアーカイブへのURLを挿入します。「検索」と「メインの目次」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。

## 引数

- オプション

  名前 | 値
  --- | ---
  linktext | 記述されていると、URLの代わりに`<a href...`タグによるリンクが挿入されます。
  amount | 「検索ページ」と「メインの目次ページ」で使用したときに、前または次のページに進んだときに表示されるアイテムの数

## スキンタイプ

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

## 例

    <%prevlink%>

内容について気がついた事があればご連絡ください。

# スキン変数：query

現在の検索文字列を挿入します。

## 引数

なし

## スキンタイプ

検索

## 例

    <%query%>

内容について気がついた事があればご連絡ください。

# スキン変数：referer

リンク元のURLを挿入します。アクセス方法や、ブラウザ、ファイアウォール等の設定によって、空白の時があります。

## 引数

なし

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：searchform

現在のブログに対する検索フォームを挿入します。

## 引数

- オプション：

  名前 | 値
  --- | ---
  blogname | 検索を実行するブログの短縮名（ブログの短縮名を指定していても、常に検索対象に含めるの設定が「はい」のブログは検索対象になります）

## スキンタイプ

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

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：searchresults

現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。

## 引数

- 必須：

  名前 | 値
  --- | ---
  template | 使用するテンプレート名

- オプション

  名前 | 値
  --- | ---
  maxresults | 表示する結果の最大数

## スキンタイプ

検索

## 例

    <%searchresults(mytemplate)%>

内容について気がついた事があればご連絡ください。

# スキン変数：self

現在表示しているページのファイル名を挿入します（index.php等で記述した「$CONF["Self"]」の値です）。

## 引数

なし

## スキンタイプ

全て

## 例

    <%self%>

内容について気がついた事があればご連絡ください。

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

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

## 引数

- 必須：

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

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

# スキン変数：sitevar

「グローバル設定」でのサイトの設定を挿入します。

## 引数

- 必須：

  名前 | 挿入される設定
  --- | ---
  url | サイトのURL
  name | サイトの名前
  admin | 管理者のメールアドレス

## スキンタイプ

全て

## 例

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

内容について気がついた事があればご連絡ください。

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

表示に使用中のスキンのあるディレクトリにリンクを張る時に使用します。パーサーのプロパティ `IncludePrefix`と共に使用することで、最良の結果を得ることができます。

## 引数

- 必須：

  名前 | 値
  --- | ---
  filename | ファイルの名前（「http://～」から始まるURLに変換されます）

## スキンタイプ

全て

## 例

    <%skinfile(mystyle.css)%>

内容について気がついた事があればご連絡ください。

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

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

## 引数

なし

## スキンタイプ

全て

## 例

    <%skinname%>

内容について気がついた事があればご連絡ください。

# スキン変数：sticky

スキンにアイテムを表示します

## 引数

- 必須：

  名前 | 値
  --- | ---
  itemid | 表示するアイテムのID
  template | アイテムを表示するためのテンプレート

## スキンタイプ

全て

## 例

    <%sticky(11,default/index)%>

内容について気がついた事があればご連絡ください。

# スキン変数：nextlink

「個別アイテムページ」では１つ新しいアイテムへ、「アーカイブページ」では１つ新しいアーカイブへのURLを挿入します。
「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。

## 引数

- オプション

  名前 | 値
  --- | ---
  linktext | 記述されていると、URLの代わりに`<a href...`タグによるリンクが挿入されます。
  amount | 「検索ページ」と「メインの目次ページ」で、１ページに表示されるアイテムの数を指定します。 次のページへ進むたびに amount で指定した数だけアイテムがスキップされます。
  recount | 「検索ページ」と「メインの目次ページ」で、２ページ目以降、アイテムの数が正確にスキップされない場合、 recount に「yes」を設定してください。 ページを進む毎に再計算されますので、正確なアイテムの数だけスキップして表示されます。

## スキンタイプ

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

## 例

    <%nextlink%>
    <%nextlink(次のページ,10)%>
    <%nextlink(,10)%>
    <%nextlink(,10,yes)%>

内容について気がついた事があればご連絡ください。

# スキン変数：todaylink

選択中のブログ、あるいはカテゴリーのトップページのURLを挿入します。

## 引数

- オプション

  名前 | 値
  --- | ---
  linktext | 記述されていると、URLの代わりに`<a href...`タグによるリンクが挿入されます。

## スキンタイプ

全て

## 例

    <%todaylink%>

内容について気がついた事があればご連絡ください。

# スキン変数：vars

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

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

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

## 引数

なし

## スキンタイプ

個別アイテム

内容について気がついた事があればご連絡ください。

# スキン変数：version

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

## 引数

なし

## スキンタイプ

全て

## 例

    <%version%>

内容について気がついた事があればご連絡ください。

# 時間変数の概要

次の変換記述は文字列フォーマットに基づきます（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 - タイムゾーンまたはその名前または短縮形
- %% - 文字リテラル"%"

以下はサーバによって対応が異なりますので、参考程度にお試しください。

- %-dまたは%#d - 日付を10進数で(1から31)
- %-Hまたは%#H - 時間を24時間表示の10進数で(0から23まで)
- %-Iまたは%#I - 時間を12時間表示の10進数で(1から12までの範囲)
- %-mまたは%#m - 月を10進数で表現 (1から12)
- %-Mまたは%#M - 分を10進数で表現(0から59まで)

内容について気がついた事があればご連絡ください。

# 管理者の特権

super-admin（最高管理者）と呼ばれ、ブログのチームへの所属とは無関係に、全ての機能と全てのブログにフルアクセスできます。

またsuper-adminは、ブログの作成、グローバル設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作（メンバーの作成/編集/削除）を行う権限があります。

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

内容について気がついた事があればご連絡ください。

# Blogの管理者

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

- チームの操作
- Blog設定の変更
- 投稿者に関係なく、該当Blogのどのアイテムでも編集や削除が可能
- Blogの削除

一つのブログは複数の管理者を持つことができます。各ブログには、最低でも一人の管理者がいなくてはなりません。

内容について気がついた事があればご連絡ください。

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

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

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

利用できる変数：（ヘッダーとフッターでは`blogid`のみが使用できます）

名前 | 説明
--- | ---
blogid | weblogのID
archivelink | アーカイブへのリンク。`<a href="<%archivelink%>">`のように使用します。
month | 月の数値（01-12の2文字表記）
year | 年（西暦の4文字表記）
day | 月の中での日付（二文字表記。日ごと表示の時のみ）

strftime変数を使用することで、日付の表記を自由にカスタマイズすることができます。この変数が複雑すぎると感じるなら、次のように記述すると良いでしょう。

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

出力される時刻と言語をあなたの住んでいる地域にあわせるために、localeを適切に設定してください。

内容について気がついた事があればご連絡ください。

# テンプレート：ブログリスト

ブログリストは次の様に出力されます：

    ブログリストヘッダー
    ブログリストアイテム（存在するブログの数だけ繰り返し）
    ブログリストフッター

ブログリストアイテムで利用可能な変数：

名前 | 説明
--- | ---
bloglink | ブログのURL（Nucleusコアによって与えられた引数から生成されるもの）`<a href="<%bloglink%>">`のように使用します。
blogurl | ブログのURL（「Blog設定」の「URL」で設定されているもの）`<a href="<%blogurl%>">`のように使用します。
blogdesc | ブログの説明
blogname | ブログ名(第二引数に『shortname』が指定された場合は『ブログの短縮名』)

ヘッダーとフッターでのみ使用できる変数：

名前 | 説明
--- | ---
siteurl | グローバル設定の「サイトのURL」
sitename | グローバル設定の「サイト名」

ブログリストの例を見る

内容について気がついた事があればご連絡ください。

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

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

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

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

名前 | 説明
--- | ---
blogid | weblogのID
blogurl | blogのURL（blogごとの「設定」で定義される）
self | パラメーター無しの現在のページ（例えば`index.php`）
catlink | 該当カテゴリーの新しいアイテムへのリンク。これにより<a href="..">タグを埋め込むことができる。
catid | カテゴリーのID
catname | カテゴリー名
catdesc | カテゴリーの説明
catiscurrent | カテゴリが選択中、もしくは表示中のアイテムが所属するカテゴリの場合｢yes｣が、そうでなければ｢no｣が出力される
currentcat | <%catiscurrent%>のシノニム

カテゴリーリストの例を見る

内容について気がついた事があればご連絡ください。

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

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

## 例

    <h2><%userlink%>さんによるコメント：</h2>
    <p><%body%></p>
    <div class="metadata">
    （接続元：<%host%> 投稿日時：<%date%> <%time%>）
    </div>

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

fujisakiさんによるコメント：

このういろう、味薄い

(接続元：host.example.org 投稿日時：2008-08-23 02:30)

内容について気がついた事があればご連絡ください。

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

このテンプレートの内容は、コメントの本体で使われる変数`<%short%>`に追加されます。

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

例：

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

内容について気がついた事があればご連絡ください。

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

## 特徴

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

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

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

## 例

コメントのヘッダー:

    <ul>

コメントの本体:

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

コメントのフッター

    </ul>

結果は次のようになります

- hsur: そうでしたね。なんでソコ抱き合ってんの・・・っていう感じで
- satona: ぼくは、センセーとしましたよ。ハグ。
- hsur: ぇ！

内容について気がついた事があればご連絡ください。

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

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

1. コメントが表示されるとき（ブログの設定、もしくは「コメント本体」のテンプレート内の<%comments%>の引数で許可されているコメントの最大数を下回っているとき）

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

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

       コメントが無い時

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

       コメントが多すぎる時

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

内容について気がついた事があればご連絡ください。

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

日本語で使う場合は、単複同型なので両方"件のコメント"にしておいて問題ないでしょう。英語で表記したい時は、次のようなことが気になるかもしれません。

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

1つしかコメントが無い時は、`<%commentword%>`は「コメントが一つの時」で設定した内容になり、2つ以上のコメントがついているなら「コメントが二つ以上の時」で設定した内容になります。

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

内容について気がついた事があればご連絡ください。

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

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

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

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

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

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

    </div>

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

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

内容について気がついた事があればご連絡ください。

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

これらは`<%date%>`と`<%time%>`という変数（詳細はテンプレート変数を参照）の日付と時刻の表示方法を設定します。フォーマットはLocaleにも左右されます。

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

内容について気がついた事があればご連絡ください。

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

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

## 例：

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

内容について気がついた事があればご連絡ください。

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

検索結果をハイライト表示するために、検索文字列を挟み込む(X)HTMLタグを入力します。" "と記述した場所が、検索文字列に置き換えられます。また、ここで入力された文字列は、プログラム中で正規表現のパターン構文数（新しいウィンドウが開きます）としてそのまま使用されますので、いくつかの記号はバックスラッシュを直前に置くことでエスケープしなければなりません。

## 例

    <span style="background-color:yellow"></span>

内容について気がついた事があればご連絡ください。

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

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

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

「ヘッダー」、「本体」「フッター」の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 - September 5th 2008 18:51 - karma - no comments

内容について気がついた事があればご連絡ください。

# テンプレート変数：itemtitle

コメント関連テンプレート変数で、元記事のタイトルを挿入します。

## 引数

- オプション：

  名前 | 値
  --- | ---
  maxlength | maxlengthで指定された数値で、アイテムのタイトル省略。

## 例

    <%itemtitle%>

内容について気がついた事があればご連絡ください。

# テンプレート：Locale

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

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

- en：英語
- dutch：オランダ語
- ja_JP：日本語
- ja_JP.UTF-8：日本語、UTF-8環境
- ...

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

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

内容について気がついた事があればご連絡ください。

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

これはコメントが登録メンバーからのものであることを示すのに利用できるテンプレートです。最終的にはコメントの本体で使われる`<%authtext%>`変数の中身として表示されます。

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

内容について気がついた事があればご連絡ください。

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

これはアイテムのテンプレート（アイテムのヘッダー、アイテムの本体、アイテムのフッターの3つ）で利用できるテンプレート変数、"morelink"がどのように表示されるかを決めるものです。利用可能な変数はアイテムのテンプレートと同じです。

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

## 例

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

内容について気がついた事があればご連絡ください。

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

最終訪問日時Cookieの保存オプションを「はい」に設定している時、前回訪問時から後に追加されたアイテムに、「新しいアイテムに付けるマーク」テンプレートの内容が、アイテムのテンプレートに記述した変数`<%new%>`の部分に表示されます。

「最終訪問日時Cookieの保存」が「いいえ」に設定されている、または前回訪問時以降にアイテムが新しく追加されていなければ、変数`<%new%>`は無視されます。

内容について気がついた事があればご連絡ください。

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

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

利用可能な変数：

名前 | 説明
--- | ---
blogid | ブログのID
query | 検索に用いられた文字列

## 例

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

内容について気がついた事があればご連絡ください。

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

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

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

名前 | 説明
--- | ---
popuplink | 画像へのポップアップ・リンク
rawpopuplink | popuplinkのジャンプ先URL
popupcode | ポップアップウィンドウを開くjavascriptコード
text | 代替テキスト（リンクテキスト）
width | イメージの幅
height | イメージの高さ
popuptext | textと同じだが、htmlエンティティ変換される
link | 画像の直接のURL
media | 画像への直接リンク

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

名前 | 説明
--- | ---
image | (x)htmlのimgタグ
link | 画像の直接のURL
text | 代替テキスト（リンクテキスト。htmlエンティティ変換される）
width | イメージの幅
height | イメージの高さ
media | 画像への直接リンク

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

名前 | 説明
--- | ---
media | ファイルへの直接リンク
link | ファイルの直接のURL
text | 代替テキスト（リンクテキスト。htmlエンティティ変換される）

内容について気がついた事があればご連絡ください。

# テンプレート変数：author

投稿者のデータを挿入します。

## 引数

- オプション：

  名前 | 挿入される情報の種類
  --- | ---
  name | 投稿者の「表示される名前」（ログインID）
  realname | 投稿者のハンドルネーム(本名)
  id | 投稿者のメンバーID
  url | 投稿者のウェブサイトのURL
  email | 投稿者の登録メールアドレス（使うのは避けるべき）

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：comments

コメントブロックを挿入します。このブロックの詳しい説明。

## 引数

- オプション：

  名前 | 値
  --- | ---
  MaxToShow | 表示するコメントの数（設定されていれば、Blog設定にあるコメントの最大量を上書きします）

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：date

日付フォーマットで設定した書式で日付を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。

## 引数

- オプション：

  名前 | 値
  --- | ---
  format | 日付のフォーマットに用いる形式
  下記の4つの特別なパラメーターが利用可能です
  `rfc822` | LocaleにあわせたRFC822フォーマットの日付
  `rfc822GMT` | GMTにあわせたRFCフォーマットの日付
  `iso8601` | ISO-8601フォーマットの日付（W3Cの時刻と日付フォーマット（新しいウィンドウが開きます）に概略があります）。例：2008-09-05T10:00:00-05:00
  `utc` | iso8601と同じ。ただし、タイムゾーンの表示として"Z"を使うUTCで表現される。

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：edit

テンプレート：アイテムを編集するためのリンクの内容を挿入します。

注意：ログイン状態のメンバーが、閲覧中のアイテムの編集を許可されている時のみ、この変数が働きます。それ以外の場合は、テンプレート変数<%edit%>は何も表示しません。

## 例

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

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

## 結果は次のようになります

タイトル

アイテムの本文

編集 - 5 comments

内容について気がついた事があればご連絡ください。

# テンプレート変数：editlink

アイテムを編集するためのbookmarkletのURLを挿入します。この変数はテンプレート：アイテムを編集するためのリンク内で使用することができます。

## 例

「アイテムを編集するためのリンク」テンプレートの一例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：editpopupcode

"アイテムの編集"ウィンドウをポップアップで開くためのjavascriptのコードを挿入します。

## 例

「アイテムを編集するためのリンク」テンプレートの一例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：image

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

通常テンプレート変数<%image%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

## 引数

- 必須：

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

- 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく "|"で区切られなければなりません。

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：karma

カルマ投票のデータを挿入します。カルマ投票は、アイテムの"カルマ"を投票する方法で、正にでも負にでも投票できます。これら投票の総計によって、該当記事が訪問者にどのように思われているのか知ることができます。

## 引数

- オプション：

  名前 | 挿入される情報の種類
  --- | ---
  totalscore | カルマ投票の総合得点（正の投票数から負の投票数を引いたもの/デフォルト）
  pos | 正の投票の総計
  neg | 負の投票の総計
  votes | 投票数の総計
  posp | 正に投じられたパーセンテージ
  negp | 負に投じられたパーセンテージ

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：media

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

通常テンプレート変数<%media%>はアイテムにメディアファイルを挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

## 引数

- 必須：

  名前 | 値
  --- | ---
  filename | オブジェクトファイルの名前
  text | オブジェクトの説明テキスト

- 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく "|"で区切られなければなりません。

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：morelink

テンプレート続きへのリンクで定義されているリンクを挿入します。「続き」に何も入力されていない時は無視されます。

テンプレート部品"続きへのリンク"の中身もまたパースされるので、同様にテンプレート変数を含むことができることに注意してください（例：続きへのリンクに<%morelink%>を記述することは可能ですが、無限ループを起こします）。

## 引数

なし

内容について気がついた事があればご連絡ください。

# テンプレート変数：popup

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

通常テンプレート変数<%popup%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

## 引数

- 必須：

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

- 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく "|"で区切られなければなりません。

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：smartbody

現在のアイテムを調べてから、｢本文｣と｢続き｣のどちらを表示するか決定します。
「続き」に何かが入力されていれば「続き」が、何も入力されていなければ「本文」が挿入されます。

部分名 | 何か入力されている？
--- | ---
本文 | 入力あり | 入力あり
続き | 入力なし | 入力あり
smartbodyで 挿入される部分 | 「本文」部分 | 「続き」部分

## 使用例

「本文」に詳しい内容を入力し、「続き」には"紹介"、"抜粋"といった内容のものを入力し、「メインの目次ページ」で使用するテンプレートには`<%smartbody%>`を使い、抜粋が存在するときにはそれを、無い時は「本文」を使用するような使い方をします。

この時、「個別アイテムページ」で使うテンプレートには、`<%body%>` + `<%more%>`のかわりに`<%body% >`だけを記述するようにすると、より効果的に使えるでしょう。

内容について気がついた事があればご連絡ください。

# テンプレート変数：syndicate_description

HTMLタグを取り除き、指定された幅にまで縮めたアイテムの本文を挿入します（指定が無い時は250）。テキストが縮められた場合は、末尾に"..."が追加される。

この変数はRSSのために使うことが意図されていましたが、他にも便利な使い方があるでしょう。

## 引数

- オプション：

  名前 | 値
  --- | ---
  MaxChars | 省略せずに残す最大の幅（デフォルトは250）

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：syndicate_title

HTMLタグを取り除き、指定された長さにまで縮めたアイテムのタイトルを挿入します（指定が無い時は100）。省略された場合、末尾に"..."が追加されます。

この変数はRSS等のために使うことが意図されていましたが、他にも便利な使い方があるでしょう。

## 引数

- オプション：

  名前 | 値
  --- | ---
  MaxChars | 省略せずに残す最大の幅（デフォルトは100）

## 例

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

内容について気がついた事があればご連絡ください。

# テンプレート変数：time

時刻フォーマットで設定した書式で時刻を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。

## 引数

- オプション：

  名前 | 値
  --- | ---
  format | 時刻のフォーマットに用いる形式

## 例

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

内容について気がついた事があればご連絡ください。

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

名前 | 説明
--- | ---
authorid | 現在のアイテムの投稿者のID
blogid | アイテムが所属するブログのID
catid | アイテムが所属するカテゴリーのID
query | 存在していれば、検索文字列
syndicate_title | RSSなどの配信用に、指定文字数以上を省略したアイテムのタイトル
syndicate_description | RSSなどの配信用に、指定文字数以上を省略した「本文」テキスト
karmaposlink | 投票用のURL
karmaneglink | 投票用のURL
new | 前回訪問時意向に追加されたアイテムを示すテキストなど
include | 指定されたファイルの内容をそのまま挿入
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入
if-ifnot-else-elseif-elseifnot-endif | 3.60より、テンプレートでif（条件分岐）が使用できます。（オプションの「nextitem, previtem, archiveprevexists, archivenextexists, skintype」は利用できません。)
plugin | プラグインを実行
edit | テンプレート「アイテムを編集するためのリンク」の内容を挿入
editlink | アイテム編集画面（bookmarklet）のURL
editpopupcode | editlink用のウィンドウをポップアップするjavascriptコード
skinfile | インポートされたスキンに属しているファイルへの正確なURLを挿入
set | パーサーのプロパティを設定
image | メディア・ライブラリの画像をインライン表示
popup | メディア・ディレクトリの画像をポップアップ
media | メディア・ディレクトリの他のメディア・オブジェクト
relevance | 検索結果を表示するテンプレートに「検索関連度」を挿入する（2.5より）

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

内容について気がついた事があればご連絡ください。

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

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

名前 | 説明
--- | ---
title | アイテムのタイトル
body | 「本文」のテキスト
more | 「続き」のテキスト
category | アイテムが所属しているカテゴリーの名前
categorylink | アイテムが所属しているカテゴリーのURL
karma | カルマ投票の得点
authorlink | 投稿者の「メンバーの詳細ページ」のURL
itemlink | アイテムのURL（permanent）
author | 投稿者の「表示される名前」
smartbody | 本文か続きのどちらか
morelink | 「続き」部分のURL
date | フォーマット済みの日付
time | フォーマット済みの時刻
daylink | アイテムが投稿された日付のアーカイブのURL
comments | コメント・ブロック、もしくはコメント数
itemid | アイテムのID
blogurl | ブログのURL

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

内容について気がついた事があればご連絡ください。

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

名前 | 説明
--- | ---
body | コメントの本体
user | コメントした人の名前
userid | コメントした人のWebサイトのURL、もしくはコメントした人のメールアドレス（入力されたままのものが挿入されます）
email | コメントした人のメールアドレス（スパム対策として、"@"は"(at)"に、".(ピリオド)"は"(dot)"に変換されます）
userlink | コメントした人がログイン中の登録メンバーの時はメンバー詳細ページに、それ以外の時は入力されたWebサイトのURL、もしくはメールアドレスに対する<a href="...">タグ付きのリンク（有効なURLかメールアドレスが入力されていない場合は、コメントした人の名前のみが表示されます）
userlinkraw | userlinkと同じ。ただし、aタグの付いたリンクではなくURL、もしくはmailto:メールアドレスのみの表記。（入力されたURLやメールアドレスがいずれも文法的に有効でない場合は空になります）
useremail | ユーザーのメールアドレス。もしコメントした人によって入力されていない場合は空
userwebsite | ユーザーのwebsiteのURL。もしコメントした人によって入力されていない場合は空
userwebsitelink | コメントした人が登録メンバーの時はメンバー詳細ページに、それ以外の時は入力されたWebサイトのURLに対する<a href="...">タグ付きのリンク（有効なURLが入力されていない場合は、コメントした人の名前のみが表示されます）
memberid | メンバーのID（コメントした人がログイン中の登録メンバーでない時は0になります）
commentcount | 該当アイテムに付けられたコメントの総数
commentword | アイテムに付けられたコメントの件数の数え方の表記
date | コメントが追加された時の日付
time | コメントが追加された時の時刻
host | コメントが投稿されたホスト名
ip | コメントが投稿されたIPアドレス
commentid | 現在のコメントのID
itemid | 現在のアイテムのID
itemlink | アイテムの詳細ページへのリンク
itemtitle | 現在のアイテムのタイトル
blogid | ブログのID
blogurl | ブログのURL
authtext | コメントした人がログイン中の登録メンバーの時は「登録メンバーからのコメントへの追加表示」テンプレートで設定した内容、それ以外は空
short | 最初の改行部分から先が省略されたコメントの本体。テンプレートによっては末尾にリンクが追加されます。
excerpt | コメントの本体。60文字でカットし"..."を追加
timestamp | コメントが追加された時のタイムスタンプ
if-ifnot-else-elseif-elseifnot-endif | 3.60より、テンプレートでif（条件分岐）が使用できます。（オプションの「nextitem, previtem, archiveprevexists, archivenextexists, skintype」は利用できません。)
include | 指定されたファイルの内容をそのまま挿入
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入
plugin | プラグインを実行
skinfile | インポートされたスキンに属しているファイルへの正確なURLを挿入
set | パーサーのプロパティを設定

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

内容について気がついた事があればご連絡ください。

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

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

テンプレート変数はスキン変数と同じ方法で広く働きますが、テンプレート内部で利用できる点でスキン変数と区別されます。変数は `<%変数名%>`という形で呼び出され、変数の機能によってはテキストを挿入します。また、その他のオプションパラメーターを持つ変数もあります。

## 利用可能な変数

テンプレート変数は、`「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」`といった、テンプレート・パーツの中で使用できます。（変数`image`、 `popup`、`media`、`plugin`はブログアイテムの中でも使用できます。）

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

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

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

内容について気がついた事があればご連絡ください。

# URLモード

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

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

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

内容について気がついた事があればご連絡ください。