potion
Potion is github-pages compatible editor for jekyll websites
Explain that, please
Potion is a completely client-side (serverless) editor for jekyll blogs. It uses the Jekyll specifications for listing drafts, posts and allows you to edit your blogs completely in the browser. It does this by using the github API.
Why not OAuth
Github allows for 2 authentication methods, OAuth and Basic Auth. We choose the later, because it allows us to remain serverless (for eg, http://prose.io uses GateKeeper). An additional advantage is that, since there are no authentication tokens involved, you are not handing keys to your private repos to anyone. The password is stored nowhere, and is kept in memory for the duration of your session. If you close the tab, you will have to login again.
Compatible with Github Pages
Potion is compatible with github pages, which means that you can add Potion as a submodule to
your own blog, and it will be available at http://username.github.com/potion
. Self-hosting
means you will have to update potion manually, but it also means that we cannot slip in malicious
code to steal your passwords at any time.
Features
When Potion will be complete, it will boast of the following features:
- Image and other binary uploads.
- YAML editor for editing YAML-front matter.
- Distraction free markdown editor with live-preview.
- Clean, simple and a minimalist interface.
Setup instructions
- Download the latest build of Potion from #TODO
- Put it inside an admin folder of your blog
- Open http://username.github.com/admin/
Alternative install
- Clone the Potion repo inside your blog (
username.github.com
) - Checkout the build branch (
git checkout build
) - Open http://username.github.com/potion
Contribute
You can setup Potion as a sublime project by copying the sample.sublime-project
file to
potion.sublime-project
and editing the root. Dependencies for development include:
- clientjade (
npm install clientjade
) - stylus (
npm install stylus
) - coffee-script (
npm install coffee-script
)
Contributors
- Abhay Rana [email protected]
- Tushar Kant [email protected]
Licence
Licenced under the MIT Licence.