aladdin 0.0.1

data/assets/javascripts/foundation/jquery.offcanvas.js

@@ -0,0 +1,50 @@
+;(function (window, document, $) {
+  // Set the negative margin on the top menu for slide-menu pages
+  var $selector1 = $('#topMenu'),
+    events = 'click.fndtn';
+  if ($selector1.length > 0) $selector1.css("margin-top", $selector1.height() * -1);
+
+  // Watch for clicks to show the sidebar
+  var $selector2 = $('#sidebarButton');
+  if ($selector2.length > 0) {
+    $('#sidebarButton').on(events, function (e) {
+      e.preventDefault();
+      $('body').toggleClass('active');
+    });
+  }
+
+  // Watch for clicks to show the menu for slide-menu pages
+  var $selector3 = $('#menuButton');
+  if ($selector3.length > 0)  {
+    $('#menuButton').on(events, function (e) {
+      e.preventDefault();
+      $('body').toggleClass('active-menu');
+    });
+  }
+
+  // // Adjust sidebars and sizes when resized
+  // $(window).resize(function() {
+  //   // if (!navigator.userAgent.match(/Android/i)) $('body').removeClass('active');
+  //   var $selector4 = $('#topMenu');
+  //   if ($selector4.length > 0) $selector4.css("margin-top", $selector4.height() * -1);
+  // });
+
+  // Switch panels for the paneled nav on mobile
+  var $selector5 = $('#switchPanels');
+  if ($selector5.length > 0)  {
+    $('#switchPanels dd').on(events, function (e) {
+      e.preventDefault();
+      var switchToPanel = $(this).children('a').attr('href'),
+          switchToIndex = $(switchToPanel).index();
+      $(this).toggleClass('active').siblings().removeClass('active');
+      $(switchToPanel).parent().css("left", (switchToIndex * (-100) + '%'));
+    });
+  }
+
+  $('#nav li a').on(events, function (e) {
+    e.preventDefault();
+    var href = $(this).attr('href'),
+      $target = $(href);
+    $('html, body').animate({scrollTop : $target.offset().top}, 300);
+  });
+}(this, document, jQuery));

data/assets/javascripts/foundation/jquery.placeholder.js

