Boost C++ Libraries
PrevUpHomeNext

Chapter 2. Installing Boostbook and Quickbook

Table of Contents

Introduction
Installation Recipes
Windows
OS X
Debian and Ubuntu
Pre-build quickbook

Introduction

This chapter describes how to install the basic documentation tools that make up the Boost documentation toolchain. This isn't enough for building the full Boost documentation, but it's enough to start using quickbook or boostbook. The basic requirements are:

  • Boost Build
  • xsltproc, which is a part of libxslt.
  • Norman Walsh's DocBook XSL stylesheets - Note that sourceforge has organized these files so that the documentation for the stylesheets is the first set of files offered for download; you have to look farther down for the actual stylesheets.
  • The DocBook DTD

Installing all of these parts can be quite tricky, so the next section contains recipes to set them up for Windows, OS X, Debian and Ubuntu. Other configurations are of course possible, but we've found these ones effective.

They assume that you have already installed Boost.Build and are familiar with the basics of using it, see the getting started guide for an introduction. It's generally a good idea to install Boost.Build from source, the prebuilt packages are often out of date.

PrevUpHomeNext