docs: setup the translation helper

docs/.vitepress/theme/index.mts

@@ -0,0 +1,19 @@
+import { h } from 'vue'
+import Theme from 'vitepress/theme'
+import TranslationStatus from 'vitepress-translation-helper/ui/TranslationStatus.vue'
+import status from '../translation-status.json'
+
+const i18nLabels = {
+  // TODO: to be translated
+  fr: 'The translation is synced to the docs on ${date} of which the commit hash is <code>${hash}</code>.',
+}
+
+
+export default {
+  ...Theme,
+  Layout() {
+    return h(Theme.Layout, null, {
+      'doc-before': () => h(TranslationStatus, { status, i18nLabels }),
+    })
+  },
+}

docs/.vitepress/translation-status.json

@@ -0,0 +1,6 @@
+{
+  "fr": {
+    "hash": "1d8e1ee",
+    "date": "2024-02-14"
+  }
+}

package.json

@@ -58,6 +58,7 @@
     "unplugin-vue-components": "0.26.0",
     "vite": "5.1.6",
     "vitepress": "1.0.0-rc.45",
+    "vitepress-translation-helper": "^0.1.3",
     "vitest": "1.3.1",
     "vue": "3.4.21",
     "vue-class-component": "8.0.0-rc.1",
@@ -81,6 +82,9 @@
     "lint:fix": "pnpm run lint --fix",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
+    "docs:translation:compare": "v-translation compare --status-file=docs/.vitepress/translation-status.json",
+    "docs:translation:update": "v-translation update --status-file=docs/.vitepress/translation-status.json",
+    "docs:translation:status": "v-translation status --status-file=docs/.vitepress/translation-status.json",
     "vue-tsc": "vue-tsc --noEmit -p tsconfig.volar.json",
     "prepublishOnly": "pnpm run build"
   },