Getting the installation page working yay

Author: remotesynth

astro.config.mjs

@@ -1,10 +1,32 @@
 // @ts-check
-import { defineConfig } from 'astro/config';
+import { defineConfig, envField } from 'astro/config';
 import starlight from '@astrojs/starlight';
 import starlightUtils from '@lorenzo_lewis/starlight-utils';
 
+import markdoc from '@astrojs/markdoc';
+
+// Fetch the latest release version from GitHub
+const response = await fetch(
+  'https://api.github.com/repos/localstack/localstack/releases/latest',
+  {
+    headers: { Accept: 'application/vnd.github+json' },
+  }
+);
+const data = await response.json();
+const latestVersion = data.tag_name.replace('v', '');
+
 // https://astro.build/config
 export default defineConfig({
+  env: {
+    schema: {
+      LOCALSTACK_VERSION: envField.string({
+        context: 'server',
+        access: 'public',
+        default: latestVersion,
+        optional: true,
+      }),
+    },
+  },
   integrations: [
     starlight({
       title: 'LocalStack Docs',
@@ -249,14 +271,14 @@ export default defineConfig({
               collapsed: true,
             },
             {
-              label: 'Capabilities',
+              label: 'Services',
               collapsed: true,
-              autogenerate: { directory: '/snowflake/capabilities' },
+              autogenerate: { directory: '/snowflake/services' },
             },
             {
-              label: 'Services',
+              label: 'Capabilities',
               collapsed: true,
-              autogenerate: { directory: '/snowflake/services' },
+              autogenerate: { directory: '/snowflake/capabilities' },
             },
             {
               label: 'Tooling',
@@ -281,5 +303,6 @@ export default defineConfig({
         },
       ],
     }),
+    markdoc(),
   ],
 });

markdoc.config.mjs

@@ -0,0 +1,6 @@
+import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+export default defineMarkdocConfig({
+  extends: [starlightMarkdoc()],
+});

package-lock.json

@@ -10,7 +10,9 @@
     "astro": "astro"
   },
   "dependencies": {
+    "@astrojs/markdoc": "^0.14.2",
     "@astrojs/starlight": "^0.34.0",
+    "@astrojs/starlight-markdoc": "^0.4.0",
     "@lorenzo_lewis/starlight-utils": "^0.3.2",
     "astro": "^5.7.3",
     "sharp": "^0.32.5"

package.json

@@ -434,7 +434,7 @@ To learn more about these configuration options, see [DNS Server]({{< ref "dns-s
 | Variable             | Example Values | Description |
 |----------------------|----------------|-------------|
 | `ACTIVATE_PRO`       | `0` \| `1`&nbsp;(default)    | Whether Pro should be activated or not. This is set to true by default if using the `localstack/localstack-pro` container image. If set to `1`, LocalStack will fail to start if the license key activation did not work. If set to `0`, an attempt is made to start LocalStack without Pro features. |
-| `LOCALSTACK_AUTH_TOKEN` |             | [Auth token]({{< ref "auth-token" >}}) to activate LocalStack Pro. |
+| `LOCALSTACK_AUTH_TOKEN` |             | [Auth token](/aws/getting-started/auth-token) to activate LocalStack Pro. |
 | `LOCALSTACK_API_KEY` |                | **Deprecated since 3.0.0** [API key]({{< ref "api-key" >}}) to activate LocalStack Pro.<br/> **Use the `LOCALSTACK_AUTH_TOKEN` instead (except for [CI environments]({{< ref "user-guide/ci/" >}})).** |
 | `LOG_LICENSE_ISSUES` | `0` \| `1`&nbsp;(default)    | Whether to log issues with the license activation to the console. |
 

src/content/docs/aws/capabilities/config/configuration.md

@@ -9,7 +9,7 @@ sidebar:
 If you have created a resource using LocalStack, such as an OpenSearch cluster or RDS database, you may need to access it from your application.
 Typically, these resources are accessible through a URL or a hostname provided by LocalStack.
 By default, LocalStack returns the hostname `localhost.localstack.cloud`, which resolves to LocalStack using DNS.
-For special environments (e.g., proxies), the [configuration]({{< ref "configuration" >}}) `LOCALSTACK_HOST` customizes the URLs returned by LocalStack.
+For special environments (e.g., proxies), the [configuration](/aws/capabilities/config/configuration) `LOCALSTACK_HOST` customizes the URLs returned by LocalStack.
 This guide will explore different scenarios and provide detailed instructions on accessing resources created by LocalStack under different scenarios.
 
 ## From your host

src/content/docs/aws/capabilities/networking/accessing-resources-created.md

@@ -17,4 +17,4 @@ LocalStack supports a growing number of [AWS services]({{< ref "aws" >}}), like
 You can find a comprehensive list of supported APIs on our [Feature Coverage]({{< ref "references/coverage" >}}) page.
 
 LocalStack also provides additional features to make your life as a cloud developer easier!
-Check out LocalStack's [Cloud Developer Tools]({{< ref "user-guide/tools" >}}).
+Check out LocalStack's [Cloud Developer Tools](/aws/tooling/).