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:
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 components > custom. All the files will render in the /custom/ directory in the browser, so make sure you point to them using '/custom/' path in your .gob file.
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).
As of right now, goblin only supports one .gob file at a time (call it page.gob, to make it easy to implement out of the box). However, multiple .gob file support is forthcoming and will soon be implemented!
###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!
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?
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.