--- 
date: 2008-09-05
category: Ruby
tags: bluecloth, markdown
title: BlueCloth, a Markdown library
---
This is the summary, which is by definition the first paragraph of the
article. The summary shows up in category listings or the index listing.

Syntax highlighting

Thanks to the fantastic highlighting library CodeRay, highlighted code blocks can be embedded easily in Markdown. For Textile support you have to require coderay/for_redcloth. These languages are supported: C, Diff, Javascript, Scheme, CSS, HTML, XML, Java, JSON, RHTML, YAML, Delphi

To activate CodeRay for a code block, you have to declare the language in lower case:

@@ruby

def method_missing(id, *args, &block)
  puts "#{id} was called with #{args.inspect}"
end

Note that the declaration MUST be followed by a blank line!

Directory layout

+ config.ru
+ pages
  + about.md
+ posts
  + 2007
  + 2008
    + 9
      + my-article.md
+ public
  + styles.css
+ templates
  + 404.rhtml
  + archive.rhtml
  + category.rhtml
  + index.rhtml
  + index.rxml
  + layout.rhtml
  + page.rhtml
  + post.rhtml

Blog configuation

In config.ru you can set the properties of your blog:

blog.config = {
  :language => 'en',
  :title => "Blog Title",
  :author => "The Author",
  :categories => ["Ruby", "Javascript"],
  :description => "Blog description"
}

Templates

Layout and templates are rendered by ERB. The layout is defined in templates/layout.rhtml. The content will be provided in the variable @content. A minimal example:

<html>
  <head>
    <title><%= @blog.title %></title>
    <%= stylesheet_link_tag 'style' %>
  </head>
  <body>
     <%= @content %>
  </body>
 </html>

The attributes of a post are accessible via the @post variable:

<div class="article">
 
  <h1><%= @post.title %></h1>
 
  <div class="date">
    <%= human_date @post.date %>
  </div>
 
  <%= @post.body_html %>

  ...      

</div>

Deployment on Heroku

Install the Heroku gem:

$ gem install heroku

Installing your public key:

$ heroku keys:add

Enter your Heroku credentials.
Email: joe@example.com
Password: 
Uploading ssh public key /Users/joe/.ssh/id_rsa.pub

Create an app on Heroku.

$ heroku create myblog
Created http://myblog.heroku.com/ | git@heroku.com:mybblog.git
Git remote heroku added

Now on your local machine, you create a new remote repository and push your blog to Heroku:

$ cd ~/myblog
$ git init
$ git add .
$ git commit -m 'initial commit'
$ git push heroku

That's it. Your blog is deployed.

GitHub Project

Download or fork the package at my github repository

FAQs

What is shinmun?

Is shinmun well maintained?

Package last updated on 04 Jul 2011

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install