Skip to content
This repository

Monologue is a basic blogging engine. It is a Rails mountable engine you can mount in your already existing Rails app, or a in a new one! Enjoy.

Octocat-spinner-32 app Merge pull request #181 from xvonabur/master January 14, 2014
Octocat-spinner-32 config create Turkish translations December 03, 2013
Octocat-spinner-32 db Remove usage of attr_accessible in migration September 24, 2013
Octocat-spinner-32 lib Rename initializer to monologue.configuration September 27, 2013
Octocat-spinner-32 script fix rails command line. Now issue command to the engine and not dummy… September 27, 2012
Octocat-spinner-32 spec Add tests for non-latin tags + fix url tag creation December 17, 2013
Octocat-spinner-32 vendor add Turkish translations for bootstrap datepicker. December 06, 2013
Octocat-spinner-32 .gitignore Update git ignore to remove coverage folder July 25, 2013
Octocat-spinner-32 .rbenv-version Added a rbenv version file July 30, 2013
Octocat-spinner-32 .rspec RSpec, guard and factory girl now works correctly January 13, 2012
Octocat-spinner-32 .rvmrc Update rvmrc to use a non specific build version of ruby May 05, 2013
Octocat-spinner-32 .travis.yml Update .travis.yml November 22, 2013
Octocat-spinner-32 CHANGELOG.md Update changelog and update.md file September 27, 2013
Octocat-spinner-32 Gemfile Update config syntax using a ruby like approach and rails application… September 27, 2013
Octocat-spinner-32 Guardfile RSpec, guard and factory girl now works correctly January 13, 2012
Octocat-spinner-32 MIT-LICENSE Update MIT-LICENSE December 20, 2012
Octocat-spinner-32 README.md remove BitDeli badge from README April 15, 2014
Octocat-spinner-32 Rakefile added rspec and capybara January 13, 2012
Octocat-spinner-32 UPGRADE.md Update changelog and update.md file September 27, 2013
Octocat-spinner-32 deprecations.rb deprecate ruby 1.8.X September 29, 2012
Octocat-spinner-32 monologue.gemspec Update version of rails to 4.0.1... December 04, 2013
README.md

Monologue

Gem Version Build Status Code Climate Coverage Status

THIS README IS FOR THE MASTER BRANCH AND REFLECTS THE WORK CURRENTLY EXISTING ON THE MASTER BRANCH. IF YOU ARE WISHING TO USE A NON-MASTER BRANCH OF MONOLOGUE, PLEASE CONSULT THAT BRANCH'S README AND NOT THIS ONE.

Monologue is a basic mountable blogging engine in Rails built to be easily mounted in an already existing Rails app, but it can also be used alone.

Version

This README is for a future Monologue version, that will be 0.4.X and be Rails 4 specific. See other branches for other versions (0-3-stable being the latest stable version).

Upgrade and changes

To know how to upgrade, see UPGRADE.md file. If you want to know what changed since the last versions, see CHANGELOG.md.

Questions? Problems? Documentation?

Some features

  • Rails mountable engine (fully named spaced and mountable in an already existing app)
  • tested
  • back to basics: few features
  • tags (or categories)
  • RSS
  • multiple users
  • support for Google Analytics and Gaug.es tags
  • few external dependencies (no Devise or Sorcery, etc…) so we don't face problem integrating with existing Rails app.(Rails mountable engines: dependency nightmare?)
  • comments are handled by disqus
  • more in the CHANGELOG

  • bonus: there is a monologue-markdown extension

missing features

Installation

1. Add the gem to your Gemfile. This will get the latest version compatible with Rails 4 until we release a gem

gem 'monologue', github: 'jipiboily/monologue'

And run bundle install to fetch the gem and update your 'Gemfile.lock'.

2. Route to Monologue

Add this to your route file (config/route.rb)

# This line mounts Monologue's routes at the root of your application.
# This means, any requests to URLs such as /my-post, will go to Monologue::PostsController.
# If you would like to change where this engine is mounted, simply change the :at option to something different.
#
# We ask that you don't use the :as option here, as Monologue relies on it being the default of "monologue"
mount Monologue::Engine, at: '/' # or whatever path, be it "/blog" or "/monologue"

For example, if you decide to mount it at /blog, the admin section will be available at /blog/monologue. Here we decide to use monologue as default route mounting it at /, it means that the admin section will directly be available at /monologue.

3. Migrate Monologue's database tables

Run these commands:

  1. $bundle exec rake monologue:install:migrations
  2. $bundle exec rake db:create (only if this is a new project)
  3. $bundle exec rake db:migrate

4. Create a user

Open your development console with rails c, then:

Monologue::User.create(name: "monologue", email:"monologue@example.com", password:"my-password", password_confirmation: "my-password")

5. Configure Monologue.

This is all done in an initializer file, say config/initializers/monologue.rb. More on this in the Wiki - Configuration.

6. Ready

Start your server and head on http://localhost:3000/monologue to log in the admin section.

Note to Heroku users

  1. Additionnal step: turn caching off in config/environments/production.rb:
config.action_controller.perform_caching = false
  1. If you use compiled assets, I recommend you to add gem "tinymce-rails" to your Gemfile otherwise you might not be able to post an article.

Note to users

Monologue is using his own tables. If you want to use your own tables with monologue (for example the User table) this might help you to monkey patch Monkey Patch

Customization

See the Wiki - Customizations.

Requirements

  • Rails 3.1 +
  • Database: MySQL & Postgres are supported but other databases might work too.

Authors

Contribute

Fork it, then pull request. Please add tests for your feature or bug fix.

You will need to install this before running the test suite:

Thanks to

Zurb for the "social foundicons".

Something went wrong with that request. Please try again.