brandon-codex 1.0.3

data/app_generators/codex/templates/code/control/basic_continuation.rb

@@ -0,0 +1,11 @@
+def open_box(continuation)
+  continuation.call if rand < 0.5
+end
+
+callcc do |continuation|
+  puts "opening box"
+  open_box(continuation)
+  puts "Phew--kitty's OK"
+end
+
+puts "closing box"

data/app_generators/codex/templates/code/control/cc_throw_catch.rb

@@ -0,0 +1,59 @@
+#START:stack
+class CatchStack
+  Frame = Struct.new(:symbol, :cc)
+  
+  def stack
+    Thread.current[:catch_stack] ||= []
+  end
+  
+  def wrap(symbol, cc)
+    stack << Frame.new(symbol, cc)
+    begin
+      yield
+    ensure
+      stack.pop
+    end
+  end
+  
+  def find_continuation_for(symbol)
+      stack.pop until stack.empty? || stack.last.symbol == symbol
+      if stack.empty?
+        fail NameError, "uncaught throw `#{sym}'"
+      else
+        stack.pop.cc
+      end
+  end
+end
+#END:stack
+
+#START:CC
+module CC
+  CATCH_STACK = CatchStack.new
+  
+  def self.catch(sym)
+    callcc do |cc|
+      CATCH_STACK.wrap(sym, cc) do
+        yield 
+      end
+    end
+  end
+  
+  def self.throw(sym, value=nil)
+    cc = CATCH_STACK.find_continuation_for(sym)
+    cc.call(value)
+  end
+end
+#END:CC
+
+#START:body
+def test_method
+  CC.throw(:x, "thrown X") if rand < 0.5
+end
+
+result = CC.catch(:x) do
+          test_method
+          "normal exit"
+        end
+        
+puts "Result is #{result}"
+#END:body

data/app_generators/codex/templates/code/control/closure_continuation.rb

@@ -0,0 +1,8 @@
+def create_continuation(arg)
+  callcc { |continuation| return continuation }
+  puts "Back in method: arg = #{arg}"
+  exit
+end
+
+cont_one = create_continuation(123)
+cont_one.call      #=> Back in method: arg = 123

data/app_generators/codex/templates/code/control/closure_continuation_2.rb

@@ -0,0 +1,12 @@
+def create_continuation(arg)
+  callcc { |continuation| return continuation }
+  puts "Back in method: arg = #{arg}"
+end
+
+cont_one = create_continuation(123)
+cont_one.call
+
+### Results in:
+#
+# Back in method: arg = 123
+# closure_continuation_2.rb:8: undefined method `call' for nil:NilClass

data/app_generators/codex/templates/content/basics.textile

@@ -0,0 +1,37 @@
+h1. The Basics
+
+h1. Content and Code
+
+* Content is created using "Textile markup":http://www.textism.com/tools/textile/
+* Code is written as normal source files
+* Content can embed parts of the source files
+* It's all processed into an HTML-based presentation
+  
+h1. Presentation Metadata
+
+* Required file @content/metadata.yml@
+
+:code content/metadata.yml
+
+h1. Where Stuff Goes
+
+* Create your content in @content/xxx.textile@
+* Write code under @code/xxx@
+* Build the files @html/xxx.html@ by running @Rake@
+
+
+h1. @.textile@ files
+
+* Each @.textile@ file is a separate chunk of the presentation
+* The first @h1.@ heading is the banner page for that chunk
+* Each subsequent @h1.@ starts a new slide
+
+
+h1. Table of Contents
+
+* You can divide your material into segments, each in a separate @xxx.textile@ file
+* Then create @content/table_of_contents.textile@, eg:
+
+:code content/table_of_contents.textile[class=code-small]
+
+

data/app_generators/codex/templates/content/building.textile

@@ -0,0 +1,27 @@
+h1. Building and Displaying HTML Slides
+
+h1. Building HTML Slides
+
+* Given an individual section in @content/xxx.textile@
+
+    @rake html/xxx.html@
+    
+* If you've created a @content/table_of_contents.textile@, build the whole presentation with
+
+    @rake all@
+    
+  The output will be in @html/all.html@
+  
+h1. Running the Presentation
+
+* Simply open the appropriate HTML file
+
+* See the "S5 documentation":http://meyerweb.com/eric/tools/s5/ for details
+
+* Some hints
+** arrow keys and space bar work
+** type the slide number to jump
+** mouse over the bottom right to bring up a set of controls and a list of all available slides
+** most IR and radio clickers seem to work OK
+** resizing your browser fonts works well to make stuff fit during the presentation
+

data/app_generators/codex/templates/content/example.textile

