Contents

= Kblog

Simple blog-engine for rails.
Authentication can be done either role-based or via http-basic-auth.
No specific authentication-framework needed.
No relation to author present. 

== installation

* gem install kblog
* rake kblog:migrations:install
* rake db:migrate
* rails g kblog # creates kblog_init.rb in config/initializers
* add the engine to route.rb: 

<tt>mount Kblog::Engine => "/kblog"</tt>

* perhaps add provided css to your layoutfile:

<tt><%= stylesheet_link_tag 'kblog/articles', :media => "all" %></tt>

adopt config/initializer/kblog_init.rb:

[role-based authentication]	role-based rights to create/alter blog-articles  
										user_class must respond_to :roles - and each role
										tring representation role.to_s == Kblog.auth_role  

<tt>Kblog.auth_type = 'role'</tt>

<tt>Kblog.auth_role = 'blogger'   # role needed to alter blogs</tt>

[basic-auth]	makes use of simple http-basic auth.
					configure with desired name/passwword

<tt>Kblog.auth_type == 'basic'</tt>

<tt>Kblog.authname = 'blogger'</tt>

<tt>Kblog.authpassword = 'changeme'</tt>

== usage

* add helper 
<tt><%= display_latest_articles(num=1) %></tt> to your views
* if mounted to /kblog visit index: /kblog/articles - 

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
kblog-0.0.2	README.rdoc