autogenerate index page (#21)

package.json

@@ -17,6 +17,7 @@
     "@astrojs/tailwind": "^5.1.0",
     "@hpcc-js/wasm": "^2.22.1",
     "astro": "^4.10.2",
+    "marked": "^14.1.2",
     "rehype-graphviz": "^0.3.0",
     "sharp": "^0.32.5",
     "tailwindcss": "^3.4.10"

scripts/generate.ts

@@ -243,6 +243,35 @@ function buildRedirects(aeps: AEP[]): object {
   return {};
 }
 
+function buildHomepage(): Markdown {
+  let frontmatter = {
+    "title": "AEPs",
+    "description": "Application Enhancement Proposals",
+    "template": "splash",
+    "hero": {
+      "tagline": "Focused design documents for flexible API development.",
+      "image": {
+        "file": "../../assets/aep.svg"
+      },
+      actions: []
+    },
+  }
+
+  let config = loadConfigFiles("hero.yaml");
+  frontmatter.hero.actions = config.hero.buttons.map((button) => ({text: button.text, link: button.href, icon: "right-arrow"}));
+
+  let contents = `import config from "../../../generated/config.json";
+
+  <HomeGrid sections={config.hero.shortcuts} />
+  `
+  let markdown = new Markdown(contents, frontmatter);
+  markdown.addComponent({
+    "names": ["HomeGrid"],
+    "path": "../../components/HomeGrid.astro"
+  });
+  return markdown;
+}
+
 // Build config.
 let config = loadConfigFiles("hero.yaml", "urls.yaml", "site.yaml");
 writeSidebar(config, "config.json");
@@ -281,4 +310,7 @@ var linter_sidebar = buildLinterSidebar(consolidated_rules);
 writeSidebar(linter_sidebar, "linter_sidebar.json");
 
 buildIndexPage(aeps);
-writeSidebar(buildRedirects(aeps), "redirects.json");
+writeSidebar(buildRedirects(aeps), "redirects.json");
+
+let homePage = buildHomepage();
+fs.writeFileSync("src/content/docs/index.mdx", homePage.build());

src/components/HomeGrid.astro

@@ -0,0 +1,15 @@
+---
+const {sections} = Astro.props;
+import { Card, CardGrid, LinkButton } from '@astrojs/starlight/components';
+import { marked } from 'marked';
+---
+<CardGrid>
+	{sections.map((section) => (
+		<Card title={section.title}>
+            <article set:html={marked.parse(section.description)} />
+
+
+            <LinkButton href={section.button.href}>{section.button.text}</LinkButton>
+		</Card>
+	))}
+</CardGrid>