editorial: revise custom stylesheets

[pkra]

Resolves #2226

• revise common.css
  • do we need any of it?
  • reduce css as per remove spec specific css or inline it #2226 (comment)
  • .image => remove after switching markup to figure
  • table styles (why does respec add borders in dark but not light mode?)
    • consider replacing our table styles with table.def from w3.org/StyleSheets/TR/2021/base.css (i.e., remove our custom styles and replace table classes with .def)
  • fix color contrast issues
    • color contrast issues speced/respec#4871
    • dark mode: th{ background-color:#eee; } (cf. Text-to-background contrast in tables under ARIA's Definition of Roles too low #2394 + duplicates)
    • syntax highlighting (light mode: IDL - dark mode: almost every code example)
      • specify a more accessible highlight.js palette
      • fix incorrect language detection such as #example-48 => https://github.com/speced/respec/wiki/ReSpec-Editor's-Guide#examples
  • ...
• revise core-aam.css
  • reduce css as per remove spec specific css or inline it #2226 (comment)
  • remove core-aam.css as they are covered via common.css
• pdf-aam: remove link to (now removed) core-aam.css
• accname styles
  • check remove spec specific css or inline it #2226 (comment) => less than reduced common.css for aria [the stylesheet has already been dropped]
• mapping-tables.css
  • ...
• editors.css - remove?
• slices.css - remove?
• html-aam.css - remove

---

Preview | Diff

[netlify]

✅ Deploy Preview for wai-aria ready!

Name	Link
🔨 Latest commit	c230c2c
🔍 Latest deploy log	https://app.netlify.com/sites/wai-aria/deploys/677fbef3eb5c0c00084aa39a
😎 Deploy Preview	https://deploy-preview-2410--wai-aria.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[pkra]

notes to self:

• the reduction of common.css in remove spec specific css or inline it #2226 (comment) includes more declarations than the reductions in remove spec specific css or inline it #2226 (comment) (core-aam) and remove spec specific css or inline it #2226 (comment) (accname). So we can start there.
• core-aam loads both core-aam.css and common.css so we can reduce core-aam.css further

[pkra]

It turns out, core-aam only sets styling that are already set in common.css.

[pkra]

@jnurthen @spectranaut @daniel-montalvo I think I actually want to suggest to remove all of common.css.

Almost all of it is minor stylistic differences to what respec does (i.e., everything after the table styles).

For tables, I would suggest to switch to respec's table.def styles. Very different but that's what they're for and it seems better to stick with respec for maintenance.

The only other bit are the nested lists styles. However, only accname actually needs these (and I feel like respec or W3C TR styles should be doing a better job here - but they probably don't want to risk it but perhaps be open to opt-in classes).

[For completeness: there are 2 nested lists in aria in 4.3.2 - all other nested lists in specs are from respec TOCs where the styles are set by respec.]

I'll prep something for the next editors meeting so we can go through them together.