Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/BlinkTagInc/gtfs-to-html

Build human readable transit timetables as HTML or PDF from GTFS.
https://github.com/BlinkTagInc/gtfs-to-html

gtfs gtfs-realtime gtfs-rt html-timetables mongodb public-transportation timetable transit transit-agencies transit-data transit-map

Last synced: 16 days ago
JSON representation

Build human readable transit timetables as HTML or PDF from GTFS.

Awesome Lists containing this project

README 

        


  ➡️

  Documentation |

  Quick Start |

  Configuration |

  Questions and Support

  ⬅️

  



  GTFS-to-HTML

  



  

  

  

  



  Create human-readable, user-friendly transit timetables in HTML, PDF or CSV format directly from GTFS.

  



  NPM







See [gtfstohtml.com](https://gtfstohtml.com) for full documentation.



Most transit agencies have schedule data in [GTFS ](https://developers.google.com/transit/gtfs/) format but need to show each route's schedule to users on a website. GTFS-to-HTML automates the process of creating nicely formatted HTML timetables for inclusion on a transit agency website. This makes it easy to keep timetables up to date and accurate when schedule changes happen and reduces the likelihood of errors.






## Features



### Configurable and customizable



`gtfs-to-html` has many options that configure how timetables are presented. It also allows using a completely custom template which makes it easy to build chunks of HTML that will fit perfectly into any website using any HTML structure and classes that you'd like. Or, create printable PDF versions or CSV exports of timetables using the `outputFormat` config option.



### Accessibility for all



`gtfs-to-html` properly formats timetables to ensure they are screen-reader accessible and WCAG 2.0 compliant.



### Mobile responsiveness built in



Built-in styling makes `gtfs-to-html` timetables ready to size and scroll easily on mobile phones and tablets.



### Schedule changes? A cinch.



By generating future timetables and including dates in table metadata, your timetables can appear in advance of a schedule change, and you can validate that your new timetables and GTFS are correct.



### Auto-generated maps



`gtfs-to-html` can also generate a map for each route that can be included with the schedule page. The map shows all stops for the route and lists all routes that serve each stop. See the `showMap` configuration option below.



Note: If you only want maps of GTFS data, use the [gtfs-to-geojson](https://github.com/blinktaginc/gtfs-to-geojson) package instead and skip making timetables entirely. If offers many different formats of GeoJSON for routes and stops.



`gtfs-to-html` uses the [`node-gtfs`](https://github.com/blinktaginc/node-gtfs) library to handle importing and querying GTFS data.



## GTFS-to-HTML on the web



You can now use `gtfs-to-html` without actually downloading any code or doing any configuration. [run.gtfstohtml.com](https://run.gtfstohtml.com) provides a web based interface for finding GTFS feeds for agencies, setting configuration and then generates a previewable and downloadable set of timetables.



## Current Usage



Many transit agencies use `gtfs-to-html` to generate the schedule pages used on their websites, including:



- [Advance Transit](https://advancetransit.com)

- [Brockton Area Transit Authority](https://ridebat.com)

- [Capital Transit (Helena, Montana)](http://www.ridethecapitalt.org)

- [Capital Transit (Juneau, Alaska)](https://juneaucapitaltransit.org)

- [Central Transit (Ellensburg, Washington)](https://centraltransit.org)

- [County Connection (Contra Costa County, California)](https://countyconnection.com)

- [El Dorado Transit](http://eldoradotransit.com)

- [Greater Attleboro-Taunton Regional Transit Authority](https://www.gatra.org)

- [Humboldt Transit Authority](http://hta.org)

- [Kings Area Rural Transit (KART)](https://www.kartbus.org)

- [Madera County Connection](http://mcctransit.com)

- [Marin Transit](https://marintransit.org)

- [Morongo Basin Transit Authority](https://mbtabus.com)

- [Mountain Transit](http://mountaintransit.org)

- [MVgo (Mountain View, CA)](https://mvgo.org)

- [NW Connector (Oregon)](http://www.nworegontransit.org)

- [Palo Verde Valley Transit Agency](http://pvvta.com)

- [Petaluma Transit](http://transit.cityofpetaluma.net)

- [RTC Washoe (Reno, NV)](https://www.rtcwashoe.com)

- [Santa Barbara Metropolitan Transit District](https://sbmtd.gov)

- [Sonoma County Transit](http://sctransit.com)

- [Tahoe Transportation District](https://www.tahoetransportation.org)

- [Tahoe Truckee Area Regional Transit](https://tahoetruckeetransit.com)

- [Transcollines](https://transcollines.ca)

- [Tulare County Area Transit](https://ridetcat.org)

- [Victor Valley Transit](https://vvta.org)

- [Worcester Regional Transit Authority](https://therta.com)



Are you using `gtfs-to-html`? Let us know via email ([email protected]) or via opening a github issue or pull request if your agency is using this library.



`gtfs-to-html` is used as an integral part of [`transit-custom-posts`](https://trilliumtransit.github.io/transit-custom-posts/) - a GTFS-optimized Wordpress plugin for transit websites.









## Installation, Configuration and Usage documentation



[See GTFS-to-HTML Documentation](https://gtfstohtml.com)



## Changelog



[See Changelog](https://github.com/blinktaginc/gtfs-to-html/blob/master/CHANGELOG.md)



## Contributing



Pull requests are welcome, as well as [feedback and reporting issues](https://github.com/blinktaginc/gtfs-to-html/issues).



## Tests



    npm test