¿Por qué me falta soyDocs para mi plantilla de soja?

Question

Plovr genera una excepción en tiempo de compilación cuando intento compilar esta plantilla de soja.

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

Aquí está el error.

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

¿Por qué me falta la soja docs para esta plantilla?

Answer 1

La documentación plantillas de cierre de los estados file structure:

Precede cada plantilla con un comentario SoyDoc que explica el propósito de la plantilla, en el mismo estilo que JavaDoc.

comentarios JavaDoc deben comenzar con el delimitador de comentario comenzará-/** como se muestra en Cómo escribir Doc Comentarios para la herramienta Javadoc bajo Format of a Doc Comment.

En el ejemplo de la plantilla anterior falta el segundo asterisco en el comentario de SoyDoc. Debe tener un aspecto como el siguiente:

/** 
* 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. de añadir sobre cpeisert's answer todas las siguientes tres líneas de comentario deben comenzar con la primera columna, es decir, no debe haber ningún espacio en blanco antes de que todo siguiendo tres líneas.

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

2. No debe haber líneas en blanco en el medio de estos códigos comentario doc de soja y de soja (es decir {template .main})

3. {template .main} también debería comienza desde column1, es decir, debe haber ningún espacio en blanco precedente.