Guides reorg with main guides page.

lando · Feb 1, 2024 · 2d903d7 · 2d903d7
1 parent f9ebf6d
commit 2d903d7
Show file tree

Hide file tree

Showing 4 changed files with 41 additions and 9 deletions.
diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs
@@ -21,6 +21,16 @@ export default defineConfig({
   themeConfig: {
     sidebar: sidebar(),
   },
+  collections: {
+    guide: {
+      frontmatter: {
+        collection: 'guide',
+      },
+      icon: '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6"><path stroke-linecap="round" stroke-linejoin="round" d="M4.26 10.147a60.438 60.438 0 0 0-.491 6.347A48.62 48.62 0 0 1 12 20.904a48.62 48.62 0 0 1 8.232-4.41 60.46 60.46 0 0 0-.491-6.347m-15.482 0a50.636 50.636 0 0 0-2.658-.813A59.906 59.906 0 0 1 12 3.493a59.903 59.903 0 0 1 10.399 5.84c-.896.248-1.783.52-2.658.814m-15.482 0A50.717 50.717 0 0 1 12 13.489a50.702 50.702 0 0 1 7.74-3.342M6.75 15a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm0 0v-3.675A55.378 55.378 0 0 1 12 8.443m-7.007 11.55A5.981 5.981 0 0 0 6.75 15.75v-1.5" /></svg>',
+      iconLink: '/guides',
+      patterns: ['guides/**/*.md'],
+    },
+  }
 });
 
 function sidebar() {
@@ -36,14 +46,7 @@ function sidebar() {
         {text: 'Syncing', link: '/sync'},
       ],
     },
-    {
-      text: 'Guides',
-      collapsed: true,
-      items: [
-        {text: 'Connecting to your database', link: '/connecting-database'},
-        {text: 'Manually importing databases and files', link: '/manually-importing-databases'},
-      ],
-    },
+    {text: 'Guides', link: '/guides', activeMatch: '/guides'},
     {
       text: 'Contribution',
       collapsed: true,

diff --git a/docs/guides.md b/docs/guides.md
@@ -0,0 +1,26 @@
+---
+description: Home helpful guides for the VitePress Default Theme Plus.
+layout: page
+title: Guides
+sidebar: false
+---
+
+<script setup>
+import {VPLCollectionPage, VPLCollectionPageTitle, VPLCollectionItems} from '@lando/vitepress-theme-default-plus';
+import {useCollection} from '@lando/vitepress-theme-default-plus';
+
+const {pages} = useCollection('guide');
+
+</script>
+
+<VPLCollectionPage>
+  <VPLCollectionPageTitle>
+    <template #title>
+      Guides
+    </template>
+    <template #lead>
+      Helpful tutorial-like content!
+    </template>
+  </VPLCollectionPageTitle>
+  <VPLCollectionItems :items="pages"/>
+</VPLCollectionPage>
diff --git a/docs/connecting-database.md → docs/guides/connecting-database.md b/docs/connecting-database.md → docs/guides/connecting-database.md
@@ -8,6 +8,8 @@ mailchimp:
   button: Sign me up!
 ---
 
+# Connecting to Your Database
+
 Just like on Acquia, Lando will automatically configure your application to connect to its local database and cache. Note that in some cases, such as when the user has purposefully removed the sourcing of the `${project}-settings.inc` file, this will not work.
 
 If you find yourself in this situation and need to manually connect to the database or cache credentials for each are below:

diff --git a/docs/manually-importing-databases.md → docs/guides/manually-importing-databases.md b/docs/manually-importing-databases.md → docs/guides/manually-importing-databases.md
@@ -1,14 +1,15 @@
 ---
 title: Manually importing databases and files
 description: Learn how to manually import other databases into your Lando Acquia site.
-guide: true
 mailchimp:
   action: https://dev.us12.list-manage.com/subscribe/post?u=59874b4d6910fa65e724a4648&amp;id=613837077f
   title: Want more Acquia guide content?
   byline: Signup and we will send you a weekly blog digest of similar content to keep you satiated.
   button: Sign me up!
 ---
 
+# Manually Importing Databases and Files
+
 In the event that `lando pull` is not working as expected you have a few other things you can try out to grab your database and files.
 
 ## Database