Add docs/source/api to docs/source/index filemap AND add better versioning support

.github/workflows/documentation.yml

@@ -29,6 +29,7 @@ jobs:
     name: Test Generating Docs
     steps:
       - uses: actions/checkout@8f4b7f84864484a7bf31766abe9204da3cbe65b3 # v3.5.0
+      - run: git fetch --depth=1 --tags # download all tags for documentation
 
       - name: Setup node
         uses: actions/setup-node@64ed1c7eab4cce3362f8c340dee64e5eaeef8f7c # v3.6.0

.gitignore

@@ -49,6 +49,8 @@ docs/*.html
 docs/tutorials/*.html
 docs/typescript/*.html
 docs/api/*.html
+# the below excludes things like "0test.x" too, but gitignore does not have something like js regex "[0-9]+", so this is the best for future versions
+docs/[0-9]*.x/
 index.html
 
 # Local Netlify folder
@@ -64,4 +66,4 @@ mongoose-*.tgz
 examples/ecommerce-netlify-functions/.netlify/state.json
 
 notes.md
-list.out
+list.out

docs/api_split.pug

@@ -1,27 +1,27 @@
 extends layout
 
 append style
-  link(rel="stylesheet", href="/docs/css/api.css")
-  script(src="/docs/js/api-bold-current-nav.js")
-  script(src="/docs/js/convert-old-anchorid.js")
+  link(rel="stylesheet", href=`${versions.versionedPath}/docs/css/api.css`)
+  script(src=`${versions.versionedPath}/docs/js/api-bold-current-nav.js`)
+  script(src=`${versions.versionedPath}/docs/js/convert-old-anchorid.js`)
 
 block content
   <a class="edit-docs-link" href="#{editLink}" target="_blank">
-    <img src="/docs/images/pencil.svg" />
+    <img src="#{versions.versionedPath}/docs/images/pencil.svg" />
   </a>
-  h1 #{name}
+  h1 #{title}
 
   include includes/native
 
   div.api-nav
     div.api-nav-content
       each item in docs
-        - if (!item.hideFromNav || item.name === name)
-          div.nav-item(id='nav-' + item.name)
-            - if (item.name === name)
+        - if (!item.hideFromNav || item.title === title)
+          div.nav-item(id='nav-' + item.title)
+            - if (item.title === title)
               div.nav-item-title(style="font-weight: bold")
                 a(href=item.fileName + '.html')
-                  | #{item.name}
+                  | #{item.title}
               ul.nav-item-sub
                 each prop in item.props
                   li
@@ -30,7 +30,7 @@ block content
             - else
               div.nav-item-title
                 a(href=item.fileName + '.html')
-                  | #{item.name}
+                  | #{item.title}
 
   div.api-content
     ul

docs/includes/favicon.pug

@@ -1,14 +1,14 @@
-link(rel='apple-touch-icon', sizes='57x57', href='/docs/images/favicon/apple-icon-57x57.png')
-link(rel='apple-touch-icon', sizes='60x60', href='/docs/images/favicon/apple-icon-60x60.png')
-link(rel='apple-touch-icon', sizes='72x72', href='/docs/images/favicon/apple-icon-72x72.png')
-link(rel='apple-touch-icon', sizes='76x76', href='/docs/images/favicon/apple-icon-76x76.png')
-link(rel='apple-touch-icon', sizes='114x114', href='/docs/images/favicon/apple-icon-114x114.png')
-link(rel='apple-touch-icon', sizes='120x120', href='/docs/images/favicon/apple-icon-120x120.png')
-link(rel='apple-touch-icon', sizes='144x144', href='/docs/images/favicon/apple-icon-144x144.png')
-link(rel='apple-touch-icon', sizes='152x152', href='/docs/images/favicon/apple-icon-152x152.png')
-link(rel='apple-touch-icon', sizes='180x180', href='/docs/images/favicon/apple-icon-180x180.png')
-link(rel='icon', type='image/png', sizes='192x192',  href='/docs/images/favicon/android-icon-192x192.png')
-link(rel='icon', type='image/png', sizes='32x32', href='/docs/images/favicon/favicon-32x32.png')
-link(rel='icon', type='image/png', sizes='96x96', href='/docs/images/favicon/favicon-96x96.png')
-link(rel='icon', type='image/png', sizes='16x16', href='/docs/images/favicon/favicon-16x16.png')
-link(rel='manifest', href='/docs/images/favicon/manifest.json')
+link(rel='apple-touch-icon', sizes='57x57', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-57x57.png`)
+link(rel='apple-touch-icon', sizes='60x60', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-60x60.png`)
+link(rel='apple-touch-icon', sizes='72x72', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-72x72.png`)
+link(rel='apple-touch-icon', sizes='76x76', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-76x76.png`)
+link(rel='apple-touch-icon', sizes='114x114', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-114x114.png`)
+link(rel='apple-touch-icon', sizes='120x120', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-120x120.png`)
+link(rel='apple-touch-icon', sizes='144x144', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-144x144.png`)
+link(rel='apple-touch-icon', sizes='152x152', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-152x152.png`)
+link(rel='apple-touch-icon', sizes='180x180', href=`${versions.versionedPath}/docs/images/favicon/apple-icon-180x180.png`)
+link(rel='icon', type='image/png', sizes='192x192',  href=`${versions.versionedPath}/docs/images/favicon/android-icon-192x192.png`)
+link(rel='icon', type='image/png', sizes='32x32', href=`${versions.versionedPath}/docs/images/favicon/favicon-32x32.png`)
+link(rel='icon', type='image/png', sizes='96x96', href=`${versions.versionedPath}/docs/images/favicon/favicon-96x96.png`)
+link(rel='icon', type='image/png', sizes='16x16', href=`${versions.versionedPath}/docs/images/favicon/favicon-16x16.png`)
+link(rel='manifest', href=`${versions.versionedPath}/docs/images/favicon/manifest.json`)

docs/includes/native.pug

@@ -1,6 +1,6 @@
 append style
   script(type="text/javascript" src="//m.servedby-buysellads.com/monetization.custom.js")
-  link(rel="stylesheet", href="/docs/css/inlinecpc.css")
+  link(rel="stylesheet", href=`${versions.versionedPath}/docs/css/inlinecpc.css`)
 
 #native-direct
 script.