From ea3bf7ea849541f8277925c83402d8101a6f14f1 Mon Sep 17 00:00:00 2001
From: ltheussl <ltheussl@13f79535-47bb-0310-9956-ffa450edef68>
Date: Mon, 12 Sep 2005 17:05:49 +0000
Subject: [PATCH] MPXDOC-24 : Add navigation bar

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@280371 13f79535-47bb-0310-9956-ffa450edef68
---
 xdoc/src/plugin-resources/site.jsl            | 23 +++++++++++++++++++
 .../templates/templates.properties            |  3 +++
 .../templates/templates_de.properties         |  3 +++
 .../templates/templates_fr.properties         |  3 +++
 xdoc/xdocs/changes.xml                        |  1 +
 xdoc/xdocs/index.xml                          | 10 ++++++++
 6 files changed, 43 insertions(+)

diff --git a/xdoc/src/plugin-resources/site.jsl b/xdoc/src/plugin-resources/site.jsl
index 4adfed34..e7a379d6 100644
--- a/xdoc/src/plugin-resources/site.jsl
+++ b/xdoc/src/plugin-resources/site.jsl
@@ -840,6 +840,29 @@
     <jsl:applyTemplates trim="false"/>
   </jsl:template>
 
+  <!-- process a guide-like navbar -->
+  <jsl:template match="navbar" trim="false">
+    <x:set var="_prevlink" select="string(@prev)"/>
+    <x:set var="_homelink" select="string(@home)"/>
+    <x:set var="_nextlink" select="string(@next)"/>
+    <j:set var="prev"><fmt:message key="site.navbar.previous" bundle="${msg}"/></j:set>
+    <j:set var="home"><fmt:message key="site.navbar.home" bundle="${msg}"/></j:set>
+    <j:set var="next"><fmt:message key="site.navbar.next" bundle="${msg}"/></j:set>
+    <hr/>
+    <div align="center" class="navbar">
+      [
+      <j:if test="${ ! empty(_prevlink) }"><a href="${_prevlink}">${prev}</a></j:if>
+      <j:if test="${ empty(_prevlink) }">${prev}</j:if>
+      |
+      <j:if test="${ ! empty(_homelink)}"><a href="${_homelink}">${home}</a></j:if>
+      <j:if test="${ empty(_homelink) }">home</j:if>
+      |
+      <j:if test="${ ! empty(_nextlink)}"><a href="${_nextlink}">${next}</a></j:if>
+      <j:if test="${ empty(_nextlink)}">${next}</j:if>
+      ]
+    </div>
+  </jsl:template>
+
   <!-- element values don't pass through as text -->
   <jsl:template match="@*"/>
 
diff --git a/xdoc/src/plugin-resources/templates/templates.properties b/xdoc/src/plugin-resources/templates/templates.properties
index b665004a..4f9d38ee 100644
--- a/xdoc/src/plugin-resources/templates/templates.properties
+++ b/xdoc/src/plugin-resources/templates/templates.properties
@@ -164,3 +164,6 @@ site.language=Language
 site.goals=Goals
 site.goal=Goal
 site.description=Description
+site.navbar.previous=previous
+site.navbar.home=home
+site.navbar.next=next
diff --git a/xdoc/src/plugin-resources/templates/templates_de.properties b/xdoc/src/plugin-resources/templates/templates_de.properties
index 5e6b5591..73ef7eb0 100644
--- a/xdoc/src/plugin-resources/templates/templates_de.properties
+++ b/xdoc/src/plugin-resources/templates/templates_de.properties
@@ -163,3 +163,6 @@ site.opens_new_window = 
 site.language = Sprache
 site.locale.en = Englisch
 site.locale.fr = Französisch
+site.navbar.previous=zurück
+site.navbar.home=Übersicht
+site.navbar.next=weiter
diff --git a/xdoc/src/plugin-resources/templates/templates_fr.properties b/xdoc/src/plugin-resources/templates/templates_fr.properties
index 3f9fce6a..1eec50ea 100644
--- a/xdoc/src/plugin-resources/templates/templates_fr.properties
+++ b/xdoc/src/plugin-resources/templates/templates_fr.properties
@@ -166,3 +166,6 @@ site.language=Langue
 site.goals=Buts
 site.goal=But
 site.description=Description
+site.navbar.previous=précédent
+site.navbar.home=Accueil
+site.navbar.next=suivant
diff --git a/xdoc/xdocs/changes.xml b/xdoc/xdocs/changes.xml
index 68d3c5b8..ee3ee858 100644
--- a/xdoc/xdocs/changes.xml
+++ b/xdoc/xdocs/changes.xml
@@ -27,6 +27,7 @@
   </properties>
   <body>
     <release version="1.10" date="in SVN">
+      <action dev="ltheussl" type="add" issue="MPXDOC-24" due-to="Gilles Dodinet">Add a navigation bar.</action>
       <action dev="ltheussl" type="add" issue="MPXDOC-158">Add an optional id tag to sub/sections, so they can be referenced.</action>
       <action dev="ltheussl" type="add" issue="MPXDOC-144">Add a property to override <code>navigation.xml</code>.</action>
       <action dev="ltheussl" type="add" issue="MPXDOC-127" due-to="Shinobu Kawai Yoshida">Show organization in header even if logo not set.</action>
diff --git a/xdoc/xdocs/index.xml b/xdoc/xdocs/index.xml
index f1aae2b4..6845b4de 100644
--- a/xdoc/xdocs/index.xml
+++ b/xdoc/xdocs/index.xml
@@ -53,6 +53,16 @@
     </A>
    </footer>]]></source>
       </subsection>
+      <subsection name="Navigation bar">
+        <p>
+          You can put a navigation bar on bottom of each page by including
+          a <code>&lt;navbar/&gt;</code> element in an xdoc's body.
+          This element takes three optional attributes,
+          <code>prev</code>, <code>home</code> and <code>next</code>, as
+          shown in the following example:
+        </p>
+        <source><![CDATA[<navbar prev="first.html" home="../index.html" next="next.html"/>]]></source>
+      </subsection>
       <subsection name="Google Search">
         <p>If a <code>search</code> element is found in the <code>navigation.xml</code> body, a search navigation menu is generated that uses <a href="http://www.google.com">google</a></p>
       </subsection>