PiccoBlog is a simple and light weight markdown blog engine for Ruby on Rails (v4.2.4+) applications.

Basic functionality includes:

• Title, body, exceprt
• Featured image
• Tagging
• Pagination
• Member's only flag
• Hidden/Visible state

TODO:

• Enable autosave feature
• Integrate complete test suite
• Comments are not fully impemented (ActiveRecord or other)

Dependencies:

• SimpleMDE v1.11.2 Markdown Editor Library
• JQuery

Installation

Add this line to your application's Gemfile:

gem 'picco_blog'

And then execute:

$ bundle install

Generate the install files (migrations and initializer)

$ rails generate picco_blog:install

Run migrations

$ rake db:migrate

If you want to override the default ERB views (most likely you do)

$ rails generate picco_blog:views

Add to config/routes.rb

mount PiccoBlog::Engine => "/blog"

Include the PiccoBlog Javascript and CSS Assets. Note: JQuery is required to be loaded first!

Add to assets/javascripts/application.js

//= require picco_blog/application

Add to assets/stylesheets/application.css

 *= require picco_blog/application

Done!

Configuation

Initializer

The default initializer was copied to config/initializers/picco_blog.rb. Each configurable option is commented in the file.

Dependency gems

By default, Dragonfly and Friendly ID gems are utilized. To override these configurations, create config/initializers/dragonfly.rb and config/initializers/friendly_id.rb initializers.

Issues

Please use the issue tracker if you have any issues.

Change Log

Changes are listed in CHANGELOG.md

Credits & Copyright

Brandon Bango - Author

This project rocks and uses MIT-LICENSE.