tag 'author'
desc 'ページの制作者の名前を表示します。'
tag 'breadcrumb'
desc %{ 現在のページの @パンくず@ 属性を表示します。}
tag 'breadcrumbs'
desc %{
パンくずリストをページに表示します。 @separator@ 属性は、それぞれのパンくずの間に挿入されるHTMLの断片を指定します。デフォルトでは、「>」がセットされています。
*使い方：*
<pre><code><r:breadcrumbs [separator="separator_string"] /></code></pre>
}
tag 'children'
desc %{
子ページへのアクセスを提供します。
*使い方:*
<pre><code><r:children>...</r:children></code></pre>
}
tag 'children:count'
desc "子ページの数を表示します。"
tag 'children:each'
desc %{
子ページごとに繰り返し処理を行います。このタグに囲まれた全てのページの属性タグは、子ページと対応づけされています。
パラメーターを追加する事によって繰り返しの対象を絞り込む事が出来ます。statusは、対象となるページの状態です。byの属性によって並び替えることが出来ます。orderは、並び順を降順(desc)か昇順(asac)で指定する事が出来ます。
offsetは、繰り返しの起点を示します。limitは、繰り返しの終点を示します。
*使い方:*
<pre><code><r:children:each [offset="number"] [limit="number"] [by="attribute"] [order="asc|desc"]
[status="draft|reviewed|published|hidden|all"]>
...
</r:children:each></code></pre>
}
tag 'children:each:child'
desc %{
このタグに囲まれたページの属性タグは、現在の子を示しています。ほとんどのケースでは、利用しません。
*使い方:*
<pre><code><r:children:each>
<r:child>...</r:child>
</r:children:each></code></pre>
}
tag 'children:each:header'
desc %{
１つ前のヘッダと一致しないコンテンツに限り、タグに囲まれた部分を表示します。これは、dateヘッダーを子のページで表示する場合に非常に便利です。
もし、複数のヘッダブロックをあなたが使いたいとき @name@ 属性によってヘッダに名前を付ける事が出来ます。ヘッダに名前を付けたとき、他の同じ名前のヘッダまで再起動しないというのは間違いです。他のヘッダに名前を付けたいときは、セミコロンを付けて列挙してください。
*使い方:*
<pre><code><r:children:each>
<r:header [name="header_name"] [restart="name1[;name2;...]"]>
...
</r:header>
</r:children:each></code></pre>
}
tag 'children:first'
desc %{
最初の子を返します。このタグに囲まれた全てのページの属性タグは、最初の子ページとして対応しています。 @<r:children:each>@ タグと同じオプションを利用する事が出来ます。
*使い方:*
<pre><code><r:children:first>...</r:children:first></code></pre>
}
tag 'children:last'
desc %{
最後の子を返します。このタグに囲まれた全てのページの属性タグは、最後の子ページとして対応しています。
@<r:children:each>@ タグと同じオプションを利用する事が出来ます。
*使い方:*
<pre><code><r:children:last>...</r:children:last></code></pre>
}
tag 'comment'
desc %{
コメントタグで囲まれた部分は表示されません。
*使い方:*
<pre><code><r:comment>...</r:comment></code></pre>
}
tag 'content'
desc %{
ページのメイン・コンテンツを表示します。 @part@ 属性を利用する事によって、パート名を指定する事が出来ます。標準では、bodyになっていいます 。
@inherit@ 属性は、親のパート引き継ぎます 。
標準では、 @inherit@ は @false@ です。
親ページのパートを引き継がせることを強制します。 @contextual@ 属性を利用する事によって、子ページの中で親ページのパートを作り直します。標準では、contextual属性はtrueになっています。
*使い方:*
<pre><code><r:content [part="part_name"] [inherit="true|false"] [contextual="true|false"] /></code></pre>
}
tag 'cycle'
desc %{
繰り返しを表示します。一行ごとに色を変えたりする場合に便利です。 @name@ 属性は、複数のサイクルを利用する事ができます。標準は @cycle@ になっています。
*使い方:*
<pre><code><r:cycle values="first, second, third" [reset="true|false"] [name="cycle"] /></code></pre>
}
tag 'date'
desc %{
ページの日付を表示します。標準では、作成・公開された時間です。日付の形式に関する属性は、プログラミング言語Rubyの @strftime@ メソッドと同じです。標準では、 @%A, %B %d, %Y@ です。for属性では、どの日付を表示するかを指定します。 @published_at@ 、 @created_at@ 、 @updated_at@ 、そして @now@ があります。 @now@ は、現在の日付/時間を表示します。
*使い方:*
<pre><code><r:date [format="%A, %B %d, %Y"] [for="published_at"]/></code></pre>
}
tag 'escape_html'
desc %{
HTMLをエスケープします。HTML文章を表示するために利用します。
* 使い方:*
<pre><code><r:escape_html>...</r:escape_html></code></pre>
}
tag 'find'
desc %{
@url@ 属性で指定したページが、このタグの間で利用する事が出来ます。
*使い方:*
<pre><code><r:find url="value_to_find">...</r:find></code></pre>
}
tag 'if_content'
desc %{
ページにパートが存在する場合に限り、タグに囲まれた部分を表示します。標準では、 @part@ 属性は @body@ にセットされています。
*使い方:*
<pre><code><r:if_content [part="part_name"]>...</r:if_content></code></pre>
}
tag 'if_parent'
desc %{
ページが親ページを持つ場合に限り、タグに囲まれた部分を表示します。言い換えれば、ルートページ以外で動作するということです。
*使い方:*
<pre><code><r:if_parent>...</r:if_parent></code></pre>
}
tag 'if_url'
desc %{
@matches@ 属性で指定した正規表現で指定したurlと一致したページに限り、タグに囲まれた部分を表示します。
もし、 @ignore_case@ 属性がfalseの場合、大文字と小文字を区別します。標準では、 @ignore_case@ はtrueになっています。
*使い方:*
<pre><code><r:if_url matches="regexp" [ignore_case="true|false"]>...</if_url></code></pre>
}
tag 'link'
desc %{
ページのリンクを表示します。ページのタイトルをリンクの名前として使うような場合、単体で使います。二重のタグとして利用するとき、二つのタグに囲まれたタグは、リンクテキストのように働きます。リンクタグは、全ての属性をHTMLタグへ渡します。 @class@ 属性や @id@ 属性のような属性を渡す場合には非常に便利です。
*使い方:*
<pre><code><r:link [anchor="name"] [other attributes...] /></code></pre>
or
<pre><code><r:link [anchor="name"] [other attributes...]>link text here</r:link></code></pre>
}
tag 'navigation'
desc %{urls属性の３つ状態によって、リンクの一覧を表示します。
* @normal@ - 通常の状態
* @here@ - ページのURLとリンクのURLが一致する状態
* @selected@ - ページが子ページのURLと一致する状態
@between@ タグは、それぞれのリンクの間に何を挿入すればよいのかを指定します。
*使い方:*
<pre><code><r:navigation urls="[Title: url | Title: url | ...]">
<r:normal><a href="<r:url />"><r:title /></a></r:normal>
<r:here><strong><r:title /></strong></r:here>
<r:selected><strong><a href="<r:url />"><r:title /></a></strong></r:selected>
<r:between> | </r:between>
</r:navigation></code></pre>
}
tag 'page'
desc %{
このタグの間では、ページの属性をタグとして扱う事ができます。
*使い方:*
<pre><code><r:page>...</r:page></code></pre>
}
tag 'parent'
desc %{
このタグに囲まれたページ属性タグは、親のページの属性タグと対応しています。
*使い方:*
<pre><code><r:parent>...</r:parent></code></pre>
}
tag 'random'
desc %{
@option@ タグによって指定されたオプションの１つをランダムに表示します。
* 使い方:*
<pre><code><r:random>
<r:option>...</r:option>
<r:option>...</r:option>
...
<r:random></code></pre>
}
tag 'rfc1123_date'
desc %{
登校時間をRFC 1123の形式で出力します。この形式は、RSSフィードに適した形式です。
使い方:
<r:rfc1123_date />
}
tag 'slug'
desc "ページにページ @slug@ 属性を表示します。"
tag 'snippet'
desc %{
@name@ 属性のスニペットを表示します。
*使い方:*
<pre><code><r:snippet name="snippet_name" /></code></pre>
}
tag 'title'
desc "ページのタイトルを表示します。"
tag 'unless_content'
desc %{
@if_content@ タグの閉じタグです。
*使い方:*
<pre><code><r:unless_content [part="part_name"]>...</r:unless_content></code></pre>
}
tag 'unless_parent'
desc %{
ページが親ページを持っていない時、言い換えればルートページの時に、タグに囲まれた部分を表示します。
*使い方:*
<pre><code><r:unless_parent>...</r:unless_parent></code></pre>
}
tag 'unless_url'
desc %{
@if_url@ タグを閉じるタグです。
*使い方:*
<pre><code><r:unless_url matches="regexp" [ignore_case="true|false"]>...</unless_url></code></pre>
}
tag 'url'
desc "ページのURLを表示します。"
tag 'archive:children'
desc %{
条件が一致するアーカイブページの子ページの一覧へのアクセスを提供します。
*使い方:*
<pre><code><r:archive:children>...</r:archive:children></code></pre>
}
