新 Blogger テンプレートのエラーメッセージ一覧

新 Blogger で新テンプレートをいじっているときに表示される、恐怖のエラーメッセージ。

Beta Blogger For Dummies: Error Messages in New Blogger Templates.

に、エラーメッセージについての素晴らしい記事があったので、早速翻訳してみました。

エラーメッセージ自体は、Blogger ダッシュボード表示言語を「日本語」にした場合のものに差し替えてあります。テンプレート作成で注意すべき点がいくつか紹介されているので、これから新 Blogger テンプレートをいじってみようと思っている人は、目を通しておくといいかもしれません。エラーが出てパニックになったときにも読み返してもらえるとうれしいです。

ということで、翻訳開始…。

新 Blogger テンプレートは XML を基にした XHTML でコード化されています。XHTML は HTML より厳しい言語なので、新テンプレートを操作すると以前よりエラーに出会う可能性が高くなっています。

旧 Blogger テンプレートの使用

最も一般的な失敗は、旧 Blogger の HTML テンプレートをテキストボックスに貼り付けるという行為です。「テンプレートを保存」や「プレビュー」ボタンを押すと表示されるエラーメッセージがこちらです。

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The content of elements must consist of well-formed character data or markup.

このエラーメッセージは、HTML テンプレートの「形式が適切でない」ために出されます。新 Blogger 移行後、クラシックテンプレートを選択していない限り、旧 Blogger 用 HTML テンプレートは互換性がありません。

タグの閉じ忘れ

XHTML では、全てのタグに対応する終了タグ必要です。終了タグが欠けていると、次のようなエラーメッセージが出ます。

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The element type "div" must be terminated by the matching end-tag "".

<div> タグに対応する終了タグは </div> です。全てのタグは、スラッシュのついた終了タグで閉じられなければなりません。空要素のタグは、スペースとスラッシュを入れてタグを閉じます（例：<br />）。空要素とは開始タグと終了タグの間に何も含まない要素のことです（例：<img src="valid.gif" />）。

& の使用

属性値でアンパーサンド（半角の＆）を使用する場合には & を使用するべきであって、単純に & という文字を使用してはいけません。& という文字をそのまま使用した場合、次のようなエラーメッセージが表示されます。

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The reference to entity "key" must end with the ';' delimiter.

（または）

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The entity name must immediately follow the '&' in the entity reference.

間違った例： <title>Boys & Girls</title> → 正しい例：<title>Boys & Girls</title>

スクリプトやスタイルの使用

XHTML では、スクリプト要素とスタイル要素は CDATA を持つとされています。そのため < や & は XML プロセッサによってそれら < や & という文字そのものの実体として認識されます。スクリプト要素やスタイル要素の中身は、CDATA セクションで囲むことで、実体の表示を避けることが出来ます。

例：

属性値の不足

全ての属性には値がなければいけません。属性値は全て ' でくくって下さい。そうしないと、次のようなメッセージが表示されます。（クリボウ注：ウィジェットやセクションのタグでエラーが出ます。）

セクションの中に必須の ID 属性がないものがあります。セクションにはそれぞれ固有の ID が必要です。

不適切なネスト（入れ子）

要素は、最後に開始したタグから閉じていく必要があります。間違った例：<em><strong>なんとかかんとか</em></strong> → 正しい例：<em><strong>なんとかかんとか</strong></em>

大小文字の混在したタグ名

XHTML では、大文字小文字は区別されます。もし <HTML> という開始タグを使っていれば、</html> ではなく </HTML> で閉じる必要があります。そうしないと、次のようなエラーメッセージが表示されます。

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The element type "HTML" must be terminated by the matching end-tag "".

変数の未定義

新 Blogger では、テンプレートのフォントや色の設定を変更できるように、変数が使われています。これらの変数は、「Variable definitions（変数定義）」部分で定義されています。定義された変数は CSS コードで使用されます。変数の定義例：

body 要素についての CSS では次のように変数が使われます。例：

body {
background: $bgColor;
}

たとえば、CSS で変数（$rightSbColor）を使用しながら、Variable definitions（変数定義）部でそれを定義していなかった場合には、次のようなエラーメッセージが表示されます。

ページスキンで無効な変数が宣言されています: 定義されていない変数が使用されています。入力: rightSbColor。

ウィジェット ID の重複

もし、テンプレートにすでに存在しているウィジェットと同じ ID を持ったウィジェット（ページ要素）を追加しようとすると、次のようなエラーメッセージが表示されます。（クリボウ注：セクションも同様です。）

ID: LinkList1 のウィジットが複数見つかりました。ウィジット ID は固有である必要があります。

Includable 外のコード

Includable 要素以外にコードを書くと、次のようなエラーメッセージが表示されます。

ID "Blog1" のウィジットに要素 "b:if" を含めることはできません。ウィジットには、b:includable 要素のみ含めることができます。

これを避けるには、b:includable id='main' 要素内にコードを記述してください。

セクション外のウィジェット

ウィジェットはつねにセクション内に書く必要があります。セクション外にウィジェットを書くと、次のようなエラーメッセージが表示されます。

ID HTML1 のウィジットは、セクション内にありません (実際の親要素は div です)。ウィジットはセクション内に存在する必要があります。

これを避けるには、b:section class='sidebar' id='sidebar' のようなセクション要素内に、ウィジェットを記述してください。

データタグの表記

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: The value of attribute "href" associated with an element type "a" must not contain the '<' character.

このエラーメッセージは、次のようなコードを書いたときに起こります。

正しい例：

同様に、

というコードも、エラーが出ます。正しい例はこちらです：

（クリボウ注：データタグは、タグに囲まれて使用される場合と、タグ自体の属性値として使用される場合とで表記の仕方が変わる、ということ。）

クォートなしの属性値

属性の値はクォートで囲む必要があります。そうしないと、次のようなエラーメッセージが表示されます。

テンプレートの形式が適切でないため、解析できませんでした。すべての XML 要素が適切に閉じられているかどうかを確認してください。
XML エラーメッセージ: Open quote is expected for attribute "width" associated with an element type "img".

たとえば img 要素の width 属性は width=56 ではなく width='56' と書く必要があります。クォートはシングルクォート（'）でもダブルクォート（"）でもかまいません。

複数のスキン

スタイルシートを記述するための b:skin 要素を、テンプレート中に２つ以上含むと、このようなエラーメッセージが出ます。

テンプレートにはスキンが 1 つだけ存在する必要があります。スキン 2 が見つかりました。

以上、翻訳終了。…長かったですね。