apply new syntax highlighting and improve formatting to the majority of existing content, moving the content of overview pages to index pages. making some very minor tweaks to content along the way

Author: ajpiano

Rules

@@ -16,7 +16,7 @@ class Nanoc3::Filter
   class CodeBlocks < Nanoc3::Filter
     LANGUAGES = { "ruby" => "ruby", "sql" => "sql", "javascript" => "javascript",
                   "css" => "css", "plain" => "plain", "erb" => "ruby; html-script: true",
-                  "html" => "xml", "xml" => "xml", "shell" => "plain", "yaml" => "yaml" }
+                  "markup" => "xml", "xml" => "xml", "shell" => "plain", "yaml" => "yaml" }
 
     def run(content, params={})
       @string = content.dup

content/ajax/ajax-overview.md

@@ -1,8 +1,5 @@
 ---
 chapter : ajax
-section : 1
-title   : Overview
-attribution:  jQuery Fundamentals
 ---
 ## Overview
 
@@ -18,7 +15,7 @@ code continues to execute while the request is being processed, so it’s
 imperative that a callback be used to handle the response.
 
 jQuery provides Ajax support that abstracts away painful browser differences.
-It offers both a full-featured $.ajax() method, and simple convenience methods
+It offers both a full-featured `$.ajax()` method, and simple convenience methods
 such as `$.get()`, `$.getScript()`, `$.getJSON()`, `$.post()`, and
 `$().load()`.
 

content/ajax/dex.md

@@ -1,4 +1,29 @@
 ---
 title: Ajax
+chapter: Ajax
+section : 1
+attribution:  jQuery Fundamentals
 ---
-Ajax is more than just a cleaning product
+The XMLHttpRequest method (XHR) allows browsers to communicate with the server
+without requiring a page reload.  This method, also known as Ajax (Asynchronous
+JavaScript and XML), allows for web pages that provide rich, interactive
+experiences.
+
+Ajax requests are triggered by JavaScript code; your code sends a request to a
+URL, and when it receives a response, a callback function can be triggered to
+handle the response.  Because the request is asynchronous, the rest of your
+code continues to execute while the request is being processed, so it’s
+imperative that a callback be used to handle the response.
+
+jQuery provides Ajax support that abstracts away painful browser differences.
+It offers both a full-featured $.ajax() method, and simple convenience methods
+such as `$.get()`, `$.getScript()`, `$.getJSON()`, `$.post()`, and
+`$().load()`.
+
+Most jQuery applications don’t in fact use XML, despite the name “Ajax”;
+instead, they transport data as plain HTML or JSON (JavaScript Object
+Notation).
+
+In general, Ajax does not work across domains.  Exceptions are services that
+provide JSONP (JSON with Padding) support, which allow limited cross-domain
+functionality.

content/assets/js/main.js

@@ -0,0 +1 @@
+alert("foo");

content/code-organization/beware-anonymous-functions.md

@@ -0,0 +1,42 @@
+---
+chapter :     code-organization
+section:      2
+title:        Beware Anonymous Functions
+attribution:  jQuery Fundamentals
+---
+
+Anonymous functions bound everywhere are a pain. They're difficult to debug,
+maintain, test, or reuse. Instead, use an object literal to organize and name
+your handlers and callbacks.
+<javascript>
+// BAD
+$(document).ready(function() {
+  $('#magic').click(function(e) {
+    $('#yayeffects').slideUp(function() {
+      // ...
+    });
+  });
+
+  $('#happiness').load(url + ' #unicorns', function() {
+    // ...
+  });
+});
+
+// BETTER
+var PI = {
+  onReady : function() {
+    $('#magic').click(PI.candyMtn);
+    $('#happiness').load(PI.url + ' #unicorns', PI.unicornCb);
+  },
+
+  candyMtn : function(e) {
+    $('#yayeffects').slideUp(PI.slideCb);
+  },
+
+  slideCb : function() { ... },
+
+  unicornCb : function() { ... }
+};
+
+$(document).ready(PI.onReady);
+</javascript>