[PATCH wayland] doc: replace publican with xmlto
ppaalanen at gmail.com
Thu Sep 4 01:38:05 PDT 2014
On Thu, 4 Sep 2014 17:32:10 +1000
Peter Hutterer <peter.hutterer at who-t.net> wrote:
> 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
> 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.
> I didn't know if you wanted to merge this before the release. This is pretty
> much the minimum required, a full conversion would mean generating PDF again
> (not sure XML is worth it) and re-arranging a few trees.
> Either way, this one passes make distcheck and generates HTML that looks
> almost the same as the publican output.
Excellent, thank you. I think we should get this in as one of the first
things in the 1.7 development cycle.
I'm happy with just HTML generation, I would guess that is the main
format for people using these docs.
> 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(-)
> delete mode 100644 doc/publican/publican.cfg
> create mode 100644 doc/publican/sources/css/brand.css
> create mode 100644 doc/publican/sources/css/common.css
> create mode 100644 doc/publican/sources/css/default.css
> create mode 100644 doc/publican/sources/css/epub.css
> create mode 100644 doc/publican/sources/css/print.css
More information about the wayland-devel