@@ -0,0 +1,80 @@
+h1. An Example
+
+This comes from the "Advanced Ruby Course":http://pragmaticstudio.com/ruby/ 
+
+h1. Continuation
+
+<div style="width: 50%; float: right">
+:code code/control/basic_continuation.rb[class=code-normal]
+</div>
+
+<div style="width: 50%">
+  
+* Construct using @callcc@
+** pass it a block
+** block receives @Continuation@ object
+** invoke that object's @call@ method, and control passes to the end of that block
+
+</div>
+
+
+h1. Continuations Are Closures
+
+:code code/control/closure_continuation.rb
+
+h1. But...
+
+:code code/control/closure_continuation_2.rb
+
+h1. But...
+
+<div>
+:code code/control/closure_continuation_2.rb
+
+<div style="position: relative; left: 60%; top: -3em; font-size: 400%; color: #6b6">Why?</div>
+</div>
+
+
+
+h1. Implementing throw...catch 
+
+Let's try to implement throw and catch so that the following works as expected:
+
+:code code/control/cc_throw_catch.rb[body]
+
+h1. Implementing throw...catch
+
+* We need a thread-local stack of all current catch blocks
+
+* When we see a @catch@, we store the symbol and a continuation for the block on the stack. If that continuation gets called, execution resumes after the block (which is what @catch@ does)
+
+* When we see a @throw@ we traverse it looking for the entry
+with the corresponding system.
+
+* When we find that entry, we call the corresponding continuation
+
+&nbsp;
+
+bq{font-size="50%"}. This implementation is based on code from Jim Weirich
+
+h1. Catch and Throw
+
+:code code/control/cc_throw_catch.rb[CC class=code-tiny]
+
+h1. And the stack
+
+:code code/control/cc_throw_catch.rb[stack class=code-tiny]
+
+h1. Continuations.
+
+* Can't invoke across threads
+
+* Can carry stale state around with them
+
+* Can use up a lot of memory
+
+* Are not fun to debug
+
+But...
+
+* They'll impress your friends

data/app_generators/codex/templates/content/including_code.textile

@@ -0,0 +1,80 @@
+h1. Including Code in Slides
+
+h1. Including Code in Slides
+
+* Write code under @code/@
+* Include it in your slides using @:code@ directives
+
+:inlinecode
+:code code/myfile.rb
+:endinlinecode
+
+* The entire contents of @code/myfile.rb@ will be included in the slide
+
+h1. Including Parts of a Source File
+
+* In the source file, use comments containing @START:sometag@ and @END:sometag@        
+
+:inlinecode
+class SomeClass
+#START:useful-method
+  def my_method
+    puts "hello world"
+  end
+#END:useful-method
+end
+:endinlinecode
+
+* In the slide, reference the tag in square brackets after the file name
+
+:inlinecode
+:code code/myfile.rb[useful-method]
+:endinlinecode   
+
+h1. Merge Multiple Fragments
+
+:inlinecode
+#START:constructor
+class SomeClass
+
+  def initialize
+    # ...
+  end
+#END:constructor
+     
+  def other_methods...
+  end
+#START:constructor
+end
+#END:constructor
+:endinlinecode
+
+
+h1. Override Code Language and/or CSS Class
+
+:inlinecode
+:code code/file.xxx[section lang=name class=name]
+:endinlinecode
+       
+* can appear in any order
+* @lang=@<em>anything supported by SyntaxHighlighter</em> 
+** look in @dp.SyntaxHighlighter/Scripts@)
+* @class=code-large | code-normal | code-small | code-tiny | code-supertiny@
+                                                                                  
+h1. Embedding Code Inline
+
+:inlinecode
+ :inlinecode
+ code that
+ goes inline in slides
+ :endinlinecode
+:endinlinecode 
+
+* @:inlinecode@ optionally takes @lang=xxx@ and @class=xx@     
+
+:inlinecode
+ :inlinecode lang=ruby
+    puts "Hello World!"
+ :endinlinecode
+:endinlinecode 
+

data/app_generators/codex/templates/content/including_tex.textile

@@ -0,0 +1,31 @@
+h1. Including TeX math formulas in slides
+
+h1. Including TeX (WebTeX) math formula in slides
+
+Everything line between :inlinetex and :endlinetex is treated as a TeX math formula
+
+*Example:*
+
+:inlinecode
+:inlinewebtex
+\alpha\beta\gamma
+:endinlinewebtex
+:end
+
+*Result:*
+
+:inlinewebtex
+\alpha\beta\gamma
+:end
+
+h1. Ritex and WebTex
+
+WebTeX is an adapation of the TeX math syntax which is designed for web page display.
+
+Ritex is a nice little gem used to generate MathML from from WebTeX.
+
+Ressources:
+* "The WebTeX documentation":http://stuff.mit.edu/afs/athena/software/webeq/currenthome/docs/webtex/toc.html
+* "The Ritex documentation":http://ritex.rubyforge.org/
+
+The flipside is that MathML doesn't always display properly in browsers :-(

data/app_generators/codex/templates/content/metadata.yml

@@ -0,0 +1,4 @@
+title:     The Codex Presentation System
+author:    Dave Thomas  
+company:   The Pragmatic Programmers, LLC
+copyright: 2008 Dave Thomas

data/app_generators/codex/templates/content/table_of_contents.textile

