Migrate to VitePress (#276)

Author: vjik

.editorconfig

@@ -12,3 +12,6 @@ trim_trailing_whitespace = true
 
 [*.md]
 trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2

.github/workflows/docs.yml

@@ -19,6 +19,6 @@ jobs:
                 reporter: github-check
                 fail_on_error: false
                 filter_mode: nofilter
-                files: '["cookbook", "guide"]'
+                files: '["src/en"]'
               env:
                   GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}

.github/workflows/github-pages.yml

@@ -0,0 +1,52 @@
+name: Deploy VitePress with GitHub Pages
+
+on:
+  pull_request:
+  push:
+    branches: ["master"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build VitePress site
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: src/.vitepress/dist
+
+  deploy:
+    if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/translation.yml .github/workflows/translate.yml.github/workflows/translation.yml renamed to .github/workflows/translate.yml

@@ -1,11 +1,10 @@
-name: Update docs translation
+name: Update translations
 
 on:
-  pull_request_target:
+  pull_request:
     paths:
       - '_translations/**'
-      - 'cookbook/**'
-      - 'guide/**'
+      - 'src/**'
 
 jobs:
   update-docs:
@@ -19,18 +18,18 @@ jobs:
           ref: ${{ github.head_ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name }}
 
+      - name: Prepare po4a configuration
+        run: _translations/prepare-config.sh
+
       - name: Use po4a
         uses: addnab/docker-run-action@v3
         with:
             image: arduanovdanil/po4a-fork:v0.73
-            options: -v ${{ github.workspace }}:/src
-            run: |
-                cd _translations/guide
-                po4a po4a.cfg
-                cd ../cookbook
-                po4a po4a.cfg
+            options: -v ${{ github.workspace }}:/src -w /src/_translations
+            run: po4a po4a.conf && po4a po4a.conf
+
       - name: Commit changed files
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: Update translation
-          file_pattern: '_translations guide cookbook'
+          file_pattern: '_translations src'

.gitignore

@@ -16,4 +16,8 @@ Thumbs.db
 .DS_Store
 
 # po4a .mo files
-*.mo
+*.mo
+
+# VitePress
+/node_modules/
+/.vitepress/cache

.nojekyll

@@ -0,0 +1,20 @@
+init:
+	npm install
+
+build:
+	npm run build
+
+preview:
+	npm run preview
+
+dev:
+	npm run dev
+
+po4a:
+	./_translations/prepare-config.sh && \
+	docker run --rm \
+		--user $(shell id -u):$(shell id -g) \
+		-v $(PWD):/src \
+		-w /src/_translations \
+		arduanovdanil/po4a-fork:v0.73 \
+		po4a.conf

Makefile

@@ -0,0 +1,89 @@
+# Spanish translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-10-19 11:34+0000\n"
+"PO-Revision-Date: 2025-10-19 11:34+0000\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: es\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Title #
+#: ../../cookbook/en/README.md
+#, no-wrap
+msgid "Yii3 community cookbook"
+msgstr ""
+
+#. type: Plain text
+#: ../../cookbook/en/README.md
+msgid "Yii3 Community Cookbook is an OpenSource book full of tips and tricks about the [Yii3](https://www.yiiframework.com/)  PHP framework."
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "The Yii community creates the cookbook."
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "Yii core team members curate and edit it."
+msgstr ""
+
+#. type: Plain text
+#: ../../cookbook/en/README.md
+msgid "Feel free to pull-request your own writings. Team members will review it, give feedback and merge the best possible way."
+msgstr ""
+
+#. type: Plain text
+#: ../../cookbook/en/README.md
+#, fuzzy
+#| msgid "We release this guide under the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs)."
+msgid "This book conforms to the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs)."
+msgstr "Esta guía se publica bajo los [Términos de documentación de Yii](https://www.yiiframework.com/license#docs))."
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+#, fuzzy
+#| msgid "[Packages](structure/package.md) +"
+msgid "[Preface](preface.md)"
+msgstr "[Paquetes](structure/package.md)"
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "[Structuring code by use-case with vertical slices](organizing-code/structuring-by-use-case-with-vertical-slices.md)"
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "[Making HTTP requests](making-http-requests.md)"
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "[Disabling CSRF protection](disabling-csrf-protection.md)"
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+#, fuzzy
+#| msgid "[Authentication](security/authentication.md) +"
+msgid "[Sentry integration](sentry-integration.md)"
+msgstr "[Autenticación](security/authentication.md)"
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "[Configuring webservers](configuring-webservers/general.md)"
+msgstr ""
+
+#. type: Bullet: '- '
+#: ../../cookbook/en/README.md
+msgid "[Deploying to Docker Swarm](deployment/docker-swarm.md)"
+msgstr ""