On Thu, 4 Sep 2014 17:32:10 +1000 Peter Hutterer <peter.hutte...@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 _______________________________________________ wayland-devel mailing list wayland-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/wayland-devel