Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/martinheidegger/conf-cal
Convenient Conference Calendar Format
https://github.com/martinheidegger/conf-cal
calendar conference
Last synced: about 4 hours ago
JSON representation
Convenient Conference Calendar Format
- Host: GitHub
- URL: https://github.com/martinheidegger/conf-cal
- Owner: martinheidegger
- License: mit
- Created: 2017-10-25T03:05:24.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-14T06:13:16.000Z (almost 6 years ago)
- Last Synced: 2024-09-14T04:42:55.772Z (19 days ago)
- Topics: calendar, conference
- Language: JavaScript
- Size: 1000 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# conf-cal
_a human-readable conference calender format and library_
[](https://travis-ci.org/martinheidegger/conf-cal)
When you have a conference, it can be a pain in the butt to keep
the schedule and generate html out of it. This little library
allows with little effort to keep all the important information in
one place in a human readable form.
It makes sure that all the important data is there:
- Name
- Day
- Location
- Google Place ID of the location! _(to be used from a map)_
- Timezone _(taken from the geo location using [geo-tz](https://npmjs.com/package/geo-tz))_
- Rooms
- Event Title/Description/Presenter
- Automatic Breaks Calculation _(times between the slots are automatically breaks)_
- Automatic Slot Calculation _(just enter the times and it can figure out the slots)_
- Automatically generates IDs for each entry that can be overridden
_(to preserve deep links even when data changes)_
- Presentation languages _(to mark different presentations in different languages)
You can process this format with a **very lightweight** Node JS library.
### Here is an example calendar:
```
Mighty Superhero Gathering
on 2019/01/01
at Top of the World#ChIJvZ69FaJU6DkRsrqrBvjcdgU
[Main Room]
10:00-10:20 Opening
11:15-12:00 What I love about underground sountracks by Batman
In this special session Batman looks into a often
overlooked benefit of getting to know really special
music played in the bars just while beating up
scum.
13:00-14:00 Lighting talks
- Lassos materials by Wonder Woman
- Leveraging water in battle by Wolverine
- Why we need friends by The Hulk
- 楽しい CM の作り方 by ウルトラマン in ja
[Track A]
10:20-11:00 Doing the right thing by Super Man #keynote
Super Man will talk about the challenges he faced
trying to do the right thing when you are
basically a god
11:15-14:00 Akward bumps of 2018 by The Flash #flash-talk
Its not always easy to travel quickly without colliding
with things. Lightheartedly, the flash will reflect on
the funniest bumps of the last year.
```
The basic pattern is:
```
on //
at #
[]
- ( by )( in )( #)
<> or list of subentries>
[]
etc.
```
## JavaScript API
Install this library using:
```bash
$ npm i conf-cal --save
```
You can check out how the API works in the [`./test/api-documentation.js`](./test/api-documentation.js)
file.
# Contribution Guidelines
- PR's and issues welcome.
- If you can create a PR quickly, its better than an issue.
- Run the test before a PR.
- Be kind and patient.
# License
MIT