Site/docs updates.
h3rald h3rald@h3rald.com
Mon, 20 Apr 2020 22:19:53 +0200
6 files changed,
60 insertions(+),
11 deletions(-)
M
docs/H3_DeveloperGuide.htm
→
docs/H3_DeveloperGuide.htm
@@ -7296,6 +7296,7 @@ </li>
<li><a href="#About">About</a> <ul> <li><a href="#Why-the-name?">Why the name?</a></li> + <li><a href="#Why-the-weird-release-labels?">Why the weird release labels?</a></li> <li><a href="#A-brief-history-of-H3">A brief history of H3</a></li> <li><a href="#Credits">Credits</a></li> </ul>@@ -7599,10 +7600,14 @@ : h3("div.spinner-container", h3("span.spinner"));
return h3("div.page", [ h3("header.row.sticky", [ h3( - "a.logo.col-sm", + "a.logo.col-sm-1", { href: "#/" }, - h3("img", { alt: "H3", src: "images/h3.svg" }) + [h3("img", { alt: "H3", src: "images/h3.svg" })] ), + h3("div.version.col-sm.col-md", [ + h3("div.version-number", "v0.1.0"), + h3("div.version-label", "“Audacious Andorian“"), + ]), h3("label.drawer-toggle.button.col-sm-last", { for: "drawer-control" }), ]), h3("div.row", [@@ -7787,6 +7792,7 @@
<ul> <li>Any attribute starting with <em>on</em> (e.g. onclick, onkeydown, etc.) will be treated as an event listener.</li> <li>The <code>classList</code> attribute can be set to a list of classes to apply to the element (as an alternative to using the element selector shorthand).</li> +<li>The <code>data</code> attribute can be set to a simple object containing <a href="https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes">data attributes</a>.</li> <li>The special <code>$key</code> attribute can be used to guarantee the uniqueness of two VNodes and it will not be translated into an HTML attribute.</li> <li>The special <code>$html</code> attribute can be used to set the <code>innerHTML</code> property of the resulting HTML element. Use only if you know what you are doing!</li> </ul>@@ -7901,6 +7907,11 @@ <h3>Why the name?<a href="#document-top" title="Go to top"></a></h3>
<p>Well, because I typically use <a href="https://h3rald.com">H3RALD</a> as my handle online… <strong>h</strong> was already used by <a href="https://github.com/hyperhype/hyperscript">HyperScript</a> so… <strong>h3</strong> was the next best thing to use as a constructor for Virtual DOM Nodes.</p> +<a name="Why-the-weird-release-labels?"></a> +<h3>Why the weird release labels?<a href="#document-top" title="Go to top"></a></h3> + +<p>Ubuntu started <a href="https://wiki.ubuntu.com/DevelopmentCodeNames">naming their releases after animals</a> in alphabetical order… In a similar way, H3 releases are named after <a href="https://en.wikipedia.org/wiki/List_of_Star_Trek_races">Star Trek races</a>.</p> + <a name="A-brief-history-of-H3"></a> <h3>A brief history of H3<a href="#document-top" title="Go to top"></a></h3>@@ -7921,7 +7932,7 @@
<a name="Credits"></a> <h3>Credits<a href="#document-top" title="Go to top"></a></h3> -<p>This site is <a href="https://github.com/h3rald/h3/blob/master/docs/js/app.js">built with H3 itself</a>, plus the following third-party libraries:</p> +<p>The H3 web site is <a href="https://github.com/h3rald/h3/blob/master/docs/js/app.js">built with H3 itself</a>, plus the following third-party libraries:</p> <ul> <li><a href="https://marked.js.org/#/README.md#README.md">marked.js</a></li>
M
docs/css/style.css
→
docs/css/style.css
@@ -5,7 +5,6 @@ }
#navigation { border: none; - border-left: 1px solid #ccc; } [type="checkbox"].drawer:checked + * {@@ -48,12 +47,21 @@ position: sticky;
top: 60px; } } +@media screen and (max-width: 767px) { + #navigation { + border-left: 1px solid #ccc; + } +} .content { margin-left: 30px; } -h2, h3, h4, h5, h6 { +h2, +h3, +h4, +h5, +h6 { margin-left: -30px; }@@ -61,4 +69,21 @@ .logo img {
width: 3em; height: 3em; margin-top: -5px; -}+} + +.drawer-toggle:before { + font-size: 2.5em; +} + +.version { + padding: 6px; +} + +.version-number { + font-size: 0.8em; + font-weight: bold; +} +.version-label { + font-size: 0.8em; + font-style: italic; +}
M
docs/js/app.js
→
docs/js/app.js
@@ -36,10 +36,14 @@ : h3("div.spinner-container", h3("span.spinner"));
return h3("div.page", [ h3("header.row.sticky", [ h3( - "a.logo.col-sm", + "a.logo.col-sm-1", { href: "#/" }, - h3("img", { alt: "H3", src: "images/h3.svg" }) + [h3("img", { alt: "H3", src: "images/h3.svg" })] ), + h3("div.version.col-sm.col-md", [ + h3("div.version-number", "v0.1.0"), + h3("div.version-label", "“Audacious Andorian“"), + ]), h3("label.drawer-toggle.button.col-sm-last", { for: "drawer-control" }), ]), h3("div.row", [
M
docs/md/about.md
→
docs/md/about.md
@@ -6,6 +6,10 @@ ### Why the name?
Well, because I typically use [H3RALD](https://h3rald.com) as my handle online... **h** was already used by [HyperScript](https://github.com/hyperhype/hyperscript) so... **h3** was the next best thing to use as a constructor for Virtual DOM Nodes. +### Why the weird release labels? + +Ubuntu started [naming their releases after animals](https://wiki.ubuntu.com/DevelopmentCodeNames) in alphabetical order... In a similar way, H3 releases are named after [Star Trek races](https://en.wikipedia.org/wiki/List_of_Star_Trek_races). + ### A brief history of H3 A while ago, I was interviewing with several companies trying to find a new job in the JavaScript ecosystem. One of these companies asked me, as a part of their interview process, to create a simple Todo List app in JavaScript *without using any libraries*.@@ -24,7 +28,7 @@ A few months after that interview, I decided to take a look at that code, tidy it up, add a few bits and bobs, package it up and release it as a *proper* microframwork. Well, kind of.
### Credits -This site is [built with H3 itself](https://github.com/h3rald/h3/blob/master/docs/js/app.js), plus the following third-party libraries: +The H3 web site is [built with H3 itself](https://github.com/h3rald/h3/blob/master/docs/js/app.js), plus the following third-party libraries: * [marked.js](https://marked.js.org/#/README.md#README.md) * [Prism.js](https://prismjs.com/)
M
docs/md/api.md
→
docs/md/api.md
@@ -111,6 +111,7 @@ #### Special attributes
* Any attribute starting with *on* (e.g. onclick, onkeydown, etc.) will be treated as an event listener. * The `classList` attribute can be set to a list of classes to apply to the element (as an alternative to using the element selector shorthand). +* The `data` attribute can be set to a simple object containing [data attributes](https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes). * The special `$key` attribute can be used to guarantee the uniqueness of two VNodes and it will not be translated into an HTML attribute. * The special `$html` attribute can be used to set the `innerHTML` property of the resulting HTML element. Use only if you know what you are doing!
M
docs/md/usage.md
→
docs/md/usage.md
@@ -104,10 +104,14 @@ : h3("div.spinner-container", h3("span.spinner"));
return h3("div.page", [ h3("header.row.sticky", [ h3( - "a.logo.col-sm", + "a.logo.col-sm-1", { href: "#/" }, - h3("img", { alt: "H3", src: "images/h3.svg" }) + [h3("img", { alt: "H3", src: "images/h3.svg" })] ), + h3("div.version.col-sm.col-md", [ + h3("div.version-number", "v0.1.0"), + h3("div.version-label", "“Audacious Andorian“"), + ]), h3("label.drawer-toggle.button.col-sm-last", { for: "drawer-control" }), ]), h3("div.row", [