Sunday, 20 September 2009

Shuffl: basic workspace persistence using AtomPub works

I've now got Shuffl persistence working against eXist. The UI is a bit clunky (well, a lot clunky really), and the error handling is poor, but it does seem to work. I must properly document how to set it up.

Roughly:

  1. install eXist
  2. configure eXist/Jetty to serve static files from some location. (See: http://shuffl-announce.blogspot.com/2009/08/exist-and-jetty-configuration.html)
  3. copy the shuffl files to that static location (I just link to my Eclipse workspace, so short-circuit this bit)
  4. start eXist
  5. Run the demo application from file shuffl-demo.xhtml (e.g. browse to http://localhost:8080/exist/shuffl/static/demo/shuffl-demo.xhtml).
  6. Use the shuffl menu (click on the logo) "Save as new workspace...", and change the URI in the dialog to something like "http://localhost:8080/exist/atom/edit/shuffl-test/" and click OK. Note the location at the bottom of the window changes to something like "http://localhost:8080/exist/atom/edit/shuffl-test/shuffl-test.json" - any filename in the URI entered is not used.
  7. Make changes to the UI and use the menu option "Save workspace"

Later, to restore the saved data, start shuffl then use menu option "Open workspace...", and change the Atom feed path to the value used previously.

Not yet implemented:

  • saving card size
  • delete cards
  • just about anything else you want to do

It's a small WIN, but I do count this as a WIN. It was a bit of a struggle getting to this point.

No comments:

Post a Comment