yelp-xsl wip/html5 -> master

[Doug Smythies]

I think it will also affect the serverguide
libs/ubuntu.xsl and maybe the libs/ubuntu-pdf.xsl files.

-----Original Message-----
From: ubuntu-doc-bounces at lists.ubuntu.com [mailto:ubuntu-doc-bounces at lists.ubuntu.com] On Behalf Of Jeremy Bicha
Sent: May 23, 2017 7:05 PM
To: Ubuntu Doc
Subject: Fwd: yelp-xsl wip/html5 -> master

For Ubuntu, I think this will mostly affect html/ubuntu.xsl in
ubuntu-docs that is used to build https://help.ubuntu.com/ .

Jeremy

---------- Forwarded message ----------
From: Shaun McCance <shaunm at gnome.org>
Date: Tue, May 23, 2017 at 11:14 AM
Subject: yelp-xsl wip/html5 -> master
To: gnome-doc-list at gnome.org


Finally, I have merged the wip/html5 branch of yelp-xsl to master.
There will have to be updates to yelp and yelp-tools in this release
cycle to match.

If you have customizations on top of yelp-xsl (for example, that you
pass to yelp-build or pintail), you will almost certainly need to
change them. This is true even if you just changed some CSS. Here's an
incomplete summary of some of the changes:

* Various divs have been replaced with semantic HTML5 elements like
article, section, and nav.

* The main page layout uses two flexboxes for layout, the outer
vertical and the inner horizontal.

* In general, quite a few layouts have been switched to flexbox. For
example, image tiles are now flexbox instead of inline-block.

* Horizontal max-width and centering happens on more deeply nested
elements, making it easier to do certain customizations.

* There are no more external images. It's all inline SVG, stylable with
CSS FTW.

* jQuery has been removed.

* Syntax highlighting has been switched to highlight.js (away from
jQuery.Syntax). Colorizers are now included by default.

* Speaking of colors, the themes color names are different and more
extensive. Most of the colors can be computed automatically using color
algorithms that probably never should have been written in XSLT.


Please pass this information along to anybody you think might be
affected by these changes.

Thanks,
Shaun

_______________________________________________
gnome-doc-list mailing list
gnome-doc-list at gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

-- 
ubuntu-doc mailing list
ubuntu-doc at lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc