From 4aaa28b671fdb62ccf8f267102f906fb8a981b80 Mon Sep 17 00:00:00 2001 From: Robert Godfrey Date: Wed, 4 Jan 2012 01:50:00 +0000 Subject: QPID-3722 : Initial improvements to the HTML presentation of the docbook git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk@1227022 13f79535-47bb-0310-9956-ffa450edef68 --- qpid/doc/book/build-book.sh | 6 +- .../book/src/AMQP-Messaging-Broker-Java-Book.xml | 50 +++++++- qpid/doc/book/src/AMQP-Messaging-Broker-Java.xml | 4 +- qpid/doc/book/src/Broker-Configuration-Guide.xml | 2 +- qpid/doc/book/src/Configure-ACLs.xml | 2 +- ...Configure-Java-Qpid-to-use-a-SSL-connection.xml | 2 +- .../Configure-Log4j-CompositeRolling-Appender.xml | 2 +- .../src/Configure-the-Broker-via-config.xml.xml | 2 +- ...gure-the-Virtual-Hosts-via-virtualhosts.xml.xml | 2 +- qpid/doc/book/src/Debug-using-log4j.xml | 2 +- .../book/src/How-to-Use-SlowConsumerDisconnect.xml | 2 +- qpid/doc/book/src/Java-Environment-Variables.xml | 2 +- .../book/src/Qpid-Java-Broker-Management-CLI.xml | 2 +- qpid/doc/book/src/Qpid-Java-Build-How-To.xml | 2 +- qpid/doc/book/src/Qpid-Java-FAQ.xml | 2 +- qpid/doc/book/src/Qpid-Troubleshooting-Guide.xml | 2 +- qpid/doc/book/src/Use-Priority-Queues.xml | 2 +- qpid/doc/book/src/css/style.css | 129 +++++++++++++++++++++ 18 files changed, 199 insertions(+), 18 deletions(-) create mode 100644 qpid/doc/book/src/css/style.css diff --git a/qpid/doc/book/build-book.sh b/qpid/doc/book/build-book.sh index 46192907e6..59b9a3fd50 100755 --- a/qpid/doc/book/build-book.sh +++ b/qpid/doc/book/build-book.sh @@ -34,6 +34,8 @@ DOCBOOK_XSL=/usr/share/sgml/docbook/xsl-stylesheets # Ubuntu: # DOCBOOK_XSL=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh +# Ubuntu 10.4 installed it here: +# DOCBOOK_XSL=/usr/share/xml/docbook/stylesheet/docbook-xsl-ns rm -rf build/$1 mkdir -p build/$1 @@ -42,6 +44,8 @@ mkdir -p build/$1/html mkdir -p build/$1/pdf cp -r src/images build/$1/html-single cp -r src/images build/$1/html +cp -r src/css build/$1/html-single +cp -r src/css build/$1/html # Create single-page .html xsltproc --xinclude --stringparam section.autolabel 1 --stringparam callout.graphics 0 --stringparam callout.unicode 0 --stringparam section.label.includes.component.label 1 ${DOCBOOK_XSL}/html/docbook.xsl src/$1.xml >build/$1/html-single/$1.html @@ -49,7 +53,7 @@ xsltproc --xinclude --stringparam section.autolabel 1 --stringparam callout.g # Create chunked .html INFILE=$(readlink -f src/$1.xml) pushd build/$1/html -xsltproc --xinclude --stringparam chunk.section.depth 1 --stringparam section.autolabel 1 --stringparam callout.graphics 0 --stringparam callout.unicode 0 --stringparam section.label.includes.component.label 1 ${DOCBOOK_XSL}/html/chunk.xsl $INFILE +xsltproc --xinclude --stringparam chunk.section.depth 1 --stringparam section.autolabel 1 --stringparam callout.graphics 0 --stringparam callout.unicode 0 --stringparam section.label.includes.component.label 1 --stringparam use.id.as.filename 1 --stringparam html.stylesheet css/style.css --stringparam section.autolabel.max.depth 3 --stringparam toc.section.depth 2 ${DOCBOOK_XSL}/html/chunk.xsl $INFILE popd # Create the .fo diff --git a/qpid/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml b/qpid/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml index 8d2e2218ff..0bb40052cd 100644 --- a/qpid/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml +++ b/qpid/doc/book/src/AMQP-Messaging-Broker-Java-Book.xml @@ -21,5 +21,53 @@ --> - + AMQP Messaging Broker (Implemented in Java) + + Introduction + Qpid provides two AMQP messaging brokers: + + + Implemented in C++ - high performance, low latency, and RDMA support. + Implemented in Java - Fully JMS compliant, runs on any Java platform. + + + Both AMQP messaging brokers support clients in multiple languages, as long as the messaging client and the messaging broker use the same version of AMQP. See to see which messaging clients work with each broker. + + This manual contains information specific to the broker that is implemented in Java. + + + + General User Guides + + + + + + + + + +How Tos + + + + + + + + + + + + + + + + + + +Management Tools + + + diff --git a/qpid/doc/book/src/AMQP-Messaging-Broker-Java.xml b/qpid/doc/book/src/AMQP-Messaging-Broker-Java.xml index d2a3427674..6cd7ce915e 100644 --- a/qpid/doc/book/src/AMQP-Messaging-Broker-Java.xml +++ b/qpid/doc/book/src/AMQP-Messaging-Broker-Java.xml @@ -20,7 +20,7 @@ --> - + AMQP Messaging Broker (Implemented in Java) Qpid provides two AMQP messaging brokers: @@ -35,7 +35,7 @@ This section contains information specific to the broker that is implemented in Java. - + General User Guides diff --git a/qpid/doc/book/src/Broker-Configuration-Guide.xml b/qpid/doc/book/src/Broker-Configuration-Guide.xml index c52e1fbfd4..63d2748eee 100644 --- a/qpid/doc/book/src/Broker-Configuration-Guide.xml +++ b/qpid/doc/book/src/Broker-Configuration-Guide.xml @@ -20,7 +20,7 @@ --> -
+
Broker Configuration Guide -
+
Configuring ACLs diff --git a/qpid/doc/book/src/Configure-Java-Qpid-to-use-a-SSL-connection.xml b/qpid/doc/book/src/Configure-Java-Qpid-to-use-a-SSL-connection.xml index 1ffd4b4050..838b899337 100644 --- a/qpid/doc/book/src/Configure-Java-Qpid-to-use-a-SSL-connection.xml +++ b/qpid/doc/book/src/Configure-Java-Qpid-to-use-a-SSL-connection.xml @@ -21,7 +21,7 @@ --> -
+<section id="Qpid-Java-SSL"><title> Configure Java Qpid to use a SSL connection. diff --git a/qpid/doc/book/src/Configure-Log4j-CompositeRolling-Appender.xml b/qpid/doc/book/src/Configure-Log4j-CompositeRolling-Appender.xml index 2c21f9e76d..f52bc55399 100644 --- a/qpid/doc/book/src/Configure-Log4j-CompositeRolling-Appender.xml +++ b/qpid/doc/book/src/Configure-Log4j-CompositeRolling-Appender.xml @@ -21,7 +21,7 @@ --> -
+<section id="Qpid-Java-Log4j"><title> Configure Log4j CompositeRolling Appender
diff --git a/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml b/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml index b91e0796b8..6a7729acd8 100644 --- a/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml +++ b/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml @@ -21,7 +21,7 @@ --> -<section> +<section id="Qpid-Java-Broker-Config-File"> <title> Configure the Broker via config.xml diff --git a/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml b/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml index 690175d57e..804970b923 100644 --- a/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml +++ b/qpid/doc/book/src/Configure-the-Virtual-Hosts-via-virtualhosts.xml.xml @@ -21,7 +21,7 @@ --> -
+<section id="Qpid-Java-Broker-Virtualhosts-Config"><title> Configure the Virtual Hosts via virtualhosts.xml
virtualhosts.xml Overview diff --git a/qpid/doc/book/src/Debug-using-log4j.xml b/qpid/doc/book/src/Debug-using-log4j.xml index c4ec107cd0..615fd9e560 100644 --- a/qpid/doc/book/src/Debug-using-log4j.xml +++ b/qpid/doc/book/src/Debug-using-log4j.xml @@ -21,7 +21,7 @@ --> -<section><title> +<section id="Java-Broker-Debug-Logging"><title> Debug using log4j diff --git a/qpid/doc/book/src/How-to-Use-SlowConsumerDisconnect.xml b/qpid/doc/book/src/How-to-Use-SlowConsumerDisconnect.xml index 5f4c627430..4e0ce0f7e0 100644 --- a/qpid/doc/book/src/How-to-Use-SlowConsumerDisconnect.xml +++ b/qpid/doc/book/src/How-to-Use-SlowConsumerDisconnect.xml @@ -21,7 +21,7 @@ under the License. --> -
+
Slow Consumer Disconnect - User Guide
diff --git a/qpid/doc/book/src/Java-Environment-Variables.xml b/qpid/doc/book/src/Java-Environment-Variables.xml index e4da38a260..12703190f2 100644 --- a/qpid/doc/book/src/Java-Environment-Variables.xml +++ b/qpid/doc/book/src/Java-Environment-Variables.xml @@ -20,7 +20,7 @@ --> -
+
Java Environment Variables diff --git a/qpid/doc/book/src/Qpid-Java-Broker-Management-CLI.xml b/qpid/doc/book/src/Qpid-Java-Broker-Management-CLI.xml index 3042e53a3f..84c4b7b7a4 100644 --- a/qpid/doc/book/src/Qpid-Java-Broker-Management-CLI.xml +++ b/qpid/doc/book/src/Qpid-Java-Broker-Management-CLI.xml @@ -20,7 +20,7 @@ --> -
+<section id="Qpid-Java-Broker-Management-CLI"><title> Qpid Java Broker Management CLI
diff --git a/qpid/doc/book/src/Qpid-Java-Build-How-To.xml b/qpid/doc/book/src/Qpid-Java-Build-How-To.xml index f38109a3fb..9f3625760a 100644 --- a/qpid/doc/book/src/Qpid-Java-Build-How-To.xml +++ b/qpid/doc/book/src/Qpid-Java-Build-How-To.xml @@ -20,7 +20,7 @@ --> -<section><title> +<section id="Qpid-Java-Build-HowTo"><title> Qpid Java Build How To diff --git a/qpid/doc/book/src/Qpid-Java-FAQ.xml b/qpid/doc/book/src/Qpid-Java-FAQ.xml index 2144d3a533..845c343350 100644 --- a/qpid/doc/book/src/Qpid-Java-FAQ.xml +++ b/qpid/doc/book/src/Qpid-Java-FAQ.xml @@ -20,7 +20,7 @@ --> -
+<section id="Qpid-Java-FAQ"><title> Qpid Java FAQ diff --git a/qpid/doc/book/src/Qpid-Troubleshooting-Guide.xml b/qpid/doc/book/src/Qpid-Troubleshooting-Guide.xml index cc642f2cdb..0920f18798 100644 --- a/qpid/doc/book/src/Qpid-Troubleshooting-Guide.xml +++ b/qpid/doc/book/src/Qpid-Troubleshooting-Guide.xml @@ -20,7 +20,7 @@ --> -
+
Qpid Troubleshooting Guide diff --git a/qpid/doc/book/src/Use-Priority-Queues.xml b/qpid/doc/book/src/Use-Priority-Queues.xml index eeac3de06d..466d958d43 100644 --- a/qpid/doc/book/src/Use-Priority-Queues.xml +++ b/qpid/doc/book/src/Use-Priority-Queues.xml @@ -20,7 +20,7 @@ --> -<section><title> +<section id="Priority-Queues"><title> Use Priority Queues diff --git a/qpid/doc/book/src/css/style.css b/qpid/doc/book/src/css/style.css new file mode 100644 index 0000000000..2a1bee8623 --- /dev/null +++ b/qpid/doc/book/src/css/style.css @@ -0,0 +1,129 @@ +/* + * + * 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. + * + */ +ul { + list-style-type:square; +} + +th { + font-weight: bold; +} + +.navfooter td { + font-size:10pt; +} + +.navheader td { + font-size:10pt; +} + +body { + width:950px; + margin-left:100px; + margin-top:40px; + + background:#FFFFFF; + font-family:"Verdana", sans-serif; + font-size:10pt; +} + +body a { + color:#000000; +} + + +div.book { + margin-left:10pt; + margin-right:10pt; +} + +div.preface { + margin-left:10pt; + margin-right:10pt; +} + +div.chapter { + margin-left:10pt; + margin-right:10pt; +} + +div.section { + margin-left:10pt; + margin-right:10pt; +} + +div.titlepage { + margin-left:-10pt; + margin-right:-10pt; +} + +.calloutlist td { + font-size:10pt; +} + +.table-contents table { + border-spacing: 0px; +} + +.table-contents td { + font-size:10pt; + padding-left:6px; + padding-right:6px; +} + +.chapter h2.title { + font-size:20pt; + color:#0c3b82; +} + +.chapter .section h2.title { + font-size:18pt; + color:#0c3b82; +} + +.section h2.title { + font-size:16pt; + color:#0c3b82; +} + +.section h3.title { + font-size:14pt; + color:#0c3b82; +} + +.section h4.title { + font-size:12pt; + color:#0c3b82; +} + +.section h5.title { + font-size:12pt; + color:#0c3b82; +} + +.section h6.title { + font-size:12pt; + color:#0c3b82; +} + +.toc a { + font-size:9pt; +} + -- cgit v1.2.1