爲什麼我缺少我的大豆模板的soyDocs？

Question

當我嘗試編譯這個大豆模板時，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}). 

爲什麼我缺少這個模板的大豆文檔？

Answer 1

爲file structure國Closure模板文件：

上一頁每個模板與SoyDoc註釋解釋模板的目的，在同一風格的JavaDoc。

JavaDoc註釋必須在顯示如何編寫文檔註釋的Javadoc工具下Format of a 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} 

Answer 2

1. 添加更多cpeisert's answer所有以下三個註釋行應以第一列開始，即應該有之前的所有下面三行沒有空格。

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

2. 應該有這些大豆文檔註釋和大豆代碼中間沒有空行（即{template .main}）

3. {template .main}還應從列1開始，即應該沒有前述空格。