@@ -0,0 +1,20 @@
+h1. The Codex System
+
+h1. Creating Content
+
+* "The Basics":basics.html
+* "Including Code":including_code.html
+
+h1. Creating Slideshows
+
+* "Building and Displaying HTML":building.html
+
+h1. An Example     
+
+* "Some Sample Slides":example.html
+
+h1. Extra filters
+
+* "The Ritex filter":including_tex.html
+* "The Graphviz filter":graphviz.html
+* "Defining your own":user_defined.html

data/app_generators/codex/templates/dp.SyntaxHighlighter/CSS.html

@@ -0,0 +1,115 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><!-- InstanceBegin template="/Templates/Test.dwt" codeOutsideHTMLIsLocked="false" -->
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<title>dp.SyntaxHighlighter Tests</title>
+<link type="text/css" rel="stylesheet" href="Styles/SyntaxHighlighter.css"></link>
+<link href="Styles/TestPages.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+
+<h1>dp.SyntaxHighlighter 1.5.0 Tests and Samples</h1>
+<p><a href="http://code.google.com/p/syntaxhighlighter/">http://code.google.com/p/syntaxhighlighter/</a></p>
+
+<h2><!-- InstanceBeginEditable name="Title" -->CSS<!-- InstanceEndEditable --></h2>
+
+<div class="layout">
+
+<div class="column1">
+	<h3>Languages:</h3>
+	<ol>
+		<li><a href="CSharp.html">C#</a></li>
+		<li><a href="CSS.html">CSS</a></li>
+		<li><a href="Cpp.html">C++</a></li>
+		<li><a href="Delphi.html">Delphi</a></li>
+		<li><a href="Java.html">Java</a></li>
+		<li><a href="JavaScript.html">JavaScript</a></li>
+		<li><a href="PHP.html">PHP</a></li>
+		<li><a href="Python.html">Python</a></li>
+		<li><a href="Ruby.html">Ruby</a></li>
+		<li><a href="SQL.html">SQL</a></li>
+		<li><a href="VB.html">Visual Basic</a></li>
+		<li><a href="XML.html">XML / HTML</a></li>
+	</ol>
+	<h3>Features:</h3>
+	<ol>
+		<li><a href="SmartTabs.html">Smart tabs</a></li>
+		<li><a href="FirstLine.html">First line</a> </li>
+		<li><a href="CollapseCode.html">Expand code</a></li>
+	    <li><a href="ShowColumns.html">Show columns</a></li>
+	    <li><a href="NoGutter.html">No gutter</a></li>
+	    <li><a href="NoControls.html">No controls</a></li>
+	</ol>
+</div>
+
+<div class="column2">
+Text body before.
+<hr/>
+<!-- InstanceBeginEditable name="Code" -->
+<pre name="code" class="css">
+/* Main style for the table */
+
+.dp-highlighter
+{
+	font-family: "Courier New", Courier, mono;
+	font-size: 12px;
+	text-align: left;
+	border: 1px solid #2B91AF;
+	background-color: #fff;
+	width: 99%;
+	overflow: auto;
+	line-height: 100% !important;
+	margin: 18px 0px 18px 0px;
+}
+
+.dp-highlighter ol
+{
+	margin: 0px 0px 0px 45px;
+	padding: 0px;
+	color: #2B91AF;
+}
+
+.dp-highlighter ol li
+{
+	border-left: 3px solid #6CE26C;
+	border-bottom: 1px solid #eee;
+	background-color: #fff;
+	padding-left: 10px;
+}
+
+.dp-highlighter ol li.alt
+{
+	background-color: #f8f8f8;
+}
+</pre>
+<!-- InstanceEndEditable -->
+<hr/>
+Text body after.
+</div>
+</div>
+
+<div class="footer">
+Copyright 2004-2007 Alex Gorbatchev.<br/>
+</div>
+
+<script class="javascript" src="Scripts/shCore.js"></script>
+<script class="javascript" src="Scripts/shBrushCSharp.js"></script>
+<script class="javascript" src="Scripts/shBrushPhp.js"></script>
+<script class="javascript" src="Scripts/shBrushJScript.js"></script>
+<script class="javascript" src="Scripts/shBrushJava.js"></script>
+<script class="javascript" src="Scripts/shBrushVb.js"></script>
+<script class="javascript" src="Scripts/shBrushSql.js"></script>
+<script class="javascript" src="Scripts/shBrushXml.js"></script>
+<script class="javascript" src="Scripts/shBrushDelphi.js"></script>
+<script class="javascript" src="Scripts/shBrushPython.js"></script>
+<script class="javascript" src="Scripts/shBrushRuby.js"></script>
+<script class="javascript" src="Scripts/shBrushCss.js"></script>
+<script class="javascript" src="Scripts/shBrushCpp.js"></script>
+<script class="javascript">
+dp.SyntaxHighlighter.ClipboardSwf = 'Scripts/clipboard.swf';
+dp.SyntaxHighlighter.HighlightAll('code');
+</script>
+
+</body>
+<!-- InstanceEnd --></html>