[PATCH wayland] doc: replace publican with xmlto

[Pekka Paalanen]

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
> 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.
> ---
> 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.


Thanks,
pq

>  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