crufter.com source code
JavaScript HTML CSS Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_includes
_layouts
_posts
_u
assets
blog
.gitignore
CNAME
Gemfile
Gemfile.lock
LICENSE.txt
README.md
_config.yml
disqus-url-map.csv
free_logo_8.ai
index.html
left-sidebar.html
logo8.png
logo8.zip
no-sidebar.html
right-sidebar.html

README.md

crufter.com

This is a multi-author, open source blog for tutorials across different kind of tech, with an API that let's you run code!

How it works:

  • The website itself it built with Jekyll and hosted with Github Pages.
  • The backend that runs code is Go & Docker. Source code and API documentation is coming soon.

How to write articles.

The article name should be in the following format:

0000-00-00-:author-:categories-:title.markdown

For example:

0000-00-00-crufter-everyday-hassles-in-go.markdown

This is not really enforced, it just makes it easier to grep for an author's articles, because unfortunately Jekyll does not traverse subdirectories to look for posts! :(

Now let's look at the frontmatter of the posts (taken from here):

layout: post
title:  "Lists"
slug: "lists"
date:   2013-04-06
categories: ["@crufter", haskell-tutorial]
seriesid: cht13
articleindex: 6
redirect_from:
   - /2013/04/06/haskell-tutorial-lists/

Notable things here:

Categories

The first category is the author, prepended with a @, this is mandatory. The second category is optional.

seriesid & articleindex

seriesid is used for grouping articles into a series of article. It helps navigation, for example, when you read an article which has other articles in the same series, you will see a list of other articles in the same series in the sidebar, have previous and next buttons, etc.

articleindex is used for ordering the post within a series.

Post with 0 articleindex will appear as the sole representator of the article series (for example showing up on the main page).

Code highlighting

By default, using the standard Jekyll and Rouge highlight, you get, well.. standard Jekyll and Rouge highlights in your blog post.