Hi Benson,

By changing the faq id, you also change the html anchor generated by the site plugin, so any old links to this faq, eg the one I added today [1], will not work anymore. I suggest to leave the id unchanged.

Cheers,
-Lukas

[1] http://svn.apache.org/viewvc?rev=1170457&view=rev


[email protected] wrote:
Author: bimargulies
Date: Wed Sep 14 12:26:44 2011
New Revision: 1170568

URL: http://svn.apache.org/viewvc?rev=1170568&view=rev
Log:
a little SEO for DocBook users. Arguably XHTML should get the same favor.

Modified:
     maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml

Modified: maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml
URL: 
http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml?rev=1170568&r1=1170567&r2=1170568&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml Wed Sep 14 
12:26:44 2011
@@ -49,15 +49,16 @@ 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>
+<!-- mention docbook explicitly so google can find this -->
+<faq id="How to include a custom Doxia module, like Twiki or Simple DocBook">
+<question>How to include a custom Doxia module, like Twiki or Simple 
DocBook?</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 (or any other 
document format
            for which a doxia parser exists, see the list of
            <a href="http://maven.apache.org/doxia/references/index.html";>Doxia 
Markup Languages</a>),
-          you need to specify the corresponding Doxia dependency, e.g. for 
Twiki:
+          you need to specify the corresponding Doxia module dependency, e.g. 
for Twiki:
          </p>
            <source>
  <![CDATA[<project>
@@ -72,7 +73,7 @@ under the License.
            <dependency>
              <groupId>org.apache.maven.doxia</groupId>
              <artifactId>doxia-module-twiki</artifactId>
-<version><!-- adapt to your site plugin version! --></version>
+<version><!-- doxia version appropriate to the site plugin version 
--></version>
            </dependency>
          </dependencies>
        </plugin>



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to