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に切り詰めて、改行コードをタグに変換しています。