Grassy

A blogging engine the ruby community deserves

As much as I love all those static website generatos like Jekyll or Octopress or Toto, all I wished for is a ruby built blogging engine that lets me publish an article from anywhere, still in Markdown but without fireing up Sublime Text, my Terminal and whatever else.

Philosophy

Grassy aims to be lightweight, simple, free, and for developpers. That said, the codebase does not include infinite options or a modular plugin system, but, it is a fairly simple Sinatra app that you can freely fork and hack on.

Following the simple philosophy, there is no concept as the one of multiple themes. In Grassy you have one theme, the current one. It can be in a git submodule or simply in the main repo but when you wish to switch themes, you empty the theme folder and put a new theme in there. As simple as that!

Technology

My goal is that the codebase gets more simple every day, I don't want anything mind boggling. Even ruby beginners with little knowledge of Sinatra must be able to follow.

  • Sinatra
  • Sequel ORM
  • SCSS

Images

Backend: Settings Backend: Settings

Backend: Posts Backend: Posts

Backend: Edit a post (or page) Backend: Edit a post (or page)

Frontend: Default theme homepage Frontend: Default theme homepage

Frontend: Default theme archives Frontend: Default theme archives

Getting started

To boot up a working dev version on you machine, you need to install the dependancies and migrate de databse, that's it.

bundle install
# Now migrate & seed
rake db:migrate
rake db:seed

# Credentials for logging in are in /db/seeds.rb
# You are free to change those before 
# seeding the database for the first time

Then the bundled server is thin, a simple

thin start

Will start a web server on localhost:3000

Features

  • Real-simple theming
  • Pages editing
  • Posts editing
  • Tag posts so reader can navigate by subject
  • Markdown
  • Brain-friendly codebase
  • Painfully easy to install
  • Open-source

FAQ

  • Is it for real?

    Sup!

  • Does it play well with Heroku?

    Yes it has been deployed to Heroku and works gracefully. My production blug is hosted there and I test every new commit on it. Just deploy it and run heroku run 'rake db:migrate[production]' and heroku run 'rake db:seed[production]

License

The MIT License

Copyright (c) 2011 Frederic Gingras - https://github.com/kiasaki

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Built With

Share this project:

Updates