Seesaaブログが公開しているHTMLカスタマイズの文法、変数、関数の一覧です。
SeesaaブログHTML関数リファレンス
| <% %> | Seesaaブログ独自のタグです。 |
| <% 変数 %> | 変数の値を表示します。 |
| <% if:条件 %>〜<% /if %> | if文です。条件分岐をします。条件が真の場合にブロック内（ifタグで囲まれた中）のHTMLを表示します。 |
| <% unless:条件 %>〜<% /unless %> | unless文です。条件分岐をします。条件が偽の場合にブロック内（ifタグで囲まれた中）のHTMLを表示します。 |
| <% if:条件 %>〜<% else %>〜<% /if %> | else文です。条件分岐をします。unless文でも同様です。 |
| <% loop:変数 %>〜<% /loop %> | loop文です。loopの中ではloopの値に応じて複数回繰り返しがおこなわれます。 |
| <% 変数 | 関数 %> | 変数を関数の種類に応じて整形します。 |
| <% include:変数 %> | ユーザーのカスタマイズが不可能な箇所です。2005年3月9日時点で記事コンテンツ の一部にincludeタグが使用されています。 |
| <%- または -%> | ［-］を使用すると直前直後の改行コードが削除されます。 |
変数には変数そのものが展開されるものと、ドット（.）をつないで展開されるものの二種類があります。
| 通常の変数 | <% page_name > |
| オブジェクト型変数 | <% blog.title > |
各ページ、あるいはコンテンツにて利用できない変数があります。
以下のオブジェクトは全てのHTMLを通して利用可能です。
以下のオブジェクトは全てのHTMLを通して利用可能です。
| blog | ブログ情報 |
| site_info | Seesaaブログサイト情報 |
| blog.name | ホスト名 |
| blog.title | ブログ名 |
| blog.description | ブログ説明 |
| blog.page_url | ブログURL |
| blog.keywords | ブログキーワード |
| blog.nickname | ブログニックネーム |
| article.subject | タイトル |
| article.body | 本文 |
| article.body_continue_text | 追記文のつなぎ文言 |
| article.body_more | 追記文 |
| article.first_body | 追記文言を含む本文 |
| article.entire_body | 本文と追記文をあわせたもの |
| article.excerpt | 概要 |
| article.disp_flag | 公開非公開フラグ |
| article.accept_tb | トラックバック受付フラグ |
| article.accept_comment | コメント受付フラグ |
| article.topics | キーワード（アフィリエイト） |
| article.createstamp | 投稿日時 |
| article.children_count | コメント数 |
| article.tr_count | トラックバック数 |
| article.nickname | 投稿者名 |
| article.tr_url | トラックバックURL |
| article.page_url | 記事ページURL |
| article.category | categoryオブジェクトを取得 |
| archive.createstamp | 日付 |
| archive.article_count | 記事数 |
| archive.prev | 前月のarchiveオブジェクトを取得 |
| archive.next | 翌月のarchiveオブジェクトを取得 |
| archive.page_url | 過去ログのURL |
| category.name | カテゴリ名 |
| category.article_count | 記事数 |
| category.page_url | カテゴリのURL |
| site_info.blog_url | SeesaaブログのURL |
| site_info.site_url | SeesaaブログのURL |
| clickable | http://で始まる文字列があった場合にその文字列をHTMLリンクにします。 |
| comma | 1000 -> 1,000 |
| date_format | 日付文字列を指定フォーマットで表示します。 例 <% article.createstamp | data_format(%Y/%m) %> |
| html | HTMLエスケープ |
| nl2br | 改行コードを<br>に変換します。 |
| ns2sp | 改行コードをスペースに変換します。 |
| oneline | 改行コードを抜いて一行にします。 |
| shorten | 指定byte以降を表示しません。 |
| tag_bleak | b,i,img,aタグを許可し、その他のHTMLタグを抜きます。 |
| tag_strip | HTMLタグを全て抜きます。 |
| text_summary | HTMLタグを有効にした上でテキスト部分を指定byte以降を表示しないようにします。 例 <% foo | text_summary(100) %> |
| __or__ | 真偽判断をし、それ以前の評価が偽の場合、それ以降の関数を実行します。 |
| __and__ | 真偽判断をし、それ以前の評価が真の場合、それ以降の関数を実行します。 |
ページの切り分けはpage_nameで制御が可能です。2005年3月9日時点でページは次の6種類です。
| index |
| article |
| archive |
| category |
| comment |
| search |
使用例： <% if:page_name eq 'index' %>トップページにだけ表示したいHTML<% /if %>
日付はdata_format関数にフォーマット文を与えて整形します。
| <% article.createstamp | data_format("%Y年%m月") %> | 2005年03月 |
| <% article.createstamp | data_format("%Y/%m") %> | 2005/03 |
| <% article.createstamp | data_format("%Y/%m/%d") %> | 2005/03/09 |
| <% article.createstamp | data_format("%Y/%m/%d %a") %> | 2005/03/09 Wed |
関数は数珠繋ぎで利用することができます。
使用例：
<% foo | tag_break | shorten(100) | nl2br %>
fooの値からHTMLタグを取り除き、テキストサイズを100byteに切り詰めて、改行コードをタグに変換しています。