updated docs

css/theme_colors.css

@@ -181,7 +181,7 @@ mark {
 	color: #2980B9;
 }
 
-.menu-vertical ul.currentrelative, .menu-vertical ul.currentrelativeroot {
+.menu-vertical ul.currentrelative {
 	background-color: #e3e3e3;
 }
 

docnetjson.htm

@@ -62,6 +62,8 @@
 
 <li class="tocentry"><a href="#footer">Footer</a></li>
 
+<li class="tocentry"><a href="#startingpagename">StartingPageName</a></li>
+
 <li class="tocentry"><a href="#pages">Pages</a></li>
 
 <li class="tocentry"><a href="#levels-without-index-defined">Levels without __index defined</a></li>
@@ -122,17 +124,18 @@
     &quot;Theme&quot; : &quot;themefolder&quot;,
     &quot;SourceFoldersToCopy&quot; : [&quot;folder1&quot;, &quot;foldern&quot;],
     &quot;Footer&quot; : &quot;footer text or HTML&quot;,
-    &quot;ConvertLocalLinks: &quot;true&quot; | &quot;false&quot;,
-    &quot;PathSpecification&quot;: &quot;Full&quot; | &quot;Relative&quot; | &quot;RelativeAsFolder&quot;,
-    &quot;UrlFormatting&quot;: &quot;None&quot; | &quot;Strip&quot; | &quot;Dashes&quot;,
-    &quot;MaxLevelInToC&quot;: &quot;3&quot;,
-    &quot;StripIndexHtm&quot;: &quot;true&quot; | &quot;false&quot;,
+    &quot;StartingPageName&quot; : &quot;Home&quot;,
+    &quot;ConvertLocalLinks&quot; : &quot;true&quot; | &quot;false&quot;,
+    &quot;PathSpecification&quot; : &quot;Full&quot; | &quot;Relative&quot; | &quot;RelativeAsFolder&quot;,
+    &quot;UrlFormatting&quot; : &quot;None&quot; | &quot;Strip&quot; | &quot;Dashes&quot;,
+    &quot;MaxLevelInToC&quot; : &quot;3&quot;,
+    &quot;StripIndexHtm&quot; : &quot;true&quot; | &quot;false&quot;,
     &quot;Pages&quot; : 
     {
         &quot;__index&quot; : &quot;index.md&quot;,
-        &quot;Title Page 1&quot;: &quot;filename_page1.md&quot;, 
-        &quot;Title Page 2&quot;: &quot;filename_page2.md&quot;,
-        &quot;Sub Header 1&quot;: 
+        &quot;Title Page 1&quot; : &quot;filename_page1.md&quot;, 
+        &quot;Title Page 2&quot; : &quot;filename_page2.md&quot;,
+        &quot;Sub Header 1&quot; : 
         {
             &quot;__index&quot; : &quot;index.md&quot;,
             &quot;Title Page 3&quot; : &quot;filename_page3.md&quot;,
@@ -181,6 +184,8 @@
 </div><div class="alert alert-warning"><span class="alert-title"><i class="fa fa-warning"></i> Important!</span><p>Note that setting this value to <code>true</code> will remove the possibility to view the docs off-line                          
</p>
 </div><h3 id="footer">Footer<a class="headerlink" href="#footer" title="Permalink to this headline"><i class="fa fa-link" aria-hidden="true"></i></a></h3>
 <p>This is text and/or HTML which is placed in the footer of each page, using a <em>marker</em> (see below).</p>
+<h3 id="startingpagename">StartingPageName<a class="headerlink" href="#startingpagename" title="Permalink to this headline"><i class="fa fa-link" aria-hidden="true"></i></a></h3>
+<p>This is the name used for the home/starting page, i.e. the <code>__index</code> page at the root level. The default value is &quot;Home&quot;.</p>
 <h3 id="pages">Pages<a class="headerlink" href="#pages" title="Permalink to this headline"><i class="fa fa-link" aria-hidden="true"></i></a></h3>
 <p>Contains the pages to generate into the output, in the order and structure in which you want them to appear in the navigation. The name given is the value used in the navigation tree and has to be unique per level. The value specified with each name is the markdown file to load, parse and generate as .htm file in the output. The markdown file is relative to the path specified in <code>Source</code>. A file <code>foo.md</code> will be generated as <code>foo.htm</code> in the output. </p>
 <p>Paths are expected to use <code>\</code> characters, and as it's json, you have to escape them, so the path <code>.\foo</code> becomes <code>.\\foo</code>.</p>

h2leveldiscovery.htm

@@ -81,7 +81,7 @@
                     <div class="section">
 <h1 id="automatic-h2-level-toc-entry-discovery">Automatic H2 level ToC entry discovery<a class="headerlink" href="#automatic-h2-level-toc-entry-discovery" title="Permalink to this headline"><i class="fa fa-link" aria-hidden="true"></i></a></h1>
 <p><code>Docnet</code> will automatically add all H2 (<code>##</code> marked) headers to the ToC as sub navigation elements below a page ToC item. It will automatically add anchors to these H2 headers in the HTML output for the page as well. This makes it very easy to create a fine-grained ToC for easy discovery.</p>
-<p>This behavior can be overridden by the <code>MaxLevelInToC</code> <a href="./docnetjson.htm">configuration option</a>.</p>
+<p>This behavior can be overridden by the <code>MaxLevelInToC</code> <a href="./docnetjson.md">configuration option</a>.</p>
 <div class="alert alert-info"><span class="alert-title"><i class="fa fa-info-circle"></i> Info</span><p>Note that level 1 headings (titles) are never shown in the ToC).</p>
 </div>
                     </div>

markdownsupport.htm

@@ -206,7 +206,7 @@ If you want to have an image rendered centered with a note below it, simply spec
 <p>To specify a block of text in a fixed sized font but not specify any language highlighting, specify <code>nohighlight</code> as language name:</p>
 <pre class="nocode">this is a simple &lt;pre&gt; block
 </pre><h2 id="linking">Linking<a class="headerlink" href="#linking" title="Permalink to this headline"><i class="fa fa-link" aria-hidden="true"></i></a></h2>
-<p><code>Docnet</code> doesn't automatically transform links to markdown files by default. To enable automatic link conversion to local markdown files, please specify the <code>ConvertLocalLinks</code> option in the <a href="docnetjson.htm">docnet.json file</a> file with the value <code>true</code>. If <code>ConvertLocalLinks</code> isn't specified or set to <code>false</code>, any link to any document in your documentation has to use the url it will get in the destination folder. </p>
+<p><code>Docnet</code> doesn't automatically transform links to markdown files by default. To enable automatic link conversion to local markdown files, please specify the <code>ConvertLocalLinks</code> option in the <a href="docnetjson.md">docnet.json file</a> file with the value <code>true</code>. If <code>ConvertLocalLinks</code> isn't specified or set to <code>false</code>, any link to any document in your documentation has to use the url it will get in the destination folder. </p>
 <p>Example: you want to link to the file <code>How to\AddEntity.md</code> from a page. If <code>ConvertLocalLinks</code> isn't specified or set to <code>false</code>, you have to specify in the markdown the url it will need to be in the result site, which is the link <code>How%20to/AddEntity.htm</code>. If <code>ConvertLocalLinks</code> is set to <code>true</code>, you can specify <code>How%20to/AddEntity.md</code> and DocNet will convert it to <code>How%20to/AddEntity.htm</code>.</p>
 <div class="alert alert-warning"><span class="alert-title"><i class="fa fa-warning"></i> Important!</span><p>The markdown parser also doesn't allow spaces to be present in the urls. If you need a space in the url, escape it with <code>%20</code>. </p>
 </div>

search_index.json

@@ -9,7 +9,7 @@
     {
       "location": "docnetjson.htm",
       "breadcrumbs": "Home / Configuration / Site configuration with the docnet.json file",
-      "keywords": "__index _marker_ _Sub 1 1_ 2 3 3rd 4 a A above absolute actual additional alert all All always an and API appear are as assigned assumed Assumes auto Auto backwards based be becomes Behaves below browsing but by called can case characters clashes clean clicked Combined commas compatibility configuration contain contains Contains content Contents convert converted ConvertLocalLinks copied copy couple create dash Dashes default Default defined described Destination destinationfolder determine Determines directive directives do docnet Docnet DocNet docs document documentation Does doesn dots e E each Each elements empty end ending entry escape etc every example Example except executable exist exists expected expects experience extremely false feature file filename_page1 filename_page2 filename_page3 filename_page4 filenames files first folder folder1 foldern folders following foo footer Footer for form format formatted forward from full Full g generate Generate generated getting given guarantees has have header Header headings Home how href htm HTML if If image Images important in include included includefolder Includes IncludeSource inclusion inclusions index info inside into introduction Introduction is isn it It its json later lead level Levels line link links list load loaded local located make markdown markdownextensions marker MaxLevelInToC md more mostly my mydocumentation name Name nameoflevel names navigated navigation never no non Non None not Note of off one only optional or order output own page Page pages Pages PageTemplate parent parse party path paths Paths PathSpecification per placed possibility process put puts recursively reference referene relative Relative RelativeAsFolder reliably remove removing Replaces result resulting results retrieved reusing right root same Search see See sensitive set Sets setting show shown simply site so some Some someintroduction somemarkdownfile source Source sourcefolder SourceFoldersToCopy spaces special specified Specifies specify started starting still straight string strip Strip StripIndexHtm structure sub Sub subfolders suffixed Table target text that the The them theme Theme themefolder Themes there they this This tip title Title titles to To ToC tool tooling topics topictitle touch treated tree true unique unsupported UrlFormatting urls use Use used useful uses using value view want way what when where which wildcard will with within without would wrapper written you",
+      "keywords": "__index _marker_ _Sub 1 1_ 2 3 3rd 4 a A above absolute actual additional alert all All always an and API appear are as assigned assumed Assumes at auto Auto backwards based be becomes Behaves below browsing but by called can case characters clashes clean clicked Combined commas compatibility configuration contain contains Contains content Contents convert converted ConvertLocalLinks copied copy couple create dash Dashes default Default defined described Destination destinationfolder determine Determines directive directives do docnet Docnet DocNet docs document documentation Does doesn dots e E each Each elements empty end ending entry escape etc every example Example except executable exist exists expected expects experience extremely false feature file filename_page1 filename_page2 filename_page3 filename_page4 filenames files first folder folder1 foldern folders following foo footer Footer for form format formatted forward from full Full g generate Generate generated getting given guarantees has have header Header headings home Home how href htm HTML i if If image Images important in include included includefolder Includes IncludeSource inclusion inclusions index info inside into introduction Introduction is isn it It its json later lead level Levels line link links list load loaded local located make markdown markdownextensions marker MaxLevelInToC md more mostly my mydocumentation name Name nameoflevel names navigated navigation never no non Non None not Note of off one only optional or order output own page Page pages Pages PageTemplate parent parse party path paths Paths PathSpecification per placed possibility process put puts recursively reference referene relative Relative RelativeAsFolder reliably remove removing Replaces result resulting results retrieved reusing right root same Search see See sensitive set Sets setting show shown simply site so some Some someintroduction somemarkdownfile source Source sourcefolder SourceFoldersToCopy spaces special specified Specifies specify started starting StartingPageName still straight string strip Strip StripIndexHtm structure sub Sub subfolders suffixed Table target text that the The them theme Theme themefolder Themes there they this This tip title Title titles to To ToC tool tooling topics topictitle touch treated tree true unique unsupported UrlFormatting urls use Use used useful uses using value view want way what when where which wildcard will with within without would wrapper written you",
       "title": "Site configuration with the docnet.json file"
     },
     {

usage.htm

@@ -32,7 +32,7 @@
 </li>
 
 <li class="tocentry current"><a class="current" href="usage.htm">Usage</a>
-<ul class="currentrelativeroot">
+<ul class="currentrelative">
 <li class="tocentry"><a href="#requirements">Requirements</a></li>