Re: svn commit: r1170568 - /maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml

2011-09-14 Thread Lukas Theussl 


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=1170457view=rev


bimargul...@apache.org wrote:

Author: bimargulies
Date: Wed Sep 14 12:26:44 2011
New Revision: 1170568

URL: http://svn.apache.org/viewvc?rev=1170568view=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=1170568r1=1170567r2=1170568view=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
-questionHow 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
+questionHow 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
  groupIdorg.apache.maven.doxia/groupId
  artifactIddoxia-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-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org

Re: svn commit: r1170568 - /maven/plugins/trunk/maven-site-plugin/src/site/fml/faq.fml

2011-09-14 Thread Benson Margulies 
whoops. I'll put it back

On Sep 14, 2011, at 10:09 AM, Lukas Theussl ltheu...@apache.org wrote:


 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=1170457view=rev


 bimargul...@apache.org wrote:
 Author: bimargulies
 Date: Wed Sep 14 12:26:44 2011
 New Revision: 1170568

 URL: http://svn.apache.org/viewvc?rev=1170568view=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=1170568r1=1170567r2=1170568view=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
 -questionHow 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
 +questionHow 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
  groupIdorg.apache.maven.doxia/groupId
  artifactIddoxia-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-unsubscr...@maven.apache.org
 For additional commands, e-mail: dev-h...@maven.apache.org


-
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org