From 5ecc47e90600b62f20a0b15074d0c24190fd04b2 Mon Sep 17 00:00:00 2001
From: ltheussl <ltheussl@13f79535-47bb-0310-9956-ffa450edef68>
Date: Sun, 18 Sep 2005 03:02:45 +0000
Subject: [PATCH] Add support for more powered-by banners. Thanks to Maarten
 Coene

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@289882 13f79535-47bb-0310-9956-ffa450edef68
---
 xdoc/src/plugin-resources/css/maven-base.css |  6 +++++-
 xdoc/src/plugin-resources/site.jsl           | 20 +++++++++++++++++++-
 xdoc/src/xsd/maven-navigation.xsd            |  8 ++++++++
 xdoc/xdocs/changes.xml                       |  2 ++
 xdoc/xdocs/index.xml                         | 18 ++++++++++++++++--
 5 files changed, 50 insertions(+), 4 deletions(-)

diff --git a/xdoc/src/plugin-resources/css/maven-base.css b/xdoc/src/plugin-resources/css/maven-base.css
index 7eae4469..45a25a15 100644
--- a/xdoc/src/plugin-resources/css/maven-base.css
+++ b/xdoc/src/plugin-resources/css/maven-base.css
@@ -89,7 +89,7 @@ div.clear hr{
 #navcolumn li.collapsed {
   background-image: url(../images/collapsed.gif);
 }
-#poweredBy {
+#poweredBy, #poweredByExternal {
   text-align: center;
 }
 #navcolumn img {
@@ -103,6 +103,10 @@ div.clear hr{
   width: 90px;
   height: 30px;
 }
+#poweredByExternal img {
+  display:block;
+  margin: 20px 0 20px 17px;
+}
 #searchbar img {
     margin: 0px;
     display: block;
diff --git a/xdoc/src/plugin-resources/site.jsl b/xdoc/src/plugin-resources/site.jsl
index b92937fe..649a1ce4 100644
--- a/xdoc/src/plugin-resources/site.jsl
+++ b/xdoc/src/plugin-resources/site.jsl
@@ -397,6 +397,10 @@
               </j:if>
             </j:if>
 
+            <x:if select="$nav/body/powered-by">
+              <jsl:applyTemplates select="$nav/body/powered-by"/>
+            </x:if>
+
             <!-- Standard Maven Navigation -->
             <j:set var="fileName">${file}</j:set>
             <j:set var="poweredbyimage">${maven.xdoc.poweredby.image}</j:set>
@@ -639,7 +643,21 @@
       <j:set var="linkCount" value="${1+linkCount}"/>
     </x:forEach>
   </jsl:template>
-  
+
+  <!-- Process additional powered-by's -->
+  <jsl:template match="powered-by" trim="true">
+    <x:forEach var="link" select="item">
+      <x:set var="poweredbyimage" select="string(@img)"/>
+      <x:set var="poweredbytitle" select="string(@name)"/>
+      <x:set var="poweredbyurl" select="string(@href)"/>
+      <j:if test="${!empty(poweredbyimage)}">
+        <a id="poweredByExternal" href="${poweredbyurl}" title="${poweredbytitle}">
+          <img alt="${poweredbytitle}" src="${poweredbyimage}" />
+        </a>
+      </j:if>
+    </x:forEach>
+   </jsl:template>
+
   <!-- Process the breadcrumb navbar -->
   <jsl:template match="breadcrumbs" trim="true">    
     <x:forEach var="link" select="item">
diff --git a/xdoc/src/xsd/maven-navigation.xsd b/xdoc/src/xsd/maven-navigation.xsd
index 47635a91..1c0f414b 100644
--- a/xdoc/src/xsd/maven-navigation.xsd
+++ b/xdoc/src/xsd/maven-navigation.xsd
@@ -42,6 +42,7 @@
         <xs:element ref="links" minOccurs="0"/>
         <xs:element ref="menu" minOccurs="0" maxOccurs="unbounded"/>
         <xs:element ref="search" minOccurs="0"/>
+        <xs:element ref="powered-by" minOccurs="0"/>
         <xs:element ref="footer" minOccurs="0"/>
       </xs:sequence>
     </xs:complexType>
@@ -74,6 +75,13 @@
       	   Values - left-header (default), left-footer -->
     </xs:complexType>
   </xs:element>
+  <xs:element name="powered-by">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="item" minOccurs="0" maxOccurs="unbounded"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
   <xs:element name="item">
     <xs:complexType>
       <xs:sequence>
diff --git a/xdoc/xdocs/changes.xml b/xdoc/xdocs/changes.xml
index 8f8b4295..bf593606 100644
--- a/xdoc/xdocs/changes.xml
+++ b/xdoc/xdocs/changes.xml
@@ -27,6 +27,8 @@
   </properties>
   <body>
     <release version="1.10" date="in SVN">
+      <action dev="ltheussl" type="add" issue="MPXDOC-126" due-to="Maarten Coene">Add support for more powered-by banners.</action>
+      
       <action dev="ltheussl" type="add" issue="MPXDOC-80" due-to="Joerg Schaible">Support global theme.</action>
       <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>
diff --git a/xdoc/xdocs/index.xml b/xdoc/xdocs/index.xml
index 635c8be9..e1d033bd 100644
--- a/xdoc/xdocs/index.xml
+++ b/xdoc/xdocs/index.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!DOCTYPE document [
-  <!ENTITY escapeXmlExample SYSTEM "escapeXml.xml">
+  <!ENTITY escapeXmlExample SYSTEM "file:xdocs/escapeXml.xml">
 ]>
 <!--
 /*
@@ -58,9 +58,23 @@
         <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>If a <code>&lt;search/&gt;</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>
+      <subsection name="Additional 'powered-by' logos">
+        <p>
+          You can add additional 'powered-by' logos above the maven logo by
+          specifying a <code>&lt;powered-by&gt;</code> element in the body
+          of <code>navigation.xml</code>, e.g.:
+        </p>
+        <source><![CDATA[<powered-by>
+  <item
+    name="Hosted by SourceForge"
+    href="http://www.sourceforge.net"
+    img="http://sourceforge.net/sflogo.php?group_id=16035&amp;type=1"/>
+</powered-by>]]></source>
+        <p>You may specify several items to include more logos.</p>
+      </subsection>
       <subsection name="escapeXml Tag">
         <p>If you need to include the contents of another XML document in your document, you can use the <code>&lt;escapeXml&gt;</code> tag, as demonstrated below. For instance, the code:</p>
         <source><![CDATA[<?xml version="1.0"?>