9

この soy テンプレートをコンパイルしようとすると、Plovr でコンパイル時例外が発生します。

// Copyright 2012 David Faux
/**
 * @overview Lays out the home page.
 */

{namespace templates.home}

/*
 * Lays out the home page.
 */
{template .main}
  <h1>Hi! Welcome to my experimental page.</h1>
  <img src="/images/logo.png" alt="" id="homeLogo" />
{/template}

これが発生したエラーです。

org.plovr.CheckedSoySyntaxException:
template templates.home.main: Not all code is in Soy V2 syntax
(missing SoyDoc for template {template .main}).

このテンプレートの大豆ドキュメントがないのはなぜですか?

4

2 に答える 2

12

ファイル構造に関する Closure Templates ドキュメントには、次のように記載されています。

JavaDoc と同じスタイルで、テンプレートの目的を説明する SoyDoc コメントを各テンプレートの前に付けます。

How to Write Doc Comments for the Javadoc ToolのFormat of a Doc Comment/**に示されているように、JavaDoc コメントは begin-comment 区切り文字で開始する必要があります。

上記のテンプレートの例では、SoyDoc コメントに 2 番目のアスタリスクがありません。次のようになります。

/**
 * Lays out the home page.
 */
{template .main}
  <h1>Hi! Welcome to my experimental page.</h1>
  <img src="/images/logo.png" alt="" id="homeLogo" />
{/template}
于 2012-07-16T03:38:28.110 に答える
6

  1. cpeisert の回答にさらに追加するには 、次の 3 つのコメント行はすべて最初の列から開始する必要があります。つまり、次の 3 行すべての前に空白があってはなりません。

    /**
* Lays out the home page.
*/

  2. これらの soy doc コメントと soy コードの中間に空白行があってはなりません (すなわち {template .main})

  3. {template .main}また、 column1 から開始する必要があります。つまり、先行する空白があってはなりません。

于 2013-07-02T08:34:42.677 に答える