Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bikeshed output fails Specberus validation for WD #802

Closed
vijaybh opened this issue Sep 2, 2016 · 4 comments
Closed

Bikeshed output fails Specberus validation for WD #802

vijaybh opened this issue Sep 2, 2016 · 4 comments

Comments

@vijaybh
Copy link

vijaybh commented Sep 2, 2016

I hit this when trying to publish https://www.w3.org/TR/2016/WD-webauthn-20160902/ through Echidna.

Error (fatal):

  • Bikeshed puts some local CSS after the W3C stylesheet. The pubrules say the W3C stylesheet must be last.

Warnings (not fatal but easily fixed):

  • Local CSS includes -webkit-fit-content which is flagged as vendor-specific
  • Should put a "back to top" link at the end of the body

Aesthetic (not flagged but it bothered me):

  • body element is not closed (i.e. no is generated)
@tabatkins
Copy link
Collaborator

Bikeshed puts some local CSS after the W3C stylesheet. The pubrules say the W3C stylesheet must be last.

Fixed now. (This was something that had to be handled by an extension script in your includes/webauthn folder, but most of the changes are things that should be safe to run for all Echidna specs, so I moved them to just happen by default.)

Local CSS includes -webkit-fit-content which is flagged as vendor-specific

I'll see if I can get this unflagged as a problem. Ignore for now.

Should put a "back to top" link at the end of the body

Hmm, this must be a new requirement. I'll investigate and see if I need to do anything or if it should be rolled back.

body element is not closed (i.e. no is generated)

There are lots of elements without end tags in a Bikeshed document, as it omits all the omittable end tags on purpose. ^_^

Should put a "back to top" link at the end of the body

@vijaybh
Copy link
Author

vijaybh commented Sep 8, 2016

Bikeshed puts some local CSS after the W3C stylesheet. The pubrules say the W3C stylesheet must be last.

Fixed now. (This was something that had to be handled by an extension script in your includes/webauthn folder, but most of the changes are things that should be safe to run for all Echidna specs, so I moved them to just happen by default.)

I just pulled down the latest bikeshed and this appears to still be broken for me. I ran Bikeshed on the spec and the W3C stylesheet was still before the local CSS.

Then I noticed that the code change puts this new processing in an if prepTR, so I tried adding "Prepare for Tr: true" to the metadata. That led to this error (I've changed the Windows style slashes to the Unix style so they show up better in the comment):

Traceback (most recent call last):
File "/Python27/Scripts/bikeshed-script.py", line 9, in
load_entry_point('Bikeshed==0.0.0', 'console_scripts', 'bikeshed')()
File "<path_to_bikeshed>/bikeshed/init.py", line 191, in main
doc.preprocess()
File "<path_to_bikeshed>/bikeshed/init.py", line 588, in preprocess
for el in findAll("[rel ~= 'icon']", doc):
NameError: global name 'doc' is not defined

@tabatkins
Copy link
Collaborator

Ah darn, that's what I get for not actually testing the code. Fixed, sorry.

I ran Bikeshed on the spec and the W3C stylesheet was still before the local CSS.

As you found, these fixups are gated by the Prepare for TR metadata. If you're using bikeshed echidna, this gets flipped on for you automatically.

@vijaybh
Copy link
Author

vijaybh commented Sep 8, 2016

Thanks, works now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants