Prepare deploy gh action

Author: kristijanhusak

.github/workflows/deploy.yml

@@ -7,19 +7,31 @@ jobs:
   build-and-deploy:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout 🛎️
-        uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install pandoc
+        uses: pandoc/actions/setup@v1
+        with:
+          version: 3.5
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Build md files
+        run: npm run pandoc:build
 
       - name: Install dependencies
-        run: |
-          sudo apt-get install -y python3-sphinx python3-sphinx-rtd-theme
+        run: npm ci
 
-      - name: Build
-        run: |
-          cd docs && make html
+      - name: Build with VitePress
+        run: npm run docs:build
 
       - name: Deploy
         uses: JamesIves/github-pages-deploy-action@v4.3.3
         with:
           branch: gh-pages
-          folder: docs/_build/html
+          folder: .vitepress/dist

package.json

@@ -6,7 +6,8 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "docs:dev": "vitepress dev",
     "docs:build": "vitepress build",
-    "docs:preview": "vitepress preview"
+    "docs:preview": "vitepress preview",
+    "pandoc:build": "node ./scripts/generate_md.mjs"
   },
   "repository": {
     "type": "git",

scripts/generate_md.mjs

@@ -7,8 +7,9 @@ import { fileURLToPath } from 'node:url';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const generateMd = async () => {
-  const files = fs.readdirSync(path.resolve(__dirname, '../docs'))
-  fs.mkdirSync(path.resolve(__dirname, '../docs_md'))
+  const files = await fs.promises.readdir(path.resolve(__dirname, '../docs'))
+  await fs.promises.rm(path.resolve(__dirname, '../docs_md'), { recursive: true, force: true })
+  fs.promises.mkdir(path.resolve(__dirname, '../docs_md'))
   for await (const file of files) {
     execSync(`pandoc --lua-filter=${__dirname}/pandoc_fix_links.lua -s ${__dirname}/../docs/${file} -o ${__dirname}/../docs_md/${path.parse(file).name}.md -t gfm`)
   }