aboutsummaryrefslogtreecommitdiff
path: root/doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn
blob: 314597cb53ad7505a046aab77e7b3afe4cf90eb6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
The meta plugin, when used to add a stylesheet to a page, adds the
following attributes by default:

  - `rel="alternate stylesheet"`
  - `title="mystylesheet"`

The intent of this feature, according to the documentation is to "add a
stylesheet to a page".

  - By setting the `rel="alternate stylesheet"`, the additional
    stylesheet is treated as an "alternate stylesheet" as described in
<http://www.w3.org/Style/Examples/007/alternatives.en.html> and is not
activated by default in the browser. The user is responsible for
activating them somehow.
  - The `title` attribute is used to *group* several alternate style
    sheets into a single one. This attribute is otherwise "purely
advisory" as defined in
<http://www.w3.org/TR/html5/document-metadata.html#attr-link-title>.

The current default behavior of the plugin implies having the additional
stylesheet not activated (if you don't set `rel="stylesheet"`) or only
one of them activated (if you add two stylesheets and not set the same
title for both). This was hard to understand for two of us while working
on <https://labs.riseup.net/code/issues/9314> and until we went and read
those W3C documents.

I think that to match better the description of that feature, and to be
easier to comprehend in its default setting, the meta plugin should by
default:

  - Set `rel="stylesheet"`.
  - Not set any `title`.

If we agree on this proposal, I'm willing to provide a patch.

This applies to all versions since c8b4ba3 and until today.