Jekyll::Google::Calendar
A Jekyll plugin that generates pages for Google Calendar events fetched using the Google Calendar API. The event and calendar data is available through the page variable.
-
page.eventcontains the data of the event resource -
page.calendarcontains calendar information from the API response -
page.calendar_idcontains the calendar ID for the Google Calendar
You must have a Google API service account key and this service account must have read access to the calendars you with to read.
Installation
Add this line to your Gemfile within the jekyll_plugins group.
gem 'jekyll-google-calendar'And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-google-calendar
Usage
Add jekyll-google-calendar to your _config.yml in the plugins array, eg:
plugins:
- jekyll-feed
- jekyll-google-calendar
Add the following configuration to your _config.yml, replacing the items in BLOCKCAPS with details for your own calendars.
gcalendar:
key_file: PATH-TO-YOUR-GOOGLE-SERVICE-ACCOUNT-KEY.json
calendars:
- id: YOUR-CALENDAR-ID # eg. blahblahblah12345678912345@group.calendar.google.com
directory: events # the directory in which to place geneated events
layout: gc_event # the Jekyll layout template to use for events
date_format: "%d-%m-%Y" # Uses Strftime formating directive (http://strftime.net/)
look_ahead: 365 # 1 year in days
To use multiple calendars, add additional calendars to the calendars array following the pattern above.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/davidgundry/jekyll-google-calendar.
License
The gem is available as open source under the terms of the MIT License.
Changelog
0.3.2
- Fix guard against missing
statuson ConferenceData (avoid NoMethodError) - Fix guard against missing
gadgeton ConferenceData - Bump
addressablegem (PR #4) to address a vulnerability
0.3.1
Updated Rake dependancy to at least version 12.3.3 due to vulnerability.
0.3.0
Added url value to event data for internal event page
0.2.0
Paginated events list generator
0.1.1
Fixed critical bug for events with attendees.
0.1.0
Initial release