Allow runnable examples anywhere

Author: wilzbach

dlang.org.ddoc

@@ -351,6 +351,8 @@ _=
 RELATIVE_LINK2=$(ALOCAL $1, $+)
 _=
 
+RUNNABLE_EXAMPLE=$(DIVC runnable-examples, $1)
+
 SAMPLESRC=$(SPANC sample_src, $(AHTTPS github.com/dlang/dmd/blob/master/samples/$0, /dmd/samples/d/$0))
 SCINI=$(TC pre, scini notranslate, $0)
 SCRIPTLOAD=<script type="text/javascript" src="$1"$+></script>

index.dd

@@ -29,6 +29,7 @@ $(DIVC intro, $(DIV, $(DIV,
             )
         )
         $(DIVID your-code-here-default,
+$(RUNNABLE_EXAMPLE
 ----
 // Round floating point numbers
 import std.algorithm, std.conv, std.functional,
@@ -49,6 +50,7 @@ void main()
 }
 ----
 )
+)
 $(EXTRA_EXAMPLE
 ----
 // Sort lines
@@ -418,8 +420,8 @@ Macros:
     TAG=<$1>$+</$1>
     TAG2=<$1 $2>$3</$1>
     D=<span class="d_inlinecode">$0</span>
-    EXAMPLE=$(TAG2 a, id="a$1-control" class="example-control", )$(TAG2 div, id="a$1" class="example-box", $2)
-    EXTRA_EXAMPLE=<div class="your-code-here-extra" style="display:none">$0</div>
+    EXAMPLE=$(TAG2 a, id="a$1-control" class="example-control", )$(TAG2 div, id="a$1" class="example-box", $(RUNNABLE_EXAMPLE $2))
+    EXTRA_EXAMPLE=<div class="your-code-here-extra" style="display:none">$(RUNNABLE_EXAMPLE $0)</div>
     LAYOUT_PREFIX=
     LAYOUT_SUFFIX=
     $(SCRIPTLOAD $(ROOT_DIR)js/platform-downloads.js,  data-latest="$(LATEST)")

js/run.js

@@ -335,17 +335,15 @@ $(document).ready(function()
 
     var currentPage = $(location).attr('pathname');
 
-    if ($('body')[0].id != "Home")
-        return;
-
-    $('pre[class~=d_code]').each(function(index)
+    $('.runnable-examples').each(function(index)
     {
-        var stripedText = $(this).text().replace(/\s/gm,'');
+        var el = $(this).children().first();
+        var stripedText = el.text().replace(/\s/gm,'');
         var md5sum = MD5(stripedText);
 
         var stdin = "";
         var args = "";
-        var currentExample = $(this);
+        var currentExample = el;
         var orig = currentExample.html();
 
         if (typeof mainPage !== 'undefined' && md5sum in mainPage)

spec/module.dd

@@ -224,6 +224,7 @@ $(H3 $(LNAME2 name_lookup, Symbol Name Lookup))
 	$(P The simplest form of importing is to just list the
 	modules being imported:)
 
+$(RUNNABLE_EXAMPLE
 ---------
 module myapp.main;
 
@@ -239,6 +240,7 @@ class Foo : BaseClass
     }
 }
 ---------
+)
 
 	$(P When a symbol name is used unqualified, a two-phase lookup will happen.
     First, the module scope will be searched, starting from the innermost
@@ -383,6 +385,7 @@ $(H3 $(LNAME2 renamed_imports, Renamed Imports))
 	all references to the module's symbols must be qualified
 	with:)
 
+$(RUNNABLE_EXAMPLE
 ---
 import io = std.stdio;
 
@@ -393,6 +396,7 @@ void main()
     writeln("hello!");           // error, writeln is undefined
 }
 ---
+)
 
 	$(P Renamed imports are handy when dealing with
 	very long import names.)
@@ -402,6 +406,7 @@ $(H3 $(LNAME2 selective_imports, Selective Imports))
 	$(P Specific symbols can be exclusively imported from
 	a module and bound into the current namespace:)
 
+$(RUNNABLE_EXAMPLE
 ---
 import std.stdio : writeln, foo = write;
 
@@ -414,13 +419,15 @@ void main()
     fwritefln(stdout, "abc");    // error, fwritefln undefined
 }
 ---
+)
 
 	$(P $(D static) cannot be used with selective imports.)
 
 $(H3 $(LNAME2 renamed_selective_imports, Renamed and Selective Imports))
 
 	$(P When renaming and selective importing are combined:)
 
+$(RUNNABLE_EXAMPLE
 ------------
 import io = std.stdio : foo = writeln;
 
@@ -437,19 +444,22 @@ void main()
                               // foo is not a member of io
 }
 --------------
+)
 
 
 $(H3 $(LNAME2 scoped_imports, Scoped Imports))
 
     $(P Import declarations may be used at any scope. For example:)
 
+$(RUNNABLE_EXAMPLE
 --------------
 void main()
 {
     import std.stdio;
     writeln("bar");
 }
 --------------
+)
 
     $(P The imports are looked up to satisfy any unresolved symbols at that scope.
     Imported symbols may hide symbols from outer scopes.)
@@ -461,6 +471,7 @@ void main()
 	at function scope cannot be forward referenced.
 	)
 
+$(RUNNABLE_EXAMPLE
 --------------
 void main()
 {
@@ -477,6 +488,7 @@ void main()
     std.stdio.writeln("bar");  // error, std is undefined
 }
 --------------
+)