maven-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Lukas Theussl <ltheu...@apache.org>
Subject Re: svn commit: r1170568 - /maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml
Date Wed, 14 Sep 2011 14:08:57 GMT

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


bimargulies@apache.org 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: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Mime
View raw message