便利なコメントアウトの仕方

2008年4月11日 00:08 | Writer: apstar | 記事本文

Movable Typeには、バージョン4以前からMTIgnoreというテンプレートタグがあります。このテンプレートタグを用いて、コメント行ももちろんですが、実験中のコードなどをコメント化することが可能です。

本家のドキュメントにも記述はありますが、あまり詳しく書いていませんのでここで説明します。

基本コードは以下のようになります。コメントアウトしたい部分をMTIgnoreタグで括ってあげるだけです。

<MTIgnore>
コメントアウトしたいコード
</MTIgnore>

コメント行として使う

コード中のコメント行として使用することができます。以下は、わかりづらいと思われる部分にコメント行を付加してみた例です。なお、このMTIgnoreテンプレートタグを用いて記述したコメント行は、再構築時にはカットされ、htmlソース中には出力されません。

<MTIgnore> ***** 表示するカテゴリの一覧をカンマ区切りでkeyword変数へ代入 ***** </MTIgnore>
<MTSetVar name="keyword" value="カテゴリ1,カテゴリ3,カテゴリ5">
<ul>
<MTCategories>
   <MTIgnore> ***** CurCat変数=ループ中のカテゴリラベル ***** </MTIgnore>
   <MTSetVarBlock name="CurCat"><MTCategoryLabel></MTSetVarBlock>
   <MTIgnore> ***** keyword変数内にCurCat変数が含まれるかチェック ***** </MTIgnore>
   <MTIf name="keyword" like="$CurCat">
      <li><a href="<$MTCategoryArchiveLink$>"<MTIfNonEmpty tag="MTCategoryDescription"> title="<$MTCategoryDescription$>"</MTIfNonEmpty>><$MTCategoryLabel$> (<$MTCategoryCount$>)</a></li>
   </MTIf>
</MTCategories>
</ul>

再利用したいかも、という箇所をとりあえず残しておく

2種類のコードを書いて、双方を比べる際などに使用すると、開発の効率は一気に上がります。

以下のコードは、このmtde.info開発中の際のスタイルシートのコードで、固定幅にするかリキッドレイアウトにするかを何度も切り替え、調整を行っていたときのものです。もしMTIgnoreテンプレートタグが無ければ、切り替えが面倒になりますので、初めからリキッド固定のみしかテストしなかったと思います。

コード中にもありますが、MTIgnoreテンプレートタグは多重の入れ子にすることも可能です。

<MTIgnore>定数セクション</MTIgnore>

<MTIgnore>色の設定</MTIgnore>
<MTSetVar name="COLOR_TEXT" value="#333333">                  <MTIgnore>Cテキスト色</MTIgnore>
<MTSetVar name="COLOR_TEXT_A" value="#104e8b">                <MTIgnore>Cリンクテキスト色</MTIgnore>
<MTSetVar name="COLOR_TEXT_A_HOVER" value="#ff7f00">          <MTIgnore>Cリンクテキストホバー色</MTIgnore>
<MTSetVar name="COLOR_TEXT_R" value="#ffffff">                <MTIgnore>RCテキスト色(リバース)</MTIgnore>
<MTSetVar name="COLOR_TEXT_A_R" value="#ffffff">              <MTIgnore>RCリンクテキスト色(リバース)</MTIgnore>
<MTSetVar name="COLOR_TEXT_A_HOVER_R" value="#ff7f00">        <MTIgnore>RCリンクテキストホバー色(リバース)</MTIgnore>

<MTIgnore>ヘッダとフッタ</MTIgnore>
<MTSetVar name="COLOR_BACKGROUND_HEADER" value="#ffffff">     <MTIgnore>Cバック色(ヘッダ)</MTIgnore>
<MTSetVar name="HEIGHT_HEADER" value="150px">                 <MTIgnore>H高さ(ヘッダ)</MTIgnore>
<MTSetVar name="COLOR_BACKGROUND_FOOTER" value="#333333">     <MTIgnore>Cバック色(フッタ)</MTIgnore>
<MTSetVar name="HEIGHT_FOOTER" value="32px">                  <MTIgnore>H高さ(フッタ)</MTIgnore>

<MTSetVar name="COLOR_BACKGROUND_GLOBALNAVI" value="#333333"> <MTIgnore>Cバックグラウンド色(グローバルナビゲーション)</MTIgnore>

<MTIgnore>
<MTIgnore>固定幅</MTIgnore>
<MTSetVar name="WIDTH_HEADER" value="100%">                   <MTIgnore>W幅(ヘッダ)</MTIgnore>
<MTSetVar name="WIDTH_BACKGROUND_GLOBALNAVI" value="100%">    <MTIgnore>W幅(グローバルナビ)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_TOTAL" value="1000px">          <MTIgnore>W幅(メイン総合)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_MAIN" value="575px">            <MTIgnore>W幅(メイン)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_MAIN2" value="770px">           <MTIgnore>W幅(メイン)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_SUB" value="195px">             <MTIgnore>W幅(サイドバー1)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_EXTRA" value="195px">           <MTIgnore>W幅(サイドバー2)</MTIgnore&gt;
<MTSetVar name="WIDTH_FOOTER" value="100%">                   <MTIgnore>W幅(フッタ)</MTIgnore>
</MTIgnore>

<MTIgnore>リキッド(96%で)</MTIgnore>
<MTSetVar name="WIDTH_HEADER" value="100%">                   <MTIgnore>W幅(ヘッダ)</MTIgnore>
<MTSetVar name="WIDTH_BACKGROUND_GLOBALNAVI" value="100%">    <MTIgnore>W幅(グローバルナビ)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_TOTAL" value="90%">             <MTIgnore>W幅(メイン総合)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_MAIN" value="52%">              <MTIgnore>W幅(メイン)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_MAIN2" value="74%">             <MTIgnore>W幅(メイン)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_SUB" value="22%">               <MTIgnore>W幅(サイドバー1)</MTIgnore>
<MTSetVar name="WIDTH_CONTENT_EXTRA" value="22%">             <MTIgnore>W幅(サイドバー2)</MTIgnore>
<MTSetVar name="WIDTH_FOOTER" value="100%">                   <MTIgnore>W幅(フッタ)</MTIgnore>

<MTSetVar name="POSITION_HEADMARGIN_LEFT" value="5%">         <MTIgnore>P位置(サイトタイトル)</MTIgnore>
<MTSetVar name="POSITION_HEADMARGIN_RIGHT" value="5%">        <MTIgnore>P位置(検索)</MTIgnore>

ページ先頭へ
前のエントリ: 変数への適切な代入場所

タグ:MTIgnore,
Variable