Allow Karaf manual contents to be included

git-svn-id: https://svn.apache.org/repos/asf/servicemix/documentation/trunk@1023675 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/pom.xml b/pom.xml
index d771b2d..9810e49 100644
--- a/pom.xml
+++ b/pom.xml
@@ -86,6 +86,33 @@
       </plugin>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>src-dependencies</id>
+            <phase>generate-resources</phase>
+            <goals>
+              <!-- use copy-dependencies instead if you don't want to explode the sources -->
+              <goal>unpack</goal>
+            </goals>
+           <configuration>
+          <artifactItems>
+            <artifactItem>
+              <groupId>org.fusesource.doc</groupId>
+              <artifactId>karaf</artifactId>
+              <version>2.1.99-SNAPSHOT</version>
+              <type>war</type>
+              <outputDirectory>${project.build.directory}/webapp/karaf</outputDirectory>
+              <includes>commands/*.conf,developers-guide/*.conf,users-guide/*.conf</includes>
+            </artifactItem>
+          </artifactItems>
+
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>      
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-resources-plugin</artifactId>
         <executions>
           <execution>
@@ -199,8 +226,8 @@
               <tasks>
                 <echo message="Generating PDF using Prince XML (http://www.princexml.com/)"/>
                 <exec executable="prince">
-                  <arg value="${project.build.directory}/sitegen/manual.html" />
-                  <arg value="${project.build.directory}/sitegen/manual.pdf" />
+                  <arg value="${project.build.directory}/sitegen/users-guide/manual.html" />
+                  <arg value="${project.build.directory}/sitegen/users-guide/manual.pdf" />
                   <arg value="--log"/>
                   <arg value="${project.build.directory}/prince.log"/>
                 </exec>
@@ -228,8 +255,9 @@
             <configuration>
               <artifacts>
                 <artifact>
-                  <file>${project.build.directory}/sitegen/manual.pdf</file>
+                  <file>${project.build.directory}/sitegen/users-guide/users-guide.pdf</file>
                   <type>pdf</type>
+                  <classifier>users-guide</classifier>
                 </artifact>
               </artifacts>
             </configuration>
diff --git a/src/main/webapp/WEB-INF/scalate/layouts/default.ssp b/src/main/webapp/WEB-INF/scalate/layouts/default.ssp
index 8d27e6b..ec38326 100644
--- a/src/main/webapp/WEB-INF/scalate/layouts/default.ssp
+++ b/src/main/webapp/WEB-INF/scalate/layouts/default.ssp
@@ -17,6 +17,7 @@
 --%>
 <%@ var body: String %>
 <%@ var title: String = "Apache ServiceMix ${servicemix.version}" %>
+<%@ var navigation: Boolean = true %>
 <!DOCTYPE html>
 <html>
 <head>
@@ -49,12 +50,13 @@
 
 
     <div id="main">
+      <% if (navigation) { %>
       <nav>
         <div id="navigation">
             ${include("/toc.ssp")}
         </div>
-
       </nav>
+      <% } %>
 
       <div id="body">
         <%= body %>
diff --git a/src/main/webapp/index.ssp b/src/main/webapp/index.ssp
new file mode 100644
index 0000000..55ee0d9
--- /dev/null
+++ b/src/main/webapp/index.ssp
@@ -0,0 +1,10 @@
+<% attributes("navigation") = false %>
+<h1>Welcome to the Apache ServiceMix documentation</h1>
+
+If you're new to Apache ServiceMix, we recommend you start here
+
+<h2>Related projects' reference manuals</h2>
+<ul>
+  <li><a href="karaf/users-guide">Karaf Users' Guide</a></li>
+  <li><a href="karaf/developers-guide">Karaf Developers' Guide</a></li>
+</ul>
\ No newline at end of file
diff --git a/src/main/webapp/manual.conf b/src/main/webapp/manual.conf
deleted file mode 100644
index eee7de1..0000000
--- a/src/main/webapp/manual.conf
+++ /dev/null
@@ -1,43 +0,0 @@
-{attributes:layout=/WEB-INF/scalate/layouts/print.ssp}
-
-h1. Getting started
-{include:getting-started/what-is-smx4.conf}
-{include:getting-started/installation.conf}
-{include:getting-started/discover.conf}
-{include:getting-started/technology-selection.conf}
-
-h1. Camel
-{include:camel/camel-index.conf}
-{include:camel/camel-deployment.conf}
-
-h1. NMR
-{include:nmr-index}
-{include:nmr-camel}
-{include:nmr-event-listeners}
-
-h1. JBI
-
-h1. JBI Component Reference
-{include:jbi/servicemix-bean.conf}
-{include:jbi/servicemix-camel.conf}
-{include:jbi/servicemix-cxf-bc.conf}
-{include:jbi/servicemix-cxf-se.conf}
-{include:jbi/servicemix-drools.conf}
-{include:jbi/servicemix-eip.conf}
-{include:jbi/servicemix-file.conf}
-{include:jbi/servicemix-ftp.conf}
-{include:jbi/servicemix-http.conf}
-{include:jbi/servicemix-jms.conf}
-{include:jbi/servicemix-mail.conf}
-{include:jbi/servicemix-osworkflow.conf}
-{include:jbi/servicemix-quartz.conf}
-{include:jbi/servicemix-saxon.conf}
-{include:jbi/servicemix-scripting.conf}
-{include:jbi/servicemix-snmp.conf}
-{include:jbi/servicemix-validation.conf}
-{include:jbi/servicemix-vfs.conf}
-{include:jbi/servicemix-wsn2005.conf}
-{include:jbi/servicemix-xmpp.conf}
-
-h1. Appendices
-{include:appendices/migration.conf}
diff --git a/src/main/webapp/appendices/migration.conf b/src/main/webapp/users-guide/appendices/migration.conf
similarity index 100%
rename from src/main/webapp/appendices/migration.conf
rename to src/main/webapp/users-guide/appendices/migration.conf
diff --git a/src/main/webapp/camel/camel-deployment.conf b/src/main/webapp/users-guide/camel/camel-deployment.conf
similarity index 100%
rename from src/main/webapp/camel/camel-deployment.conf
rename to src/main/webapp/users-guide/camel/camel-deployment.conf
diff --git a/src/main/webapp/camel/camel-index.conf b/src/main/webapp/users-guide/camel/camel-index.conf
similarity index 100%
rename from src/main/webapp/camel/camel-index.conf
rename to src/main/webapp/users-guide/camel/camel-index.conf
diff --git a/src/main/webapp/getting-started/discover.conf b/src/main/webapp/users-guide/getting-started/discover.conf
similarity index 100%
rename from src/main/webapp/getting-started/discover.conf
rename to src/main/webapp/users-guide/getting-started/discover.conf
diff --git a/src/main/webapp/getting-started/installation.conf b/src/main/webapp/users-guide/getting-started/installation.conf
similarity index 100%
rename from src/main/webapp/getting-started/installation.conf
rename to src/main/webapp/users-guide/getting-started/installation.conf
diff --git a/src/main/webapp/getting-started/technology-selection.conf b/src/main/webapp/users-guide/getting-started/technology-selection.conf
similarity index 100%
rename from src/main/webapp/getting-started/technology-selection.conf
rename to src/main/webapp/users-guide/getting-started/technology-selection.conf
diff --git a/src/main/webapp/getting-started/what-is-smx4.conf b/src/main/webapp/users-guide/getting-started/what-is-smx4.conf
similarity index 100%
rename from src/main/webapp/getting-started/what-is-smx4.conf
rename to src/main/webapp/users-guide/getting-started/what-is-smx4.conf
diff --git a/src/main/webapp/index.conf b/src/main/webapp/users-guide/index.conf
similarity index 100%
rename from src/main/webapp/index.conf
rename to src/main/webapp/users-guide/index.conf
diff --git a/src/main/webapp/jbi/servicemix-bean.conf b/src/main/webapp/users-guide/jbi/servicemix-bean.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-bean.conf
rename to src/main/webapp/users-guide/jbi/servicemix-bean.conf
diff --git a/src/main/webapp/jbi/servicemix-camel.conf b/src/main/webapp/users-guide/jbi/servicemix-camel.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-camel.conf
rename to src/main/webapp/users-guide/jbi/servicemix-camel.conf
diff --git a/src/main/webapp/jbi/servicemix-cxf-bc.conf b/src/main/webapp/users-guide/jbi/servicemix-cxf-bc.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-cxf-bc.conf
rename to src/main/webapp/users-guide/jbi/servicemix-cxf-bc.conf
diff --git a/src/main/webapp/jbi/servicemix-cxf-se.conf b/src/main/webapp/users-guide/jbi/servicemix-cxf-se.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-cxf-se.conf
rename to src/main/webapp/users-guide/jbi/servicemix-cxf-se.conf
diff --git a/src/main/webapp/jbi/servicemix-drools.conf b/src/main/webapp/users-guide/jbi/servicemix-drools.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-drools.conf
rename to src/main/webapp/users-guide/jbi/servicemix-drools.conf
diff --git a/src/main/webapp/jbi/servicemix-eip.conf b/src/main/webapp/users-guide/jbi/servicemix-eip.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-eip.conf
rename to src/main/webapp/users-guide/jbi/servicemix-eip.conf
diff --git a/src/main/webapp/jbi/servicemix-file.conf b/src/main/webapp/users-guide/jbi/servicemix-file.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-file.conf
rename to src/main/webapp/users-guide/jbi/servicemix-file.conf
diff --git a/src/main/webapp/jbi/servicemix-ftp.conf b/src/main/webapp/users-guide/jbi/servicemix-ftp.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-ftp.conf
rename to src/main/webapp/users-guide/jbi/servicemix-ftp.conf
diff --git a/src/main/webapp/jbi/servicemix-http.conf b/src/main/webapp/users-guide/jbi/servicemix-http.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-http.conf
rename to src/main/webapp/users-guide/jbi/servicemix-http.conf
diff --git a/src/main/webapp/jbi/servicemix-jms.conf b/src/main/webapp/users-guide/jbi/servicemix-jms.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-jms.conf
rename to src/main/webapp/users-guide/jbi/servicemix-jms.conf
diff --git a/src/main/webapp/jbi/servicemix-mail.conf b/src/main/webapp/users-guide/jbi/servicemix-mail.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-mail.conf
rename to src/main/webapp/users-guide/jbi/servicemix-mail.conf
diff --git a/src/main/webapp/jbi/servicemix-osworkflow.conf b/src/main/webapp/users-guide/jbi/servicemix-osworkflow.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-osworkflow.conf
rename to src/main/webapp/users-guide/jbi/servicemix-osworkflow.conf
diff --git a/src/main/webapp/jbi/servicemix-quartz.conf b/src/main/webapp/users-guide/jbi/servicemix-quartz.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-quartz.conf
rename to src/main/webapp/users-guide/jbi/servicemix-quartz.conf
diff --git a/src/main/webapp/jbi/servicemix-saxon.conf b/src/main/webapp/users-guide/jbi/servicemix-saxon.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-saxon.conf
rename to src/main/webapp/users-guide/jbi/servicemix-saxon.conf
diff --git a/src/main/webapp/jbi/servicemix-scripting.conf b/src/main/webapp/users-guide/jbi/servicemix-scripting.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-scripting.conf
rename to src/main/webapp/users-guide/jbi/servicemix-scripting.conf
diff --git a/src/main/webapp/jbi/servicemix-snmp.conf b/src/main/webapp/users-guide/jbi/servicemix-snmp.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-snmp.conf
rename to src/main/webapp/users-guide/jbi/servicemix-snmp.conf
diff --git a/src/main/webapp/jbi/servicemix-validation.conf b/src/main/webapp/users-guide/jbi/servicemix-validation.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-validation.conf
rename to src/main/webapp/users-guide/jbi/servicemix-validation.conf
diff --git a/src/main/webapp/jbi/servicemix-vfs.conf b/src/main/webapp/users-guide/jbi/servicemix-vfs.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-vfs.conf
rename to src/main/webapp/users-guide/jbi/servicemix-vfs.conf
diff --git a/src/main/webapp/jbi/servicemix-wsn2005.conf b/src/main/webapp/users-guide/jbi/servicemix-wsn2005.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-wsn2005.conf
rename to src/main/webapp/users-guide/jbi/servicemix-wsn2005.conf
diff --git a/src/main/webapp/jbi/servicemix-xmpp.conf b/src/main/webapp/users-guide/jbi/servicemix-xmpp.conf
similarity index 100%
rename from src/main/webapp/jbi/servicemix-xmpp.conf
rename to src/main/webapp/users-guide/jbi/servicemix-xmpp.conf
diff --git a/src/main/webapp/users-guide/manual.conf b/src/main/webapp/users-guide/manual.conf
new file mode 100644
index 0000000..359014c
--- /dev/null
+++ b/src/main/webapp/users-guide/manual.conf
@@ -0,0 +1,43 @@
+{attributes:layout=/WEB-INF/scalate/layouts/print.ssp}
+
+h1. Getting started
+{include:users-guide/getting-started/what-is-smx4.conf}
+{include:users-guide/getting-started/installation.conf}
+{include:users-guide/getting-started/discover.conf}
+{include:users-guide/getting-started/technology-selection.conf}
+
+h1. Camel
+{include:users-guide/camel/camel-index.conf}
+{include:users-guide/camel/camel-deployment.conf}
+
+h1. NMR
+{include:users-guide/nmr-index}
+{include:users-guide/nmr-camel}
+{include:users-guide/nmr-event-listeners}
+
+h1. JBI
+
+h1. JBI Component Reference
+{include:users-guide/jbi/servicemix-bean.conf}
+{include:users-guide/jbi/servicemix-camel.conf}
+{include:users-guide/jbi/servicemix-cxf-bc.conf}
+{include:users-guide/jbi/servicemix-cxf-se.conf}
+{include:users-guide/jbi/servicemix-drools.conf}
+{include:users-guide/jbi/servicemix-eip.conf}
+{include:users-guide/jbi/servicemix-file.conf}
+{include:users-guide/jbi/servicemix-ftp.conf}
+{include:users-guide/jbi/servicemix-http.conf}
+{include:users-guide/jbi/servicemix-jms.conf}
+{include:users-guide/jbi/servicemix-mail.conf}
+{include:users-guide/jbi/servicemix-osworkflow.conf}
+{include:users-guide/jbi/servicemix-quartz.conf}
+{include:users-guide/jbi/servicemix-saxon.conf}
+{include:users-guide/jbi/servicemix-scripting.conf}
+{include:users-guide/jbi/servicemix-snmp.conf}
+{include:users-guide/jbi/servicemix-validation.conf}
+{include:users-guide/jbi/servicemix-vfs.conf}
+{include:users-guide/jbi/servicemix-wsn2005.conf}
+{include:users-guide/jbi/servicemix-xmpp.conf}
+
+h1. Appendices
+{include:users-guide/appendices/migration.conf}
diff --git a/src/main/webapp/nmr/nmr-camel.conf b/src/main/webapp/users-guide/nmr/nmr-camel.conf
similarity index 100%
rename from src/main/webapp/nmr/nmr-camel.conf
rename to src/main/webapp/users-guide/nmr/nmr-camel.conf
diff --git a/src/main/webapp/nmr/nmr-event-listeners.conf b/src/main/webapp/users-guide/nmr/nmr-event-listeners.conf
similarity index 100%
rename from src/main/webapp/nmr/nmr-event-listeners.conf
rename to src/main/webapp/users-guide/nmr/nmr-event-listeners.conf
diff --git a/src/main/webapp/nmr/nmr-index.conf b/src/main/webapp/users-guide/nmr/nmr-index.conf
similarity index 100%
rename from src/main/webapp/nmr/nmr-index.conf
rename to src/main/webapp/users-guide/nmr/nmr-index.conf