DOC: update reference index

Author: chrisws

_build/Makefile

@@ -18,7 +18,7 @@ pandoc = /usr/bin/pandoc
 # variables
 mkdir = @mkdir -p $(dir $@)
 out = _out
-pandoc_options=--smart --to html5
+pandoc_options=--to html5
 bas = $(patsubst layouts/%.html, $(out)/%.bas, $(wildcard layouts/*.html))
 pages = $(patsubst pages/%.markdown, $(out)/pages4/%.html, $(wildcard pages/*.markdown))
 reference = $(patsubst reference/%.markdown, $(out)/reference3/%.html, $(wildcard reference/*.markdown))

_build/includes/head.html

@@ -2,7 +2,7 @@
   <meta charset="utf-8">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{{ page.title }}</title>
+  <title>SmallBASIC - {{ page.name }}</title>
   <meta name="description" content="{{ page.help }}">
   <link rel="canonical" href="{{ page.url }}">
   <link rel="keywords" href="{{ page.title }}">

_build/page.bas

@@ -37,7 +37,7 @@ else
   package = item.package
   filepath = item.nodeId + "-" + lower(item.package) + "-" + lower(item.keyword) + ".markdown"
   filepath = "reference/" + translate(filepath, " ", "")
-  lastedit = run("git log -1 --format=\"%aD\" -- " + filepath)
+  lastedit = run("git log -1 --format=\"%cD by %cn\" -- " + filepath)
   sourceurl = "https://github.com/smallbasic/smallbasic.github.io/blob/master/_build/" + filepath
   changesurl = "https://github.com/smallbasic/smallbasic.github.io/commits/master/_build/" + filepath
 endif

_build/pages/reference.markdown

@@ -4,19 +4,35 @@ Language reference
 BASIC is a very simple language and it is a perfect tool for calculations or utilities.
 Its name stands for (B)eginners (A)ll-purpose (S)ymbolic (I)nstruction (c)ode. It was developed by John
 Kemeny and Thomas Kurtz at Dartmouth College during the middle of 1960, and was one of the most
-popular languages for several decades. {.roleNote}
+popular languages for several decades.
+
+::: contentsPanel ::
+::: contentsHeader ::
+Contents
+:::
+
+#. [Console](/reference/521.html)
+#. [Data](/reference/581.html)
+#. [Date](/reference/575.html)
+#. [File](/reference/580.html)
+#. [Graphics](/reference/611.html)
+#. [Language](/reference/622.html)
+#. [Math](/reference/704.html)
+#. [String](/reference/771.html)
+#. [System](/reference/1439.html)
+:::
 
 How to read the language reference syntax
 -----------------------------------------
 
-* Everything written inside of [] characters are optional values.
-* Everything written inside of { characters means you must select one of them.
-* The symbol | means OR.
-* The symbols ... mean you can repeat the previous syntax.
-* Keywords are written with capital letters.
-* Parameters are written with lower letters.
-* Keywords with suffix () are functions.
-* Parameters with suffix () are arrays.
++ Everything written inside of [] characters are optional values.
++ Everything written inside of { characters means you must select one of them.
++ The symbol | means OR.
++ The symbols ... mean you can repeat the previous syntax.
++ Keywords are written with capital letters.
++ Parameters are written with lower letters.
++ Keywords with suffix () are functions.
++ Parameters with suffix () are arrays.
 
 ~~~
 FOO     <- This is keyword
@@ -30,27 +46,16 @@ foo()   <- This is array/parameter
 The following example means that you must give the first parameter (a) but you can use the second (x)
 only if you want to. But if you want to use the (x) you must also separate it from (a) with a comma.
 
-~~~FOO a[, x]~~~
+~~~
+FOO a[, x]
+~~~
 
 The next example means that you must use the first parameter. You can also use second parameter
 but you must separate it with ',' or ';'. You can also repeat the last syntax more times.
 
-~~~FOO var [{,|;} var2 [...]]~~~
-
-  <div class="contentsPanel">
-    <div class="contentsHeader">Contents</div>
-    <ul>
-      <li><span>1</span><a href="/reference/521.html">Console</a></li>
-      <li><span>2</span><a href="/reference/581.html">Data</a></li>
-      <li><span>3</span><a href="/reference/575.html">Date</a></li>
-      <li><span>4</span><a href="/reference/580.html">File</a></li>
-      <li><span>5</span><a href="/reference/611.html">Graphics</a></li>
-      <li><span>6</span><a href="/reference/662.html">Language</a></li>
-      <li><span>7</span><a href="/reference/704.html">Math</a></li>
-      <li><span>8</span><a href="/reference/771.html">String</a></li>
-      <li><span>9</span><a href="/reference/1439.html">System</a></li>
-    </ul>
-  </div>
+~~~
+FOO var [{,|;} var2 [...]]
+~~~
 
 You can find
 ------------
@@ -64,12 +69,10 @@ STEP under Graphics,  aspect under Graphics, FILLED under Graphics, QBcolors und
 "system variables" AKA built in coder constants under System eg, pi, xmax, ymax, cwd...
 INCLUDE under System
 
-Allot of information is under Articles > "Welcome to SmallBASIC":
+Alot of information is under Articles > "Welcome to SmallBASIC"
 operators eg ~ % ^ ! IN LIKE
 special characters eg   [ , ;]  ARRAY definition << append to array
 basic stuff about variables, subs and functions
 aha! stuff on units, meta commands, options, pseudo operators
 
 TRY CATCH THROW ENDTRY ... located in Language ref > Language unsorted list
-  
-

_build/reference/1015-console-definekey.markdown

@@ -12,7 +12,8 @@ sub moveLeft
 end
 defineKey 0xFF04, moveLeft
 Refer to keymap.h in the SVN repository for key definitions. TODO: create a keys.bas unit for key constants
-<pre>
+
+~~~
 
 ' DEFINEKEY demo.bas  SmallBASIC 0.12.2 [B+=MGA] 2016-03-30
 'remember Etch-A-Sketch?
@@ -78,9 +79,10 @@ sub quit
   stop
 end
 
-</pre>
+~~~
+
 
-<pre>
+~~~
 
 ' Note:
 ' * You may Include "definekey_const.bas" file in another file to make your code more clear.
@@ -169,5 +171,5 @@ Const DK_MK_WHEEL   = 0xFFC4
 Const DK_MK_FIRST   = DK_MK_PUSH
 Const DK_MK_LAST    = DK_MK_WHEEL
 
-</pre>
+~~~
 

_build/reference/1425-language-try.markdown

@@ -8,7 +8,8 @@ The TRY statement introduces a TRY/CATCH BLOCK
 
 Note:
 If this demo program crashes... then run it again. It seems that TRY / CATCH block might be unstable within a function or sub... (?)
-<pre>
+
+~~~
 
 ' See also: Home -- Articles -- TRY / CATCH
 Const FILE_NAME = "try demo.tmp" ' -- DON'T use existing file for demo.
@@ -73,5 +74,5 @@ If fn Then
 Fi
 Pause
 
-</pre>
+~~~
 

_build/reference/1432-data-array.markdown

@@ -4,7 +4,8 @@
 
 Creates a ARRAY or MAP variable from the given string or expression
 
-<pre>
+
+~~~
 
 ' See also Article "New features" -> "User defined structures".
 Def uline(text) = Cat(2) + text + Cat(-2) ' Underline text
@@ -78,7 +79,7 @@ b.title = "Top-Left"
 ?:?:? " Press any key..."
 Pause
 
-</pre>
+~~~
 
 Thank you.
 Ah, new stuff!
@@ -108,13 +109,14 @@ Here I quote Chris from Home -- Forums -- Project help -- Tile Map Editor:
 <blockquote>
 ...
 If you click File / Export and save the output in JSON format, you can then use the output in a SmallBASIC program like this:
-<pre>
+
+~~~
 
 tload "map.json" , buffer, 1
 tiles= array(buffer)
 ? tiles.layers(0).data(0)
 
-</pre>
+~~~
 
 ...
 </blockquote>
@@ -123,7 +125,8 @@ That's useful but can it be applied to other ARRAY types? For example I can make
 I've copy this code from JSON Wikipedia, it seems like JSON supports more then one 
 dimension according to the example... 
 The following example shows a possible JSON representation describing a person:
-<pre>
+
+~~~
 
 {
   "firstName": "John",
@@ -154,7 +157,7 @@ The following example shows a possible JSON representation describing a person:
   "spouse": null
 }
 
-</pre>
+~~~
 
 This what Chris wrote at Home -- Forums -- Announcements (10/02/2014):
 <blockquote>
@@ -175,7 +178,8 @@ Home -- Forums -- Project help -- Tile Map Editor -- coffee first...
 It shows how easy is to save and load ordinary array with more than one dimension, by using the WRITE and READ keywords to save and load array variables in binary format.
 I am trying to make a dictionary with two columns as part of writing an assembler. I can SEARCH the first column and use (0,1) then (1,1) to look up the second column if I REDIM the array loaded from a file.
 But I cannot see a way to load the file with two dimensions.
-<pre>
+
+~~~
 
 REM SmallBASIC
 REM created: 03/04/2016
@@ -222,11 +226,12 @@ SEARCH i, "JEQ", r
 ? "jump   = ",i(0,r)
 ? "binary = ",i(1,r)
 
-</pre>
+~~~
 
 See:  Home -- Language reference -- File -- TLOAD -- How to convert TLOAD's array into nested array
 Thanks for your help but REDIM works for me.
-<pre>
+
+~~~
 
 ? "OPEN \\"dest\\" FOR INPUT AS #1"
 OPEN "dest" FOR INPUT AS #1

_build/reference/1439-system-chain.markdown

@@ -4,7 +4,8 @@
 
 Compile and run the given source. Source can be a file name, a line of code or an array of code. Use ENV to share variables with the parent process.
 
-<pre>
+
+~~~
 
 ' Note: CHAIN behaves like EVAL function in other languages.
 Option Base 1 ' (for 'IN' keyword which is 1-Based)
@@ -48,9 +49,10 @@ Color 15 ' print the return value from file
 ? " (Return value SB1 is: "; Env("SB1"); ")" ' (i is 6)
 Pause
 
-</pre>
+~~~
+
 
-<pre>
+~~~
 
 Const FILENAME = "demo.bas"
 ' Create demo bas file (could be any SmallBASIC file):
@@ -83,9 +85,10 @@ Color 7:  ? "I'm The Parent Program..."
 Color 15: ? "Child program returned value: "; Env("SB1")
 Pause
 
-</pre>
+~~~
+
 
-<pre>
+~~~
 
 ' Dedicated to MGA.
 ' s is any legal SmallBASIC Math Expression as String, e.g. "1 + 2 / 4"
@@ -106,5 +109,5 @@ End Func
 ? eval("Rad((45 * 3) - 20) * 2")
 Pause
 
-</pre>
+~~~
 

_build/reference/1443-system-exec.markdown

@@ -4,7 +4,8 @@
 
 Transfers control to another operating system program.
 
-<pre>
+
+~~~
 
 Const IS_LINUX = (Left(HOME, 1) = "/")  ' Check if it's Linux system
 Const IS_WINDOWS = Not IS_LINUX
@@ -51,7 +52,7 @@ End Select
 ? "Done.";
 Pause
 
-</pre>
+~~~
 
 Apparently, RUN/EXEC have bugs in SmallBASIC version 0.12.2...:
 chrisws replied on Sun, 04/24/2016 - 00:29 http://smallbasic.sourceforge.net/?q=comment/1187#comment-1187