Released new versions of HastyScribe, HastySite, and min.
h3rald h3rald@h3rald.com
Sun, 19 Nov 2017 18:47:58 +0100
5 files changed,
121 insertions(+),
41 deletions(-)
M
assets/hastyscribe/HastyScribe_UserGuide.htm
→
assets/hastyscribe/HastyScribe_UserGuide.htm
@@ -3262,9 +3262,9 @@ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.8);
color: #eee; background-color: #222; border: 1px solid #ccc; - white-space: pre-wrap; padding: 0 3px; border: 2px solid #999; + white-space: pre-wrap; border-top: 10px solid #999; } .terminal a {@@ -3285,13 +3285,17 @@ }
} .terminal p, .terminal p:first-child { - margin-top: 0; + margin-top: -40px; margin-bottom: 0; text-shadow: none; font-weight: normal; font-family: "Source Code Pro", "Monaco", "DejaVu Sans Mono", "Courier New", monospace; font-size: 85%; color: #eee; +} +.terminal p:first-child, +.terminal p:first-child:first-child { + margin-top: 0px; } .terminal p:before, .terminal p:first-child:before {@@ -3315,9 +3319,9 @@ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.8);
color: #eee; background-color: #222; border: 1px solid #ccc; - white-space: pre-wrap; padding: 0 3px; border: 2px solid #999; + white-space: pre-wrap; border-top: 10px solid #999; } .terminal-su a {@@ -3338,13 +3342,17 @@ }
} .terminal-su p, .terminal-su p:first-child { - margin-top: 0; + margin-top: -40px; margin-bottom: 0; text-shadow: none; font-weight: normal; font-family: "Source Code Pro", "Monaco", "DejaVu Sans Mono", "Courier New", monospace; font-size: 85%; color: #eee; +} +.terminal-su p:first-child, +.terminal-su p:first-child:first-child { + margin-top: 0px; } .terminal-su p:before, .terminal-su p:first-child:before {@@ -4561,11 +4569,11 @@
<p>The easiest way to get HastyScribe is by downloading one of the prebuilt binaries from the <a href="https://github.com/h3rald/hastyscribe/releases/download/v">Github Release Page</a>:</p> <ul> -<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.0/hastyscribe_v1.7.0_macosx_x64.zip">HastyScribe for Mac OS X (x64)</a> – Compiled on Mac OS X Sierra (LLVM CLANG 8.0.0)</li> -<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.0/hastyscribe_v1.7.0_windows_x64.zip">HastyScribe for Windows (x64)</a> – Cross-compiled on Mac OS X Sierra (MinGW-w64 GCC 4.8.2)</li> -<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.0/hastyscribe_v1.7.0_linux_x64.zip">HastyScribe for Linux (x64)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.1)</li> -<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.0/hastyscribe_v1.7.0_linux_x86.zip">HastyScribe for Linux (x86)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.1)</li> -<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.0/hastyscribe_v1.7.0_linux_arm.zip">HastyScribe for Linux (ARM)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.2)</li> +<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.1/hastyscribe_v1.7.1_macosx_x64.zip">HastyScribe for Mac OS X (x64)</a> – Compiled on Mac OS X Sierra (LLVM CLANG 8.0.0)</li> +<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.1/hastyscribe_v1.7.1_windows_x64.zip">HastyScribe for Windows (x64)</a> – Cross-compiled on Mac OS X Sierra (MinGW-w64 GCC 4.8.2)</li> +<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.1/hastyscribe_v1.7.1_linux_x64.zip">HastyScribe for Linux (x64)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.1)</li> +<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.1/hastyscribe_v1.7.1_linux_x86.zip">HastyScribe for Linux (x86)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.1)</li> +<li><a href="https://github.com/h3rald/hastyscribe/releases/download/v1.7.1/hastyscribe_v1.7.1_linux_arm.zip">HastyScribe for Linux (ARM)</a> – Cross-compiled on Mac OS X Sierra (GNU GCC 4.8.2)</li> </ul>@@ -4722,59 +4730,59 @@ </thead>
<tbody> <tr> <td><code>{{$timestamp}}</code> </td> -<td> 1509301438</td> +<td> 1511037877</td> </tr> <tr> <td><code>{{$date}}</code> </td> -<td> 2017-10-29</td> +<td> 2017-11-18</td> </tr> <tr> <td><code>{{$full-date}}</code> </td> -<td> Sunday, October 29, 2017</td> +<td> Saturday, November 18, 2017</td> </tr> <tr> <td><code>{{$long-date}}</code> </td> -<td> October 29, 2017</td> +<td> November 18, 2017</td> </tr> <tr> <td><code>{{$medium-date}}</code> </td> -<td> Oct 29, 2017</td> +<td> Nov 18, 2017</td> </tr> <tr> <td><code>{{$short-date}}</code> </td> -<td> 10/29/17</td> +<td> 11/18/17</td> </tr> <tr> <td><code>{{$short-time}}</code> </td> -<td> 19:23 PM</td> +<td> 21:44 PM</td> </tr> <tr> <td><code>{{$short-time-24}}</code> </td> -<td> 19:23</td> +<td> 21:44</td> </tr> <tr> <td><code>{{$time}}</code> </td> -<td> 19:23:58 PM</td> +<td> 21:44:37 PM</td> </tr> <tr> <td><code>{{$time-24}}</code> </td> -<td> 19:23:58</td> +<td> 21:44:37</td> </tr> <tr> <td><code>{{$day}}</code> </td> -<td> 29</td> +<td> 18</td> </tr> <tr> <td><code>{{$short-day}}</code> </td> -<td> 29</td> +<td> 18</td> </tr> <tr> <td><code>{{$month}}</code> </td> -<td> 10</td> +<td> 11</td> </tr> <tr> <td><code>{{$short-month}}</code> </td> -<td> 10</td> +<td> 11</td> </tr> <tr> <td><code>{{$year}}</code> </td>@@ -4786,19 +4794,19 @@ <td> 17</td>
</tr> <tr> <td><code>{{$weekday}}</code> </td> -<td> Sunday</td> +<td> Saturday</td> </tr> <tr> <td><code>{{$weekday-abbr}}</code> </td> -<td> 29</td> +<td> 18</td> </tr> <tr> <td><code>{{$month-name}}</code> </td> -<td> October</td> +<td> November</td> </tr> <tr> <td><code>{{$month-name-abbr}}</code> </td> -<td> Oct</td> +<td> Nov</td> </tr> <tr> <td><code>{{$timezone-offset}}</code> </td>@@ -5803,7 +5811,7 @@
<p style="text-align:center;"> <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFgAAAAfCAYAAABjyArgAAAGa0lEQVRo3u1aW08bRxTmuSqIV0SlIFWtAKkVtEpfWiVI6Q+gT60qpeIhTXkrSpqoaZ1AkJMobSRkkUahEtAWCVWBYMDcfME22MZ3rw0hrzzwAxC/4FTfrGeYXXa9u8Y0yGGkEeu5nGW+OfOdy2wDETU1NDTQea19JcKf8o/lwBKthlbIH16j0EaQwrEwbSSiFEvFaCuToFQuSel8mrKFDOWULOWKObUqWcoqGcrk02wMxsZTMTY3EgszWf6wn8nGO3xri7SwOk/zy16aW3pJL32zrM4uztDMwou6qRLQR+AGIn5a3wxRNB6hWHKTgZXOpxiAhVKeijsKlV4VaXt3m3ZeqxXPpVcl1ocxWSXL5mAuZEQTESYTsvUge5fnBMgAuE5BbtCCm4gyDUxmk0xbARpAdT9w05Uvr1BjU+Oxo4A29LkfutnYwnaBbQo0Op6OM21e31zXgLy4tkDzK14VZN8RyHdcd6ijo+PYO9CGPruLOwtyBMCgBRlcAJMrZplWekY91Nraapt3MNbz1MPmgkKgzQkBckjQxZLfR4urKsjQ4j/GnlJ7R7uQ09PTQwMDA6zimbdjzOjzUdNFoe+syBEAgydBC0fg5pgm9n7VqwGvubmZ+vr6aGhoiCKRCKt4Rhv65LGYG0/GKF9SQYYmgy5UTl6jleCyoIp/pv+mpqYmdV5vL+3t7ZG+oA19GIOxRouanJo4U3IEwDBo4EvQAjRXDy7AA5AHBwdUqUxOTmqAxu4CZGwYNg7vgOELRgO0tr6qUsXqgjiC2Ci5SNZY8w4uW78grnF6OZ6REfr2629OLMdszWZyBMA4vjBK4FwcbRncrq4uwx00K9gEzJE1GTLByXjHEVWoWnx30CU05fXuriXAKFxzZA7EM9o+6e6mP5+PacBtaWmhxncb6fbNn2h/f9+WHKP/x6wYydEAHGPUkGIGDZwrg2ultXZABifD8DGqSMUoEle1GFzc0alqr5NNxFhuaPhi+Clo/+BDev9CG13+/Avq//46a8Ppe/TwEXuenZmxJeek/48GYKa9SoZRAzdoOOqKolC1BSBzuoBMyIYLx7U4tKFqMTcg+oLjyTfI6KhyQyMvBm23btykn2/dZiDzyjXXSCPN5MhFliXXSnI0AIMf86U8c8X4orDrJy2cn1DhwuGEcC4Ol9029MEy64tBVKQpmKMHRpaTSiYZsLIM/NaDbCUHpf+HfsNaSY4GYERoyo7CfFmuvTI1wFsAz2CXUGXw9X0jIyOaF3MthmxwMSI+mSZOC2BeoLkAtvujj4XmweAF/H5HcqxKRYBh3HCEeRAhH0kAaOTvAkyv12vYJ8/nRx2yEfGBihJlly0YDdacIuRyeHhIE+Pj7Bmaqz/i4On/hSKQT9jeLYkFyVrIjVVbWxsjcwCOZxx/3sc9DQDO+4xoAmF1TsPDQers7DQ1Kmbaa9c4QVMBBLQXldMEDN29X110ofU9W3KuX7tmWG0bOfi+yCvwBQFE/SKNONkOX8snAO+AT7yV2RIAD96/J9wiuwBbuVcyPbjvDws3DS4btNqpnBO7aW8SYAQc3FWzE2hwrnMSIDz57fdjgUY1cipxb8VAwy5FwPDBdcMzQJUpQt9nlyIA8PSL6foOlSsZuUqGzI6R4zusGrkie5ds5ADwUsBHU/9OabJW2DTIwXw5aLFK0gAcOUnzJuUcc9N4iAzXSn/Mzdw0gMzb9X0o0GjZTUtLblogEhCZNZYfXpqjX+7WYbqSBxpymKz3Z2sZaGyWAw2kLnlWjact6+l2QwCcSBuHyk7i8WpDZTn5XrcAy8meib/Ga5/sGfUw2Uj24F08ZSkn3vnNRj1dHQmAUV2DLpGuvPrdVQ3ITpI+0HrDdGUhQ8MPht/G2+WjHwM3fmRuVLGKhDv6MEZOuF/87CKjBvjZrnLe960GGBUJcAQDAFnW5GqujABuvpijZ2PP7H5HYBhk6MfYkWP22yyZ5EROpaSUJcACZEW99AQnO770HOWXnlnb4BoBYbQwJxtVab7djaqBHOMO0IV8bQ/QrK7tcXPBru3xfUQh45gWrNKVTjfK7G8t5VQNMLvf+rSbvIte5sLBT1bEhycl6cOTEmuTPzyZ93np0uVL1XxqdCJqsKKEajS4BnKs/2GA9fjJYwpFQ9KnU+WKT6cKGdaHMdUAe1oafGY5+LzWsBLRO+dAnN7Xlf8BOGLNYHeHmZwAAAAASUVORK5CYII=" alt="Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 Unported License" /></p> </div> <div id="footer"> - <p><span class="copy"></span> Fabio Cevasco – October 29, 2017</p> + <p><span class="copy"></span> Fabio Cevasco – November 18, 2017</p> <p><span>Powered by</span> <a href="https://h3rald.com/hastyscribe"><span class="hastyscribe"></span></a></p> </div> </div>
M
assets/hastysite/HastySite_UserGuide.htm
→
assets/hastysite/HastySite_UserGuide.htm
@@ -3262,9 +3262,9 @@ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.8);
color: #eee; background-color: #222; border: 1px solid #ccc; - white-space: pre-wrap; padding: 0 3px; border: 2px solid #999; + white-space: pre-wrap; border-top: 10px solid #999; } .terminal a {@@ -3285,13 +3285,17 @@ }
} .terminal p, .terminal p:first-child { - margin-top: 0; + margin-top: -40px; margin-bottom: 0; text-shadow: none; font-weight: normal; font-family: "Source Code Pro", "Monaco", "DejaVu Sans Mono", "Courier New", monospace; font-size: 85%; color: #eee; +} +.terminal p:first-child, +.terminal p:first-child:first-child { + margin-top: 0px; } .terminal p:before, .terminal p:first-child:before {@@ -3315,9 +3319,9 @@ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.8);
color: #eee; background-color: #222; border: 1px solid #ccc; - white-space: pre-wrap; padding: 0 3px; border: 2px solid #999; + white-space: pre-wrap; border-top: 10px solid #999; } .terminal-su a {@@ -3338,13 +3342,17 @@ }
} .terminal-su p, .terminal-su p:first-child { - margin-top: 0; + margin-top: -40px; margin-bottom: 0; text-shadow: none; font-weight: normal; font-family: "Source Code Pro", "Monaco", "DejaVu Sans Mono", "Courier New", monospace; font-size: 85%; color: #eee; +} +.terminal-su p:first-child, +.terminal-su p:first-child:first-child { + margin-top: 0px; } .terminal-su p:before, .terminal-su p:first-child:before {@@ -4516,11 +4524,11 @@
<p>You can download one of the following pre-built HastySite binaries:</p> <div class="unstyled"><ul> -<li><span class="apple"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.0/hastysite_v1.0.0_macosx_x64.zip">hastysite v1.0.0 for macOS (x64)</a></li> -<li><span class="windows"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.0/hastysite_v1.0.0_windows_x64.zip">hastysite v1.0.0 for Windows (x64)</a></li> -<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.0/hastysite_v1.0.0_linux_x64.zip">hastysite v1.0.0 for Linux (x64)</a></li> -<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.0/hastysite_v1.0.0_linux_x86.zip">hastysite v1.0.0 for Linux (x86)</a></li> -<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.0/hastysite_v1.0.0_linux_arm.zip">hastysite v1.0.0 for Linux (arm)</a></li> +<li><span class="apple"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.1/hastysite_v1.0.1_macosx_x64.zip">hastysite v1.0.1 for macOS (x64)</a></li> +<li><span class="windows"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.1/hastysite_v1.0.1_windows_x64.zip">hastysite v1.0.1 for Windows (x64)</a></li> +<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.1/hastysite_v1.0.1_linux_x64.zip">hastysite v1.0.1 for Linux (x64)</a></li> +<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.1/hastysite_v1.0.1_linux_x86.zip">hastysite v1.0.1 for Linux (x86)</a></li> +<li><span class="linux"></span><a href="https://github.com/h3rald/hastysite/releases/download/v1.0.1/hastysite_v1.0.1_linux_arm.zip">hastysite v1.0.1 for Linux (arm)</a></li> </ul> </div>@@ -4556,6 +4564,28 @@ <div class="terminal"><p>hastysite init</p></div>
<p>This will create the following default directory structure:</p> +<ul> +<li>assets/ — <em>Your site assets</em> + +<ul> +<li>fonts/</li> +<li>styles/</li> +</ul> +</li> +<li>contents/ — <em>Your site contents.</em></li> +<li>output/ — <em>Your static web site.</em></li> +<li>rules.min — <em>Rules to process your contents and assets.</em></li> +<li>scripts/ — <em>Scripts to manage your site.</em></li> +<li>settings.json — <em>Your site configuration.</em></li> +<li>temp/ — <em>Temporary files and folders will be placed here.</em></li> +<li>templates/ — <em>Mustache templates.</em></li> +</ul> + + +<div class="tip"><p>Tip</p> + +<p>Default folder paths can be configured in your <span class="file">settings.json</span> file.</p></div> + <p>Then, create your first page by running the following command and specifying the page ID and Title:</p> <div class="terminal"><p>hastysite page@@ -4614,6 +4644,16 @@ <p>Builds the site by preprocessing contents and assets, processing rules defined in the <span class="file">rules.min</span> file, and creating a temporary file containing the checksums of all newly-generated files. By doing so, the next time this command is executed, only the files that have actually been modified will be copied to the <span class="dir">output</span> directory.</p>
<p>The <span class="file">rules.min</span> file processed by this command:</p> +<ul> +<li>Ignores contents and assets starting with <span class="kwd">.</span> or <span class="kwd">_</span>.</li> +<li>Pre-processes <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables">CSS variables</a> in all <span class="ext">.css</span> files.</li> +<li>Processes text as <a href="https://h3rald.com/hastysite">HastyScribe</a>-compatible Markdown in all <span class="ext">.md</span> content files.</li> +<li>Associates contents to <a href="https://mustache.github.io/">mustache</a> templates based on the value of the <span class="kwd">content-type</span> metadata property.</li> +<li>Copies each asset file “as-is” to the <span class="dir">output</span> directory, respecting the source directory structure in the <span class="dir">asset</span> directory.</li> +<li>Copies each content file to a directory within the <span class="dir">output</span> named after the source content ID, in an <span class="file">index.html</span> file (to easily obtain “pretty URLs” ending with no extension).</li> +</ul> + + <div class="note"><p>Note</p> <p>This command can be customized by modifying the <span class="file">scripts/build.min</span> file within your site directory.</p></div>@@ -4631,6 +4671,28 @@ <a name="init"></a>
<h4>init<a href="#document-top" title="Go to top"></a></h4> <p>Initializes a new HastySite site directory, by creating the following directory structure:</p> + +<ul> +<li>assets/ — <em>Your site assets</em> + +<ul> +<li>fonts/</li> +<li>styles/</li> +</ul> +</li> +<li>contents/ — <em>Your site contents.</em></li> +<li>output/ — <em>Your static web site.</em></li> +<li>rules.min — <em>Rules to process your contents and assets.</em></li> +<li>scripts/ — <em>Scripts to manage your site.</em></li> +<li>settings.json — <em>Your site configuration.</em></li> +<li>temp/ — <em>Temporary files and folders will be placed here.</em></li> +<li>templates/ — <em>Mustache templates.</em></li> +</ul> + + +<div class="tip"><p>Tip</p> + +<p>Default folder paths can be configured in your <span class="file">settings.json</span> file.</p></div> <a name="page"></a> <h4>page<a href="#document-top" title="Go to top"></a></h4>@@ -4794,6 +4856,16 @@
<p>In this phase, the control of the build process is passed to the <span class="file">rules.min</span> script. It is important to point out that in case of an empty <span class="file">rules.min</span> file, <em>nothing</em> will be done and no output file will be generated.</p> <p>Luckily, a default <span class="file">rules.min</span> file is provided, which:</p> + +<ul> +<li>Ignores contents and assets starting with <span class="kwd">.</span> or <span class="kwd">_</span>.</li> +<li>Pre-processes <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables">CSS variables</a> in all <span class="ext">.css</span> files.</li> +<li>Processes text as <a href="https://h3rald.com/hastysite">HastyScribe</a>-compatible Markdown in all <span class="ext">.md</span> content files.</li> +<li>Associates contents to <a href="https://mustache.github.io/">mustache</a> templates based on the value of the <span class="kwd">content-type</span> metadata property.</li> +<li>Copies each asset file “as-is” to the <span class="dir">output</span> directory, respecting the source directory structure in the <span class="dir">asset</span> directory.</li> +<li>Copies each content file to a directory within the <span class="dir">output</span> named after the source content ID, in an <span class="file">index.html</span> file (to easily obtain “pretty URLs” ending with no extension).</li> +</ul> + <p>Typically, you only need to modify this file to change how HastySite builds your site.</p>@@ -5145,7 +5217,7 @@
<p>The contents of the site are also available in a standalone HTML document, <a href="https://h3rald.com/hastysite/HastySitee_UserGuide.htm">here</a>.</p> </div> <div id="footer"> - <p><span class="copy"></span> Fabio Cevasco – November 12, 2017</p> + <p><span class="copy"></span> Fabio Cevasco – November 19, 2017</p> <p><span>Powered by</span> <a href="https://h3rald.com/hastyscribe"><span class="hastyscribe"></span></a></p> </div> </div>
M
contents/hastyscribe.md
→
contents/hastyscribe.md
@@ -7,7 +7,7 @@ active: true
home: /hastyscribe/ docs: /hastyscribe/HastyScribe_UserGuide.htm summary: "A self-contained Markdown compiler that can generate self-contained HTML files, useful for writing essays, reports, meeting notes, etc." -version: "1.7.0" +version: "1.7.1" download: "https://github.com/h3rald/hastyscribe/releases/download/" ----- {{download => https://github.com/h3rald/hastyscribe/releases/download/}}
M
contents/hastysite.md
→
contents/hastysite.md
@@ -8,7 +8,7 @@ subtitle: "A small but powerful static site generator"
summary: "A self-contained static site generator featuring markdown support, mustache templates, and a powerful min-powered rule and script engine." content-type: project active: true -version: 1.0.0 +version: 1.0.1 download: "https://github.com/h3rald/hastysite/releases/download/" -----
M
contents/min.md
→
contents/min.md
@@ -8,7 +8,7 @@ summary: "A functional, concatenative programming language with a minimalist syntax, a small but practical standard library, and an advanced REPL. All packed in about 1MB."
content-type: project active: true download: "https://github.com/h3rald/min/releases/download/" -version: 0.12.0 +version: 0.13.0 docs: "https://cdn.rawgit.com/h3rald/min/v0.12.0/Min_DeveloperGuide.htm" -----