Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jchris/sofa
Standalone CouchDB Blog, used by the O'Reilly CouchDB book
https://github.com/jchris/sofa
Last synced: 3 months ago
JSON representation
Standalone CouchDB Blog, used by the O'Reilly CouchDB book
- Host: GitHub
- URL: https://github.com/jchris/sofa
- Owner: jchris
- Created: 2009-01-08T17:27:48.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2019-02-08T17:53:19.000Z (over 5 years ago)
- Last Synced: 2024-01-18T11:01:16.123Z (5 months ago)
- Language: JavaScript
- Homepage: http://books.couchdb.org
- Size: 813 KB
- Stars: 373
- Watchers: 13
- Forks: 66
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Lists
- alex-mikhalev-awesome-stars - sofa - Standalone CouchDB Blog, used by the O'Reilly CouchDB book (JavaScript)
- awesome-stars - sofa - Standalone CouchDB Blog, used by the O'Reilly CouchDB book (JavaScript)
- awesome-stars - sofa
- awesome-stars - sofa
- awesome-starred - jchris/sofa - Standalone CouchDB Blog, used by the O'Reilly CouchDB book (others)
README
# Sofa: Standalone CouchDB Blog
Sofa showcases the [potential of pure CouchDB applications](http://jchris.mfdz.com/code/2008/10/standalone_applications_with_co). It should provide an easy way for people to put thier thoughts online, anywhere there's a running Couch. It's just HTML, JavaScript and the magic of CouchDB.
Currently supports authoring by anyone with the proper roles, and comments from anyone with a user account.
## Current News
Things are moving crazy fast around here right now as I bring this stuff up to ship-shape for the [CouchDB book](http://books.couchdb.org). I'll be renaming methods and stuff (if I find the time), any API feedback will be appreciated.
## Install CouchDB
You'll also need CouchDB (verion 0.11 or newer). Once you have that installed and the tests passing, you can install CouchApp
and the blog software.
## Install CouchApp
CouchApp makes it easy to edit application that are hosted in CouchDB, by keeping a correspondence between a set of files, and a CouchDB design document. You'll use CouchApp to install Sofa in your CouchDB instance.
sudo easy_install couchapp
CouchApp is a set of utilities for developing standalone CouchDB applications You can [learn more about the CouchApp project here](http://github.com/couchapp/couchapp/). Also, [`easy_install` has an unpleasant bug on OSX](http://mail.python.org/pipermail/pythonmac-sig/2008-October/020567.html), so you might end up having to work from git source.
### Setup Admin Access
If you are going to put your blog in public, you'll want to [set up an Admin account (screencast)](http://www.youtube.com/watch?v=oHKvV3Nh-CI).
## Install Sofa
git clone git://github.com/jchris/sofa.git
cd sofa
couchapp push . http://user:[email protected]:5984/myblogdb
You'll want to edit the HTML and CSS to personalize your site. Don't worry, the markup is pretty basic, so it's easy to rework. Adding new features is just a few lines of JavaScript away.
Anytime you make edits to the on-disk version of Sofa, and want to see them in your browser, just run `couchapp push . http://127.0.0.1:5984/blogdb` again. **You probably want to setup your `.couchapprc` file.** You should read the CouchApp readme to learn about that.
You can customize the blog title and other stuff in the `blog.json` file.
# Relax
[Visit your new blog.](http://127.0.0.1:5984/blogdb/_design/sofa/_list/index/recent-posts?descending=true&limit=5)
## License
Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0