9

当我尝试编译这个大豆模板时,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

文件结构的闭包模板文档指出:

在每个模板之前添加一个解释模板用途的 SoyDoc 注释,其风格与 JavaDoc 相同。

JavaDoc 注释必须以 begin-comment 分隔符开头/**,如如何为 Javadoc 工具编写 Doc 注释中的 Doc Comment 格式下所示。

上面的模板示例在 SoyDoc 注释中缺少第二个星号。它应该如下所示:

/**
 * 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 的答案添加更多内容, 所有以下三个注释行都应以第一列开头,即在所有以下三行之前不应有空格。

    /**
    * Lays out the home page.
    */
    
  2. 这些soy doc注释和soy代码中间不应该有空行(即 {template .main}

  3. {template .main}也应该从 column1 开始,即前面不应该有空格。

于 2013-07-02T08:34:42.677 回答