svn commit: r1829011 [1/12] - in /maven/doxia/website/content: ./ book/ css/ developers/ doxia-example-book/ fonts/ images/ images/logos/ images/profiles/ img/ issues/ js/ macros/ modules/ references/

Thu, 12 Apr 2018 14:22:37 -0700 

Author: svn-site-role
Date: Thu Apr 12 21:22:02 2018
New Revision: 1829011

URL: http://svn.apache.org/viewvc?rev=1829011&view=rev
Log:
Site checkin for project Doxia Site

Added:
    maven/doxia/website/content/.htaccess
    maven/doxia/website/content/book/
    maven/doxia/website/content/book/index.html
    maven/doxia/website/content/components.links
    maven/doxia/website/content/css/
    maven/doxia/website/content/css/apache-maven-fluido-1.7.min.css
    maven/doxia/website/content/css/print.css
    maven/doxia/website/content/css/site.css
    maven/doxia/website/content/developers/
    maven/doxia/website/content/developers/index.html
    maven/doxia/website/content/developers/macros.html
    maven/doxia/website/content/developers/maven-integration.html
    maven/doxia/website/content/developers/modules.html
    maven/doxia/website/content/developers/sink.html
    maven/doxia/website/content/doap_Doxia.rdf
    maven/doxia/website/content/downloads.html
    maven/doxia/website/content/doxia   (with props)
    maven/doxia/website/content/doxia-1.8.pdf   (with props)
    maven/doxia/website/content/doxia-archives   (with props)
    maven/doxia/website/content/doxia-example-book/
    maven/doxia/website/content/doxia-example-book/aegis-binding.html
    maven/doxia/website/content/doxia-example-book/bind.html
    maven/doxia/website/content/doxia-example-book/bindings.html
    maven/doxia/website/content/doxia-example-book/castor.html
    maven/doxia/website/content/doxia-example-book/doxia-example-book.pdf   
(with props)
    maven/doxia/website/content/doxia-example-book/doxia-example-book.rtf
    maven/doxia/website/content/doxia-example-book/http-transport.html
    maven/doxia/website/content/doxia-example-book/index.html
    maven/doxia/website/content/doxia-example-book/jms-transport.html
    maven/doxia/website/content/doxia-example-book/local-transport.html
    
maven/doxia/website/content/doxia-example-book/transport-and-channel-api.html
    maven/doxia/website/content/doxia-example-book/transports.html
    maven/doxia/website/content/doxia-ide   (with props)
    maven/doxia/website/content/doxia-ide.html
    maven/doxia/website/content/doxia-sitetools   (with props)
    maven/doxia/website/content/doxia-sitetools-archives   (with props)
    maven/doxia/website/content/doxia-tools   (with props)
    maven/doxia/website/content/doxia-tools-archives   (with props)
    maven/doxia/website/content/faq.html
    maven/doxia/website/content/fonts/
    maven/doxia/website/content/fonts/glyphicons-halflings-regular.eot   (with 
props)
    maven/doxia/website/content/fonts/glyphicons-halflings-regular.svg
    maven/doxia/website/content/fonts/glyphicons-halflings-regular.ttf   (with 
props)
    maven/doxia/website/content/fonts/glyphicons-halflings-regular.woff   (with 
props)
    maven/doxia/website/content/images/
    maven/doxia/website/content/images/accessories-text-editor.png   (with 
props)
    maven/doxia/website/content/images/add.gif   (with props)
    maven/doxia/website/content/images/apache-maven-project-2.png   (with props)
    maven/doxia/website/content/images/application-certificate.png   (with 
props)
    maven/doxia/website/content/images/architecture.odg   (with props)
    maven/doxia/website/content/images/architecture.png   (with props)
    maven/doxia/website/content/images/contact-new.png   (with props)
    maven/doxia/website/content/images/document-properties.png   (with props)
    maven/doxia/website/content/images/doxia-logo.png   (with props)
    maven/doxia/website/content/images/doxia-logo.svg
    maven/doxia/website/content/images/drive-harddisk.png   (with props)
    maven/doxia/website/content/images/fix.gif   (with props)
    maven/doxia/website/content/images/icon_error_sml.gif   (with props)
    maven/doxia/website/content/images/icon_help_sml.gif   (with props)
    maven/doxia/website/content/images/icon_info_sml.gif   (with props)
    maven/doxia/website/content/images/icon_success_sml.gif   (with props)
    maven/doxia/website/content/images/icon_warning_sml.gif   (with props)
    maven/doxia/website/content/images/image-x-generic.png   (with props)
    maven/doxia/website/content/images/internet-web-browser.png   (with props)
    maven/doxia/website/content/images/logos/
    maven/doxia/website/content/images/logos/build-by-maven-black.png   (with 
props)
    maven/doxia/website/content/images/logos/build-by-maven-white.png   (with 
props)
    maven/doxia/website/content/images/logos/maven-feather.png   (with props)
    maven/doxia/website/content/images/network-server.png   (with props)
    maven/doxia/website/content/images/package-x-generic.png   (with props)
    maven/doxia/website/content/images/profiles/
    maven/doxia/website/content/images/profiles/pre-release.png   (with props)
    maven/doxia/website/content/images/profiles/retired.png   (with props)
    maven/doxia/website/content/images/profiles/sandbox.png   (with props)
    maven/doxia/website/content/images/remove.gif   (with props)
    maven/doxia/website/content/images/rss.png   (with props)
    maven/doxia/website/content/images/update.gif   (with props)
    maven/doxia/website/content/images/window-new.png   (with props)
    maven/doxia/website/content/img/
    maven/doxia/website/content/img/glyphicons-halflings-white.png   (with 
props)
    maven/doxia/website/content/img/glyphicons-halflings.png   (with props)
    maven/doxia/website/content/index.html
    maven/doxia/website/content/integration.html
    maven/doxia/website/content/issue-tracking.html
    maven/doxia/website/content/issues/
    maven/doxia/website/content/issues/index.html
    maven/doxia/website/content/js/
    maven/doxia/website/content/js/apache-maven-fluido-1.7.min.js
    maven/doxia/website/content/macros/
    maven/doxia/website/content/macros/index.html
    maven/doxia/website/content/macros/swf-macro.html
    maven/doxia/website/content/mail-lists.html
    maven/doxia/website/content/modules/
    maven/doxia/website/content/modules/index.html
    maven/doxia/website/content/overview.html
    maven/doxia/website/content/project-info.html
    maven/doxia/website/content/references/
    maven/doxia/website/content/references/apt-format.html
    maven/doxia/website/content/references/doxia-apt.html
    maven/doxia/website/content/references/fml-format.html
    maven/doxia/website/content/references/index.html
    maven/doxia/website/content/references/xdoc-format.html
    maven/doxia/website/content/resources.html
    maven/doxia/website/content/source-repository.html
    maven/doxia/website/content/team-list.html
    maven/doxia/website/content/upgrading.html
    maven/doxia/website/content/whatsnew-1.1.html

Added: maven/doxia/website/content/.htaccess
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/.htaccess?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/.htaccess (added)
+++ maven/doxia/website/content/.htaccess Thu Apr 12 21:22:02 2018
@@ -0,0 +1,8 @@
+RedirectMatch permanent ^/doxia/doxia-1.2/(.*)$ 
/doxia/doxia-archives/doxia-1.2/$1
+RedirectMatch permanent ^/doxia/doxia-sitetools-1.2 
/doxia/doxia-sitetools-archives/doxia-sitetools-1.2/$1
+Redirect Permanent /doxia/doxia-ide/index.html  /doxia/doxia-ide.html
+# support resources pointed from /doxia/*-archives/
+Redirect Permanent /doxia/images/apache-maven-project.png  
/images/apache-maven-project.png
+RedirectMatch permanent ^/doxia/.*-archives/images/(.*)$ /doxia/images/$1
+RedirectMatch permanent ^/doxia/.*-archives/css/(.*)$ /doxia/css/$1
+#RedirectMatch permanent ^/doxia/.*-archives/index.html$ /doxia/index.html

