improved explanations about site (with skin) vs doc rendering
authorHervé Boutemy <hboutemy@apache.org>
Sat, 3 Nov 2018 11:02:20 +0000 (12:02 +0100)
committerHervé Boutemy <hboutemy@apache.org>
Sat, 3 Nov 2018 11:02:20 +0000 (12:02 +0100)
src/site/resources/images/doxia-sitetools-deps.png
src/site/xdoc/doxia-sitetools-deps.odg
src/site/xdoc/index.xml

index a1555f8..410e33a 100644 (file)
Binary files a/src/site/resources/images/doxia-sitetools-deps.png and b/src/site/resources/images/doxia-sitetools-deps.png differ
index dd50293..af3825b 100644 (file)
Binary files a/src/site/xdoc/doxia-sitetools-deps.odg and b/src/site/xdoc/doxia-sitetools-deps.odg differ
index 6e1c72a..818a2a6 100644 (file)
 
     <section name="Doxia Sitetools">
 
-      <p>Doxia Sitetools is an extension of <a href="../doxia">base Doxia component</a> that generates either <b>HTML sites</b>,
-      consisting of decoration and content that was generated by Doxia, or <b>documents</b> like RTF or PDF.</p>
+      <p>Doxia Sitetools is an extension of <a href="../doxia">base Doxia component</a> that generates:</p>
+      <ul>
+      <li>either <b>HTML sites</b>, adding decoration (header, footer, navigation bar, menu, ...) to content that was generated by Doxia:
+      a decoration is defined in a <b>site skin</b>,</li>
+      <li>or <b>documents</b> like RTF or PDF.</li>
+      </ul>
       <p>In addition, Doxia Sitetools processes files with extra <code>.vm</code> extension with <a href="http://velocity.apache.org/">Velocity</a>.</p>
 
       <p>
-        <img src="images/doxia-sitetools-deps.png" width="599" height="250" border="0" usemap="#Doxia_sitetools_dependencies" alt="Doxia Sitetools Dependencies"/>
+        <img src="images/doxia-sitetools-deps.png" width="670" height="370" border="0" usemap="#Doxia_sitetools_dependencies" alt="Doxia Sitetools Dependencies"/>
         <map name="Doxia_sitetools_dependencies" id="Doxia_sitetools_dependencies">
-          <area shape="rect" coords="0,0,160,34"      href="doxia-integration-tools/index.html"   alt="Doxia Integration Tools"/>
-          <area shape="rect" coords="166,0,306,34"    href="doxia-site-renderer/index.html"       alt="Doxia Site Renderer"/>
-          <area shape="rect" coords="0,77,164,111"    href="doxia-decoration-model/index.html"    alt="Doxia Decoration Model"/>
-          <area shape="rect" coords="115,121,231,154" href="doxia-skin-model/index.html"          alt="Doxia Skin Model"/>
-          <area shape="rect" coords="392,0,529,34"    href="doxia-doc-renderer/index.html"        alt="Doxia Document Renderer"/>
-          <area shape="rect" coords="267,76,423,111"  href="http://codehaus-plexus.github.io/plexus-velocity/"        alt="Plexus Velocity"/>
-          <area shape="rect" coords="297,133,393,168" href="http://velocity.apache.org"           alt="Velocity"/>
-          <area shape="rect" coords="166,182,306,217" href="/doxia/doxia/doxia-modules/doxia-module-xhtml/index.html" alt="Doxia Module XHTML"/>
-          <area shape="rect" coords="339,183,453,217" href="/doxia/doxia/doxia-modules/doxia-module-fo/index.html"    alt="Doxia Module FO"/>
-          <area shape="rect" coords="456,183,590,217" href="/doxia/doxia/doxia-modules/doxia-module-itext/index.html" alt="Doxia Module iText"/>
-          <area shape="rect" coords="158,178,598,249" href="/doxia/doxia/doxia-modules/index.html" alt="Doxia Modules"/>
+          <area shape="rect" coords="133,63,274,97"   href="doxia-site-renderer/index.html"       alt="Doxia Site Renderer"/>
+          <area shape="rect" coords="2,119,162,153"   href="doxia-integration-tools/index.html"   alt="Doxia Integration Tools"/>
+          <area shape="rect" coords="32,232,199,267"  href="doxia-decoration-model/index.html"    alt="Doxia Decoration Model"/>
+          <area shape="rect" coords="207,232,324,267" href="doxia-skin-model/index.html"          alt="Doxia Skin Model"/>
+          <area shape="rect" coords="459,63,596,97"   href="doxia-doc-renderer/index.html"        alt="Doxia Document Renderer"/>
+          <area shape="rect" coords="288,123,444,159" href="http://codehaus-plexus.github.io/plexus-velocity/"        alt="Plexus Velocity"/>
+          <area shape="rect" coords="318,180,414,214" href="http://velocity.apache.org"                               alt="Velocity"/>
+          <area shape="rect" coords="134,301,274,337" href="/doxia/doxia/doxia-modules/doxia-module-xhtml/index.html" alt="Doxia Module XHTML"/>
+          <area shape="rect" coords="409,301,524,336" href="/doxia/doxia/doxia-modules/doxia-module-fo/index.html"    alt="Doxia Module FO"/>
+          <area shape="rect" coords="527,302,663,337" href="/doxia/doxia/doxia-modules/doxia-module-itext/index.html" alt="Doxia Module iText"/>
+          <area shape="rect" coords="126,297,669,369" href="/doxia/doxia/doxia-modules/index.html" alt="Doxia Modules"/>
         </map>
       </p>