Home | Archives

PostgreSQL EPUB

The other day, I made it sound like building an EPUB file from the PostgreSQL Manual under Mac OS X was really difficult, but it turns out I was wrong about that. I just had to get over my reluctance to resort to MacPorts. With that out of the way, you can just go:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
sudo port install docbook-dsssl \
                  docbook-sgml-4.2 \
                  docbook-xml-4.2 \
                  docbook-xsl \
                  libxslt \
                  openjade \
                  opensp  
cd postgres-9.4.4/
./configure
cd doc/src/sgml
make postgres.epub

Et voilĂ !

On the other hand, I also figured a way to make it even easier (for certain values of easier) and keep MacPorts out of the mix, using a purpose-built Docker container, with the docbook toolchain installed from Debian and the configure && make taken care of during the build. If run with a local directory mounted in to a volume, it just spits the finished EPUB out at you and exits. I posted it as a snippet on Bitbucket.

Of course, now that I've gone through all this, you don't have to. You can just grab the 9.4.4 (latest stable, as of this writing) PostgreSQL Manual from me. I also plan to post again if there's an update.