Skip to content
ADVERTISEMENT
Sign In
  • Sections
    • News
    • Advice
    • The Review
  • Topics
    • Data
    • Diversity, Equity, & Inclusion
    • Finance & Operations
    • International
    • Leadership & Governance
    • Teaching & Learning
    • Scholarship & Research
    • Student Success
    • Technology
    • Transitions
    • The Workplace
  • Magazine
    • Current Issue
    • Special Issues
    • Podcast: College Matters from The Chronicle
  • Newsletters
  • Events
    • Virtual Events
    • Chronicle On-The-Road
    • Professional Development
  • Ask Chron
  • Store
    • Featured Products
    • Reports
    • Data
    • Collections
    • Back Issues
  • Jobs
    • Find a Job
    • Post a Job
    • Professional Development
    • Career Resources
    • Virtual Career Fair
  • More
  • Sections
    • News
    • Advice
    • The Review
  • Topics
    • Data
    • Diversity, Equity, & Inclusion
    • Finance & Operations
    • International
    • Leadership & Governance
    • Teaching & Learning
    • Scholarship & Research
    • Student Success
    • Technology
    • Transitions
    • The Workplace
  • Magazine
    • Current Issue
    • Special Issues
    • Podcast: College Matters from The Chronicle
  • Newsletters
  • Events
    • Virtual Events
    • Chronicle On-The-Road
    • Professional Development
  • Ask Chron
  • Store
    • Featured Products
    • Reports
    • Data
    • Collections
    • Back Issues
  • Jobs
    • Find a Job
    • Post a Job
    • Professional Development
    • Career Resources
    • Virtual Career Fair
    Upcoming Events:
    College Advising
    Serving Higher Ed
    Chronicle Festival 2025
Sign In
Profhacker Logo

ProfHacker

Teaching, tech, and productivity.

The New Web Timeline Tool in Town

By Konrad M. Lawson April 15, 2011
TimelineSetter Example

The coders over at ProPublica, a leading source for independent investigative journalism, have released their new

To continue reading for FREE, please sign in.

Sign In

Or subscribe now to read with unlimited access for as low as $10/month.

Don’t have an account? Sign up now.

A free account provides you access to a limited number of free articles each month, plus newsletters, job postings, salary data, and exclusive store discounts.

Sign Up

TimelineSetter Example

The coders over at ProPublica, a leading source for independent investigative journalism, have released their new TimelineSetter tool under an open license. The tool takes a list of comma separate values (you can follow their example) containing the content for the timeline and spits out a web page to display it, complete with the various additional files needed to display it on any old web server. When these files are uploaded to your server the result are timelines that look like this.

Sounds great, doesn’t it? Well for some, it may take a little time to get up and running. First, the tool runs on Ruby, and you need to install it from the command line. On the Mac or most distros of Linux, this is often as easy as entering “gem install timeline_setter” from a terminal application. There may be complications along the way, though. For example, the folder this got installed in on my system does not allow the command to run the tool (timeline-setter) to be recognized without adding it to the “PATH” variable. This can be confusing to those who are not familiar with such things. Secondly, the command itself has a few parameters: you need to know how to correctly enter in the path where your CSV file is (which you may create in something simple like TextEdit), and the target folder (which must already exist) for the outputted files. The command they provide in the documentation page linked above is not actually quite correct. You need to add an "-a” (or -m to build everything into a single page) to make it output all the files you need to display the timeline correctly. That makes it:

timeline-setter -c /path/to/data.csv -o /path/to/output/directory -a

ADVERTISEMENT

Thus, if I have a timeline file on my Mac desktop called “timeline.txt” and a newly created folder called “timeline” the correct command would be:

timeline-setter -c ~/Desktop/timeline.txt -o ~/Desktop/timeline -a

I then take that folder “timeline” and upload it to my server. I can either edit the “timeline.html” file it creates to add content before and after it or leave it as it is.

[Geek Alert] Because it generates the timeline and all the files based on the “ingredients” you provide it (the CSV file) it is said to “bake” out the results, and doesn’t dynamically pull in the data from the CSV. If one wants to change the timeline, one has to “bake” the timeline again or carefully edit the timeline.html file. This is handy for those who don’t have any server side scripting support but have Ruby support for the local baking. However, I wonder if someone out there has (or is planning to) to create a version of TimelineSetter for servers that support a scripting language such as PHP. This would cut out the need for any baking at all and avoid the above command line work. With an hour or two of coding, it would be relatively easy to inject some PHP into the part of the timeline.html file that calls the TimelineSetter.Timeline.boot function and feed it data dynamically from a hosted CSV file. Anyone want to take this ProfHacker challenge? Post your solution, or a link to the code in the comments! [End Alert]

