From 1aac313a02c44a7b42d7e533d7e28d7786605d88 Mon Sep 17 00:00:00 2001 From: Lars Henrik Mai Date: Sat, 3 May 2014 13:47:22 +0200 Subject: added README --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..11c1879 --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ += sublab calendar stuff + +Code and tools related to working with the sublab calendar. Currently +'working' means reading it. + +== Getting started + +You'll need ruby and ruby bundler (http://bundler.io). + + # install dependencies + bundle install + + # start a REPL + pry -r ./sublab_calendar + + cal = SublabCalendar.load + + cal.events # all events + cal.future # future events + cal.past # past events + + # dump future events as JSON + puts JSON.pretty_generate(cal.future) + +== Vagrant + +There is a Vagrant (vagrantup.com) VM defined for playing around with a +radicale CalDAV server. + + # start the VM + vagrant up + + # stop the VM + vagrant halt + + # help! + vagrant -h + vagrant -h + +The VM being imported and provisioned on first run, this may take a +little while depending on your Internet connection. + +The radicale server will be available on your host machine on http://localhost:5232. + +See http://radicale.org/ for more docs. + +Note: this is a debian wheezy (7.4), which ships an old version of +radicale. Upgrading to a more current version may be necessary for +proper client and feature support. + -- cgit v1.2.1