Update documentation site

- Add Guide section and move to it everything in the Articles section
- Add custom template
- Various minor changes

docs/articles/differential_geometry/tensors.md

@@ -0,0 +1,3 @@
+# Tensors
+
+[work in progress]

docs/articles/intro.md

@@ -1,3 +1,3 @@
 # Mathematics.NET Articles
 
-Welcome to Mathematics.NET.
+This section is dedicated to highlighting areas of math covered in this library.

docs/articles/toc.yml

@@ -1,10 +1,6 @@
 - name: Introduction
   href: intro.md
-- name: Get Started
+- name: Differential Geometry
   items:
-  - name: Installation
-    href: get_started/installation.md
-- name: Fundamentals
-  items:
-  - name: Numeric Types
-    href: fundamentals/numeric-types.md
+  - name: Tensors
+    href: differential_geometry/tensors.md

docs/docfx.json

@@ -23,18 +23,8 @@
   "build": {
     "content": [
       {
-        "files": [
-          "api/**.yml",
-          "api/index.md"
-        ]
-      },
-      {
-        "files": [
-          "articles/**.md",
-          "articles/**/toc.yml",
-          "toc.yml",
-          "*.md"
-        ]
+        "files": [ "**/*.{md,yml}" ],
+        "exclude": [ "_site/**", "obj/**" ]
       }
     ],
     "resource": [
@@ -49,7 +39,8 @@
     "fileMetadataFiles": [],
     "template": [
       "default",
-      "modern"
+      "modern",
+      "template"
     ],
     "postProcessors": [ "ExtractSearchIndex" ],
     "keepFileLink": false,

docs/guide/intro.md

@@ -0,0 +1,3 @@
+# Mathematics.NET Guide
+
+Welcome to Mathematics.NET.

docs/guide/toc.yml

@@ -0,0 +1,10 @@
+- name: Introduction
+  href: intro.md
+- name: Get Started
+  items:
+  - name: Installation
+    href: get_started/installation.md
+- name: Fundamentals
+  items:
+  - name: Numeric Types
+    href: fundamentals/numeric-types.md

docs/template/public/main.css

@@ -0,0 +1,58 @@
+:root, [data-bs-theme="dark"] {
+  --bg-color-primary: #161616;
+  --bg-color-secondary: #082424;
+}
+
+[data-bs-theme="light"] {
+  --bg-color-primary: #e4e4e4;
+  --bg-color-secondary: #b4f8f8;
+}
+
+header {
+  --bs-border-width: 0px;
+}
+
+body {
+  background-color: var(--bg-color-primary);
+}
+
+  body > footer {
+    display: flex;
+    align-items: center;
+    padding: 0rem;
+    height: 3rem;
+  }
+
+footer {
+  background-color: var(--bg-color-secondary);
+  font-size: 0.75rem;
+}
+
+  footer.border-top{
+    border-top: 0px;
+  }
+
+a {
+  text-decoration: none;
+}
+
+  a:hover {
+    text-decoration: underline;
+  }
+
+.bg-body {
+  background-color: var(--bg-color-secondary);
+}
+
+.dropdown a:hover {
+  text-decoration: none;
+}
+
+.dropdown-menu[data-bs-popper] {
+    background-color: var(--bg-color-secondary);
+    margin-top: 1.125rem;
+}
+
+  .dropdown-menu a:hover {
+    text-decoration: none;
+  }

docs/template/public/main.js

@@ -0,0 +1,15 @@
+export default {
+  defaultTheme: 'dark',
+  iconLinks: [
+    {
+      icon: 'github',
+      href: 'https://github.com/HamletTanyavong/Mathematics.NET',
+      title: 'GitHub'
+    },
+    {
+      icon: 'heart',
+      href: 'https://github.com/sponsors/HamletTanyavong',
+      title: 'Sponsor'
+    }
+  ]
+}

docs/toc.yml

@@ -1,5 +1,6 @@
+- name: Guide
+  href: guide/
+- name: API
+  href: api/
 - name: Articles
   href: articles/
-- name: Api Documentation
-  href: api/
-  homepage: api/index.md