Rashaad Essop skopp

Markdown and reStructuredText

GitHub supports several lightweight markup languages for documentation; the most popular ones (generally, not just at GitHub) are Markdown and reStructuredText. Markdown is sometimes considered easier to use, and is often preferred when the purpose is simply to generate HTML. On the other hand, reStructuredText is more extensible and powerful, with native support (not just embedded HTML) for tables, as well as things like automatic generation of tables of contents.

Backstory: I decided to crowdsource static site generator recommendations, so the following are actual real world suggested-to-me results. I then took those and sorted them by language/server and, just for a decent relative metric, their Github Watcher count. If you want a heap of other projects (including other languages like Haskell and Python) Nanoc has the mother of all site generator lists. If you recommend another one, by all means add a comment.

Ruby

Jekyll 5,676
Octopress 2,696
Middleman 685
NestaCMS 664
Statis 509
Nanoc 355

	#!/bin/bash
	NODE_VERSION=0.4.10
	NPM_VERSION=1.0.22

	sudo apt-get update
	sudo apt-get install -y build-essential git-core nginx libssl-dev pkg-config curl

	# Install node
	mkdir -p $HOME/local/node
	git clone git://github.com/joyent/node.git

	#!/bin/sh
	# SPDX-License-Identifier: MIT

	## Copyright (C) 2011 Przemyslaw Pawelczyk <[email protected]>
	##
	## This script is licensed under the terms of the MIT license.
	## https://opensource.org/licenses/MIT
	#
	# Usage: gitio URL [CODE]
	#

	// ==UserScript==
	// @name Use Markdown, sometimes, in your HTML.
	// @author Paul Irish <http://paulirish.com/>
	// @link http://git.io/data-markdown
	// @match *
	// ==/UserScript==


	// If you're not using this as a userscript just delete from this line up. It's cool, homey.


	<!DOCTYPE html>
	<!--[if lt IE 7 ]> <html lang="en" class="no-js ie6 lte-ie8"> <![endif]-->
	<!--[if IE 7 ]> <html lang="en" class="no-js ie7 lte-ie8"> <![endif]-->
	<!--[if IE 8 ]> <html lang="en" class="no-js ie8 lte-ie8"> <![endif]-->
	<!--[if (gte IE 9)\|!(IE)]><!--> <html lang="en" class="no-js"> <!--<![endif]-->
	<head>
	<meta charset="utf-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
	<title>Nepal on Rails</title>

	<!-- Add these tags to the HEAD section of your page. -->

	<link href="http://coderwall.com/stylesheets/jquery.coderwall.css" media="all" rel="stylesheet" type="text/css">
	<script src="http://coderwall.com/javascripts/jquery.coderwall.js"></script>

	<!-- You also need to place a container where you'd like the Coderwall badges to render. -->
	<section class="coderwall" data-coderwall-username="(your username)" data-coderwall-orientation="(vertical or horizontal)"></section>

	/*==========================================================
	Open Sans
	==========================================================*/

	@font-face {
	font-family: 'OpenSans';
	src: url('../fonts/OpenSans-Light-webfont.eot');
	src: url('../fonts/OpenSans-Light-webfont.eot?#iefix') format('embedded-opentype'),
	url('../fonts/OpenSans-Light-webfont.woff') format('woff'),
	url('../fonts/OpenSans-Light-webfont.ttf') format('truetype'),

	<?php
	/**
	* BoxBilling
	*
	* LICENSE
	*
	* This source file is subject to the license that is bundled
	* with this package in the file LICENSE.txt
	* It is also available through the world-wide-web at this URL:
	* http://www.boxbilling.com/LICENSE.txt

	// How to use this:
	// 1. Go to the desired profile page on coderwall, like http://coderwall.com/marcinbunsch
	// 2. Paste this gist in the JS console
	//
	// You can also probably use this in greasemonkey and dot.js
	//
	// Also, it was tested in Chrome, Firefox and Safari, it probably will
	// not work in IE, but I just don't care about it ;)
	//
	// UPDATE: Coderwall made changes to the site and I cannot retrieve the achievements, so they are hardcoded, taken from a cached version of the achievements page