How-To - Write a Blog Post - Rubinius
Author: Less Than Three. <3. http://less.thanthree.com
Description: Rubinius is an implementation of the Ruby programming language. The Rubinius bytecode virtual machine is written in C++. The bytecode compiler is written in pure Ruby. The vast majority of the core library is also written in Ruby, with some supporting primitives that interact with the VM directly.

1.2.3

## How-To - Write a Blog Post

The Rubinius blog uses Jekyll and is integrated with the website and documentation. We encourage and appreciate guest blog posts about your experiences using or developing Rubinius.

The preferred format for blog posts is Markdown. However, if you have special formatting needs, the post can be written in HTML directly.

Clone Rubinius repository as that is where the website and posts are stored.

    git clone https://github.com/rubinius/rubinius.git

To get started, ensure you have the `kramdown` and `jekyll` gems installed.

    rbx gem install jekyll kramdown

Now go to the posts directory

    cd rubinius/web/_posts

Create a file in the console using the filename format `YYYY-MM-DD-perma-link.markdown`.

    touch "%(date +"%Y-%m-%d")-perma-link-title.markdown"

Write your brilliant post.

    cat /dev/random > <<the file post>> # :-p

Run jekyll to compile the website, including your post.

    cd ../web/
    rbx -S jekyll

Create a commit of all the changes in the `web/` directory.

    cd ../
    git add web/
    git commit -m "Wrote a blog post on ....."

Submit a patch, pull request, or if you have commit rights, push the commit to the master branch.

Tell us that there is a new blog post. We may have some feedback for you before publishing.