This is a main Puddle repository.
This repository has documentation on Puddle and overwiew of other puddle modules. While puddle modules are being actievely developed they are checked into this repo as well.
The following puddle- modules are included in this repository:
- puddle-editor // in memory editor
- puddle-server // serves files and proxies requests to pomagma backend
- puddle-cli // simple command line client to puddle-editor
- puddle-d3 // view only client to puddle-editor
Following modules have ther own repositories:
- puddle-syntax // conversion from one courpus form to another
- puddle-corpus // storage
- puddle-crud // socket.IO sync server <=> clients
- puddle-hub //standard API wrapper
Please refer to the ./doc for features, architecture, contributing, etc.
$ npm install
$ npm start
Then navigate to http://localhost:34934/
$ npm run develop-editor # Ctrl-C to stop
In another terminal
$ npm run develop-server # Ctrl-C to stop
Demo of how to use local modules:
$ git clone email@example.com:pomagma/puddle $ cd puddle $ ls puddle-corpus puddle-hub puddle-editor $ cd puddle-editor $ mkdir -p node_modules $ cd node_modules $ ln -s ../../puddle-corpus # relative link $ cd .. $ git add node_modules/puddle-corpus # so other devs can use this $ git commit -m 'Add local npm link to puddle-corpus'
Travis currently uses a test matrix to test each module individually.
To test a single modules, set the environment variable
MODULE, for example
MODULE=puddle-corpus npm test # run tests puddle-corpus only
Make sure to declare environment variables for each of sub modules
Puddle was factored out of Pomagma in 2014.
Copyright 2013-2014 Fritz Obermeyer.
Puddle is licensed under the MIT license.