1.2.1 • Published 2 years ago

reveal-timeline v1.2.1

Weekly downloads
-
License
-
Repository
-
Last release
2 years ago

reveal-timeline

npm version npm publish

A reveal.js plugin for adding a timeline to slides:

demo

Check out the live demo.

The timeline is generated using timeline.js.


Installation

  1. Download and install the package in your project:

    npm install --save reveal-timeline

    or

    yarn add reveal-timeline

    or just download dist/reveal-timeline.js into the plugin folder of your reveal.js presentation, e.g.. plugins/reveal-timeline.

  2. Add the plugins to the dependencies in your presentation

    <script src="node_modules/reveal-timeline/dist/reveal-timeline.js"></script>
    // ...
    Reveal.initialize({
      // ...
      plugins: [
          // ...
          RevealTimeline,
      ]
    });

    If you're using reveal-md you can add a script to load the plugin:

    options.plugins.push(RevealTimeline)

    and then add a reference to this script along with node_modules/reveal-timeline/dist/timeline.js to the scripts object inside reveal-md.json config file.

For reference, take a look at the demo package in this repo.


Usage

The timeline is generated by parsing section data attributes:

HTML attributetimeline.js propertyoptionalpossible values
data-timeline-start-datestart_dateonly for titleISO 8601 date
data-timeline-end-dateend_dateyesISO 8601 date
data-timeline-headlinetext.headlineyesany text
data-timeline-groupgroupyesany text
data-timeline-display-datedisplay_dateyesany text
data-timeline-autolinkautolinkyesboolean
idunique_idyesa unique string

If data-timeline-headline is not defined, the headline will be a concatenation of all headings in a slide.

In addition, adding the attribute data-timeline-hidden to a slide will cause the timeline to be removed from this slide.

For more details, see timeline.js documentation.


Configuration

To configure the plugin pass a timeline object to Reveal.initialize with any of the following options:

namepurposeallowed valuesdefault
positiontimeline position'top' or 'bottom''bottom'
heighttimeline heightCSS \ or number of pixels'140px
separatorseparator between headline linesany text'<br><br>'
1.2.1

2 years ago

1.2.0

2 years ago

1.1.0

2 years ago

1.0.2

2 years ago