doc: replace publican with xmlto

Graphics / Wayland / Wayland - Peter Hutterer [who-t.net] - 22 September 2014 02:30 UTC

Publican isn't packaged for some distros, xmlto is a lot more common. Most of what publican provides for us is the stylesheet anyway, so we can just use xmlto and the publican stylesheet to get roughly the same look.

PDF and XML generation has been dropped, this needs a bit more more effort than a mere switchover to xmlto.

The top-level directory structure imposed by publican is kept for now (specifically the Wayland/en-US/html tree). This makes it easier to transition over for packagers. Note that the list of files inside has changed.

CSS files are taken from publican to keep a uniform look compared to previous documentations. Stylesheets are licensed under CC0 1.0 Universal license, see publican/LICENSE:

1. Files in the datadir/Common_Content directory and its subdirectories are licensed under the CC0 1.0 Universal license.

To the extent possible under law, the developers of Publican waive all copyright and related or neighboring rights to the files contained in the datadir/Common_Content directory and its subdirectories.

f3e7eed doc: replace publican with xmlto
configure.ac | 12 +-
doc/publican/Makefile.am | 70 +-
doc/publican/publican.cfg | 9 -
doc/publican/sources/css/brand.css | 14 +
doc/publican/sources/css/common.css | 1769 ++++++++++++++++++++++++++++++++++
doc/publican/sources/css/default.css | 3 +
doc/publican/sources/css/epub.css | 115 +++
doc/publican/sources/css/print.css | 15 +
8 files changed, 1956 insertions(+), 51 deletions(-)

Upstream: cgit.freedesktop.org

  • Share