A reusable function for history timelines.
JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css
docs
htlBuilder
htlQuizzer
images
js
test
tl
LICENSE
Notes for Lars.txt
README.md
historytimeline.html
modernIsrael.html
one-callTimeline.html

README.md

historytimeline

Overview timeline

historytimeline is a library which draws history timelines on a random webpage requiring only the inclusion on the page of the library itself and the data file describing the timeline (no CSS file is required). historytimeline uses timeline data in a particular format which can be generated with the companion app htlBuilder but is simple enough to be hand-coded.

All of the code and documentation is available on GitHub here. The project is ongoing and anyone with the interest and skill to contribute is welcome to contact the lead developer [b@ruml.com]. Design contributions are as eagerly sought as code.

Features

Of course, the main point is to draw a beautiful timeline which clearly depicts the information provided by the timeline's creator. The timeline above displays a series of labelled eras commonly used in the study of the Hebrew Bible. There is a live version here.

One problem with many timelines is excessive busyness: too much information being displayed at once. So a major challenge is to hide the second-level information until the user asks for it in some simple way. Two relevant kinds of information are not shown on the timeline above: the start and end dates of each era and the description of what caused an era to begin and end.

Precipitating Events

Overview timeline

historytimeline provides a way to display both of these when the cursor is held over that era. In the timeline above, the cursor is over the United Kingdom era and the dates for the era appear above it.