@@ -0,0 +1,157 @@
+/*! http://mths.be/placeholder v2.0.7 by @mathias */
+;(function(window, document, $) {
+
+	var isInputSupported = 'placeholder' in document.createElement('input'),
+	    isTextareaSupported = 'placeholder' in document.createElement('textarea'),
+	    prototype = $.fn,
+	    valHooks = $.valHooks,
+	    hooks,
+	    placeholder;
+
+	if (isInputSupported && isTextareaSupported) {
+
+		placeholder = prototype.placeholder = function() {
+			return this;
+		};
+
+		placeholder.input = placeholder.textarea = true;
+
+	} else {
+
+		placeholder = prototype.placeholder = function() {
+			var $this = this;
+			$this
+				.filter((isInputSupported ? 'textarea' : ':input') + '[placeholder]')
+				.not('.placeholder')
+				.bind({
+					'focus.placeholder': clearPlaceholder,
+					'blur.placeholder': setPlaceholder
+				})
+				.data('placeholder-enabled', true)
+				.trigger('blur.placeholder');
+			return $this;
+		};
+
+		placeholder.input = isInputSupported;
+		placeholder.textarea = isTextareaSupported;
+
+		hooks = {
+			'get': function(element) {
+				var $element = $(element);
+				return $element.data('placeholder-enabled') && $element.hasClass('placeholder') ? '' : element.value;
+			},
+			'set': function(element, value) {
+				var $element = $(element);
+				if (!$element.data('placeholder-enabled')) {
+					return element.value = value;
+				}
+				if (value == '') {
+					element.value = value;
+					// Issue #56: Setting the placeholder causes problems if the element continues to have focus.
+					if (element != document.activeElement) {
+						// We can't use `triggerHandler` here because of dummy text/password inputs :(
+						setPlaceholder.call(element);
+					}
+				} else if ($element.hasClass('placeholder')) {
+					clearPlaceholder.call(element, true, value) || (element.value = value);
+				} else {
+					element.value = value;
+				}
+				// `set` can not return `undefined`; see http://jsapi.info/jquery/1.7.1/val#L2363
+				return $element;
+			}
+		};
+
+		isInputSupported || (valHooks.input = hooks);
+		isTextareaSupported || (valHooks.textarea = hooks);
+
+		$(function() {
+			// Look for forms
+			$(document).delegate('form', 'submit.placeholder', function() {
+				// Clear the placeholder values so they don't get submitted
+				var $inputs = $('.placeholder', this).each(clearPlaceholder);
+				setTimeout(function() {
+					$inputs.each(setPlaceholder);
+				}, 10);
+			});
+		});
+
+		// Clear placeholder values upon page reload
+		$(window).bind('beforeunload.placeholder', function() {
+			$('.placeholder').each(function() {
+				this.value = '';
+			});
+		});
+
+	}
+
+	function args(elem) {
+		// Return an object of element attributes
+		var newAttrs = {},
+		    rinlinejQuery = /^jQuery\d+$/;
+		$.each(elem.attributes, function(i, attr) {
+			if (attr.specified && !rinlinejQuery.test(attr.name)) {
+				newAttrs[attr.name] = attr.value;
+			}
+		});
+		return newAttrs;
+	}
+
+	function clearPlaceholder(event, value) {
+		var input = this,
+		    $input = $(input);
+		if (input.value == $input.attr('placeholder') && $input.hasClass('placeholder')) {
+			if ($input.data('placeholder-password')) {
+				$input = $input.hide().next().show().attr('id', $input.removeAttr('id').data('placeholder-id'));
+				// If `clearPlaceholder` was called from `$.valHooks.input.set`
+				if (event === true) {
+					return $input[0].value = value;
+				}
+				$input.focus();
+			} else {
+				input.value = '';
+				$input.removeClass('placeholder');
+				input == document.activeElement && input.select();
+			}
+		}
+	}
+
+	function setPlaceholder() {
+		var $replacement,
+		    input = this,
+		    $input = $(input),
+		    $origInput = $input,
+		    id = this.id;
+		if (input.value == '') {
+			if (input.type == 'password') {
+				if (!$input.data('placeholder-textinput')) {
+					try {
+						$replacement = $input.clone().attr({ 'type': 'text' });
+					} catch(e) {
+						$replacement = $('<input>').attr($.extend(args(this), { 'type': 'text' }));
+					}
+					$replacement
+						.removeAttr('name')
+						.data({
+							'placeholder-password': true,
+							'placeholder-id': id
+						})
+						.bind('focus.placeholder', clearPlaceholder);
+					$input
+						.data({
+							'placeholder-textinput': $replacement,
+							'placeholder-id': id
+						})
+						.before($replacement);
+				}
+				$input = $input.removeAttr('id').hide().prev().attr('id', id).show();
+				// Note: `$input[0] != input` now!
+			}
+			$input.addClass('placeholder');
+			$input[0].value = $input.attr('placeholder');
+		} else {
+			$input.removeClass('placeholder');
+		}
+	}
+
+}(this, document, jQuery));

data/assets/javascripts/foundation/modernizr.foundation.js

