[WIP] Curated Doc Refactoring

.gitignore

@@ -89,3 +89,8 @@ build/
 i686-pc-mingw32/
 src/librustc/lib/llvmdeps.rs
 *.pot
+src/doc/documentation/tmp
+src/doc/documentation/output
+src/doc/documentation/public
+src/doc/documentation/*.log
+src/doc/documentation/target

src/doc/documentation/Gemfile

@@ -0,0 +1,20 @@
+source "http://rubygems.org"
+
+ruby '2.1.1'
+
+gem 'builder'
+gem 'coderay'
+gem 'kramdown'
+gem 'mime-types', '~> 1.16'
+gem 'nanoc'
+gem 'nokogiri', '~> 1.6.0'
+gem 'pygments.rb'
+gem 'rake', '~> 0.9.2'
+gem 'thin'
+gem 'yajl-ruby', '~> 0.8.2'
+gem 'pandoc-ruby'
+
+group :development do
+  gem 'adsf'
+  gem 'fssm'
+end

src/doc/documentation/Gemfile.lock

@@ -0,0 +1,53 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    adsf (1.2.0)
+      rack (>= 1.0.0)
+    blankslate (3.1.2)
+    builder (3.2.2)
+    coderay (1.1.0)
+    colored (1.2)
+    cri (2.6.0)
+      colored (~> 1.2)
+    daemons (1.1.9)
+    eventmachine (1.0.3)
+    ffi (1.0.11)
+    fssm (0.2.10)
+    kramdown (1.3.3)
+    mime-types (1.25.1)
+    mini_portile (0.6.0)
+    nanoc (3.6.11)
+      cri (~> 2.3)
+    nokogiri (1.6.2.1)
+      mini_portile (= 0.6.0)
+    pandoc-ruby (0.7.5)
+    pygments.rb (0.2.13)
+      rubypython (~> 0.5.3)
+    rack (1.5.2)
+    rake (0.9.6)
+    rubypython (0.5.3)
+      blankslate (>= 2.1.2.3)
+      ffi (~> 1.0.7)
+    thin (1.6.2)
+      daemons (>= 1.0.9)
+      eventmachine (>= 1.0.0)
+      rack (>= 1.0.0)
+    yajl-ruby (0.8.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  adsf
+  builder
+  coderay
+  fssm
+  kramdown
+  mime-types (~> 1.16)
+  nanoc
+  nokogiri (~> 1.6.0)
+  pandoc-ruby
+  pygments.rb
+  rake (~> 0.9.2)
+  thin
+  yajl-ruby (~> 0.8.2)

src/doc/documentation/Makefile

@@ -0,0 +1,27 @@
+RUSTC ?= rustc
+RUSTC_FLAGS ?=
+
+check: validator-build
+	./target/validator content/
+
+validator-build: validator/bin.rs
+	mkdir -p target
+	$(RUSTC) validator/bin.rs --out-dir target
+
+validator-clean:
+	@rm -rf target
+
+doc-build:
+	@nanoc
+
+doc-server:
+	@nanoc autocompile -p 3002 -H thin
+
+doc-clean:
+	@rm -rf ./tmp
+	@rm -rf ./public
+	@rm crash.log
+
+clean: validator-clean doc-clean
+
+.PHONY: validator-clean doc-clean doc-build doc-server

src/doc/documentation/Rules

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+compile '/static/*' do
+end
+
+compile '*' do
+  filter :erb
+  filter :pandoc
+  filter :colorize_syntax, :default_colorizer => :pygmentsrb
+  layout item[:layout] || 'default'
+end
+
+route '/static/*' do
+  item.identifier[7..-2]
+end
+
+route '*' do
+  item.identifier + 'index.html'
+end
+
+layout '*', :erb

src/doc/documentation/content/getting-started.md

@@ -0,0 +1,38 @@
+---
+title: "Getting Started"
+---
+
+# Getting Started
+
+Let's go through the process of installing Rust on your system and being able to compile your first program.
+
+
+## Installation
+
+Head over to [Rust's homepage](http://www.rust-lang.org/) and download the nightly version of Rust for your operating system. This should be a simple, one-click install.
+
+## Using It
+
+Now that Rust is installed, you'll have access to the `rustc` executable. That's the Rust compiler.
+
+Let's create a new file called `hello_world.rs`. The Rust file extension, if you didn't know already, is `rs`.
+
+``` {.rust}
+// hello_world.rs
+fn main() {
+  println!("Hello World!");
+}
+```
+
+Now you can compile it with:
+
+```bash
+$ rustc hello_world.rs -o helloworld
+```
+
+Let's run the hello world program written in Rust:
+
+```
+$ ./helloworld
+Hello World!
+```

src/doc/documentation/content/index.md

@@ -0,0 +1,8 @@
+---
+title: "Rust Documentation"
+---
+
+# Rust Documentation
+
+* [Introduction](/introduction/)
+* [Getting Started](/getting-started/)