You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by de...@apache.org on 2010/08/09 23:09:24 UTC
svn commit: r983825 - in /maven/plugins/branches/maven-site-plugin-3.x: ./
src/site/fml/faq.fml
Author: dennisl
Date: Mon Aug 9 21:09:23 2010
New Revision: 983825
URL: http://svn.apache.org/viewvc?rev=983825&view=rev
Log:
Merge r950463 from trunk.
document validation and entity issues
Modified:
maven/plugins/branches/maven-site-plugin-3.x/ (props changed)
maven/plugins/branches/maven-site-plugin-3.x/src/site/fml/faq.fml
Propchange: maven/plugins/branches/maven-site-plugin-3.x/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Mon Aug 9 21:09:23 2010
@@ -1 +1 @@
-/maven/plugins/trunk/maven-site-plugin:801155,801171,801470,806898-806906,807943-808180,809252,810298,884137,886844,886847,890094,890124,891014,891688,920027,942622,943455,944145,956681
+/maven/plugins/trunk/maven-site-plugin:801155,801171,801470,806898-806906,807943-808180,809252,810298,884137,886844,886847,890094,890124,891014,891688,920027,942622,943455,944145,950463,956681
Modified: maven/plugins/branches/maven-site-plugin-3.x/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/branches/maven-site-plugin-3.x/src/site/fml/faq.fml?rev=983825&r1=983824&r2=983825&view=diff
==============================================================================
--- maven/plugins/branches/maven-site-plugin-3.x/src/site/fml/faq.fml (original)
+++ maven/plugins/branches/maven-site-plugin-3.x/src/site/fml/faq.fml Mon Aug 9 21:09:23 2010
@@ -21,6 +21,7 @@ under the License.
<faqs xmlns="http://maven.apache.org/FML/1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/FML/1.0 http://maven.apache.org/xsd/fml-1.0.xsd" id="FAQ" title="Frequently Asked Questions">
<part id="General">
+ <title>General</title>
<faq id="What is the difference between mvn site and mvn site:site">
<question>What is the difference between <i>mvn site</i> and <i>mvn site:site</i>?</question>
<answer>
@@ -48,6 +49,62 @@ under the License.
</ul>
</answer>
</faq>
+ <faq id="How to include a custom Doxia module, like Twiki">
+ <question>How to include a custom Doxia module, like Twiki?</question>
+ <answer>
+ <p>
+ The site plugin handles out-of-box apt, xdoc and fml formats. If you
+ want to use a custom format like Twiki, you need to specify the
+ Doxia Twiki dependency, i.e.:
+ <source>
+<![CDATA[<project>
+ ...
+ <build>
+ <plugins>
+ ...
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.maven.doxia</groupId>
+ <artifactId>doxia-module-twiki</artifactId>
+ <version>1.0</version>
+ </dependency>
+ </dependencies>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+</project>]]></source>
+ </p>
+ </answer>
+ </faq>
+ <faq id="Can_I_validate_xml">
+ <question>How can I validate my xdoc/fml source files?</question>
+ <answer>
+ <p>
+ Since version 2.1.1 of the site plugin, there is a <code>validate</code>
+ configuration parameter that switches on xml validation (default is off).
+ Note that in the current implementation of the parser used by Doxia,
+ validation requires an independent parsing run, so that every source
+ file is actually parsed twice when validation is switched on.
+ </p>
+ <p>
+ If validation is switched on, <strong>all</strong> xml source
+ files need a correct schema and/or DTD definition.
+ See the Doxia documentation on
+ <a href="http://maven.apache.org/doxia/references/xdoc-format.html#Validation">validating xdocs</a>,
+ and the schema definitions for
+ <a href="http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/using-xdoc-xsd.html">xdoc</a>
+ and
+ <a href="http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-fml/using-fml-xsd.html">fml</a>.
+ </p>
+ </answer>
+ </faq>
+ </part>
+ <part id="Specific_issues">
+ <title>Specific issues</title>
<faq id="Why do my absolute links get translated into relative links">
<question>Why do my absolute links get translated into relative links?</question>
<answer>
@@ -91,36 +148,22 @@ under the License.
</p>
</answer>
</faq>
- <faq id="How to include a custom Doxia module, like Twiki">
- <question>How to include a custom Doxia module, like Twiki?</question>
+ <faq id="Can_I_use_entities">
+ <question>Can I use entities in xdoc/fml source files?</question>
<answer>
<p>
- The site plugin handles out-of-box apt, xdoc and fml formats. If you
- want to use a custom format like Twiki, you need to specify the
- Doxia Twiki dependency, i.e.:
- <source>
-<![CDATA[<project>
- ...
- <build>
- <plugins>
- ...
- <plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-site-plugin</artifactId>
- <dependencies>
- <dependency>
- <groupId>org.apache.maven.doxia</groupId>
- <artifactId>doxia-module-twiki</artifactId>
- <version>1.0</version>
- </dependency>
- </dependencies>
- </plugin>
- </plugins>
- </build>
- ...
-</project>]]></source>
+ Yes. Entity resolution has been added in Doxia version 1.1, available
+ in site plugin 2.1 and later.
+ </p>
+ <p>
+ There is a catch however. In the current implementation (as of site-plugin-2.1.1),
+ entities are only resolved by an independent
+ <a href="#Can_I_validate_xml">validation</a> run.
+ Therefore, if you want to use entities, you <strong>have</strong> to switch on
+ validation for your xml source files.
+ See <a href="http://jira.codehaus.org/browse/MSITE-483">MSITE-483</a>.
</p>
</answer>
</faq>
</part>
-</faqs>
\ No newline at end of file
+</faqs>