New Website

.github/workflows/deploy.yml

@@ -0,0 +1,34 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ new-website ]
+  # To run this workflow manually from the Actions tab on GitHub.
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout your repository using git
+        uses: actions/checkout@v4
+      - name: Install, build, and upload your site
+        uses: withastro/action@v3
+        with:
+          path: website
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

website/.gitignore

@@ -0,0 +1,23 @@
+.cache
+
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

website/.prettierrc.mjs

@@ -0,0 +1,12 @@
+/** @type {import("prettier").Config} */
+export default {
+  plugins: ["prettier-plugin-astro"],
+  overrides: [
+    {
+      files: "*.astro",
+      options: {
+        parser: "astro",
+      },
+    },
+  ],
+};

website/README.md

@@ -0,0 +1,9 @@
+# Helix Docs
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+The helix documentation.
+
+[Contributing instructions](https://helix-editor.vercel.app/contributing/this-site).
+
+The new website is available at [helix-editor.vercel.app](https://helix-editor.vercel.app).

website/astro.config.mjs

@@ -0,0 +1,134 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+import starlightLinksValidator from "starlight-links-validator";
+import starlightBlog from "starlight-blog";
+import { rehypeHeadingIds } from "@astrojs/markdown-remark";
+import rehypeAutolinkHeadings from "rehype-autolink-headings";
+import rehypeExternalLinks from "rehype-external-links";
+
+import sitemap from "@astrojs/sitemap";
+
+// https://astro.build/config
+export default defineConfig({
+  site: "https://helix-editor.vercel.app",
+  vite: {
+    optimizeDeps: { include: ["asciinema-player"] },
+  },
+  markdown: {
+    rehypePlugins: [
+      rehypeHeadingIds,
+
+      [
+        rehypeExternalLinks,
+        {
+          content: {
+            type: "text",
+            value: " ↗",
+          },
+          properties: {
+            target: "_blank",
+          },
+          rel: ["noopener"],
+        },
+      ],
+      [rehypeAutolinkHeadings, { behavior: "wrap" }],
+    ],
+  },
+  integrations: [
+    starlight({
+      head: [
+        {
+          tag: "link",
+          attrs: {
+            rel: "sitemap",
+            href: "/sitemap-index.xml",
+          },
+        },
+      ],
+      plugins: [
+        starlightLinksValidator(),
+        starlightBlog({ title: "News", prefix: "news" }),
+      ],
+      title: "Helix",
+      logo: {
+        src: "./public/favicon.svg",
+      },
+      social: {
+        github: "https://github.com/helix-editor/helix",
+        matrix: "https://matrix.to/#/#helix-community:matrix.org",
+      },
+      components: {
+        ThemeProvider: "./src/components/ThemeProvider.astro",
+        ThemeSelect: "./src/components/ThemeSelect.astro",
+        Head: "./src/components/Head.astro",
+      },
+      editLink: {
+        baseUrl: "https://github.com/helix-editor/helix/edit/main/website/",
+      },
+      sidebar: [
+        {
+          label: "Getting Started",
+          items: ["getting-started/installation", "getting-started/basics"],
+        },
+        {
+          label: "Usage",
+          items: [
+            "usage/multiple-cursors",
+            "usage/text-objects",
+            "usage/surround",
+            "usage/language-support",
+            "usage/pickers",
+            "usage/registers",
+          ],
+        },
+        {
+          label: "Configuration",
+          items: [
+            "configuration/editor",
+            "configuration/languages",
+            "configuration/remapping",
+          ],
+        },
+        {
+          label: "Reference",
+          items: [
+            "reference/keymap",
+            "reference/typed-commands",
+            "reference/list-of-themes",
+            "reference/custom-themes",
+            "reference/language-servers",
+            "reference/formatters",
+            "reference/debuggers",
+          ],
+        },
+        {
+          label: "Help",
+          items: [
+            "help/recipes",
+            "help/faq",
+            "help/troubleshooting",
+            "help/terminal-support",
+            "help/language-defaults",
+            "help/refactor-examples",
+          ],
+        },
+        {
+          label: "Contributing to Helix",
+          items: [
+            "contributing/vision",
+            "contributing/this-site",
+            "contributing/releases",
+            "contributing/architecture",
+            "contributing/languages",
+            "contributing/textobject-queries",
+            "contributing/indent-queries",
+            "contributing/injection-queries",
+          ],
+        },
+      ],
+      customCss: ["./src/globals.css"],
+    }),
+    sitemap(),
+  ],
+});

website/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "helix-docs",
+  "type": "module",
+  "packageManager": "pnpm@latest",
+  "version": "1.0.0",
+  "scripts": {
+    "termshots": "node scripts/termshots.js",
+    "predev": "pnpm termshots",
+    "prebuild": "pnpm termshots",
+    "prepreview": "pnpm termshots",
+    "dev": "astro dev",
+    "build": "astro check && astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/check": "^0.9.4",
+    "@astrojs/markdown-remark": "^5.3.0",
+    "@astrojs/sitemap": "^3.2.1",
+    "@astrojs/starlight": "^0.29.2",
+    "asciinema-player": "^3.8.1",
+    "astro": "^4.16.10",
+    "astro-og-canvas": "^0.5.4",
+    "canvaskit-wasm": "^0.39.1",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-external-links": "^3.0.0",
+    "sharp": "^0.32.5",
+    "starlight-blog": "^0.15.0",
+    "starlight-contributor-list": "^0.1.0",
+    "starlight-links-validator": "^0.13.2",
+    "typescript": "^5.6.3"
+  }
+}