Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rkh/gerippe

Monk skeleton with compass and rspec.
https://github.com/rkh/gerippe

Last synced: about 1 month ago
JSON representation

Monk skeleton with compass and rspec.

Awesome Lists containing this project

README

        

= Project

== Skeleton

This skeleton uses the followin libraries:

* Compass for fast layout development
* RSpec for testing
* Extlib (with monkey-lib) for sane ruby extensions

== Alternate directory structure

Instead of the usual app/ structure known from Rails, Merb or other Monk skeletons,
this project uses a different project structure:

for controllers/helpers: routes/
for views: views/
for models: lib/project/

Models should be written in a way to be reusable and viewed as a stand-alone library
(hence them being in lib)

== Usage

This skeleton can be used with monk, priest or as stand-alone. It does not depend in any
way on monk, but plays well with it.

=== Stand-alone usage

Run this to create a new project called example_project:

git clone git://github.com/rkh/gerippe.git example_path
cd example_path
bin/project rename example_project

If you have dependency issues, you can install those either as git submodules:

rake vendor:install:submodules

Or globally as gems:

rake vendor:install:gems

There after you'll be able to create routes and such:

bin/example_project create route pages page/:name

=== Monk usage

monk add gerippe git://github.com/rkh/gerippe.git
monk init example_path -s gerippe
cd example_path
dep vendor --all
monk create route pages page/:name

=== Priest usage
Priest is an extended monk version (http://github.com/rkh/priest).

priest add gerippe git://github.com/rkh/gerippe.git
priest init example_path -s gerippe --keep-remote
cd example_path
rake vendor:install:submodules
priest create route pages page/:name

Note: You can also add --keep-remote to the "priest add" line, so
it will be default option for every "priest init" of gerippe.
However, this will cause the gerippe skeleton entry to be unusable
from the original monk command line tool, as monk and priest share
the same config file. Future versions of monk will be able to cope
with priest's extended config entries. If you just use priest this
should not cause any problems.

== Custom Monk tasks

monk name # displayes the projects name, currently Project
monk rename NAME # changes the projects name to NAME
monk create TYPE NAME [ARGS] # generate routes and such
monk types # lists types available for monk create

Note: "monk" can be replaced with "priest" or "bin/PROJECT_NAME"

== TODO

* Create forks for different ORMs.