Added: maven/doxia/website/content/book/index.html
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/book/index.html?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/book/index.html (added)
+++ maven/doxia/website/content/book/index.html Thu Apr 12 21:22:02 2018
@@ -0,0 +1,265 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.8 from 
content/apt/book/index.apt at 2018-04-12
+ | Rendered using Apache Maven Fluido Skin 1.7
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Trygve Laugstol
+Vincent Siveton" />
+    <meta name="Date-Creation-yyyymmdd" content="20120413" />
+    <meta name="Date-Revision-yyyymmdd" content="20180412" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Doxia &#x2013; Writing Books in Doxia</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+    <script type="text/javascript" 
src="../js/apache-maven-fluido-1.7.min.js"></script>
+    <!-- Google Analytics -->
+    <script type="text/javascript">
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 
'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 
'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; 
s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  </head>
+  <body class="topBarDisabled">
+    <div class="container-fluid">
+      <div id="banner">
+        <div class="pull-left"><a href="https://www.apache.org/"; 
id="bannerLeft"><img src="../../images/apache-maven-project.png"  alt="Doxia 
Site"/></a></div>
+        <div class="pull-right"><a href=".././" id="bannerRight"><img 
src="../images/doxia-logo.png"  alt="Doxia"/></a></div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+      <li class=""><a href="https://www.apache.org/"; class="externalLink" 
title="Apache">Apache</a><span class="divider">/</span></li>
+      <li class=""><a href="../../index.html" title="Maven">Maven</a><span 
class="divider">/</span></li>
+      <li class=""><a href="http://maven.apache.org/doxia/index.html"; 
class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li>
+    <li class="active ">Writing Books in Doxia</li>
+        <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li>
+        </ul>
+      </div>
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+    <ul class="nav nav-list">
+      <li class="nav-header">About Doxia</li>
+    <li><a href="../index.html" title="What is Doxia?"><span 
class="none"></span>What is Doxia?</a></li>
+    <li><a href="../overview.html" title="Overview"><span 
class="none"></span>Overview</a></li>
+    <li><a href="../upgrading.html" title="Upgrading"><span 
class="icon-chevron-right"></span>Upgrading</a></li>
+    <li><a href="../downloads.html" title="Downloads"><span 
class="none"></span>Downloads</a></li>
+    <li><a href="../faq.html" title="FAQ"><span 
class="none"></span>FAQ</a></li>
+      <li class="nav-header">Documentation</li>
+    <li><a href="../references/index.html" title="Format References"><span 
class="icon-chevron-right"></span>Format References</a></li>
+    <li><a href="../modules/index.html" title="Doxia Modules Guide"><span 
class="none"></span>Doxia Modules Guide</a></li>
+    <li><a href="../macros/index.html" title="Doxia Macros Guide"><span 
class="none"></span>Doxia Macros Guide</a></li>
+    <li class="active"><a href="#"><span class="none"></span>Writing 
Books</a></li>
+    <li><a href="../issues/index.html" title="Issues &amp; Gotchas"><span 
class="none"></span>Issues &amp; Gotchas</a></li>
+    <li><a href="../resources.html" title="External Resources"><span 
class="none"></span>External Resources</a></li>
+      <li class="nav-header">Developer Docs</li>
+    <li><a href="../developers/index.html" title="Developer Centre"><span 
class="icon-chevron-right"></span>Developer Centre</a></li>
+    <li><a href="../doxia/index.html" title="Doxia 1.8"><span 
class="icon-chevron-down"></span>Doxia 1.8</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia/index.html" title="Doxia base"><span 
class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span 
class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.5"><span 
class="icon-chevron-down"></span>Doxia 1.5</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span 
class="none"></span>Doxia Tools</a></li>
+    <li><a href="../doxia-ide.html" title="Doxia IDE"><span 
class="none"></span>Doxia IDE</a></li>
+      <li class="nav-header">Project Documentation</li>
+    <li><a href="../project-info.html" title="Project Information"><span 
class="icon-chevron-right"></span>Project Information</a></li>
+      <li class="nav-header">Maven Projects</li>
+    <li><a href="../../archetype/index.html" title="Archetype"><span 
class="none"></span>Archetype</a></li>
+    <li><a href="../../resolver/index.html" title="Artifact Resolver"><span 
class="none"></span>Artifact Resolver</a></li>
+    <li><a href="../index.html" title="Doxia"><span 
class="none"></span>Doxia</a></li>
+    <li><a href="../../jxr/index.html" title="JXR"><span 
class="none"></span>JXR</a></li>
+    <li><a href="../../ref/current" title="Maven"><span 
class="none"></span>Maven</a></li>
+    <li><a href="../../pom/index.html" title="Parent POMs"><span 
class="none"></span>Parent POMs</a></li>
+    <li><a href="../../plugins/index.html" title="Plugins"><span 
class="none"></span>Plugins</a></li>
+    <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span 
class="none"></span>Plugin Testing</a></li>
+    <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span 
class="none"></span>Plugin Tools</a></li>
+    <li><a href="../../apache-resource-bundles/index.html" title="Resource 
Bundles"><span class="none"></span>Resource Bundles</a></li>
+    <li><a href="../../scm/index.html" title="SCM"><span 
class="none"></span>SCM</a></li>
+    <li><a href="../../shared/index.html" title="Shared Components"><span 
class="none"></span>Shared Components</a></li>
+    <li><a href="../../skins/index.html" title="Skins"><span 
class="none"></span>Skins</a></li>
+    <li><a href="../../surefire/index.html" title="Surefire"><span 
class="none"></span>Surefire</a></li>
+    <li><a href="../../wagon/index.html" title="Wagon"><span 
class="none"></span>Wagon</a></li>
+      <li class="nav-header">ASF</li>
+    <li><a href="https://www.apache.org/foundation/how-it-works.html"; 
class="externalLink" title="How Apache Works"><span class="none"></span>How 
Apache Works</a></li>
+    <li><a href="https://www.apache.org/foundation/"; class="externalLink" 
title="Foundation"><span class="none"></span>Foundation</a></li>
+    <li><a href="https://www.apache.org/foundation/sponsorship.html"; 
class="externalLink" title="Sponsoring Apache"><span 
class="none"></span>Sponsoring Apache</a></li>
+    <li><a href="https://www.apache.org/foundation/thanks.html"; 
class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+</ul>
+<form id="search-form" action="https://www.google.com/search"; method="get" >
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript">asyncJs( 
'https://cse.google.com/brand?form=search-form' )</script>
+          <hr />
+          <div id="poweredBy">
+            <div class="clear"></div>
+            <div class="clear"></div>
+    <div id="twitter">
+    <a href="https://twitter.com/ASFMavenProject"; 
class="twitter-follow-button" data-show-count="false" data-align="left" 
data-size="medium" data-show-screen-name="true" data-lang="en">Follow 
ASFMavenProject</a>
+    <script type="text/javascript">!function(d,s,id){var 
js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+    </div>
+            <div class="clear"></div>
+            <div class="clear"></div>
+<a href="http://maven.apache.org/"; title="Built by Maven" 
class="poweredBy"><img class="builtBy" alt="Built by Maven" 
src="../images/logos/maven-feather.png" /></a>
+            </div>
+          </div>
+        </div>
+        <div id="bodyColumn"  class="span10" >
+<div class="section">
+<h2><a name="Introduction"></a>Introduction</h2>
+<p>Doxia allows you to write books like user manuals and guides in any format 
supported by Doxia. Combined with the Doxia Book Maven you are able to include 
the manuals directly in your generated site with links to the off-line friendly 
formats like XDoc, PDF, RTF and LaTeX.</p>
+<p>The Xdoc output which has been rendered into this site can be viewed <a 
href="../doxia-example-book/index.html">here</a>.</p>
+<p>The generated PDF is <a 
href="../doxia-example-book/doxia-example-book.pdf">here</a> and the generated 
RTF <a href="../doxia-example-book/doxia-example-book.rtf">here</a>.</p>
+<div class="section">
+<h3><a name="How_It_Works"></a>How It Works</h3>
+<p>The only thing you need in addition to the content files itself is a simple 
book descriptor which is used to specify the ordering of the sections and the 
names for the chapters.</p>
+<p>See <a href="../doxia-tools/doxia-book-renderer/book.html">The Book 
Descriptor Reference</a> for a reference to the descriptor.</p></div>
+<div class="section">
+<h3><a name="Creating_a_Book_Descriptor"></a>Creating a Book Descriptor</h3>
+<p>An XML file is used to describe the layout of the book.</p>
+<p>A sample is given below:</p>
+<div class="source"><pre class="prettyprint linenums">&lt;book 
xmlns=&quot;http://maven.apache.org/BOOK/1.0.0&quot;
+ xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+ xsi:schemaLocation=&quot;http://maven.apache.org/BOOK/1.0.0 
http://maven.apache.org/xsd/book-1.0.0.xsd&quot;&gt;
+  &lt;id&gt;doxia-example-book&lt;/id&gt;
+  &lt;title&gt;XFire User Manual&lt;/title&gt;
+  &lt;chapters&gt;
+    &lt;chapter&gt;
+      &lt;id&gt;bind&lt;/id&gt;
+      &lt;title&gt;Bindings&lt;/title&gt;
+      &lt;sections&gt;
+        &lt;section&gt;
+          &lt;id&gt;bindings&lt;/id&gt;
+        &lt;/section&gt;
+        &lt;section&gt;
+          &lt;id&gt;aegis-binding&lt;/id&gt;
+        &lt;/section&gt;
+        &lt;section&gt;
+          &lt;id&gt;castor&lt;/id&gt;
+        &lt;/section&gt;
+      &lt;/sections&gt;
+    &lt;/chapter&gt;
+    &lt;chapter&gt;
+      &lt;id&gt;transports&lt;/id&gt;
+      &lt;title&gt;Transports&lt;/title&gt;
+      &lt;sections&gt;
+        &lt;section&gt;
+          &lt;id&gt;transport-and-channel-api&lt;/id&gt;
+        &lt;/section&gt;
+        &lt;section&gt;
+          &lt;id&gt;http-transport&lt;/id&gt;
+        &lt;/section&gt;
+        &lt;section&gt;
+          &lt;id&gt;jms-transport&lt;/id&gt;
+        &lt;/section&gt;
+        &lt;section&gt;
+          &lt;id&gt;local-transport&lt;/id&gt;
+        &lt;/section&gt;
+      &lt;/sections&gt;
+    &lt;/chapter&gt;
+  &lt;/chapters&gt;
+&lt;/book&gt;
+</pre></div></div>
+<div class="section">
+<h3><a name="Configuring_Doxia_Book_Maven_Plugin"></a>Configuring Doxia Book 
Maven Plugin</h3>
+<p>This example illustrates how to configure the Doxia Book Maven Plugin. It 
will render the book in three different formats. By default the output will be 
under <tt>target/generated-site/&lt;format&gt;/&lt;book id&gt; </tt>.</p>
+<p>The currently supported format ids are: <tt>xdoc</tt>, <tt>pdf</tt>, 
<tt>latex</tt>, <tt>rtf</tt>, <tt>xhtml</tt>, <tt>doc-book</tt></p>
+<p>A sample <tt>pom.xml</tt> is given below:</p>
+<div class="source"><pre class="prettyprint linenums">&lt;plugin&gt;
+  &lt;groupId&gt;org.apache.maven.doxia&lt;/groupId&gt;
+  &lt;artifactId&gt;doxia-book-maven-plugin&lt;/artifactId&gt;
+  &lt;version&gt;1.3-SNAPSHOT&lt;/version&gt;
+  &lt;executions&gt;
+    &lt;execution&gt;
+      &lt;phase&gt;pre-site&lt;/phase&gt;
+      &lt;goals&gt;
+        &lt;goal&gt;render-books&lt;/goal&gt;
+      &lt;/goals&gt;
+    &lt;/execution&gt;
+  &lt;/executions&gt;
+  &lt;configuration&gt;
+    &lt;books&gt;
+      &lt;book&gt;
+        &lt;directory&gt;content/books/example-book&lt;/directory&gt;
+        &lt;descriptor&gt;content/books/example-book.xml&lt;/descriptor&gt;
+        &lt;formats&gt;
+          &lt;format&gt;
+            &lt;id&gt;latex&lt;/id&gt;
+          &lt;/format&gt;
+          &lt;format&gt;
+            &lt;id&gt;xdoc&lt;/id&gt;
+          &lt;/format&gt;
+          &lt;format&gt;
+            &lt;id&gt;pdf&lt;/id&gt;
+          &lt;/format&gt;
+          &lt;format&gt;
+            &lt;id&gt;rtf&lt;/id&gt;
+          &lt;/format&gt;
+        &lt;/formats&gt;
+      &lt;/book&gt;
+    &lt;/books&gt;
+  &lt;/configuration&gt;
+&lt;/plugin&gt;
+</pre></div></div></div>
+        </div>
+      </div>
+    </div>
+    <hr/>
+    <footer>
+      <div class="container-fluid">
+        <div class="row-fluid">
+            <p>Copyright &copy;2005&#x2013;2018
+<a href="https://www.apache.org/";>The Apache Software Foundation</a>.
+All rights reserved.</p>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file

Added: maven/doxia/website/content/components.links
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/components.links?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/components.links (added)
+++ maven/doxia/website/content/components.links Thu Apr 12 21:22:02 2018
@@ -0,0 +1,9 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in https://maven.apache.org/doxia/components/
+doxia=components/doxia
+doxia-archives=components/doxia-archives
+doxia-sitetools=components/doxia-sitetools
+doxia-sitetools-archives=components/doxia-sitetools-archives
+doxia-ide=components/doxia-ide
+doxia-tools=components/doxia-tools
+doxia-tools-archives=components/doxia-tools-archives

Added: maven/doxia/website/content/css/apache-maven-fluido-1.7.min.css
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/css/apache-maven-fluido-1.7.min.css?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/css/apache-maven-fluido-1.7.min.css (added)
+++ maven/doxia/website/content/css/apache-maven-fluido-1.7.min.css Thu Apr 12 
21:22:02 2018
@@ -0,0 +1,17 @@
+/*!
+ * Bootstrap v2.3.2
+ *
+ * Copyright 2013 Twitter, Inc
+ * Licensed under the Apache License v2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Designed and built with all the love in the world by @mdo and @fat.

[... 11 lines stripped ...]
Added: maven/doxia/website/content/css/print.css
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/css/print.css?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/css/print.css (added)
+++ maven/doxia/website/content/css/print.css Thu Apr 12 21:22:02 2018
@@ -0,0 +1,23 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/* $Id$ */
+
+#banner, #footer, #leftcol, #breadcrumbs, .docs #toc, .docs .courtesylinks, 
#leftColumn, #navColumn {display: none !important;}
+#bodyColumn, body.docs div.docs {margin: 0 !important;border: none !important}
\ No newline at end of file

Added: maven/doxia/website/content/css/site.css
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/css/site.css?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/css/site.css (added)
+++ maven/doxia/website/content/css/site.css Thu Apr 12 21:22:02 2018
@@ -0,0 +1,37 @@
+a.externalLink, a.externalLink:link, a.externalLink:visited, 
a.externalLink:active, a.externalLink:hover {
+  background: none;
+  padding-right: 0;
+}
+
+body ul {
+  list-style-type: square;
+}
+
+#downloadbox {
+  float: right;
+  margin-left: 2em;
+  padding-left: 1em;
+  padding-right: 1em;
+  padding-bottom: 1em;
+  border: 1px solid #999;
+  background-color: #eee;
+  width: 17.5em;
+}
+
+#downloadbox h5 {
+  color: #000;
+  margin: 0;
+  border-bottom: 1px solid #aaaaaa;
+  font-size: smaller;
+  padding: 0;
+  margin-top: 1em;
+}
+
+#downloadbox p {
+  margin-top: 1em;
+  margin-bottom: 0;
+}
+
+#downloadbox li {
+  text-indent: inherit;
+}

