What makes goblin so special?
It's a great, and very versitile language. It's also the lingua franca of the web, and is one that front-end developers are more likely to be comfortable with.
Why is goblin so great?
It just is! Let's get on to the details...
Installing goblin is easy. First you must have these two dependencies installed:
Then, here are the steps:
In addition, you can feel free to use an already hosted CouchDB instance -- like signing up for one for free at IrisCouch (http://iriscouch.com) if you don't want to install couch locally (see the next part for more details!).
##Using IrisCouch for your CouchDB instance
I've found that, for developement, it's often too much to download and run CouchDB on your local machine. If you want to get started faster, without installing it, you can follow these instructions and create a CouchDB instance on a remote host (like IrisCouch.com)
These steps explain how to do it with a hosted CouchDB on IrisCouch (for free)
Here is an example (from 'lib/config.js'):
// Couch Admin user name couchUsername : "username", // Couch Admin Password couchPassword : "password", // URL of the CouchDB instance couchURL : "https://subdomain.iriscouch.com", // Port of the CouchDB instance couchPort : 443
If you have any issues installing, please provide feedback on where these instructions are not illumintating enough! You can report an issue on GitHub for this to be fixed, or even email me directly (see: Feedback).
The ability to easily theme is at the heart of goblin's mission. The bulk of this work happens within the .gob file system.
To create a .gob file, just create an HTML file and place all/some of the goblin variables in the place where you want it to render.
These are the variables currently supported in this release of goblin:
After you are done, change the extension from .html to .gob, and place it in the templates folder.
Place all of your customized CSS and JS files into the 'public/theme' folder. All the files will render in the '/theme' directory in the browser.
goblin adopts mustache's great templating language (https://github.com/janl/mustache.js/), so anything you can do with mustache you can use here (this information will come in handy when creating themes with custom variables).
Any .gob file you place in the '/theme' folder will be an option for your pages.
###So go get started, amigo!
goblin is built to be as flexible as possible, so a lot of customization can be built into this, and documentation on this will come soon! In the meantime, please use, run, theme and explore goblin, and please report any issues you run into (no matter how small) and submit improvements if you can!
###Current Limitations / To-do List
goblin is currently in a development, alpha phase. We are looking for feedback to help build the product out based on some great user feedback. However, there are a few things we are looking to do sooner than later (and would love your help with!):
Please, please, please provide feedback! We would love to hear your thoughts on goblin, as well as field any and all bugs and issues thrown our way. If you find a defect, or have a feature suggestion, please log an 'issue' in GitHub, and we will address it as soon as possible! If you're having an issue figuring things out, you can either go to StackOverflow and post, use / develop our wiki here, and even just email me (firstname.lastname@example.org) and I can try to help you out personally.
Regardless of the method, please get in touch without any hesitation. Did we mention we love feedback?
-- ###Related Projects
goblin has some sibilings! Below are projects that either directly correspond with the goblin project, or have been inspired by and/or help the goblin cause. Please consider getting involved in these great projects as well!
Copyright (C) 2013 Managing Editor Inc (http://www.maned.com/)
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.