@@ -0,0 +1,4 @@
+/* Modernizr 2.6.2 (Custom Build) | MIT & BSD
+ * Build: http://modernizr.com/download/#-inlinesvg-svg-svgclippaths-touch-shiv-mq-cssclasses-teststyles-prefixes-ie8compat-load
+ */
+;window.Modernizr=function(a,b,c){function y(a){j.cssText=a}function z(a,b){return y(m.join(a+";")+(b||""))}function A(a,b){return typeof a===b}function B(a,b){return!!~(""+a).indexOf(b)}function C(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:A(f,"function")?f.bind(d||b):f}return!1}var d="2.6.2",e={},f=!0,g=b.documentElement,h="modernizr",i=b.createElement(h),j=i.style,k,l={}.toString,m=" -webkit- -moz- -o- -ms- ".split(" "),n={svg:"http://www.w3.org/2000/svg"},o={},p={},q={},r=[],s=r.slice,t,u=function(a,c,d,e){var f,i,j,k,l=b.createElement("div"),m=b.body,n=m||b.createElement("body");if(parseInt(d,10))while(d--)j=b.createElement("div"),j.id=e?e[d]:h+(d+1),l.appendChild(j);return f=["&#173;",'<style id="s',h,'">',a,"</style>"].join(""),l.id=h,(m?l:n).innerHTML+=f,n.appendChild(l),m||(n.style.background="",n.style.overflow="hidden",k=g.style.overflow,g.style.overflow="hidden",g.appendChild(n)),i=c(l,a),m?l.parentNode.removeChild(l):(n.parentNode.removeChild(n),g.style.overflow=k),!!i},v=function(b){var c=a.matchMedia||a.msMatchMedia;if(c)return c(b).matches;var d;return u("@media "+b+" { #"+h+" { position: absolute; } }",function(b){d=(a.getComputedStyle?getComputedStyle(b,null):b.currentStyle)["position"]=="absolute"}),d},w={}.hasOwnProperty,x;!A(w,"undefined")&&!A(w.call,"undefined")?x=function(a,b){return w.call(a,b)}:x=function(a,b){return b in a&&A(a.constructor.prototype[b],"undefined")},Function.prototype.bind||(Function.prototype.bind=function(b){var c=this;if(typeof c!="function")throw new TypeError;var d=s.call(arguments,1),e=function(){if(this instanceof e){var a=function(){};a.prototype=c.prototype;var f=new a,g=c.apply(f,d.concat(s.call(arguments)));return Object(g)===g?g:f}return c.apply(b,d.concat(s.call(arguments)))};return e}),o.touch=function(){var c;return"ontouchstart"in a||a.DocumentTouch&&b instanceof DocumentTouch?c=!0:u(["@media (",m.join("touch-enabled),("),h,")","{#modernizr{top:9px;position:absolute}}"].join(""),function(a){c=a.offsetTop===9}),c},o.svg=function(){return!!b.createElementNS&&!!b.createElementNS(n.svg,"svg").createSVGRect},o.inlinesvg=function(){var a=b.createElement("div");return a.innerHTML="<svg/>",(a.firstChild&&a.firstChild.namespaceURI)==n.svg},o.svgclippaths=function(){return!!b.createElementNS&&/SVGClipPath/.test(l.call(b.createElementNS(n.svg,"clipPath")))};for(var D in o)x(o,D)&&(t=D.toLowerCase(),e[t]=o[D](),r.push((e[t]?"":"no-")+t));return e.addTest=function(a,b){if(typeof a=="object")for(var d in a)x(a,d)&&e.addTest(d,a[d]);else{a=a.toLowerCase();if(e[a]!==c)return e;b=typeof b=="function"?b():b,typeof f!="undefined"&&f&&(g.className+=" "+(b?"":"no-")+a),e[a]=b}return e},y(""),i=k=null,function(a,b){function k(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function l(){var a=r.elements;return typeof a=="string"?a.split(" "):a}function m(a){var b=i[a[g]];return b||(b={},h++,a[g]=h,i[h]=b),b}function n(a,c,f){c||(c=b);if(j)return c.createElement(a);f||(f=m(c));var g;return f.cache[a]?g=f.cache[a].cloneNode():e.test(a)?g=(f.cache[a]=f.createElem(a)).cloneNode():g=f.createElem(a),g.canHaveChildren&&!d.test(a)?f.frag.appendChild(g):g}function o(a,c){a||(a=b);if(j)return a.createDocumentFragment();c=c||m(a);var d=c.frag.cloneNode(),e=0,f=l(),g=f.length;for(;e<g;e++)d.createElement(f[e]);return d}function p(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return r.shivMethods?n(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+l().join().replace(/\w+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(r,b.frag)}function q(a){a||(a=b);var c=m(a);return r.shivCSS&&!f&&!c.hasCSS&&(c.hasCSS=!!k(a,"article,aside,figcaption,figure,footer,header,hgroup,nav,section{display:block}mark{background:#FF0;color:#000}")),j||p(a,c),a}var c=a.html5||{},d=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,e=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,f,g="_html5shiv",h=0,i={},j;(function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",f="hidden"in a,j=a.childNodes.length==1||function(){b.createElement("a");var a=b.createDocumentFragment();return typeof a.cloneNode=="undefined"||typeof a.createDocumentFragment=="undefined"||typeof a.createElement=="undefined"}()}catch(c){f=!0,j=!0}})();var r={elements:c.elements||"abbr article aside audio bdi canvas data datalist details figcaption figure footer header hgroup mark meter nav output progress section summary time video",shivCSS:c.shivCSS!==!1,supportsUnknownElements:j,shivMethods:c.shivMethods!==!1,type:"default",shivDocument:q,createElement:n,createDocumentFragment:o};a.html5=r,q(b)}(this,b),e._version=d,e._prefixes=m,e.mq=v,e.testStyles=u,g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(f?" js "+r.join(" "):""),e}(this,this.document),function(a,b,c){function d(a){return"[object Function]"==o.call(a)}function e(a){return"string"==typeof a}function f(){}function g(a){return!a||"loaded"==a||"complete"==a||"uninitialized"==a}function h(){var a=p.shift();q=1,a?a.t?m(function(){("c"==a.t?B.injectCss:B.injectJs)(a.s,0,a.a,a.x,a.e,1)},0):(a(),h()):q=0}function i(a,c,d,e,f,i,j){function k(b){if(!o&&g(l.readyState)&&(u.r=o=1,!q&&h(),l.onload=l.onreadystatechange=null,b)){"img"!=a&&m(function(){t.removeChild(l)},50);for(var d in y[c])y[c].hasOwnProperty(d)&&y[c][d].onload()}}var j=j||B.errorTimeout,l=b.createElement(a),o=0,r=0,u={t:d,s:c,e:f,a:i,x:j};1===y[c]&&(r=1,y[c]=[]),"object"==a?l.data=c:(l.src=c,l.type=a),l.width=l.height="0",l.onerror=l.onload=l.onreadystatechange=function(){k.call(this,r)},p.splice(e,0,u),"img"!=a&&(r||2===y[c]?(t.insertBefore(l,s?null:n),m(k,j)):y[c].push(l))}function j(a,b,c,d,f){return q=0,b=b||"j",e(a)?i("c"==b?v:u,a,b,this.i++,c,d,f):(p.splice(this.i++,0,a),1==p.length&&h()),this}function k(){var a=B;return a.loader={load:j,i:0},a}var l=b.documentElement,m=a.setTimeout,n=b.getElementsByTagName("script")[0],o={}.toString,p=[],q=0,r="MozAppearance"in l.style,s=r&&!!b.createRange().compareNode,t=s?l:n.parentNode,l=a.opera&&"[object Opera]"==o.call(a.opera),l=!!b.attachEvent&&!l,u=r?"object":l?"script":"img",v=l?"script":u,w=Array.isArray||function(a){return"[object Array]"==o.call(a)},x=[],y={},z={timeout:function(a,b){return b.length&&(a.timeout=b[0]),a}},A,B;B=function(a){function b(a){var a=a.split("!"),b=x.length,c=a.pop(),d=a.length,c={url:c,origUrl:c,prefixes:a},e,f,g;for(f=0;f<d;f++)g=a[f].split("="),(e=z[g.shift()])&&(c=e(c,g));for(f=0;f<b;f++)c=x[f](c);return c}function g(a,e,f,g,h){var i=b(a),j=i.autoCallback;i.url.split(".").pop().split("?").shift(),i.bypass||(e&&(e=d(e)?e:e[a]||e[g]||e[a.split("/").pop().split("?")[0]]),i.instead?i.instead(a,e,f,g,h):(y[i.url]?i.noexec=!0:y[i.url]=1,f.load(i.url,i.forceCSS||!i.forceJS&&"css"==i.url.split(".").pop().split("?").shift()?"c":c,i.noexec,i.attrs,i.timeout),(d(e)||d(j))&&f.load(function(){k(),e&&e(i.origUrl,h,g),j&&j(i.origUrl,h,g),y[i.url]=2})))}function h(a,b){function c(a,c){if(a){if(e(a))c||(j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}),g(a,j,b,0,h);else if(Object(a)===a)for(n in m=function(){var b=0,c;for(c in a)a.hasOwnProperty(c)&&b++;return b}(),a)a.hasOwnProperty(n)&&(!c&&!--m&&(d(j)?j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}:j[n]=function(a){return function(){var b=[].slice.call(arguments);a&&a.apply(this,b),l()}}(k[n])),g(a[n],j,b,n,h))}else!c&&l()}var h=!!a.test,i=a.load||a.both,j=a.callback||f,k=j,l=a.complete||f,m,n;c(h?a.yep:a.nope,!!i),i&&c(i)}var i,j,l=this.yepnope.loader;if(e(a))g(a,0,l,0);else if(w(a))for(i=0;i<a.length;i++)j=a[i],e(j)?g(j,0,l,0):w(j)?B(j):Object(j)===j&&h(j,l);else Object(a)===a&&h(a,l)},B.addPrefix=function(a,b){z[a]=b},B.addFilter=function(a){x.push(a)},B.errorTimeout=1e4,null==b.readyState&&b.addEventListener&&(b.readyState="loading",b.addEventListener("DOMContentLoaded",A=function(){b.removeEventListener("DOMContentLoaded",A,0),b.readyState="complete"},0)),a.yepnope=k(),a.yepnope.executeStack=h,a.yepnope.injectJs=function(a,c,d,e,i,j){var k=b.createElement("script"),l,o,e=e||B.errorTimeout;k.src=a;for(o in d)k.setAttribute(o,d[o]);c=j?h:c||f,k.onreadystatechange=k.onload=function(){!l&&g(k.readyState)&&(l=1,c(),k.onload=k.onreadystatechange=null)},m(function(){l||(l=1,c(1))},e),i?k.onload():n.parentNode.insertBefore(k,n)},a.yepnope.injectCss=function(a,c,d,e,g,i){var e=b.createElement("link"),j,c=i?h:c||f;e.href=a,e.rel="stylesheet",e.type="text/css";for(j in d)e.setAttribute(j,d[j]);g||(n.parentNode.insertBefore(e,n),m(c,0))}}(this,document),Modernizr.load=function(){yepnope.apply(window,[].slice.call(arguments,0))},Modernizr.addTest("ie8compat",function(){return!window.addEventListener&&document.documentMode&&document.documentMode===7});

data/bin/aladdin

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'aladdin'
+require 'optparse'
+
+opt_parser = OptionParser.new do |opts|
+
+  opts.banner = 'Usage: aladdin /path/to/tutorial/directory'
+
+  opts.on_tail('--version', 'Display current gem version.') do
+    puts 'aladdin v' + Aladdin::VERSION
+    exit 0
+  end
+
+end
+opt_parser.parse!
+
+Aladdin.launch from: ARGV[0]

data/lib/aladdin.rb

@@ -0,0 +1,43 @@
+# ~*~ encoding: utf-8 ~*~
+require 'sinatra'
+require 'zurb-foundation'
+require 'albino'
+require 'haml'
+require 'redcarpet'
+require 'sanitize'
+
+require 'aladdin/render/sanitize'
+require 'aladdin/render/markdown'
+
+# Aladdin is for tutorial apps.
+module Aladdin
+
+  # Launches the tutorial app using 'thin' as the default webserver.
+  # @option opts [String] from        path to author's markdown documents;
+  #                                   defaults to the current working directory
+  def self.launch(opts = {})
+    Aladdin::App.set :views, Aladdin::VIEWS.merge(markdown: opts[:from] || '.')
+    Aladdin::App.run!
+  end
+
+  # Converts a hash to struct.
+  def self.to_struct(hash)
+    Struct.new( *(k = hash.keys) ).new( *hash.values_at( *k ) )
+  end
+  private_class_method :to_struct
+
+  # Paths to different types of views.
+  VIEWS = {
+    haml:     File.expand_path('../../views/haml', __FILE__),
+    scss:     File.expand_path('../../views/scss', __FILE__),
+    default:  File.expand_path('../../views', __FILE__)
+  }
+
+  # Paths to other parts of the library.
+  PATHS = to_struct(
+    assets: File.expand_path('../../assets', __FILE__),
+  ).freeze
+
+end
+
+require 'aladdin/app'

data/lib/aladdin/app.rb

@@ -0,0 +1,89 @@
+# ~*~ encoding: utf-8 ~*~
+module Aladdin
+
+  # Sinatra app that serves the tutorial. Should be able to use this in a
+  # config.ru file or as middleware. Authors should launch the app using the
+  # +bin/aladdin+ executable.
+  # Adapted from https://github.com/jerodsanto/sinatra-foundation-skeleton/
+  class App < Sinatra::Base
+
+    # Default markdown options.
+    MARKDOWN_OPTIONS = {
+      renderer:           Aladdin::Render::HTML,
+      no_intra_emphasis:  true,
+      tables:             true,
+      fenced_code_blocks: true,
+      autolink:           true,
+      strikethrough:      true,
+      layout_engine:      :haml
+    }
+
+    class << self
+      private
+
+      # Configures path to the views, with different paths for different file
+      # types.
+      # @return [void]
+      def configure_views
+        helpers do
+          def find_template(views, name, engine, &block)
+            _, dir = views.detect { |k,v| engine == Tilt[k] }
+            dir ||= views[:default]
+            super(dir, name, engine, &block)
+          end
+        end
+      end
+
+      # Configures path to static assets in the public folder.
+      # @return [void]
+      def configure_assets
+        set :public_folder, Aladdin::PATHS.assets
+      end
+
+      # Configures ZURB's compass to compile laddin's scss assets.
+      # @return [void]
+      def configure_compass
+        Compass.configuration do |config|
+          config.http_path = '/'
+          config.http_images_path = '/images'
+        end
+        set :scss, Compass.sass_engine_options
+      end
+
+      # Registers redcarpet2 and laddin's markdown renderer to be as close to
+      # the github-flavored markdown as possible.
+      # @return [void]
+      def configure_markdown
+        Tilt.register Tilt::RedcarpetTemplate::Redcarpet2, 'markdown', 'mkd', 'md'
+        set :markdown, MARKDOWN_OPTIONS
+      end
+
+    end
+
+    # Calls the given +block+ and invokes +pass+ on error.
+    # @param block        block to call within wrapper
+    def render_or_pass(&block)
+      begin return block.call
+      rescue pass
+      end
+    end
+
+    configure_views
+    configure_markdown
+
+    configure :development, :test do
+      configure_assets
+      configure_compass
+    end
+
+    get '/stylesheets/*.css' do |path|
+      render_or_pass { scss path.to_sym }
+    end
+
+    get '/*' do |path|
+      render_or_pass { markdown path.to_sym }
+    end
+
+  end
+
+end

data/lib/aladdin/render/markdown.rb

@@ -0,0 +1,40 @@
+# ~*~ encoding: utf-8 ~*~
+module Aladdin
+
+  # laddin-render module for all of Laddin's rendering needs.
+  module Render
+
+    # HTML Renderer for Markdown.
+    # It creates pygmentized code blocks, supports hard-wraps, and only
+    # generates links for protocols which are considered safe.
+    # @see http://github.github.com/github-flavored-markdown/
+    class HTML < ::Redcarpet::Render::HTML
+
+      @sanitize = Aladdin::Sanitize.new
+      class << self; attr_reader :sanitize; end
+
+      # Creates a new HTML renderer.
+      # @param [Hash] options        described in the RedCarpet documentation.
+      def initialize(options = {})
+        super options.merge(hard_wrap: true, safe_links_only: true)
+      end
+
+      # Pygmentizes code blocks.
+      # @param [String] code        code block contents
+      # @param [String] language    name of language, for syntax highlighting
+      # @return [String] highlighted code
+      def block_code(code, language)
+        Albino.colorize code, language
+      end
+
+      # Sanitizes the final document.
+      # @param [String] document    html document
+      # @return [String] sanitized document
+      def postprocess(document)
+        HTML.sanitize.clean document
+      end
+
+    end
+
+  end
+end

data/lib/aladdin/render/sanitize.rb

@@ -0,0 +1,84 @@
+# ~*~ encoding: utf-8 ~*~
+
+module Aladdin
+
+  # Encapsulate sanitization options.
+  # Adapted from
+  # https://github.com/github/gollum/blob/master/lib/gollum/sanitization.rb
+  class Sanitize < ::Sanitize
+
+    # white-listed elements
+    ELEMENTS = [
+      'a', 'abbr', 'acronym', 'address', 'area', 'b', 'big',
+      'blockquote', 'br', 'button', 'caption', 'center', 'cite',
+      'code', 'col', 'colgroup', 'dd', 'del', 'dfn', 'dir',
+      'div', 'dl', 'dt', 'em', 'fieldset', 'font', 'form', 'h1',
+      'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'i', 'img', 'input',
+      'ins', 'kbd', 'label', 'legend', 'li', 'map', 'menu',
+      'ol', 'optgroup', 'option', 'p', 'pre', 'q', 's', 'samp',
+      'select', 'small', 'span', 'strike', 'strong', 'sub',
+      'sup', 'table', 'tbody', 'td', 'textarea', 'tfoot', 'th',
+      'thead', 'tr', 'tt', 'u', 'ul', 'var'
+    ].freeze
+
+    # white-listed attributes
+    ATTRIBUTES = {
+      'a'   => ['href'],
+      'img' => ['src'],
+      :all  => ['abbr', 'accept', 'accept-charset',
+                'accesskey', 'action', 'align', 'alt', 'axis',
+                'border', 'cellpadding', 'cellspacing', 'char',
+                'charoff', 'class', 'charset', 'checked', 'cite',
+                'clear', 'cols', 'colspan', 'color',
+                'compact', 'coords', 'datetime', 'dir',
+                'disabled', 'enctype', 'for', 'frame',
+                'headers', 'height', 'hreflang',
+                'hspace', 'id', 'ismap', 'label', 'lang',
+                'longdesc', 'maxlength', 'media', 'method',
+                'multiple', 'name', 'nohref', 'noshade',
+                'nowrap', 'prompt', 'readonly', 'rel', 'rev',
+                'rows', 'rowspan', 'rules', 'scope',
+                'selected', 'shape', 'size', 'span',
+                'start', 'summary', 'tabindex', 'target',
+                'title', 'type', 'usemap', 'valign', 'value',
+                'vspace', 'width']
+    }.freeze
+
+    # white-listed protocols
+    PROTOCOLS = {
+      'a'   => {'href' => ['http', 'https', 'mailto', 'ftp', 'irc', 'apt', :relative]},
+      'img' => {'src'  => ['http', 'https', :relative]}
+    }.freeze
+
+    # elements to remove (incl. contents)
+    REMOVE_CONTENTS = [
+      'script',
+      'style'
+    ].freeze
+
+    # attributes to add to elements
+    ADD_ATTRIBUTES = {
+      'a' => {'rel' => 'nofollow'}
+    }
+
+    # Creates a new sanitizer with Aladdin's configuration.
+    def initialize
+      super config
+    end
+
+    private
+
+    # Returns a configuration hash.
+    def config
+      { elements:         ELEMENTS.dup,
+        attributes:       ATTRIBUTES.dup,
+        protocols:        PROTOCOLS.dup,
+        add_attributes:   ADD_ATTRIBUTES.dup,
+        remove_contents:  REMOVE_CONTENTS.dup,
+        allow_comments:   false
+      }
+    end
+
+  end
+
+end