なぜ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}). 

なぜこのテンプレート用のsoyドキュメントがありませんか？

Answer 1

file structure状態の閉鎖テンプレートのドキュメント：

はJavaDocのと同じスタイルで、テンプレートの目的を説明SoyDocのコメントで各テンプレートを先行します。 Format of a Doc Comment下Javadocツールののdocコメントの記述方法をに示すよう

Javadocコメントが始まり、コメント区切り文字/**で開始する必要があります。

上記テンプレートの例では、SoyDocコメントに2番目のアスタリスクがありません。これは次のようになります。

/** 
* 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にもっと追加する前に、すべての3つの行を次のように空白があってはなりません。

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

2. これら大豆docコメントおよび大豆コード（すなわち{template .main}）

3. {template .main}の中央には空白行があってはならない、また、すなわちそこがない空白を先行する必要があり、COLUMN1から始まるべきではありません。