This new tool is not the only game in town. Here at ProfHacker we have introduced other tools such as Dipity, Storify, and also timeline programs for your desktop.

ADVERTISEMENT

The most mature and powerful web timeline tool out there, however, has to be the SIMILE Timeline tool out of MIT. It has far more flexibility and power than the young TimelineSetter project and is also better, in my opinion, at handling complex timelines with many events. Your chosen solution will probably depend on what you want to accomplish. However, in the case of SIMILE Timeline, with power comes complexity and a learning curve.

Fortunately, our own ProfHacker, Brian “the Chronolomancer” Croxall has got your back. He has created a series of tutorials, including screencasts, that will help you get up and running with SIMILE Timeline and allow you to create timelines with data pulled directly out of a Google spreadsheet. I strongly recommend that aspiring acolytes pay his site a visit: Brian’s Timeline Tutorials

[Creative Commons licensed image by Flickr user neil cummings]

We welcome your thoughts and questions about this article. Please email the editors or submit a letter for publication.
Share
  • Twitter
  • LinkedIn
  • Facebook
  • Email
ADVERTISEMENT
ADVERTISEMENT

More News

Protesters attend a demonstration in support of Palestinian activist Mahmoud Khalil, March 10, 2025, in New York.
First Amendment Rights
Noncitizen Professors Testify About Chilling Effect of Others’ Detentions
Photo-based illustration of a rock preciously suspended by a rope over three beakers.
Broken Promise
U.S. Policy Made America’s Research Engine the Envy of the World. One President Could End That.
lab-costs-promo.jpg
Research Expenses
What Does It Cost to Run a Lab?
Research illustration Microscope
Dreams Deferred
How Trump’s Cuts to Science Funding Are Derailing Young Scholars’ Careers

From The Review

University of Virginia President Jim Ryan keeps his emotions in check during a news conference, Monday, Nov. 14, 2022 in Charlottesville. Va. Authorities say three people have been killed and two others were wounded in a shooting at the University of Virginia and a student is in custody. (AP Photo/Steve Helber)
The Review | Opinion
Jim Ryan’s Resignation Is a Warning
By Robert Zaretsky
Photo-based illustration depicting a close-up image of a mouth of a young woman with the letter A over the lips and grades in the background
The Review | Opinion
When Students Want You to Change Their Grades
By James K. Beggan
Photo-based illustration of a student and a professor, each occupying a red circle in a landscape of scribbles.
The Review | Opinion
Meet Students Where They Are? Maybe Not.
By Mark Horowitz

Upcoming Events

Chronfest25_Virtual-Events_Page_862x574.png
Chronicle Festival: Innovation Amid Uncertainty
07-16-Advising-InsideTrack - forum assets v1_Plain.png
The Evolving Work of College Advising
Lead With Insight
  • Explore Content
    • Latest News
    • Newsletters
    • Letters
    • Free Reports and Guides
    • Professional Development
    • Events
    • Chronicle Store
    • Chronicle Intelligence
    • Jobs in Higher Education
    • Post a Job
  • Know The Chronicle
    • About Us
    • Vision, Mission, Values
    • DEI at The Chronicle
    • Write for Us
    • Work at The Chronicle
    • Our Reporting Process
    • Advertise With Us
    • Brand Studio
    • Accessibility Statement
  • Account and Access
    • Manage Your Account
    • Manage Newsletters
    • Individual Subscriptions
    • Group and Institutional Access
    • Subscription & Account FAQ
  • Get Support
    • Contact Us
    • Reprints & Permissions
    • User Agreement
    • Terms and Conditions
    • Privacy Policy
    • California Privacy Policy
    • Do Not Sell My Personal Information
1255 23rd Street, N.W. Washington, D.C. 20037
© 2025 The Chronicle of Higher Education
The Chronicle of Higher Education is academe’s most trusted resource for independent journalism, career development, and forward-looking intelligence. Our readers lead, teach, learn, and innovate with insights from The Chronicle.
Follow Us
  • twitter
  • instagram
  • youtube
  • facebook
  • linkedin