KatanaCode/blogit

View on GitHub
doc/file.README.html

Summary

Maintainability
Test Coverage
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>
  File: README
  
    &mdash; Blogit - Add a blog to your Ruby on Rails application
  
</title>

  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />

  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />

<script type="text/javascript" charset="utf-8">
  hasFrames = window.top.frames.main ? true : false;
  relpath = '';
  framesUrl = "frames.html#!file.README.html";
</script>


  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>

  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>


  </head>
  <body>
    <div id="header">
      <div id="menu">
  
    <a href="_index.html">Index</a> &raquo; 
    <span class="title">File: README</span>
  

  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
</div>

      <div id="search">
  
    <a class="full_list_link" id="class_list_link"
        href="class_list.html">
      Class List
    </a>
  
    <a class="full_list_link" id="method_list_link"
        href="method_list.html">
      Method List
    </a>
  
    <a class="full_list_link" id="file_list_link"
        href="file_list.html">
      File List
    </a>
  
</div>
      <div class="clear"></div>
    </div>

    <iframe id="search_frame"></iframe>

    <div id="content"><div id='filecontents'><p><a href="http://badge.fury.io/rb/blogit"><img src="https://badge.fury.io/rb/blogit.png" alt="Gem Version"></a>
<a href="http://codeclimate.com/github/KatanaCode/blogit/"><img src="https://codeclimate.com/github/KatanaCode/blogit.png" alt="Code Climate"></a>
<a href="https://gemnasium.com/KatanaCode/blogit"><img src="https://gemnasium.com/KatanaCode/blogit.png" alt="Blogit"></a>
<a href="https://travis-ci.org/KatanaCode/blogit.png"><img src="https://travis-ci.org/KatanaCode/blogit.png" alt="Travis CI"></a></p>

<h1>Blogit - A Rails blogging solution</h1>

<p>Blogit lets you add a blog to your Ruby on Rails application in just a few seconds.</p>

<h2>Instant gratification</h2>

<p>Add this to your Gemfile</p>

<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>blogit</span><span class='tstring_end'>&quot;</span></span>
</code></pre>

<p>...and run <code>bundle install</code> to install the gem.</p>

<p>Next, run:</p>

<pre class="code bash"><code class="bash"># add an initializer to config/initializers with all of the configuration options
$ rails g blogit:install
# This will add the necessary migrations to your app&#39;s db/migrate directory
rake blogit:install:migrations
# This will run any pending migrations
rake db:migrate
</code></pre>

<p>then add the following to your routes.rb file:</p>

<pre class="code bash"><code class="bash"># config/routes.rb
mount Blogit::Engine =&gt; &quot;/blog&quot;
</code></pre>

<p>Finally, declare which of your models acts as blogger in your app (probably User or Admin).</p>

<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>User</span>

  <span class='id identifier rubyid_blogs'>blogs</span>

<span class='kw'>end</span>
</code></pre>

<h2>Configuration</h2>

<p>Running <code>rails g blogit:install</code> will add an initializer file named blogit.rb. In here
you can set various configuration options. Please <a href="http://blogit.katanacode.com">read the documentation</a> for a full list of the options available.</p>

<h2>Batteries included</h2>

<p>Blogit provides you with the following features</p>

<ul>
<li>An XML Sitemap located at <code>/blog/posts.xml</code></li>
<li>An RSS feed located at <code>/blog/posts.rss</code></li>
<li>Internationalization (see the <a href="config/locales/en.yml">locales file</a> for configurable options)</li>
<li>Share links (Google+, Twitter &amp; Facebook)</li>
<li><a href="http://disqus.com">Disquss Comments</a></li>
<li>Code Syntax Highlighting CSS file (add <code>*= require pygments</code> to your app&#39;s stylesheet)</li>
</ul>

<h2>Issues</h2>

<p>If you discover a problem with Blogit, please let us know about it. </p>

<p><strong>Remember</strong> to search the <a href="https://github.com/KatanaCode/blogit/issues">issues list</a> first in case your issue has already been raised
by another Githuber</p>

<h2>Documentation</h2>

<p>Full documentation is available here: <a href="http://blogit.katanacode.com">http://blogit.katanacode.com</a></p>

<h2>Contributing</h2>

<p>You&#39;re welcome to contribute to Blogit. Please consult the <a href="http://blogit.katanacode.com/doc/file.Contributing.html">contribution guidelines</a> for more info.</p>

<h2>Legal Stuff</h2>

<p>Copyright © 2011 - 2015 <a href="http://katanacode.com">Katana Code Ltd.</a></p>

<p>See <a href="LEGAL">LEGAL</a> for full details.</p>

<h2>Credits</h2>

<p>Developed by <a href="http://katanacode.com">Katana Code</a></p>

<p>with generous contributions from:</p>

<ul>
<li><a href="https://github.com/philou">Philou</a></li>
<li><a href="https://github.com/stewartmckee">Stewart McKee</a></li>
<li><a href="https://github.com/kassi">Karsten Silkenbäumer</a></li>
</ul>

<h2>About Katana Code</h2>

<p>Katana Code are <a href="http://katanacode.com/" title="Katana Code">web developers based in Edinburgh, Scotland</a>.</p>
</div></div>

    <div id="footer">
  Generated on Mon Jun 22 15:23:49 2015 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.8.7.6 (ruby-2.1.2).
</div>

  </body>
</html>