openstack-manuals/doc/high-availability-guide
Andreas Jaeger c01f511f30 Fix broken URLs
This fixes a number of broken URLs in the guides.

Change-Id: Iae027614ec7466fefafa1b504b348f795bb5fac7
Partial-Bug: #1225093
2013-10-01 08:53:26 +02:00
..
figures Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
includes openstack-ha: Networking Highly Available 2013-09-09 14:18:53 +02:00
locale Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-automated-deployment.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-computes.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-controllers.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-database.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-haproxy.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-network.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
aa-overview.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-rabbitmq.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
aa-storage.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-node.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-pacemaker.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-api-vip.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-ceilometer-agent-central.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-cinder-api.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
ap-cloud-controller.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-glance-api.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
ap-keystone.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
ap-mysql.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-network-controller.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
ap-neutron-server.txt Fix broken URLs 2013-10-01 08:53:26 +02:00
ap-overview.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-pacemaker.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ap-rabbitmq.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ha-guide-docinfo.xml Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
ha-guide.txt openstack-ha: Networking Highly Available 2013-09-09 14:18:53 +02:00
intro.txt Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00
pom.xml Corrected spelling, grammar, and formatting errors, and updated pom file to 1.10.0 2013-09-20 11:50:30 -05:00
README Folder rename, file rename, flattening of directories 2013-09-08 15:15:50 -07:00

This directory contains what's eventually intended to become reference
documentation for OpenStack High Availability.

Contrary to the rest of the documentation which is straight-up
DocBook, this guide is being maintained, at least for the time being,
in AsciiDoc. AsciiDoc processing is supported by the OpenStack Jenkins
CI infrastructure, but not by the Maven toolchain. So as a stop-gap
measure until such support becomes available, please do this if you
want to build offline before you send a patch:

1. Make your change to the AsciiDoc source file (.txt). The syntax
   should be self explanatory-and intuitive to anyone who's ever used
   something like Markdown or RST. The AsciiDoc cheatsheet is an
   extremely useful resource: http://powerman.name/doc/asciidoc

2. Pipe your stuff through AsciiDoc. Here's one catch: AsciiDoc
   currently doesn't fully support DocBook 5, but the Maven toolchain
   requires it. So you'll have to run your AsciiDoc output through the
   "db4upgrade.xsl" stylesheet that ships with DocBook 5.

3. Finally, indent your resulting XML with two spaces. This should
   produce a clean patch against bk-ha-guide.xml which you can then
   submit to Gerrit along with your .txt file patch.

4. Add an "xml:id" attribute on the root <book> element. The Maven
   toolchain requires this.

Here's a command line you can use with AsciiDoc, xsltproc, xmllint and
sed to achieve all of the above:

asciidoc -b docbook -d book -o - ha-guide.txt | \
  xsltproc -o - /path/to/db4-upgrade.xsl - | \
  xmllint --format - | \
  sed -e 's,^<book ,<book xml:id="bk-ha-guide" ,' \
  > bk-ha-guide.xml

Admittedly, the sed hack is particularly ugly, but it does get the job
done.

After that, you should be able to build with "mvn clean
generate-sources" as you normally would.