docs: migrate website to vitepress (#2359)

Co-authored-by: Pete Davison <[email protected]>
Co-authored-by: Andrey Nering <[email protected]>

Author: 3 people

.editorconfig

@@ -8,6 +8,6 @@ charset = utf-8
 trim_trailing_whitespace = true
 indent_style = tab
 
-[*.{md,mdx,yml,yaml,json,toml,htm,html,js,ts,css,svg,sh,bash,fish}]
+[*.{md,mdx,yml,yaml,json,toml,htm,html,js,ts,vue,css,svg,sh,bash,fish}]
 indent_style = space
 indent_size = 2

.github/workflows/lint.yml

@@ -40,35 +40,4 @@ jobs:
         run: python -m pip install 'check-jsonschema==0.27.3'
 
       - name: check-jsonschema (metaschema)
-        run: check-jsonschema --check-metaschema website/static/schema.json
-  check_doc:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Get changed files in the docs folder
-        id: changed-files-specific
-        uses: tj-actions/changed-files@v46
-        with:
-          files: website/versioned_docs/**
-
-      - uses: actions/github-script@v7
-        if: steps.changed-files-specific.outputs.any_changed == 'true'
-        with:
-          script: |
-            core.setFailed('website/versioned_docs has changed. Instead you need to update the docs in the website/docs folder.')
-  check_schema:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Get changed files in the docs folder
-        id: changed-files-specific
-        uses: tj-actions/changed-files@v46
-        with:
-          files: |
-            website/static/schema.json
-            website/static/schema-taskrc.json
-      - uses: actions/github-script@v7
-        if: steps.changed-files-specific.outputs.any_changed == 'true'
-        with:
-          script: |
-            core.setFailed('schema.json or schema-taskrc.json has changed. Instead you need to update next-schema.json or next-schema-taskrc.json.')
+        run: check-jsonschema --check-metaschema website/src/public/schema.json

.github/workflows/release.yml

@@ -19,6 +19,18 @@ jobs:
         with:
           go-version: 1.24.x
 
+      - name: Install Task
+        uses: arduino/setup-task@v2
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'pnpm'
+
       - name: Run GoReleaser
         uses: goreleaser/goreleaser-action@v6
         with:
@@ -28,3 +40,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{secrets.GH_PAT}}
           GORELEASER_KEY: ${{secrets.GORELEASER_KEY}}
+
+      - name: Deploy Website
+        shell: bash
+        run: |
+          task website:deploy:prod

cmd/release/main.go

@@ -9,21 +9,14 @@ import (
 	"time"
 
 	"github.com/Masterminds/semver/v3"
-	"github.com/otiai10/copy"
 	"github.com/spf13/pflag"
 
 	"github.com/go-task/task/v3/errors"
 )
 
 const (
-	changelogSource    = "CHANGELOG.md"
-	changelogTarget    = "website/docs/changelog.mdx"
-	docsSource         = "website/docs"
-	docsTarget         = "website/versioned_docs/version-latest"
-	schemaSource       = "website/static/next-schema.json"
-	schemaTarget       = "website/static/schema.json"
-	schemaTaskrcSource = "website/static/next-schema-taskrc.json"
-	schemaTaskrcTarget = "website/static/schema-taskrc.json"
+	changelogSource = "CHANGELOG.md"
+	changelogTarget = "website/docs/changelog.md"
 )
 
 var (
@@ -83,14 +76,6 @@ func release() error {
 		return err
 	}
 
-	if err := docs(); err != nil {
-		return err
-	}
-
-	if err := schema(); err != nil {
-		return err
-	}
-
 	return nil
 }
 
@@ -173,23 +158,3 @@ func setJSONVersion(fileName string, version *semver.Version) error {
 	// Write the JSON file
 	return os.WriteFile(fileName, []byte(new), 0o644)
 }
-
-func docs() error {
-	if err := os.RemoveAll(docsTarget); err != nil {
-		return err
-	}
-	if err := copy.Copy(docsSource, docsTarget); err != nil {
-		return err
-	}
-	return nil
-}
-
-func schema() error {
-	if err := copy.Copy(schemaSource, schemaTarget); err != nil {
-		return err
-	}
-	if err := copy.Copy(schemaTaskrcSource, schemaTaskrcTarget); err != nil {
-		return err
-	}
-	return nil
-}

website/.gitignore

@@ -1,21 +1,9 @@
 # Dependencies
 /node_modules
 
-# Production
-/build
-
-# Generated files
-.docusaurus
-.cache-loader
-i18n
-
-# Misc
-.DS_Store
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+.vitepress/cache
+.vitepress/dist
+.task/

website/.nojekyll

@@ -0,0 +1 @@
+pnpm-lock.yaml

website/.prettierignore

@@ -0,0 +1,5 @@
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue';
+  const component: DefineComponent<{}, {}, any>;
+  export default component;
+}

website/.vitepress/components.d.ts

@@ -0,0 +1,97 @@
+<template>
+  <div class="author-compact" v-if="author">
+    <img :src="author.avatar" :alt="author.name" class="author-avatar" />
+    <div class="author-info">
+      <div class="author-name-line">
+        <span class="author-name">{{ author.name }}</span>
+
+        <div class="author-socials">
+          <a
+            v-for="{ link, icon } in author.links"
+            :key="link"
+            :href="link"
+            target="_blank"
+            class="social-link"
+          >
+            <span :class="`vpi-social-${icon}`"></span>
+          </a>
+        </div>
+      </div>
+      <span class="author-bio">{{ author.title }}</span>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { team } from '../team.ts';
+import { computed } from 'vue';
+const props = defineProps({
+  author: String
+});
+
+const author = computed(() => {
+  return team.find((m) => m.slug === props.author) || null;
+});
+</script>
+
+<style scoped>
+.author-compact {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin: 1.5rem 0;
+}
+
+.author-avatar {
+  width: 48px;
+  height: 48px;
+  border-radius: 50%;
+  object-fit: cover;
+}
+
+.author-info {
+  display: flex;
+  flex-direction: column;
+  gap: 0.1rem;
+  flex: 1;
+}
+
+.author-name-line {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.author-name {
+  font-weight: 600;
+  color: var(--vp-c-text-1);
+  font-size: 0.95rem;
+}
+
+.author-bio {
+  color: var(--vp-c-text-2);
+  font-size: 0.85rem;
+}
+
+.author-socials {
+  display: flex;
+  gap: 0.5rem;
+}
+
+.social-link {
+  color: var(--vp-c-text-2);
+  transition: color 0.2s;
+  display: flex;
+  align-items: center;
+}
+
+.social-link:hover {
+  color: var(--vp-c-brand-1);
+}
+
+@media (max-width: 768px) {
+  .author-compact {
+    margin-bottom: 1rem;
+  }
+}
+</style>