: Write Benchmarks : : Write Documentation

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 build

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.

: Write Benchmarks : : Write Documentation

Tweet at @rubinius on Twitter or email community@rubinius.com. Please report Rubinius issues to our issue tracker.