Added: maven/doxia/website/content/developers/index.html
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/developers/index.html?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/developers/index.html (added)
+++ maven/doxia/website/content/developers/index.html Thu Apr 12 21:22:02 2018
@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.8 from 
content/apt/developers/index.apt at 2018-04-12
+ | Rendered using Apache Maven Fluido Skin 1.7
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Vincent Siveton" />
+    <meta name="Date-Creation-yyyymmdd" content="20080302" />
+    <meta name="Date-Revision-yyyymmdd" content="20180412" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Doxia &#x2013; Doxia Developers Centre</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+    <script type="text/javascript" 
src="../js/apache-maven-fluido-1.7.min.js"></script>
+    <!-- Google Analytics -->
+    <script type="text/javascript">
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 
'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 
'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; 
s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  </head>
+  <body class="topBarDisabled">
+    <div class="container-fluid">
+      <div id="banner">
+        <div class="pull-left"><a href="https://www.apache.org/"; 
id="bannerLeft"><img src="../../images/apache-maven-project.png"  alt="Doxia 
Site"/></a></div>
+        <div class="pull-right"><a href=".././" id="bannerRight"><img 
src="../images/doxia-logo.png"  alt="Doxia"/></a></div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+      <li class=""><a href="https://www.apache.org/"; class="externalLink" 
title="Apache">Apache</a><span class="divider">/</span></li>
+      <li class=""><a href="../../index.html" title="Maven">Maven</a><span 
class="divider">/</span></li>
+      <li class=""><a href="http://maven.apache.org/doxia/index.html"; 
class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li>
+    <li class="active ">Doxia Developers Centre</li>
+        <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li>
+        </ul>
+      </div>
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+    <ul class="nav nav-list">
+      <li class="nav-header">About Doxia</li>
+    <li><a href="../index.html" title="What is Doxia?"><span 
class="none"></span>What is Doxia?</a></li>
+    <li><a href="../overview.html" title="Overview"><span 
class="none"></span>Overview</a></li>
+    <li><a href="../upgrading.html" title="Upgrading"><span 
class="icon-chevron-right"></span>Upgrading</a></li>
+    <li><a href="../downloads.html" title="Downloads"><span 
class="none"></span>Downloads</a></li>
+    <li><a href="../faq.html" title="FAQ"><span 
class="none"></span>FAQ</a></li>
+      <li class="nav-header">Documentation</li>
+    <li><a href="../references/index.html" title="Format References"><span 
class="icon-chevron-right"></span>Format References</a></li>
+    <li><a href="../modules/index.html" title="Doxia Modules Guide"><span 
class="none"></span>Doxia Modules Guide</a></li>
+    <li><a href="../macros/index.html" title="Doxia Macros Guide"><span 
class="none"></span>Doxia Macros Guide</a></li>
+    <li><a href="../book/index.html" title="Writing Books"><span 
class="none"></span>Writing Books</a></li>
+    <li><a href="../issues/index.html" title="Issues &amp; Gotchas"><span 
class="none"></span>Issues &amp; Gotchas</a></li>
+    <li><a href="../resources.html" title="External Resources"><span 
class="none"></span>External Resources</a></li>
+      <li class="nav-header">Developer Docs</li>
+    <li class="active"><a href="#"><span 
class="icon-chevron-down"></span>Developer Centre</a>
+    <ul class="nav nav-list">
+    <li><a href="../developers/modules.html" title="Create a Doxia 
Module"><span class="none"></span>Create a Doxia Module</a></li>
+    <li><a href="../developers/macros.html" title="Create a Doxia Macro"><span 
class="none"></span>Create a Doxia Macro</a></li>
+    <li><a href="../developers/sink.html" title="Using the Sink API"><span 
class="none"></span>Using the Sink API</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.8"><span 
class="icon-chevron-down"></span>Doxia 1.8</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia/index.html" title="Doxia base"><span 
class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span 
class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.5"><span 
class="icon-chevron-down"></span>Doxia 1.5</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span 
class="none"></span>Doxia Tools</a></li>
+    <li><a href="../doxia-ide.html" title="Doxia IDE"><span 
class="none"></span>Doxia IDE</a></li>
+      <li class="nav-header">Project Documentation</li>
+    <li><a href="../project-info.html" title="Project Information"><span 
class="icon-chevron-right"></span>Project Information</a></li>
+      <li class="nav-header">Maven Projects</li>
+    <li><a href="../../archetype/index.html" title="Archetype"><span 
class="none"></span>Archetype</a></li>
+    <li><a href="../../resolver/index.html" title="Artifact Resolver"><span 
class="none"></span>Artifact Resolver</a></li>
+    <li><a href="../index.html" title="Doxia"><span 
class="none"></span>Doxia</a></li>
+    <li><a href="../../jxr/index.html" title="JXR"><span 
class="none"></span>JXR</a></li>
+    <li><a href="../../ref/current" title="Maven"><span 
class="none"></span>Maven</a></li>
+    <li><a href="../../pom/index.html" title="Parent POMs"><span 
class="none"></span>Parent POMs</a></li>
+    <li><a href="../../plugins/index.html" title="Plugins"><span 
class="none"></span>Plugins</a></li>
+    <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span 
class="none"></span>Plugin Testing</a></li>
+    <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span 
class="none"></span>Plugin Tools</a></li>
+    <li><a href="../../apache-resource-bundles/index.html" title="Resource 
Bundles"><span class="none"></span>Resource Bundles</a></li>
+    <li><a href="../../scm/index.html" title="SCM"><span 
class="none"></span>SCM</a></li>
+    <li><a href="../../shared/index.html" title="Shared Components"><span 
class="none"></span>Shared Components</a></li>
+    <li><a href="../../skins/index.html" title="Skins"><span 
class="none"></span>Skins</a></li>
+    <li><a href="../../surefire/index.html" title="Surefire"><span 
class="none"></span>Surefire</a></li>
+    <li><a href="../../wagon/index.html" title="Wagon"><span 
class="none"></span>Wagon</a></li>
+      <li class="nav-header">ASF</li>
+    <li><a href="https://www.apache.org/foundation/how-it-works.html"; 
class="externalLink" title="How Apache Works"><span class="none"></span>How 
Apache Works</a></li>
+    <li><a href="https://www.apache.org/foundation/"; class="externalLink" 
title="Foundation"><span class="none"></span>Foundation</a></li>
+    <li><a href="https://www.apache.org/foundation/sponsorship.html"; 
class="externalLink" title="Sponsoring Apache"><span 
class="none"></span>Sponsoring Apache</a></li>
+    <li><a href="https://www.apache.org/foundation/thanks.html"; 
class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+</ul>
+<form id="search-form" action="https://www.google.com/search"; method="get" >
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript">asyncJs( 
'https://cse.google.com/brand?form=search-form' )</script>
+          <hr />
+          <div id="poweredBy">
+            <div class="clear"></div>
+            <div class="clear"></div>
+    <div id="twitter">
+    <a href="https://twitter.com/ASFMavenProject"; 
class="twitter-follow-button" data-show-count="false" data-align="left" 
data-size="medium" data-show-screen-name="true" data-lang="en">Follow 
ASFMavenProject</a>
+    <script type="text/javascript">!function(d,s,id){var 
js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+    </div>
+            <div class="clear"></div>
+            <div class="clear"></div>
+<a href="http://maven.apache.org/"; title="Built by Maven" 
class="poweredBy"><img class="builtBy" alt="Built by Maven" 
src="../images/logos/maven-feather.png" /></a>
+            </div>
+          </div>
+        </div>
+        <div id="bodyColumn"  class="span10" >
+<div class="section">
+<h2><a name="Doxia_Developers_Centre"></a>Doxia Developers Centre</h2>
+<p>This documentation centre is for those that are developing Doxia modules or 
macro.</p>
+<p>Currently you can find information on the following topics:</p>
+<ul>
+<li><a href="./modules.html">Creating Doxia Modules</a></li>
+<li><a href="./macros.html">Creating Doxia Macros</a></li>
+<li><a href="./sink.html">Using the Doxia Sink API</a></li></ul></div>
+        </div>
+      </div>
+    </div>
+    <hr/>
+    <footer>
+      <div class="container-fluid">
+        <div class="row-fluid">
+            <p>Copyright &copy;2005&#x2013;2018
+<a href="https://www.apache.org/";>The Apache Software Foundation</a>.
+All rights reserved.</p>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file

Added: maven/doxia/website/content/developers/macros.html
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/developers/macros.html?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/developers/macros.html (added)
+++ maven/doxia/website/content/developers/macros.html Thu Apr 12 21:22:02 2018
@@ -0,0 +1,232 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.8 from 
content/apt/developers/macros.apt at 2018-04-12
+ | Rendered using Apache Maven Fluido Skin 1.7
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Vincent Siveton" />
+    <meta name="Date-Creation-yyyymmdd" content="20080302" />
+    <meta name="Date-Revision-yyyymmdd" content="20180412" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Doxia &#x2013; Doxia Developers Centre</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+    <script type="text/javascript" 
src="../js/apache-maven-fluido-1.7.min.js"></script>
+    <!-- Google Analytics -->
+    <script type="text/javascript">
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 
'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 
'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; 
s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  </head>
+  <body class="topBarDisabled">
+    <div class="container-fluid">
+      <div id="banner">
+        <div class="pull-left"><a href="https://www.apache.org/"; 
id="bannerLeft"><img src="../../images/apache-maven-project.png"  alt="Doxia 
Site"/></a></div>
+        <div class="pull-right"><a href=".././" id="bannerRight"><img 
src="../images/doxia-logo.png"  alt="Doxia"/></a></div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+      <li class=""><a href="https://www.apache.org/"; class="externalLink" 
title="Apache">Apache</a><span class="divider">/</span></li>
+      <li class=""><a href="../../index.html" title="Maven">Maven</a><span 
class="divider">/</span></li>
+      <li class=""><a href="http://maven.apache.org/doxia/index.html"; 
class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li>
+    <li class="active ">Doxia Developers Centre</li>
+        <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li>
+        </ul>
+      </div>
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+    <ul class="nav nav-list">
+      <li class="nav-header">About Doxia</li>
+    <li><a href="../index.html" title="What is Doxia?"><span 
class="none"></span>What is Doxia?</a></li>
+    <li><a href="../overview.html" title="Overview"><span 
class="none"></span>Overview</a></li>
+    <li><a href="../upgrading.html" title="Upgrading"><span 
class="icon-chevron-right"></span>Upgrading</a></li>
+    <li><a href="../downloads.html" title="Downloads"><span 
class="none"></span>Downloads</a></li>
+    <li><a href="../faq.html" title="FAQ"><span 
class="none"></span>FAQ</a></li>
+      <li class="nav-header">Documentation</li>
+    <li><a href="../references/index.html" title="Format References"><span 
class="icon-chevron-right"></span>Format References</a></li>
+    <li><a href="../modules/index.html" title="Doxia Modules Guide"><span 
class="none"></span>Doxia Modules Guide</a></li>
+    <li><a href="../macros/index.html" title="Doxia Macros Guide"><span 
class="none"></span>Doxia Macros Guide</a></li>
+    <li><a href="../book/index.html" title="Writing Books"><span 
class="none"></span>Writing Books</a></li>
+    <li><a href="../issues/index.html" title="Issues &amp; Gotchas"><span 
class="none"></span>Issues &amp; Gotchas</a></li>
+    <li><a href="../resources.html" title="External Resources"><span 
class="none"></span>External Resources</a></li>
+      <li class="nav-header">Developer Docs</li>
+    <li><a href="../developers/index.html" title="Developer Centre"><span 
class="icon-chevron-down"></span>Developer Centre</a>
+    <ul class="nav nav-list">
+    <li><a href="../developers/modules.html" title="Create a Doxia 
Module"><span class="none"></span>Create a Doxia Module</a></li>
+    <li class="active"><a href="#"><span class="none"></span>Create a Doxia 
Macro</a></li>
+    <li><a href="../developers/sink.html" title="Using the Sink API"><span 
class="none"></span>Using the Sink API</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.8"><span 
class="icon-chevron-down"></span>Doxia 1.8</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia/index.html" title="Doxia base"><span 
class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span 
class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.5"><span 
class="icon-chevron-down"></span>Doxia 1.5</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span 
class="none"></span>Doxia Tools</a></li>
+    <li><a href="../doxia-ide.html" title="Doxia IDE"><span 
class="none"></span>Doxia IDE</a></li>
+      <li class="nav-header">Project Documentation</li>
+    <li><a href="../project-info.html" title="Project Information"><span 
class="icon-chevron-right"></span>Project Information</a></li>
+      <li class="nav-header">Maven Projects</li>
+    <li><a href="../../archetype/index.html" title="Archetype"><span 
class="none"></span>Archetype</a></li>
+    <li><a href="../../resolver/index.html" title="Artifact Resolver"><span 
class="none"></span>Artifact Resolver</a></li>
+    <li><a href="../index.html" title="Doxia"><span 
class="none"></span>Doxia</a></li>
+    <li><a href="../../jxr/index.html" title="JXR"><span 
class="none"></span>JXR</a></li>
+    <li><a href="../../ref/current" title="Maven"><span 
class="none"></span>Maven</a></li>
+    <li><a href="../../pom/index.html" title="Parent POMs"><span 
class="none"></span>Parent POMs</a></li>
+    <li><a href="../../plugins/index.html" title="Plugins"><span 
class="none"></span>Plugins</a></li>
+    <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span 
class="none"></span>Plugin Testing</a></li>
+    <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span 
class="none"></span>Plugin Tools</a></li>
+    <li><a href="../../apache-resource-bundles/index.html" title="Resource 
Bundles"><span class="none"></span>Resource Bundles</a></li>
+    <li><a href="../../scm/index.html" title="SCM"><span 
class="none"></span>SCM</a></li>
+    <li><a href="../../shared/index.html" title="Shared Components"><span 
class="none"></span>Shared Components</a></li>
+    <li><a href="../../skins/index.html" title="Skins"><span 
class="none"></span>Skins</a></li>
+    <li><a href="../../surefire/index.html" title="Surefire"><span 
class="none"></span>Surefire</a></li>
+    <li><a href="../../wagon/index.html" title="Wagon"><span 
class="none"></span>Wagon</a></li>
+      <li class="nav-header">ASF</li>
+    <li><a href="https://www.apache.org/foundation/how-it-works.html"; 
class="externalLink" title="How Apache Works"><span class="none"></span>How 
Apache Works</a></li>
+    <li><a href="https://www.apache.org/foundation/"; class="externalLink" 
title="Foundation"><span class="none"></span>Foundation</a></li>
+    <li><a href="https://www.apache.org/foundation/sponsorship.html"; 
class="externalLink" title="Sponsoring Apache"><span 
class="none"></span>Sponsoring Apache</a></li>
+    <li><a href="https://www.apache.org/foundation/thanks.html"; 
class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+</ul>
+<form id="search-form" action="https://www.google.com/search"; method="get" >
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript">asyncJs( 
'https://cse.google.com/brand?form=search-form' )</script>
+          <hr />
+          <div id="poweredBy">
+            <div class="clear"></div>
+            <div class="clear"></div>
+    <div id="twitter">
+    <a href="https://twitter.com/ASFMavenProject"; 
class="twitter-follow-button" data-show-count="false" data-align="left" 
data-size="medium" data-show-screen-name="true" data-lang="en">Follow 
ASFMavenProject</a>
+    <script type="text/javascript">!function(d,s,id){var 
js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+    </div>
+            <div class="clear"></div>
+            <div class="clear"></div>
+<a href="http://maven.apache.org/"; title="Built by Maven" 
class="poweredBy"><img class="builtBy" alt="Built by Maven" 
src="../images/logos/maven-feather.png" /></a>
+            </div>
+          </div>
+        </div>
+        <div id="bodyColumn"  class="span10" >
+<div class="section">
+<h2><a name="Create_a_New_Doxia_Macro"></a>Create a New Doxia Macro</h2>
+<p>You need to add the following plugin configuration to generate the correct 
Plexus <i>component.xml</i> file for the project containing your macro:</p>
+<div class="source"><pre class="prettyprint linenums">&lt;project&gt;
+  ...
+  &lt;build&gt;
+    ...
+    &lt;plugins&gt;
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.codehaus.plexus&lt;/groupId&gt;
+        &lt;artifactId&gt;plexus-maven-plugin&lt;/artifactId&gt;
+        &lt;executions&gt;
+          &lt;execution&gt;
+            &lt;goals&gt;
+              &lt;goal&gt;descriptor&lt;/goal&gt;
+            &lt;/goals&gt;
+          &lt;/execution&gt;
+        &lt;/executions&gt;
+      &lt;/plugin&gt;
+      ...
+    &lt;/plugins&gt;
+  ...
+  &lt;/build&gt;
+  ...
+&lt;/project&gt;</pre></div>
+<p>You should implement the <i>AbstractMacro</i> class:</p>
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.macro.AbstractMacro;
+
+/**
+ * @plexus.component role=&quot;org.apache.maven.doxia.macro.Macro&quot; 
role-hint=&quot;my&quot;
+ */
+public class MyMacro
+    extends AbstractMacro
+{
+...
+    public void execute( Sink sink, MacroRequest request )
+        throws MacroExecutionException
+    {
+        String myValue = (String) request.getParameter( &quot;myParam&quot; );
+...
+    }
+...
+}</pre></div>
+<p>To use it, you need to write the following markups:</p>
+<ul>
+<li>APT
+<div class="source"><pre class="prettyprint linenums">%{my|myParam=myValue} 
&lt;!-- my is the macro name defined by role-hint --&gt;</pre></div></li>
+<li>XDoc
+<div class="source"><pre class="prettyprint linenums">&lt;macro 
name=&quot;my&quot;&gt; &lt;!-- my is the required macro name defined by 
role-hint --&gt;
+  &lt;param name=&quot;myParam&quot; value=&quot;myValue&quot;/&gt;
+&lt;/macro&gt;</pre></div></li></ul>
+<div class="section">
+<h3><a name="References">References</a></h3>
+<ul>
+<li><a href="../modules/index.html">Doxia Modules Guide</a></li>
+<li><a href="../macros/index.html">Doxia Macros Guide</a></li>
+<li><a href="../doxia/apidocs/index.html">Doxia API Reference</a></li>
+<li><a href="../doxia-sitetools/apidocs/index.html">Doxia Sitetools API 
Reference</a></li></ul></div></div>
+        </div>
+      </div>
+    </div>
+    <hr/>
+    <footer>
+      <div class="container-fluid">
+        <div class="row-fluid">
+            <p>Copyright &copy;2005&#x2013;2018
+<a href="https://www.apache.org/";>The Apache Software Foundation</a>.
+All rights reserved.</p>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file

Added: maven/doxia/website/content/developers/maven-integration.html
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/developers/maven-integration.html?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/developers/maven-integration.html (added)
+++ maven/doxia/website/content/developers/maven-integration.html Thu Apr 12 
21:22:02 2018
@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.8 from 
content/apt/developers/maven-integration.apt at 2018-04-12
+ | Rendered using Apache Maven Fluido Skin 1.7
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Vincent Siveton" />
+    <meta name="Date-Creation-yyyymmdd" content="20090302" />
+    <meta name="Date-Revision-yyyymmdd" content="20180412" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Doxia &#x2013; Integration With Maven</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+    <script type="text/javascript" 
src="../js/apache-maven-fluido-1.7.min.js"></script>
+    <!-- Google Analytics -->
+    <script type="text/javascript">
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 
'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 
'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; 
s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  </head>
+  <body class="topBarDisabled">
+    <div class="container-fluid">
+      <div id="banner">
+        <div class="pull-left"><a href="https://www.apache.org/"; 
id="bannerLeft"><img src="../../images/apache-maven-project.png"  alt="Doxia 
Site"/></a></div>
+        <div class="pull-right"><a href=".././" id="bannerRight"><img 
src="../images/doxia-logo.png"  alt="Doxia"/></a></div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+      <li class=""><a href="https://www.apache.org/"; class="externalLink" 
title="Apache">Apache</a><span class="divider">/</span></li>
+      <li class=""><a href="../../index.html" title="Maven">Maven</a><span 
class="divider">/</span></li>
+      <li class=""><a href="http://maven.apache.org/doxia/index.html"; 
class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li>
+    <li class="active ">Integration With Maven</li>
+        <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li>
+        </ul>
+      </div>
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+    <ul class="nav nav-list">
+      <li class="nav-header">About Doxia</li>
+    <li><a href="../index.html" title="What is Doxia?"><span 
class="none"></span>What is Doxia?</a></li>
+    <li><a href="../overview.html" title="Overview"><span 
class="none"></span>Overview</a></li>
+    <li><a href="../upgrading.html" title="Upgrading"><span 
class="icon-chevron-down"></span>Upgrading</a>
+    <ul class="nav nav-list">
+    <li><a href="../whatsnew-1.1.html" title="What's new in 1.1?"><span 
class="none"></span>What's new in 1.1?</a></li>
+    <li class="active"><a href="#"><span class="none"></span>Maven 
Integration</a></li>
+    </ul>
+</li>
+    <li><a href="../downloads.html" title="Downloads"><span 
class="none"></span>Downloads</a></li>
+    <li><a href="../faq.html" title="FAQ"><span 
class="none"></span>FAQ</a></li>
+      <li class="nav-header">Documentation</li>
+    <li><a href="../references/index.html" title="Format References"><span 
class="icon-chevron-right"></span>Format References</a></li>
+    <li><a href="../modules/index.html" title="Doxia Modules Guide"><span 
class="none"></span>Doxia Modules Guide</a></li>
+    <li><a href="../macros/index.html" title="Doxia Macros Guide"><span 
class="none"></span>Doxia Macros Guide</a></li>
+    <li><a href="../book/index.html" title="Writing Books"><span 
class="none"></span>Writing Books</a></li>
+    <li><a href="../issues/index.html" title="Issues &amp; Gotchas"><span 
class="none"></span>Issues &amp; Gotchas</a></li>
+    <li><a href="../resources.html" title="External Resources"><span 
class="none"></span>External Resources</a></li>
+      <li class="nav-header">Developer Docs</li>
+    <li><a href="../developers/index.html" title="Developer Centre"><span 
class="icon-chevron-right"></span>Developer Centre</a></li>
+    <li><a href="../doxia/index.html" title="Doxia 1.8"><span 
class="icon-chevron-down"></span>Doxia 1.8</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia/index.html" title="Doxia base"><span 
class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span 
class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.5"><span 
class="icon-chevron-down"></span>Doxia 1.5</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span 
class="none"></span>Doxia Tools</a></li>
+    <li><a href="../doxia-ide.html" title="Doxia IDE"><span 
class="none"></span>Doxia IDE</a></li>
+      <li class="nav-header">Project Documentation</li>
+    <li><a href="../project-info.html" title="Project Information"><span 
class="icon-chevron-right"></span>Project Information</a></li>
+      <li class="nav-header">Maven Projects</li>
+    <li><a href="../../archetype/index.html" title="Archetype"><span 
class="none"></span>Archetype</a></li>
+    <li><a href="../../resolver/index.html" title="Artifact Resolver"><span 
class="none"></span>Artifact Resolver</a></li>
+    <li><a href="../index.html" title="Doxia"><span 
class="none"></span>Doxia</a></li>
+    <li><a href="../../jxr/index.html" title="JXR"><span 
class="none"></span>JXR</a></li>
+    <li><a href="../../ref/current" title="Maven"><span 
class="none"></span>Maven</a></li>
+    <li><a href="../../pom/index.html" title="Parent POMs"><span 
class="none"></span>Parent POMs</a></li>
+    <li><a href="../../plugins/index.html" title="Plugins"><span 
class="none"></span>Plugins</a></li>
+    <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span 
class="none"></span>Plugin Testing</a></li>
+    <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span 
class="none"></span>Plugin Tools</a></li>
+    <li><a href="../../apache-resource-bundles/index.html" title="Resource 
Bundles"><span class="none"></span>Resource Bundles</a></li>
+    <li><a href="../../scm/index.html" title="SCM"><span 
class="none"></span>SCM</a></li>
+    <li><a href="../../shared/index.html" title="Shared Components"><span 
class="none"></span>Shared Components</a></li>
+    <li><a href="../../skins/index.html" title="Skins"><span 
class="none"></span>Skins</a></li>
+    <li><a href="../../surefire/index.html" title="Surefire"><span 
class="none"></span>Surefire</a></li>
+    <li><a href="../../wagon/index.html" title="Wagon"><span 
class="none"></span>Wagon</a></li>
+      <li class="nav-header">ASF</li>
+    <li><a href="https://www.apache.org/foundation/how-it-works.html"; 
class="externalLink" title="How Apache Works"><span class="none"></span>How 
Apache Works</a></li>
+    <li><a href="https://www.apache.org/foundation/"; class="externalLink" 
title="Foundation"><span class="none"></span>Foundation</a></li>
+    <li><a href="https://www.apache.org/foundation/sponsorship.html"; 
class="externalLink" title="Sponsoring Apache"><span 
class="none"></span>Sponsoring Apache</a></li>
+    <li><a href="https://www.apache.org/foundation/thanks.html"; 
class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+</ul>
+<form id="search-form" action="https://www.google.com/search"; method="get" >
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript">asyncJs( 
'https://cse.google.com/brand?form=search-form' )</script>
+          <hr />
+          <div id="poweredBy">
+            <div class="clear"></div>
+            <div class="clear"></div>
+    <div id="twitter">
+    <a href="https://twitter.com/ASFMavenProject"; 
class="twitter-follow-button" data-show-count="false" data-align="left" 
data-size="medium" data-show-screen-name="true" data-lang="en">Follow 
ASFMavenProject</a>
+    <script type="text/javascript">!function(d,s,id){var 
js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+    </div>
+            <div class="clear"></div>
+            <div class="clear"></div>
+<a href="http://maven.apache.org/"; title="Built by Maven" 
class="poweredBy"><img class="builtBy" alt="Built by Maven" 
src="../images/logos/maven-feather.png" /></a>
+            </div>
+          </div>
+        </div>
+        <div id="bodyColumn"  class="span10" >
+<div class="section">
+<h2><a name="Integration_With_Maven"></a>Integration With Maven</h2>
+<p>This page presents how to use Doxia 1.1 under Maven 2.0.x and 2.1.x with a 
Maven reporting plugin. Its goal is to help the Maven reporting plugin 
developer to integrate it.</p>
+<div class="section">
+<h3><a name="Maven_2.0.x"></a>Maven 2.0.x</h3>
+<p>Doxia 1.0 API is embedded in Maven 2.0.x (see <a class="externalLink" 
href="https://issues.apache.org/jira/browse/MNG-3402";>MNG-3402</a>), so your 
Maven reporting plugin needs to shade Doxia 1.1 API and Logging to be backward 
compatible with Maven 2.0.x.</p>
+<div class="source"><pre class="prettyprint linenums">&lt;project&gt;
+  ...
+  &lt;build&gt;
+    ...
+    &lt;plugins&gt;
+      &lt;plugin&gt;
+        &lt;artifactId&gt;maven-shade-plugin&lt;/artifactId&gt;
+        &lt;version&gt;1.2&lt;/version&gt;
+        &lt;executions&gt;
+          &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+              &lt;goal&gt;shade&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+              &lt;finalName&gt;${project.build.finalName}&lt;/finalName&gt;
+              
&lt;createDependencyReducedPom&gt;false&lt;/createDependencyReducedPom&gt;
+              
&lt;keepDependenciesWithProvidedScope&gt;true&lt;/keepDependenciesWithProvidedScope&gt;
+              &lt;transformers&gt;
+                &lt;transformer 
implementation=&quot;org.apache.maven.plugins.shade.resource.ComponentsXmlResourceTransformer&quot;
 /&gt;
+              &lt;/transformers&gt;
+              &lt;artifactSet&gt;
+                &lt;includes&gt;
+                  
&lt;include&gt;org.apache.maven.doxia:doxia-sink-api&lt;/include&gt;
+                  
&lt;include&gt;org.apache.maven.doxia:doxia-logging-api&lt;/include&gt;
+                &lt;/includes&gt;
+              &lt;/artifactSet&gt;
+            &lt;/configuration&gt;
+          &lt;/execution&gt;
+        &lt;/executions&gt;
+      &lt;/plugin&gt;
+      ...
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+  ...
+&lt;/project&gt;</pre></div></div>
+<div class="section">
+<h3><a name="Maven_2.1.x"></a>Maven 2.1.x</h3>
+<p>Doxia 1.1 API and Logging are embedded in Maven 2.1.x, your Maven reporting 
plugin is directly compatible with 2.1.x.</p></div></div>
+<div class="section">
+<h2><a name="Common_Bugs_and_Pitfalls"></a>Common Bugs and Pitfalls</h2>
+<p>Please read the <a href="../issues/index.html">Doxia Issues</a> 
page.</p></div>
+        </div>
+      </div>
+    </div>
+    <hr/>
+    <footer>
+      <div class="container-fluid">
+        <div class="row-fluid">
+            <p>Copyright &copy;2005&#x2013;2018
+<a href="https://www.apache.org/";>The Apache Software Foundation</a>.
+All rights reserved.</p>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file

Added: maven/doxia/website/content/developers/modules.html
URL: 
http://svn.apache.org/viewvc/maven/doxia/website/content/developers/modules.html?rev=1829011&view=auto
==============================================================================
--- maven/doxia/website/content/developers/modules.html (added)
+++ maven/doxia/website/content/developers/modules.html Thu Apr 12 21:22:02 2018
@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.8 from 
content/apt/developers/modules.apt at 2018-04-12
+ | Rendered using Apache Maven Fluido Skin 1.7
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Vincent Siveton" />
+    <meta name="Date-Creation-yyyymmdd" content="20080302" />
+    <meta name="Date-Revision-yyyymmdd" content="20180412" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Doxia &#x2013; Doxia Developers Centre</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" />
+    <link rel="stylesheet" href="../css/site.css" />
+    <link rel="stylesheet" href="../css/print.css" media="print" />
+    <script type="text/javascript" 
src="../js/apache-maven-fluido-1.7.min.js"></script>
+    <!-- Google Analytics -->
+    <script type="text/javascript">
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 
'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 
'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; 
s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  </head>
+  <body class="topBarDisabled">
+    <div class="container-fluid">
+      <div id="banner">
+        <div class="pull-left"><a href="https://www.apache.org/"; 
id="bannerLeft"><img src="../../images/apache-maven-project.png"  alt="Doxia 
Site"/></a></div>
+        <div class="pull-right"><a href=".././" id="bannerRight"><img 
src="../images/doxia-logo.png"  alt="Doxia"/></a></div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+      <li class=""><a href="https://www.apache.org/"; class="externalLink" 
title="Apache">Apache</a><span class="divider">/</span></li>
+      <li class=""><a href="../../index.html" title="Maven">Maven</a><span 
class="divider">/</span></li>
+      <li class=""><a href="http://maven.apache.org/doxia/index.html"; 
class="externalLink" title="Doxia">Doxia</a><span class="divider">/</span></li>
+    <li class="active ">Doxia Developers Centre</li>
+        <li id="publishDate" class="pull-right">Last Published: 2018-04-12</li>
+        </ul>
+      </div>
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+    <ul class="nav nav-list">
+      <li class="nav-header">About Doxia</li>
+    <li><a href="../index.html" title="What is Doxia?"><span 
class="none"></span>What is Doxia?</a></li>
+    <li><a href="../overview.html" title="Overview"><span 
class="none"></span>Overview</a></li>
+    <li><a href="../upgrading.html" title="Upgrading"><span 
class="icon-chevron-right"></span>Upgrading</a></li>
+    <li><a href="../downloads.html" title="Downloads"><span 
class="none"></span>Downloads</a></li>
+    <li><a href="../faq.html" title="FAQ"><span 
class="none"></span>FAQ</a></li>
+      <li class="nav-header">Documentation</li>
+    <li><a href="../references/index.html" title="Format References"><span 
class="icon-chevron-right"></span>Format References</a></li>
+    <li><a href="../modules/index.html" title="Doxia Modules Guide"><span 
class="none"></span>Doxia Modules Guide</a></li>
+    <li><a href="../macros/index.html" title="Doxia Macros Guide"><span 
class="none"></span>Doxia Macros Guide</a></li>
+    <li><a href="../book/index.html" title="Writing Books"><span 
class="none"></span>Writing Books</a></li>
+    <li><a href="../issues/index.html" title="Issues &amp; Gotchas"><span 
class="none"></span>Issues &amp; Gotchas</a></li>
+    <li><a href="../resources.html" title="External Resources"><span 
class="none"></span>External Resources</a></li>
+      <li class="nav-header">Developer Docs</li>
+    <li><a href="../developers/index.html" title="Developer Centre"><span 
class="icon-chevron-down"></span>Developer Centre</a>
+    <ul class="nav nav-list">
+    <li class="active"><a href="#"><span class="none"></span>Create a Doxia 
Module</a></li>
+    <li><a href="../developers/macros.html" title="Create a Doxia Macro"><span 
class="none"></span>Create a Doxia Macro</a></li>
+    <li><a href="../developers/sink.html" title="Using the Sink API"><span 
class="none"></span>Using the Sink API</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.8"><span 
class="icon-chevron-down"></span>Doxia 1.8</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia/index.html" title="Doxia base"><span 
class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools/index.html" title="Doxia Sitetools"><span 
class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
1.7"><span class="icon-chevron-down"></span>Doxia 1.7</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.7/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.7.5/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
1.6"><span class="icon-chevron-down"></span>Doxia 1.6</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.6/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.6/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia/index.html" title="Doxia 1.5"><span 
class="icon-chevron-down"></span>Doxia 1.5</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.5/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
1.4"><span class="icon-chevron-down"></span>Doxia 1.4</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.4/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.4/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
1.3"><span class="icon-chevron-down"></span>Doxia 1.3</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.3/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.3/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
1.2"><span class="icon-chevron-down"></span>Doxia 1.2</a>
+    <ul class="nav nav-list">
+    <li><a href="../doxia-archives/doxia-1.2/index.html" title="Doxia 
base"><span class="none"></span>Doxia base</a></li>
+    <li><a href="../doxia-sitetools-archives/doxia-sitetools-1.2/index.html" 
title="Doxia Sitetools"><span class="none"></span>Doxia Sitetools</a></li>
+    </ul>
+</li>
+    <li><a href="../doxia-tools/index.html" title="Doxia Tools"><span 
class="none"></span>Doxia Tools</a></li>
+    <li><a href="../doxia-ide.html" title="Doxia IDE"><span 
class="none"></span>Doxia IDE</a></li>
+      <li class="nav-header">Project Documentation</li>
+    <li><a href="../project-info.html" title="Project Information"><span 
class="icon-chevron-right"></span>Project Information</a></li>
+      <li class="nav-header">Maven Projects</li>
+    <li><a href="../../archetype/index.html" title="Archetype"><span 
class="none"></span>Archetype</a></li>
+    <li><a href="../../resolver/index.html" title="Artifact Resolver"><span 
class="none"></span>Artifact Resolver</a></li>
+    <li><a href="../index.html" title="Doxia"><span 
class="none"></span>Doxia</a></li>
+    <li><a href="../../jxr/index.html" title="JXR"><span 
class="none"></span>JXR</a></li>
+    <li><a href="../../ref/current" title="Maven"><span 
class="none"></span>Maven</a></li>
+    <li><a href="../../pom/index.html" title="Parent POMs"><span 
class="none"></span>Parent POMs</a></li>
+    <li><a href="../../plugins/index.html" title="Plugins"><span 
class="none"></span>Plugins</a></li>
+    <li><a href="../../plugin-testing/index.html" title="Plugin Testing"><span 
class="none"></span>Plugin Testing</a></li>
+    <li><a href="../../plugin-tools/index.html" title="Plugin Tools"><span 
class="none"></span>Plugin Tools</a></li>
+    <li><a href="../../apache-resource-bundles/index.html" title="Resource 
Bundles"><span class="none"></span>Resource Bundles</a></li>
+    <li><a href="../../scm/index.html" title="SCM"><span 
class="none"></span>SCM</a></li>
+    <li><a href="../../shared/index.html" title="Shared Components"><span 
class="none"></span>Shared Components</a></li>
+    <li><a href="../../skins/index.html" title="Skins"><span 
class="none"></span>Skins</a></li>
+    <li><a href="../../surefire/index.html" title="Surefire"><span 
class="none"></span>Surefire</a></li>
+    <li><a href="../../wagon/index.html" title="Wagon"><span 
class="none"></span>Wagon</a></li>
+      <li class="nav-header">ASF</li>
+    <li><a href="https://www.apache.org/foundation/how-it-works.html"; 
class="externalLink" title="How Apache Works"><span class="none"></span>How 
Apache Works</a></li>
+    <li><a href="https://www.apache.org/foundation/"; class="externalLink" 
title="Foundation"><span class="none"></span>Foundation</a></li>
+    <li><a href="https://www.apache.org/foundation/sponsorship.html"; 
class="externalLink" title="Sponsoring Apache"><span 
class="none"></span>Sponsoring Apache</a></li>
+    <li><a href="https://www.apache.org/foundation/thanks.html"; 
class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+</ul>
+<form id="search-form" action="https://www.google.com/search"; method="get" >
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript">asyncJs( 
'https://cse.google.com/brand?form=search-form' )</script>
+          <hr />
+          <div id="poweredBy">
+            <div class="clear"></div>
+            <div class="clear"></div>
+    <div id="twitter">
+    <a href="https://twitter.com/ASFMavenProject"; 
class="twitter-follow-button" data-show-count="false" data-align="left" 
data-size="medium" data-show-screen-name="true" data-lang="en">Follow 
ASFMavenProject</a>
+    <script type="text/javascript">!function(d,s,id){var 
js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+    </div>
+            <div class="clear"></div>
+            <div class="clear"></div>
+<a href="http://maven.apache.org/"; title="Built by Maven" 
class="poweredBy"><img class="builtBy" alt="Built by Maven" 
src="../images/logos/maven-feather.png" /></a>
+            </div>
+          </div>
+        </div>
+        <div id="bodyColumn"  class="span10" >
+<div class="section">
+<h2><a name="Create_a_New_Doxia_Module"></a>Create a New Doxia Module</h2>
+<p>First, you need to create a POM with <i>doxia-modules</i> as parent:</p>
+<div class="source"><pre class="prettyprint linenums">&lt;project&gt;
+  &lt;parent&gt;
+    &lt;groupId&gt;org.apache.maven.doxia&lt;/groupId&gt;
+    &lt;artifactId&gt;doxia-modules&lt;/artifactId&gt;
+    &lt;version&gt;1.0&lt;/version&gt; &lt;!-- Latest release --&gt;
+  &lt;/parent&gt;
+  &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+  &lt;artifactId&gt;doxia-module-my&lt;/artifactId&gt;
+  &lt;name&gt;Doxia :: MY Module&lt;/name&gt;
+
+  ...
+&lt;/project&gt;</pre></div>
+<p>Secondly, you should implement some Doxia classes:</p>
+<ul>
+<li><i>MyParser</i> class
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.parser.AbstractParser;
+
+/**
+ * @plexus.component role=&quot;org.apache.maven.doxia.parser.Parser&quot; 
role-hint=&quot;my&quot;
+ */
+public class MyParser
+    extends AbstractParser
+{
+...
+}</pre></div></li>
+<li><i>MyParseException</i> class (optional)
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.parser.ParseException;
+
+public class MyParseException
+    extends ParseException
+{
+...
+}</pre></div></li>
+<li><i>MySiteModule</i> class (optional, will be used by doxia-sitetools)
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.module.site.AbstractSiteModule;
+
+/**
+ * @plexus.component 
role=&quot;org.apache.maven.doxia.module.site.SiteModule&quot; 
role-hint=&quot;my&quot;
+ */
+public class MySiteModule
+    extends AbstractSiteModule
+{
+...
+}</pre></div></li>
+<li><i>MySink</i> class
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.sink.SinkAdapter;
+
+public class MySink
+    extends SinkAdapter
+{
+...
+}</pre></div></li>
+<li><i>MySinkFactory</i> class
+<div class="source"><pre class="prettyprint linenums">import 
org.apache.maven.doxia.sink.SinkFactory;
+
+/**
+ * @plexus.component role=&quot;org.apache.maven.doxia.sink.SinkFactory&quot; 
role-hint=&quot;my&quot;
+ */
+public class MySinkFactory
+    extends SinkFactory
+{
+...
+}</pre></div></li></ul>
+<div class="section">
+<h3><a name="References">References</a></h3>
+<ul>
+<li><a href="../modules/index.html">Doxia Modules Guide</a></li>
+<li><a href="../macros/index.html">Doxia Macros Guide</a></li>
+<li><a href="../doxia/apidocs/index.html">Doxia API Reference</a></li>
+<li><a href="../doxia-sitetools/apidocs/index.html">Doxia Sitetools API 
Reference</a></li></ul></div></div>
+        </div>
+      </div>
+    </div>
+    <hr/>
+    <footer>
+      <div class="container-fluid">
+        <div class="row-fluid">
+            <p>Copyright &copy;2005&#x2013;2018
+<a href="https://www.apache.org/";>The Apache Software Foundation</a>.
+All rights reserved.</p>
+        </div>
+      </div>
+    </footer>
+  </body>
+</html>
\ No newline at end of file

Reply via email to