- on slides: .slide x=y
- on elements: .element x=y
Those are detected in html comment, in order to not be visible
if a markdown is edited in an html editor.
The first slide of a vertical stack see some data attributes ignored.
Mainly the data-transition one.
Repeat all data-attributes on the wrapping section element.
Ignore any other attributes (like 'id="xxx"'), in order to not
mess with internal links (by repeating twice an id).
By default, look for <!-- slide-attributes: xxxx -->.
Whatever 'xxx' is will be added to the section attributes.
You can define your own pattern with 'data-attributes'.
For instance 'data-attributes="^\s*?-- (.*?)$"':
that will be added to the options.
The 'attributes' section is removed from the content of the slide,
so the final markdown doesn't reflect them.
That also means you can add those attributes *anywhere* in the slide
But that allows for *any* attribute to be added for a specifc slide,
like:
- id="plan", for allowing internal link (issue #430)
- data-background="#ff0000"
- data-transition="fade"
You list those attributes on a single line, like
- (default):
` <!-- id="plan" data-background="#ff0000" -->`
- or, with an alternative data-attributes pattern:
` -- id="plan" data-background="#ff0000"`
Again, that line is remove from the final content.
1. Show an alert when loading the file throws an exception
2. Whenever the status isn't success (2xx) - upon exception or e.g.
"file not found" - replace the section's content with information
about the failure (instead of being silent about it and showing
a blank slide).
We need to inform the user something went wrong, not just be silent
about it. An experienced developer, upon seing a blank slide, will
likely check the javascript console - but the rest will profit from
being told about the problem (and solution) explicitely.
Hakim El Hattab