Convert CSS2 to Bikeshed #5196
Convert CSS2 to Bikeshed #5196
Commits on Jun 10, 2020
-
-
[CSS2] Add way more dfn elements
This primarily marks up many (but not all) property value definitions as being property values for their respective properties. The choice is mostly those keywords that exist in other specs; this should be further completed in due course.
-
[CSS2] lowercase all HTML tag names
This is in preparation for conversion to Bikeshed; both because the forthcoming conversion relies on parse/serialize cycles (using html5lib, which doesn't support preserving case) and because Bikeshed itself relies on tags when they appear in BSMD being lowercase.
-
[CSS2] eliminate new line characters within HTML tags
This is done for the same reason as the previous commit (both Bikeshed conversion tooling does this, so this limits the diff in that single commit making blame more workable, and because Bikeshed does not handle tags split across multiple lines). Note that this doesn't deal with new lines within attributes yet.
-
[CSS2] put source files through a html5lib parse/serialize cycle
This is, similar to parent commits, prior to the Bikeshed conversion to make more easily ignored from blame (plus also is easier to review). Most of this just gets rid of ambiguous ampersands and makes quoting of elements consistent (the choice of quotes is done to minimize the size of this diff).
-
[CSS2] Concatenate all source files into Overview.bs
Plus get rid of all the old source files (to git can correctly notice the lines have moved) as well as the old build system and the committed output.
-
[CSS2] Redo the previous concat based on parsed input
This doesn't actually produce a particularly large diff, contrary to what one might expect. This primarily just gets rid of head elements. The algorithm used here is pretty simple: 1. Start with cover.src, then for each chapter/appendix: 2. Append the contents of the body element to the existing body 3. If the style element in the head has content not yet seen, add it to the existing head. -
-
[CSS2] include property definitions
These BSMD blocks were generated with a modified version of the old propdef generator, but should be trivially correct.
-
-
-
The q0 anchors date back to the original 2011 publication of CSS 2.1 and are all applied to the top-level headings within each page. As such, they're essentially unused (because everywhere just links to the top of the page). Additionally, the q0 anchors were removed when CSS 2.1 was edited in place in 2016 (see w3c#2551).
-
[CSS2] Move anchors to the header element itself
The old build system always took the first anchor within the header as the header's anchor, but Bikeshed (very reasonably) expects the anchor to be on the header itself. Note in many cases we also provide "legacy" anchors as spans within the header; these are unchanged.
-
[CSS2] remove strong outwith/within dfn
In plenty of places we have strong directly nested within dfn or dfn directly nested within strong; in both cases this is unnecessary as the goal here is purely presentational and the current TR stylesheet boldens all dfns anyawy.
-
[CSS2] turn index definitions into dfns
The old build system generated its index through specific markup rather than using all dfns. In reality, most of the things marked up for the index are actually generally useful dfns (this is unsurprising, given the index contains things people might want to lookup!).
-
-
-
[CSS2] further remove strong adjacent to dfn
This is needed as moving the IDs got rid fo a number of spans, therefore making new strong elements now adjacent.
-
-
[CSS2] make "instances" of terms be autolinks
Amusingly, some of the index instances are never actually defined.
-
-
[CSS2] replace <pre><code class=css> with <pre class=lang-css>
The former produces quotes around the element in the BS output; the latter enables CSS syntax highlighting. The latter seems like the better behaviour.
-
[CSS2] add lang-xml to some pre elements
This just adds lang-xml to pre elements with no lang-* class whose contents can be parsed as XML, as it is unlikely for arbitrary content to parse as XML (potentially some of this is intended to be HTML, but highlighting it as if it is XML is unlikely to be harmful).
-
[CSS2] add lang-css to some pre/code elements
This, similar to the previous commit, adds lang-css when there is no lang-* class already and the content parses as CSS without any parse errors. As CSS is more permissive, the automated script added slightly too much here and a little was manually reverted.
-
[CSS2] Remove new lines from attribute values
This happens to only be in img[alt]
-
[CSS2] add ids to all images for compatibility
The old built system added an ID to all imgs, so we should to.
-
-
[CSS2] Change the spec reference syntax to the BSMD one
The old CSS2 build system used [[FOO]] for a normative reference and [[-FOO]] for a non-normative one. BSMD uses [[!FOO]] for a normative reference and [[FOO] for a non-normative one.
-
-
-
[CSS2] stop requiring some old IDs
This drops IDs for: index xrefs (x[n]), bits of generated content (annoying-warning, minitoc, W3C-doctype), refs (ref-*), and the index sections (index-[A]). Only the first might be referenced at all, and unfortunately they are not unique across all pages unlike all other anchors.
-
-
-
-
