为什么我的大豆模板缺少 soyDocs？答案

【问题标题】：Why am I missing soyDocs for my soy template?为什么我的大豆模板缺少 soyDocs？
【发布时间】：2012-07-15 23:15:11
【问题描述】：

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

为什么我缺少此模板的大豆文档？

【问题讨论】：

标签： google-closure google-closure-templates

【解决方案1】：

file structure 的闭包模板文档指出：

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

JavaDoc cmets 必须以开始注释分隔符 /** 开头，如 Format of a Doc Comment 下的如何为 Javadoc 工具编写文档注释中所示。

上面的模板示例在 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}

【讨论】：

【解决方案2】：

要在cpeisert's answer 中添加更多内容，所有以下三行注释应以第一列开头，即在所有后续三行之前不应有空格。
```
/**
* Lays out the home page.
*/
```
这些soy doc注释和soy代码中间不能有空行（即{template .main}）
{template .main} 也应该从 column1 开始，即前面不应该有空格。

【讨论】：