Tristen Brown tristen

Let's say your Jekyll site's directory structure looks like:

|-- _config.yml
|-- _drafts/
|   |-- a-draft-post.md
|-- _layouts/
|   |-- default.html
|-- _posts/
| |-- 2013-05-10-a-published-post

If your post looked something like:

# Awesome Blog Post

Here is an example post to show how to use the new `excerpt` tag.

The excerpt tag provides a quick and easy way to tease a post by exposing only the first paragraph such as on a blog index page.

Here's an example of how to embed a Gist on GitHub Pages:

{% gist 5555251 %}

All you need to do is copy and paste the Gist's ID from the URL (here 5555251), and add it to a gist tag surrounded by {% and %}.

Use DocPad, GitHub and Prose as a Wiki

This guide will walk you through how you can use a GitHub repository to house your wiki content, have DocPad render it, and automatically update on changes. It's also really nice as we get to benefit from the github project workflow for our wiki, that is issues, pull requests, etc.

We use this workflow heavily by linking the DocPad Website and the DocPad Documentation repositories allowing us to have users edit and submit pull requests for improvements to our documentation, and once merged, the website regenerates automatically.

1. Create a new repository for your Wiki Content

Deploying a subfolder to GitHub Pages

Sometimes you want to have a subdirectory on the master branch be the root directory of a repository’s gh-pages branch. This is useful for things like sites developed with Yeoman, or if you have a Jekyll site contained in the master branch alongside the rest of your code.

For the sake of this example, let’s pretend the subfolder containing your site is named dist.

Step 1

Remove the dist directory from the project’s .gitignore file (it’s ignored by default by Yeoman).

	// Generated by CoffeeScript 1.5.0
	(function() {
	var median;

	median = function(x) {
	var sorted;
	if (x.length === 0) {
	return null;
	}
	sorted = x.slice().sort(function(a, b) {

	<!DOCTYPE html>
	<meta charset="utf-8">
	<style>
	body {
	font:12px/20px 'Helvetica';
	}
	textarea, input {
	width:100%;
	height:20px;
	margin:0;

	function whichTransitionEvent(){
	var t;
	var el = document.createElement('fakeelement');
	var transitions = {
	'transition':'transitionend',
	'MSTransition':'msTransitionEnd',
	'MozTransition':'transitionend',
	'WebkitTransition':'webkitTransitionEnd'
	}

	$(function(){

	var formUrl = '/* ex: https://docs.google.com/a/developmentseed.org/spreadsheet/formResponse?formkey=... */';

	// Set up map
	var m = mapbox.map('map').addLayer(mapbox.layer().id(' /* mapbox-account.id */ '));

	// Set up map ui features with point selector
	var ui = mapbox.ui().map(m).auto().pointselector(function(d) {
	// Remove all points except the most recent

	<!DOCTYPE html>
	<meta charset="utf-8">
	<style>
	body { margin:0; padding:0; }
	.cell {
	border: solid 1px white;
	font: 9px sans-serif;
	line-height: 10px;
	overflow: hidden;
	position: absolute;