A guide to the Research & Education Space for contributors and developers
HTML Makefile CSS
Clone or download
Prashanth Devarajappa
Latest commit d839346 Mar 29, 2017
Permalink
Failed to load latest commit information.
appendices
architecture
developers
indices
publishers
res-intro
using
.gitignore
Makefile.am
README.md
acropolis-architecture.svg
bibliography.xml Initial commit. Apr 17, 2014
book.xml
buildrules.make
describing.xml
glossary.xml
index.html
inside-acropolis.pdf
legal.xml RESDATA-1113 : [tentative] Fix typos and re generate index.html which… Mar 22, 2017
local.css
masthead.png Initial commit. Apr 17, 2014
powered-by-res-icon-green-text.jpeg RESDATA-1113 : Adding RES logo and more changes for website. Mar 29, 2017
preface.xml
res-architecture.svg Clean up introductory chapter (#23) and add a high-level diagram of h… May 28, 2015

README.md

Inside Acropolis

This is Inside Acropolis, a guide to the Research & Education Space for contributors and developers.

This is an open-content book, licensed under the terms of the Open Government Licence, v2.0. Accompanying code and samples are licensed under the terms of the Apache License, Version 2.0.

The canonical version of the book can be found at:

https://bbcarchdev.github.io/inside-acropolis/

Building the book

Inside Acropolis is written using DocBook 5, an XML-based mark-up language designed for technical publishing. The file book.xml contains the root element, and uses XInclude to combine the various chapters into a single document for processing.

The book is converted to HTML using a set of XSL stylesheets.

The PDF version of the book is generated using wkpdf, which is unfortunately only available for Mac OS X. While wkhtmltopdf shows promise as a cross-platform alternative, at the time of writing the rendering quality is not yet on a par with wkpdf.

To re-build the HTML or PDF, first clone this repository and the RES XSL stylesheets:

$ git clone https://github.com/bbcarchdev/inside-acropolis.git
$ cd inside-acropolis
$ git clone https://github.com/bbcarchdev/docbook-html5.git

Next, after modifying the DocBook sources, you can re-build the HTML with:

$ make -f buildrules.make

If you have wkpdf installed, you can generate the PDF from the HTML with:

$ make -f buildrules.make pdf