I just tried to compile the docs, and as I suspected, there are many errors. These errors need to be corrected before it can compile, and before it can be included in the online docs. You can download the distro and try to compile them yourself and fix the problems. The XML files MUST be utf8 encoded, and there MUST be no syntax errors. Here is the error list from the first attempt to compile:
make LANG=zh_CN html
rm -f current_lang
ln -s zh_CN current_lang
sed "s/{DATE}/`date '+%Y-%m-%d'`/" entities/version.ent.in > entities/version.ent
rm -rf manual-zh_CN
/usr/bin/xmlto html \
-o manual-zh_CN \
--stringparam use.id.as.filename=1 \
--stringparam chunker.output.encoding='UTF-8' \
--stringparam chunker.output.indent='yes' \
-x /usr/share/xml/docbook/stylesheet/docbook-xsl/html/chunk.xsl \
manual.xml
xmlto: /home/mohrt/www/Smarty3Dev/documentation/manual.xml does not validate (status 1)
xmlto: Fix document syntax or use --skip-validation option
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax/language-syntax-functions.xml:7: parser error : Opening and ending tag mismatch: para line 5 and link
link linkend="language.variables">变量</link>或者调用
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax/language-syntax-functions.xml:12: parser error : Opening and ending tag mismatch: sect1 line 3 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax/language-syntax-functions.xml:60: parser error : chunk is not well balanced
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax/language-syntax-functions.xml:60: parser error : chunk is not well balanced
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax.xml:18: parser error : Failure to process entity designers.language-basic-syntax.language-syntax-functions
&designers.language-basic-syntax.language-syntax-functions;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax.xml:18: parser error : Entity 'designers.language-basic-syntax.language-syntax-functions' not defined
&designers.language-basic-syntax.language-syntax-functions;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-ba sic-syntax.xml:45: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:41: parser error : Failure to process entity designers.language-basic-syntax
&designers.language-basic-syntax;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:41: parser error : Entity 'designers.language-basic-syntax' not defined
&designers.language-basic-syntax;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers/language-modifier-strip.xml:13: parser error : Opening and ending tag mismatch: para line 10 and link
linkend="language.function.strip"><varname>{strip}</varname></link> 函数?
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers/language-modifier-strip.xml:14: parser error : Opening and ending tag mismatch: note line 8 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers/language-modifier-strip.xml:15: parser error : Opening and ending tag mismatch: sect1 line 3 and note
</note>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers/language-modifier-strip.xml:55: parser error : chunk is not well balanced
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers/language-modifier-strip.xml:55: parser error : chunk is not well balanced
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers.xml:131: parser error : Failure to process entity designers.language-modifiers.language-modifier-strip
&designers.language-modifiers.language-modifier-strip;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers.xml:131: parser error : Entity 'designers.language-modifiers.language-modifier-strip' not defined
&designers.language-modifiers.language-modifier-strip;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-mo difiers.xml:161: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:43: parser error : Failure to process entity designers.language-modifiers
&designers.language-modifiers;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:43: parser error : Entity 'designers.language-modifiers' not defined
&designers.language-modifiers;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions/language-function-block.xml:257: parser error : Opening and ending tag mismatch: para line 9 and sect1
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions/language-function-block.xml:279: parser error : Premature end of data in tag sect1 line 3
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions/language-function-block.xml:279: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions.xml:25: parser error : Failure to process entity designers.language-builtin-functions.language-function-block
&designers.language-builtin-functions.language-function-block;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions.xml:25: parser error : Entity 'designers.language-builtin-functions.language-function-block' not defined
&designers.language-builtin-functions.language-function-block;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/language-bu iltin-functions.xml:68: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:45: parser error : Failure to process entity designers.language-builtin-functions
&designers.language-builtin-functions;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:45: parser error : Entity 'designers.language-builtin-functions' not defined
&designers.language-builtin-functions;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:16: parser error : Opening and ending tag mismatch: para line 12 and link
<parameter>$debug_tpl</parameter></link>指向
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:20: parser error : Opening and ending tag mismatch: chapter line 3 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:42: parser error : Opening and ending tag mismatch: link line 38 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:43: parser error : Opening and ending tag mismatch: para line 35 and note
</note>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:53: parser error : Opening and ending tag mismatch: note line 33 and chapter
</chapter>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/designers/chapter-deb ugging-console.xml:77: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:48: parser error : Failure to process entity designers.chapter-debugging-console
&designers.chapter-debugging-console;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:48: parser error : Entity 'designers.chapter-debugging-console' not defined
&designers.chapter-debugging-console;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles/variable-default-config-type.xml:12: parser error : Opening and ending tag mismatch: para line 5 and sect1
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles/variable-default-config-type.xml:32: parser error : Premature end of data in tag sect1 line 3
-->
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles/variable-default-config-type.xml:32: parser error : chunk is not well balanced
-->
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles.xml:44: parser error : Failure to process entity programmers.api-variables.variable-default-config-type
&programmers.api-variables.variable-default-config-type;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles.xml:44: parser error : Entity 'programmers.api-variables.variable-default-config-type' not defined
&programmers.api-variables.variable-default-config-type;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/api-varia bles.xml:86: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:56: parser error : Failure to process entity programmers.api-variables
&programmers.api-variables;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:56: parser error : Entity 'programmers.api-variables' not defined
&programmers.api-variables;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources /resources-file.xml:21: parser error : Opening and ending tag mismatch: link line 18 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources /resources-file.xml:22: parser error : Opening and ending tag mismatch: para line 16 and note
</note>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources /resources-file.xml:183: parser error : Opening and ending tag mismatch: note line 14 and sect1
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources /resources-file.xml:205: parser error : Premature end of data in tag sect1 line 3
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources /resources-file.xml:205: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources .xml:14: parser error : Failure to process entity programmers.resources.resources-file
&programmers.resources.resources-file;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources .xml:14: parser error : Entity 'programmers.resources.resources-file' not defined
&programmers.resources.resources-file;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/resources .xml:40: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:59: parser error : Failure to process entity programmers.resources
&programmers.resources;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:59: parser error : Entity 'programmers.resources' not defined
&programmers.resources;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features/advanced-features-template-inheritance.xml:115: parser error : Opening and ending tag mismatch: link line 114 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features/advanced-features-template-inheritance.xml:126: parser error : Opening and ending tag mismatch: para line 111 and example
</example>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features/advanced-features-template-inheritance.xml:133: parser error : Opening and ending tag mismatch: example line 109 and sect1
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features/advanced-features-template-inheritance.xml:155: parser error : Premature end of data in tag sect1 line 3
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features/advanced-features-template-inheritance.xml:155: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features.xml:7: parser error : Failure to process entity programmers.advanced-features.advanced-features-template-inheritance
&programmers.advanced-features.advanced-features-template-inheritance;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features.xml:7: parser error : Entity 'programmers.advanced-features.advanced-features-template-inheritance' not defined
&programmers.advanced-features.advanced-features-template-inheritance;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/programmers/advanced- features.xml:35: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:60: parser error : Failure to process entity programmers.advanced-features
&programmers.advanced-features;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:60: parser error : Entity 'programmers.advanced-features' not defined
&programmers.advanced-features;
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/appendixes/tips.xml:5 1: parser error : Opening and ending tag mismatch: link line 49 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/appendixes/tips.xml:6 8: parser error : Opening and ending tag mismatch: para line 48 and sect1
</sect1>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/appendixes/tips.xml:1 86: parser error : Opening and ending tag mismatch: para line 185 and link
当在模板内使用<varname>{html_select_date}</varname></link>,
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/appendixes/tips.xml:1 88: parser error : Opening and ending tag mismatch: sect1 line 138 and para
</para>
^
/home/mohrt/www/Smarty3Dev/documentation/current_lang/appendixes/tips.xml:4 15: parser error : chunk is not well balanced
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:68: parser error : Failure to process entity appendixes.tips
&appendixes.tips;
^
/home/mohrt/www/Smarty3Dev/documentation/manual.xml:68: parser error : Entity 'appendixes.tips' not defined
&appendixes.tips;
^
make: *** [html] Error 11
On Jun 14, 2012, at 8:01 PM, jake wrote: