No commit activity in last 3 years
No release in over 3 years
PiccoBlog is a simple Ruby on Rails markdown blog engine.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

PiccoBlog Logo

Gem Version

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:

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.