Reference examples now use syntax highlighting

Author: chrisws

_build/Makefile

@@ -19,12 +19,14 @@ pandoc = /usr/bin/pandoc
 mkdir = @mkdir -p $(dir $@)
 out = _out
 pandoc_options=--from markdown-tex_math_dollars --to html5 --syntax-definition=smallbasic.xml
+pandoc_ide_options=--from markdown-tex_math_dollars --to html5
 bas = $(patsubst layouts/%.html, $(out)/%.bas, $(wildcard layouts/*.html))
 pages = $(patsubst pages/%.markdown, $(out)/pages3/%.html, $(wildcard pages/*.markdown))
 posts = $(patsubst posts/%.markdown, $(out)/posts3/%.html, $(wildcard posts/*.markdown))
 scripts = $(patsubst scripts/%.html, $(out)/scripts2/%.html, $(wildcard scripts/*.html))
 reference = $(patsubst reference/%.markdown, $(out)/reference3/%.html, $(wildcard reference/*.markdown))
 reference_txt = $(patsubst reference/%.markdown, $(out)/reference_txt/%.txt, $(wildcard reference/*.markdown))
+reference_ide = $(patsubst reference/%.markdown, $(out)/reference_ide/%.html, $(wildcard reference/*.markdown))
 
 # rules
 .data: reference.json page.bas site.bas mkdata.bas includes/header.html
@@ -35,7 +37,11 @@ $(out)/%.bas: layouts/%.html .data
 	$(mkdir)
 	$(sbasic) mkpage.bas $< > $@
 
-$(out)/reference1/%.html: reference/%.markdown
+$(out)/reference0/%.markdown: reference/%.markdown
+	$(mkdir)
+	$(sbasic) mkhl.bas $< > $@
+
+$(out)/reference1/%.html: $(out)/reference0/%.markdown $(bas)
 	$(mkdir)
 	$(pandoc) $(pandoc_options) -o $@ $<
 
@@ -87,7 +93,11 @@ $(out)/reference_txt/%.txt: reference/%.markdown
 	$(mkdir)
 	$(pandoc) --from markdown-tex_math_dollars --to plain -o $@ $<
 
-all: $(reference) $(out)/sbref.txt $(out)/sbasic_ref.csv $(pages) $(posts) $(scripts)
+$(out)/reference_ide/%.html: reference/%.markdown
+	$(mkdir)
+	$(pandoc) $(pandoc_ide_options) -o $@ $<
+
+all: $(reference) $(reference_ide) $(out)/sbref.txt $(out)/sbasic_ref.csv $(pages) $(posts) $(scripts)
 	@mkdir -p ../reference/ide
 	@mkdir -p ../pages
 	@mkdir -p ../posts

_build/deploy.bas

@@ -15,7 +15,7 @@ for package in ref
     endif
     copy in_filename, out_filename
 
-    in_filename = "_out/reference1/" + item.nodeId + "-" + lower(package) + "-" + translate(lower(item.keyword), " ", "") + ".html"
+    in_filename = "_out/reference_ide/" + item.nodeId + "-" + lower(package) + "-" + translate(lower(item.keyword), " ", "") + ".html"
     out_filename = "../reference/ide/" + item.nodeId + ".html"
     if (not exist(in_filename)) then
       throw "File does not exist:" + in_filename

_build/mkhl.bas

@@ -0,0 +1,23 @@
+'
+' adds syntax highlight handling for code blocks
+'
+
+tload trim(command), buffer
+inBlock = false
+for s in buffer
+  if (trim(s) == "```smallbasic") then
+    ' highlight marker already applied here
+    print(s)
+    inBlock = true
+  else if (trim(s) == "```" || trim(s) == "~~~") then
+    ' block start or end
+    if (inBlock) then
+      print "```"
+    else
+      print "```smallbasic"
+    endif
+    inBlock = !inBlock
+  else
+    print(s)
+  endif
+next

_build/reference/1015-console-definekey.markdown

@@ -37,7 +37,7 @@ Keycodes for PC keyboard
 
 Example 1: Bind keystroke for left and right arrow key
 
-```smallbasic
+```
 defineKey 0xFF04, Increase      'Left arrow
 defineKey 0xFF05, Decrease      'Right arrow
 
@@ -59,13 +59,13 @@ wend
 
 Example 2: Unbind a keystroke
 
-```smallbasic
+```
 DEFINEKEY 0xFF04, 0
 ```
 
 Example 3: Etch-a-Sketch
 
-```smallbasic
+```
 ' DEFINEKEY demo.bas  SmallBASIC 0.12.2 [B+=MGA] 2016-03-30
 'remember Etch-A-Sketch?
 'definekey key,sub
@@ -133,7 +133,7 @@ end
 
 Example 4: This example is outdated and just a reference for buttons in PALM OS
 
-```smallbasic
+```
 ' Note:
 ' * You may Include "definekey_const.bas" file in another file to make your code more clear.
 '

_build/reference/521-console-at.markdown

@@ -4,7 +4,7 @@
 
 Moves the console cursor to the specified position. x,y are in pixels.
 
-```smallbasic
+```
 at 100,100
 print "This text starts at pixel 100,100"
 ```

_build/reference/524-console-cls.markdown

@@ -4,7 +4,7 @@
 
 Clears the screen.
 
-```smallbasic
+```
 print "Test"
 CLS
 ```

_build/reference/525-console-form.markdown

@@ -72,7 +72,7 @@ The type attribute can be one of the following:
 
 ### Example 1: Creating a push button using callback function
 
-```smallbasic
+```
 button.type = "button"
 button.x = 120
 button.y = 120
@@ -99,7 +99,7 @@ end
 
 ### Example 2: Creating a push button using doEvents result
 
-```smallbasic
+```
 button.type = "button"
 button.x = 120
 button.y = 120
@@ -125,7 +125,7 @@ f.close()
 
 ### Example 3: Creating a label
 
-```smallbasic
+```
 l.type = "label"
 l.x = 120
 l.y = 120
@@ -145,7 +145,7 @@ f.close()
 
 ### Example 4: Creating a link to an external website
 
-```smallbasic
+```
 l.type = "link"
 l.x = 120
 l.y = 120
@@ -167,7 +167,7 @@ f.close()
 
 ### Example 5: Creating a listbox
 
-```smallbasic
+```
 l.type = "listbox"
 l.x = 120
 l.y = 120
@@ -196,7 +196,7 @@ f.close()
 
 ### Example 6: Creating a dropdown listbox
 
-```smallbasic
+```
 l.type = "choice"
 l.x = 120
 l.y = 120
@@ -224,7 +224,7 @@ f.close()
 
 ### Example 7: Creating a text input field
 
-```smallbasic
+```
 t.type = "text"
 t.x = 120
 t.y = 120
@@ -266,7 +266,7 @@ end
 In this example a callback function will be used. If you want to use the doEvents result instead,
 have a look at example 2.
 
-```smallbasic
+```
 ' Create a simple button and save it as png
 ' If you have already an image for you button,
 ' this part is not necessary.
@@ -301,7 +301,7 @@ end
 
 ### Example 9: One more example
 
-```smallbasic
+```
 f.handleKeys = 0
 ' create some buttons
 button1.y = 120

_build/reference/527-console-input.markdown

@@ -6,14 +6,14 @@ Reads text from keyboard and stores it in the variable `var`. The string `prompt
 
 ### Example 1: Using a single var
 
-```smallbasic
+```
 input "How old are you?", age
 print age
 ```
 
 ### Example 2: Using multiple vars
 
-```smallbasic
+```
 input "Input three numbers: ", a, b, c   ' Input i.e. 1,2,3
 print a, b, c
 ```

_build/reference/528-console-lineinput.markdown

@@ -6,14 +6,14 @@ Reads a whole text line from file or console and stores it in the string `var`.
 
 ### Example 1: Read from console
 
-```smallbasic
+```
 LINEINPUT S
 PRINT S
 ```
 
 ### Example 2: Read from file
 
-```smallbasic
+```
 ' create a file
 open "File.txt" for output as #1
 

_build/reference/529-console-linput.markdown

@@ -6,14 +6,14 @@ Reads a whole text line from file or console and stores it in the string `var`.
 
 ### Example 1: Read from console
 
-```smallbasic
+```
 LINPUT S
 PRINT S
 ```
 
 ### Example 2: Read from file
 
-```smallbasic
+```
 ' create a file
 open "File.txt" for output as #1