ES reference pages updated to Docbook 5 / HTML 5

I’ve udpated the ES 3 API and GLSL reference pages to Docbook 5 source and HTML5 output. They are now using MathJax for rendering equations on browsers that don’t support MathML (e.g. everything except Firefox, basically). There’s an improved (hopefully) sidebar navigation interface and some CSS changes to be more similar to the OpenCL reference pages.

If you currently have browsers open on the ES SDK ref pages, please do a full page reload to make sure you get all the new content.

Because many people probably arrive at the man pages via search engine links, and because IE8 and earlier browsers don’t deal well with HTML5, the old pages are now redirection links which point to the current index page but also allow escaping to cached copies of the XHTML Transitional output. Eventually these will be purged (I think IE <= 8 users are less than 10% of khronos.org site visits these days, probably much less for people visiting ES reference pages). Hopefully the search engines will start linking to the HTML5 pages soon, but that’s outside our control.

If you have problems or other feedback, please report it here. This has also been done for the GL ref pages on opengl.org. The build instructions on the Wiki are now way out of date and will also be updated soon (quick version: you need the latest docbook-xsl-ns 1.78.1 stylesheets installed).

If you’re using the Docbook sources and don’t want to migrate to Docbook 5 yet, the old sources are still available in docbook4/ subdirectories in Subversion, but they will not be updated going forward.

This topic was automatically closed 183 days after the last reply. New replies are no longer allowed.