Prepare deploy gh action

Author: kristijanhusak

.github/workflows/deploy.yml

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

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`)
   }