Tributary allows you to share live-editable code snippets. These snippets will most likely use d3.js and allow a user to play with code in a very responsive way.
Tributary is innovation on principle, taking the excellent work of Gabriel Florit which was in turn inspired by Bret Victor's genius and making it sharable.
Tributary is a labor of love by Ian '@enjalot' Johnson and EJ '@mrejfox' Fox.
Start typing into the code editor and watch your code come to life! If you want to save your work you can click the fork button and it will save into a gist. The url in your browser will update to something like: http://tributary.io/inlet/2165875
where the number: 2165875 is the gist id (you can see it here: https://gist.github.com/2165875 )
Tributary is an experimental environment and an experimental project. We are playing with different "views" on code which have different assumptions. Once you get into it you may find you want to make your own view.
If you want to have github authentication working you will need to setup a github app and fill out the local_settings.py (see local_settings_example.py) The FLASK_SECRET_KEY is just a random string that's supposed to be unique to protect your sessions
On the backend tributary only depends on Flask:
sudo easy_install flask
To deploy locally run
git clone https://github.com/enjalot/tributary cd ./tributary python app.py
If you want to deploy behind apache, check out the sample apache config in server/sample_apache_config.txt If you want to setup wsgi there is a sample wsgi file in deploy/sample_tributary.wsgi (you can copy it into the base directory to match the sample apache config)
Frontend JS src file compilation with make to static requires node.js and uglify-js
You need to compile the frontend code and templates using make:
You can check the Makefile to see how it's done with uglify and handlebars
Reserved properties of the tributary object:
- re-enable vim and emacs mode (add ui for those selections somewhere)
- re-enable local storage backups per editor (need it so you can load code back but not execute it)
- open file from disk (file dialog)
- edit filename
Embedding example (simpler UI, assemble from fewer pieces)
Make BV button work for any of the renders (not just svg)