doc/bugs/meta_plugin_should_not_add_alternate_stylesheets_and_title_by_default.mdwn

   1 The meta plugin, when used to add a stylesheet to a page, adds the
   2 following attributes by default:
   3
   4   - `rel="alternate stylesheet"`
   5   - `title="mystylesheet"`
   6
   7 The intent of this feature, according to the documentation is to "add a
   8 stylesheet to a page".
   9
  10   - By setting the `rel="alternate stylesheet"`, the additional
  11     stylesheet is treated as an "alternate stylesheet" as described in
  12 <http://www.w3.org/Style/Examples/007/alternatives.en.html> and is not
  13 activated by default in the browser. The user is responsible for
  14 activating them somehow.
  15   - The `title` attribute is used to *group* several alternate style
  16     sheets into a single one. This attribute is otherwise "purely
  17 advisory" as defined in
  18 <http://www.w3.org/TR/html5/document-metadata.html#attr-link-title>.
  19
  20 The current default behavior of the plugin implies having the additional
  21 stylesheet not activated (if you don't set `rel="stylesheet"`) or only
  22 one of them activated (if you add two stylesheets and not set the same
  23 title for both). This was hard to understand for two of us while working
  24 on <https://labs.riseup.net/code/issues/9314> and until we went and read
  25 those W3C documents.
  26
  27 I think that to match better the description of that feature, and to be
  28 easier to comprehend in its default setting, the meta plugin should by
  29 default:
  30
  31   - Set `rel="stylesheet"`.
  32   - Not set any `title`.
  33
  34 If we agree on this proposal, I'm willing to provide a patch.
  35
  36 This applies to all versions since c8b4ba3 and until today.