個人的な備忘録
その他の記事
タグの記法について
大文字小文字は区別しない。
<MTIgnore>も<mtignore>も同じ。
MT と mt: の違いはない。歴史的な経緯。
<MTIgnore>も<mt:ignore>も同じ。
$有りと無し
$は変数のメタファー。
<MTVar name="custom_field">はタグ。
<$custom_field$>は変数のメタファー。
mt:BlogHost
ブログのホスト名を表示します。例えば、ブログ URL が http://www.example.com/blog/ の場合、www.example.com を表示します。
mt:BlogURL
目的
ブログのFQDN（ドメイン名）を含むURLを出力する。
通常は mt:BlogURL を使う方が良いが、検索CGIなどを使った場合、異なるドメイン（ホスト・サーバー）でCGIが実行されていると、リンク切れになる場合がある。
このような場合は、FQDNを含む完全なURLで出力する。
使い方
<a href="<$mt:BlogURL$>">TOP</a>
mt:BlogRelativeURL
目的
Apache の mod_write での rewrite_base に相当する。
MovableTypeは、一つのシステムで複数のブログを公開できる為、ブログ毎にディレクトリィを分ける場合がある。
FQDN（ドメイン名）を含めないのは、URLでドメイン名が省略されていた場合、カレントのページと同一であるとみなす仕様がある為。
こうすることで、MovableTypeの実行環境（ドメイン）と生成されたHTMLの公開環境（ドメイン）が異なっていてもリンクできる。
使い方
<a href="<$mt:MTBlogRelativeURL$>">TOP</a>
mt:BlogName
目的
環境設定で設定されたブログ名を表示する。
使い方
<header><h1><$mt:BlogName$></h1></header>
mt:BlogRelativeURL
目的
ドキュメント・ルートからの、ブログのパスを抽象化する。
使い方
<$MTBlogRelativeUrl$>foo.html → /blog-root/foo.html
CategoryBasename
encode_html
目的
HTMLのエスケープ（"<"や">"など）
使い方
<mt:EntryBody encode_html="1">
encode_url
目的
Aタグ（アンカー）のhrefに利用する値をエンコードする時に使います。
使い方
<mt:EntryTitle encode_url="1">
<MTVar name="custom_field" encode_url="1">
MTCanonicalURL
目的
CanonicalなURLを出力する
使い方
<link rel="canonical" href="<$MTCanonicalURL$>" />
regex_replace
目的
正規表現による置換
使い方
例えば、http: を https: に置換する。
<MTVar name="custom_field" regex_replace="/http:/","https:">
タグを変数に変換する
使い方
タグ <mt:WebsiteURL> を変数 $MTWebsiteURL に変換する。
<mt:WebsiteURL setvar="MTWebsiteURL">
目的
記事のURLはフル・パスだが、ドキュメント・ルート・パスに変換したい。
<mt:WebsiteURL setvar="MTWebsiteURL">
<mt:WebsiteRelativeURL setvar="MTWebsiteRelativeURL">
<mt:EntryPermalink replace="$MTWebsiteURL","$MTWebsiteRelativeURL">
置換を使っているのは、ブログのパスがドキュメント・ルート直下ではなく、サブディレクトリィに設定されている場合があるから。
<mt:WebsiteURL> → http://example.com/example/
<mt:WebsiteRelativeURL> → /example/
配列のループ
基本
配列に代入された値を出力する。
ループの評価に利用される変数 i は、$i でタグの中で利用できる。
配列を定義
<mt:SetVar name="list[1]" value="one" />
<mt:SetVar name="list[2]" value="twe" />
<mt:SetVar name="list[3]" value="three" />
ループ処理
<mt:For var="i" from="1" to="3">
<mt:Var name="i"> <mt:Var name="list[$i]"> <br/>
</mt:For>
2次元配列なら、連想配列より、こちらの方が直感的でシンプル
各配列へ定義した値をタグ内で使いたい場合は、GetVar して、変数に SetVar する。
複数の配列を定義する。
<mt:SetVar name="name[1]" value="新着" />
<mt:SetVar name="code[1]" value="new" />
<mt:SetVar name="name[2]" value="人気" />
<mt:SetVar name="code[2]" value="popular" />
<mt:SetVar name="name[3]" value="ほげ" />
<mt:SetVar name="code[3]" value="hoge" />
ループ処理
<mt:For var="i" from="1" to="3">
各配列に代入されている値を出力
<mt:Var name="i"> <mt:Var name="name[$i]"> <mt:Var name="code[$i]"><br/>
カテゴリー名で記事を抽出する
<mt:GetVar name="name[$i]" setvar="category_name" />
<mt:Entries lastn="10" category="$category_name">
<$MTEntryTitle$><br/>
</mt:Entries>
</mt:For>
プラグイン
MTTruncateURL
目的
リンク（aタグのhref）のスキーム（http, https）やFQDN（ドメイン名）を含むURL（https://example.com/foo/bar）を、ドメイン名を除いた、ドキュメント・ルート・パス（https://example.com/foo/bar → /foo/bar）に変換する。
使い方
MTTruncateURL Plugin配布サイトからプラグインをダウンロードしてpluginフォルダにアップします。
対象となるのは、aタグのhrefアトリビュート要素の値だけです。
<mt:truncateurl>
<a href="<$MTCategoryArchiveLink$>"><$MTCategoryArchiveLink$></a>
</mt:truncateurl>