google-closure - 为什么我的大 bean 模板缺少soyDocs？

Question

当我尝试编译此大 bean 模板时，Plovr is引发了编译时异常。

// 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}).

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

Answer 1

file structure的关闭模板文档指出:

Precede each template with a SoyDoc comment that explains the purpose of the template, in the same style as JavaDoc.

JavaDoc注释必须以开始注释定界符 /**开头，如如何在 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}