Upload first version of very, very incomplete docs

.gitignore

@@ -2,3 +2,5 @@
 *.suo
 */bin/
 */obj/
+
+Documentation/out/

Documentation/in/attrib/path/index.md

@@ -0,0 +1,21 @@
+<!-- attrib template: default -->
+<!-- attrib title: &#91;#path#] -->
+<!-- attrib code: yeah -->
+<div class="warning card">
+    <b>This is an Apricot special attribute.</b> It <em>cannot</em> be defined with <code>&lt;!-- attrib path: ... --></code>.
+</div>
+    The path to the current page from the site's root. Can be used for conditionals.
+
+**Example:**
+*[#path#] (this page)*
+<pre><code>&lt;title>&#91;path!=index.md][#title#] - [/path!=]AutoSite Documentation&lt;/title>
+...
+&#91;path=index.md]You are on the homepage.[/path=]
+&#91;path!=index.md]You are not on the homepage.[/path!=]</code></pre>
+**Output:**
+> **Page title:** [path!=index.md][#title#] - [/path!=]AutoSite Documentation
+>
+> [path=index.md]You are on the homepage.[/path=]
+> [path!=index.md]You are not on the homepage.[/path!=]
+
+Test

Documentation/in/attrib/root/index.md

@@ -0,0 +1,20 @@
+<!-- attrib template: default -->
+<!-- attrib title: &#91;#root#] -->
+<!-- attrib code: yeah -->
+<div class="warning card">
+    <b>This is an Apricot special attribute.</b> It <em>cannot</em> be defined with <code>&lt;!-- attrib root: ... --></code>. <code>&#91;#root#]</code> does not show in the Attribute Map.
+</div>
+    Relative path to the site's root. Used for linking to includes and other pages.
+
+**Example:**
+*[#path#] (this page)*
+<pre><code>&lt;img src="&#91;#root#]img/lynx.jpg" alt="Lynx lynx" height="350"&gt;
+  (or, in Markdown..)
+!&#91;Lynx lynx&#93;(&#91;#root#]img/lynx.jpg)</code></pre>
+*Output:*
+> ```
+> <img src="[#root#]img/lynx.jpg" alt="Lynx lynx" height="350">
+>   (or, in Markdown..)
+> ![Lynx lynx]([#root#]img/lynx.jpg)
+> ```
+> <img src="[#root#]img/lynx.jpg" alt="Lynx lynx" height="350">

Documentation/in/index.md

@@ -0,0 +1,19 @@
+<!-- attrib template: default -->
+<!-- attrib title: Help Topics -->
+<!--
+Notes:
+  - &#91; is [
+  - &#93; is ]
+
+<div class="card">
+  <h4>Important</h4>
+  <hr>
+  <p>AutoSite uses <code>default.html</code> as your default template.</p>
+</div>
+-->
+## Internal Attributes
+- <a href="[#root#]attrib/root/index.html"><code><span>&#91;</span>#root#]</code></a></li>
+- <a href="[#root#]attrib/path/index.html"><code><span>&#91;</span>#path#]</code></a></li>
+
+<!--## AutoSite
+ - <a href="[#root#]core/diy/index.html">How to roll your own AutoSite Core</a> -->

Documentation/includes/classless.css

@@ -0,0 +1,312 @@
+/* Classless.css v0.9
+
+Table of Contents:
+ 1. Base Tags
+ 2. Extra Tags
+ 3. Classes 
+*/
+
+/* 1. Base Tags 
+–––––––––––––––––––––––––––––––––––––––––––– */
+
+/* Reset: basic margins for block elements  */
+* {box-sizing: border-box; border-spacing: 0;}
+header, footer, figure ,table, video, blockquote,
+ul, ol, dl, fieldset, pre, pre > code { 
+    display: block; 
+    margin: 0.5rem 0rem 1rem;
+    width: 100%; 
+    overflow-x: auto;
+    overflow-y: hidden;
+}
+body { 
+    margin: auto; 
+    max-width: 50rem; 
+    padding: 2rem 0.5rem 0rem; 
+    overflow-x: hidden; 
+    background-color: #2F4147;
+    color: white;
+}
+footer { 
+    margin: 2rem 0rem 5rem; 
+    padding-top: 1rem;
+    border-top: #3C545C solid;
+    text-align: center;
+    opacity: 0.5;
+}
+
+
+/* text */
+:root { font: 13pt 'Open Sans', sans-serif; line-height: 1.5; color: #424456; }
+small, sub, sup { font-size: 75%; }
+
+
+/* headings */
+h1, h2, h3, h4, h5, h6 { 
+    margin: 1.5em 0 0em; 
+    padding: 0.3em 0; 
+}
+h1 { font-size: 2.5em; font-weight: 300; }  
+h2 { font-size: 2.0em; font-weight: 300; } 
+h3 { font-size: 1.5em; font-weight: 400; } 
+h4 { font-size: 1.1em; font-weight: 700; margin: .5em 0 0em; } 
+h5 { font-size: 1.2em; font-weight: 400; margin-top: 0.5em; color: #777; }
+h6 { font-size: 1.0em; font-weight: 700; }
+p strong { font-weight: bold; font-size: 1.0em; } /* original: color: #424456 */
+
+
+/* lists */
+li, dd { margin-bottom: 0.5rem; } 
+dt { font-weight: bold; }
+
+
+/* tables */
+td, th {
+  padding: 0.5rem 1.5rem;
+  text-align: right;
+  border-bottom: 0.1rem solid #d1d1d1;
+  white-space: nowrap;
+}
+td:first-child, th:first-child { padding-left:  0; text-align: left; }
+td:last-child,  th:last-child  { padding-right: 0; }
+tr:hover{ background-color: #f4f5f6; }
+
+
+/* figures */
+img { max-width: 100%; }
+figure { text-align: center; }
+figure > img { display: block; margin: 0.5em auto; }
+figcaption, caption { color: #777; margin-bottom: 1rem; }
+
+
+/*code*/
+pre > code {
+  margin: 0;
+  padding: 0.5rem 1.0rem;
+  border-left: 0.3rem solid #3273dc;
+  background-color: #333; /* Original: f4f5f6 */
+  border-radius: 5px;
+}
+code, kbd, samp { 
+    padding: 0.3em; background: #333; white-space: pre; font-size: 90%; border-radius: 5px;
+}
+
+
+/* links */
+a { color: #6FBBFF; text-decoration: none; cursor: pointer; }  /* original: 0065bd */
+a:hover, button:not([disabled]):hover { 
+    color: #00C5bd; 
+    border-color: #00C5bd; 
+}
+
+
+/* forms and inputs */
+textarea, input, button, select { border-radius: .3rem; border: .1rem solid #d1d1d1; padding: 0.3rem; outline: none;}
+button { padding: 0.7rem 1rem; cursor: pointer; font-weight: bold; letter-spacing: 0.1rem; color: #0065bd; background-color: #f4f5f6; border: .1rem solid #0065bd; }
+
+
+/* misc */
+blockquote{ border-left: 0.3rem solid #d1d1d1; padding: 1rem 1.5rem; }
+hr { border: 0; border-top: 0.1rem solid #d1d1d1; }
+
+
+
+
+/* 2. Extra Tags 
+–––––––––––––––––––––––––––––––––––––––––––––––––––––– */
+
+/* Extra: non-clashing headings */
+h1+h2, h2+h3, h3+h4, h4+h5, h5+h6 { 
+    margin-top: 0.5em; padding-top: 0; 
+}
+
+
+/* Extra: side menu */
+main aside { 
+    position: absolute; 
+    margin-left: 50.5rem; 
+    max-width: 10rem; 
+    font-size: smaller; 
+}
+@media (max-width: 73rem) { main aside { position: relative; margin: 1rem 0; } }
+
+
+/* Extra: navbar  */
+body nav { 
+    width: 100%; min-height: 3rem;
+    background-color: #2D7C9A;  /* Styled for AutoSite docs:
+                                   Original: #f4f5f6 */
+    border-bottom: solid 0.1rem #276C86; /* Original: d1d1d1 */
+}
+body > nav { position: fixed; top: 0; left: 0; }
+nav ul:first-child { 
+    list-style-type: none;
+    margin: auto; 
+    max-width: 50rem;
+    padding: 0 0.5rem;
+    overflow: visible;
+}
+nav ul:first-child > li { 
+    display: inline-block;
+    margin: 0;
+    padding: 0.8rem 1.0rem;
+    position: relative;
+    float: left; 
+}
+nav ul:first-child > li:first-child { padding-left: 0; }
+nav ul > li > ul { 
+    display: none; 
+    width: auto;
+    position: absolute;
+    padding: 1.0rem 2.5rem 0rem;
+    background-color: #f4f5f6;
+    z-index: 2;
+}
+nav ul > li > ul > li { white-space: nowrap; } 
+nav ul > li:hover > ul { display: block; }
+nav+main, nav+header { margin-top: 3rem; }
+/* AutoSite Documentation */
+nav ul > li > a { color: white; }
+
+
+/* Extra: forms and inputs advanced styling */
+fieldset { border-radius: 0rem; border: .1rem solid #d1d1d1; }
+textarea:focus, input:not([type=checkbox]):not([type=radio]):hover, select:hover{
+  border:.1rem solid #00C5bd;
+}
+textarea:focus, input:not([type=checkbox]):not([type=radio]):focus{
+    border:.1rem solid #3273dc;
+    box-shadow: 0 0 5px #3273dc;
+}
+button[disabled]{ color: #777; border-color: #d1d1d1; }
+
+
+/* misc */ 
+q:before { content: "\201C"; } q q:before { content: "\2018"; }
+q:after  { content: "\201D"; } q q:after  { content: "\2019"; }
+summary { font-weight: bold; cursor: pointer; margin: 0.5rem 0;}
+time{ color: #777; }
+mark{ background-color: transparent; color: #007c30; text-decoration: underline solid #007c30 }
+
+
+
+
+/* 3. Bootstrap Compatibile Classes
+–––––––––––––––––––––––––––––––––––––––––––––––––––––– */
+
+ /* grid */
+.row {
+    display: flex; 
+    margin: 0 -0.5rem;
+    align-items: stretch;
+}
+.row [class*="col"] { padding: 0 0.5rem; }
+.row .col   { flex: 1 1 100%; }
+.row .col-2 { flex: 0 0 16.66%; }
+.row .col-3 { flex: 0 0 25%; }
+.row .col-4 { flex: 0 0 33.33%; }
+.row .col-6 { flex: 0 0 50%; }
+
+
+ /* cards */
+ .card {
+    display: block;
+    margin: .5rem 0;
+    padding: .5rem 1rem 0.5rem; 
+    border-radius: .3rem; 
+    box-shadow: .1rem .1rem .4rem 0 #26240C; /* Original: 777 */  
+}
+
+
+/* align */
+.align-top      { vertical-align: top; }
+.align-middle   { vertical-align: middle; }
+.align-bottom   { vertical-align: bottom; }
+.align-baseline { vertical-align: baseline; }
+
+.text-left   { text-align: left; }
+.text-right  { text-align: right; }
+.text-center { text-align: center; }
+
+.float-left  { float: left !important; }
+.float-right { float: right !important; }
+.clearfix    {  }
+
+
+/* colors */
+.text-black    { color: #000; }
+.text-white    { color: #fff; }
+.text-primary  { color: #0065bd; }
+.text-secondary{ color: #333; }
+
+.bg-white    { background-color: #fff; }
+.bg-light    { background-color: #f4f5f6; }
+.bg-primary  { background-color: #0065bd; }
+.bg-secondary{ background-color: #d1d1d1; }
+
+
+/* spacing */
+.w-25  { width: 25.00% !important; }
+.w-33  { width: 33.33% !important; }
+.w-50  { width: 50.00% !important; }
+.w-75  { width: 75.00% !important; }
+.w-100 { width: 100.0% !important; }
+
+
+/* margins */
+.mx-auto { margin-left: auto; margin-right: auto; }
+
+.m-0, .mx-0, .mr-0 { margin-right:  0.0rem !important; }
+.m-0, .mx-0, .ml-0 { margin-left:   0.0rem !important; }
+.m-0, .my-0, .mt-0 { margin-top:    0.0rem !important; }
+.m-0, .my-0, .mb-0 { margin-bottom: 0.0rem !important; }
+
+.m-05, .mx-05, .mr-05 { margin-right:  0.5rem !important; }
+.m-05, .mx-05, .ml-05 { margin-left:   0.5rem !important; }
+.m-05, .my-05, .mt-05 { margin-top:    0.5rem !important; }
+.m-05, .my-05, .mb-05 { margin-bottom: 0.5rem !important; }
+
+.m-1, .mx-1, .mr-1 { margin-right:  1.0rem !important; }
+.m-1, .mx-1, .ml-1 { margin-left:   1.0rem !important; }
+.m-1, .my-1, .mt-1 { margin-top:    1.0rem !important; }
+.m-1, .my-1, .mb-1 { margin-bottom: 1.0rem !important; }
+
+.m-2, .mx-2, .mr-2 { margin-right:  2.0rem !important; }
+.m-2, .mx-2, .ml-2 { margin-left:   2.0rem !important; }
+.m-2, .my-2, .mt-2 { margin-top:    2.0rem !important; }
+.m-2, .my-2, .mb-2 { margin-bottom: 2.0rem !important; }
+
+
+/* padding */
+.p-0, .px-0, .pr-0 { padding-right:  0.0rem !important; }
+.p-0, .px-0, .pl-0 { padding-left:   0.0rem !important; }
+.p-0, .py-0, .pt-0 { padding-top:    0.0rem !important; }
+.p-0, .py-0, .pb-0 { padding-bottom: 0.0rem !important; }
+
+.p-05, .px-05, .pr-05 { padding-right:  0.5rem !important; }
+.p-05, .px-05, .pl-05 { padding-left:   0.5rem !important; }
+.p-05, .py-05, .pt-05 { padding-top:    0.5rem !important; }
+.p-05, .py-05, .pb-05 { padding-bottom: 0.5rem !important; }
+
+.p-1, .px-1, .pr-1 { padding-right:  1.0rem !important; }
+.p-1, .px-1, .pl-1 { padding-left:   1.0rem !important; }
+.p-1, .py-1, .pt-1 { padding-top:    1.0rem !important; }
+.p-1, .py-1, .pb-1 { padding-bottom: 1.0rem !important; }
+
+.p-2, .px-2, .pr-2 { padding-right:  2.0rem !important; }
+.p-2, .px-2, .pl-2 { padding-left:   2.0rem !important; }
+.p-2, .py-2, .pt-2 { padding-top:    2.0rem !important; }
+.p-2, .py-2, .pb-2 { padding-bottom: 2.0rem !important; }
+
+
+/* responsive, smaller than */
+@media (max-width: 40em) { 
+    .row { flex-direction: column !important; }
+    nav ul:first-child > li:first-child:after { content: "\25BE"; padding-left: .5rem; } 
+    nav ul:first-child > li:not(:first-child) { display: none; }
+    nav ul:first-child:hover > li { display: block; float: none !important;}
+}
+@media (min-width: 40em) {
+    [class*="col"] > * { margin-top: 1rem; !important; }
+}
+@media (max-width: 61rem) { aside {position: relative; margin: 0.5rem 0; } }