docs(blog): prepare for v0.10 release post (#746)

* docs(blog): prepare for v0.10 release post * Update v0.10.md * Update v0.10.md to refine upgrade instructions and enhance blog features. Added synchronized tab switching and pagination controls, while improving the search experience and table of contents navigation. * Enhance v0.10 release documentation with detailed upgrade instructions and migration guide. Added Tailwind theme variable customization section and clarified breaking changes. Improved clarity on CSS class prefix changes for better user experience. * Update v0.10.md to enhance upgrade instructions, clarify breaking changes, and improve overall readability. Adjusted formatting for consistency and added details on asset management and user experience improvements. * Add notable new features to v0.10.md, including dropdown menu support, enhanced search experience, and blog list pagination. Updated FlexSearch upgrade details for clarity and improved migration guide by removing redundant breaking change notes. * chore: update zh-cn translation * chore: update ja translation * chore: update fa and ja translations * chore: prepare release
2025-08-24 03:37:18 -04:00 · 2025-08-14 23:49:06 +08:00
parent eca7665571
commit ec007d73c0
85 changed files with 4172 additions and 1545 deletions
--- a/exampleSite/content/docs/guide/deploy-site.fa.md
+++ b/exampleSite/content/docs/guide/deploy-site.fa.md
@@ -1,90 +1,92 @@
 ---
-title: به‌کاراندازی سایت
+title: استقرار سایت
 prev: /docs/guide/shortcodes
 next: /docs/advanced
 ---

-Hugo وب‌سایت‌های استاتیک را ایجاد می‌کند و امکان گزینه‌های میزبانی انعطاف‌پذیر را فراهم می‌کند.
- این صفحه راهنماهایی برای به‌کاراندازی سایت هگزترا شما در پلتفرم‌های مختلف ارائه می‌کند.
-
+Hugo وبسایت‌های استاتیک تولید می‌کند که امکان میزبانی انعطاف‌پذیر را فراهم می‌سازد.
+این صفحه راهنماهایی برای استقرار سایت Hextra شما روی پلتفرم‌های مختلف ارائه می‌دهد.

 <!--more-->


-## گیت‌هاب Pages
+## GitHub Pages

-[گیت‌هاب Pages](https://docs.github.com/pages) روشی توصیه شده برای به‌کاراندازی و میزبانی وب‌سایت شما به صورت رایگان است.
+[GitHub Pages](https://docs.github.com/pages) روش توصیه‌شده برای استقرار و میزبانی رایگان وبسایت شماست.

-اگر سایت را با استفاده از [hextra-starter-template](https://github.com/imfing/hextra-starter-template) راه‌اندازی سریع پیاده‌سازی می‌کنید، گردش کار گیت‌هاب Actions را به صورت خارج از جعبه ارائه کرده‌ایم که به‌کاراندازی خودکار در گیت‌هاب Pages  به شما کمک می‌کند.
+اگر سایت را با استفاده از [hextra-starter-template](https://github.com/imfing/hextra-starter-template) راه‌اندازی کرده‌اید، این قالب از پیش یک گردش کار GitHub Actions برای استقرار خودکار در GitHub Pages ارائه می‌دهد.

-{{% details title="پیکربندی گیت‌هاب Actions" closed="true" %}}
+{{% details title="پیکربندی GitHub Actions" closed="true" %}}

-در زیر یک پیکربندی مثال از [hextra-starter-template](https://github.com/imfing/hextra-starter-template) آورده شده است:
+در زیر یک نمونه پیکربندی از [hextra-starter-template](https://github.com/imfing/hextra-starter-template) آمده است:

 ```yaml {filename=".github/workflows/pages.yaml"}
-# Sample workflow for building and deploying a Hugo site to GitHub Pages
-name: Deploy Hugo site to Pages
+# نمونه گردش کار برای ساخت و استقرار یک سایت Hugo در GitHub Pages
+name: استقرار سایت Hugo در Pages

 on:
-  # Runs on pushes targeting the default branch
+  # در push به شاخه پیش‌فرض اجرا می‌شود
  push:
    branches: ["main"]

-  # Allows you to run this workflow manually from the Actions tab
+  # امکان اجرای دستی این گردش کار از تب Actions
  workflow_dispatch:

-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+# تنظیم مجوزهای GITHUB_TOKEN برای امکان استقرار در GitHub Pages
 permissions:
  contents: read
  pages: write
  id-token: write

-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+# اجازه فقط یک استقرار همزمان، رد کردن اجراهای در صف بین اجرای در حال انجام و آخرین صف
+# با این حال، اجراهای در حال انجام را لغو نکنید زیرا می‌خواهیم این استقرارها کامل شوند.
 concurrency:
  group: "pages"
  cancel-in-progress: false

-# Default to bash
+# پیش‌فرض bash
 defaults:
  run:
    shell: bash

 jobs:
-  # Build job
+  # کار ساخت
  build:
    runs-on: ubuntu-latest
    env:
-      HUGO_VERSION: 0.117.0
+      HUGO_VERSION: 0.147.7
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
-          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
-      - name: Setup Go
-        uses: actions/setup-go@v4
+          fetch-depth: 0  # دریافت تمام تاریخچه برای .GitInfo و .Lastmod
+          submodules: recursive
+      - name: راه‌اندازی Go
+        uses: actions/setup-go@v5
        with:
-          go-version: '1.21'
-      - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v2
-        with:
-          hugo-version: '0.117.0'
-          extended: true
-      - name: Build with Hugo
+          go-version: '1.22'
+      - name: راه‌اندازی Pages
+        id: pages
+        uses: actions/configure-pages@v4
+      - name: راه‌اندازی Hugo
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: ساخت با Hugo
        env:
-          # For maximum backward compatibility with Hugo modules
+          # برای حداکثر سازگاری با ماژول‌های Hugo
          HUGO_ENVIRONMENT: production
          HUGO_ENV: production
        run: |
          hugo \
            --gc --minify \
-            --baseURL "https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/"
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v2
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
+      - name: آپلود آرتیفکت
+        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

-  # Deployment job
+  # کار استقرار
  deploy:
    environment:
      name: github-pages
@@ -92,22 +94,22 @@ jobs:
    runs-on: ubuntu-latest
    needs: build
    steps:
-      - name: Deploy to GitHub Pages
+      - name: استقرار در GitHub Pages
        id: deployment
-        uses: actions/deploy-pages@v2
+        uses: actions/deploy-pages@v4
 ```

 {{% /details %}}


 {{< callout >}}
-  در تنظیمات مخزن خود، **Pages** > **Build and deployment** > **Source** را روی **GitHub Actions** تنظیم کنید:
+  در تنظیمات مخزن، بخش **Pages** > **Build and deployment** > **Source** را روی **GitHub Actions** تنظیم کنید:
  ![](https://user-images.githubusercontent.com/5097752/266784808-99676430-884e-42ab-b901-f6534a0d6eee.png)
 {{< /callout >}}

-به‌طور پیش‌فرض، گردش کار گیت‌هاب Actions بالا `.github/workflows/pages.yaml` فرض می‌کند که سایت در حال به‌کاراندازی در `https://<USERNAME>.github.io/<REPO>/` است.
+به طور پیش‌فرض، گردش کار GitHub Actions فوق `.github/workflows/pages.yaml` فرض می‌کند که سایت در `https://<USERNAME>.github.io/<REPO>/` مستقر می‌شود.

-اگر در حال استفاده از `https://<USERNAME>.github.io/` هستید، سپس `--baseURL` را تغییر دهید:
+اگر در `https://<USERNAME>.github.io/` مستقر می‌کنید، `--baseURL` را اصلاح کنید:

 ```yaml {filename=".github/workflows/pages.yaml",linenos=table,linenostart=54,hl_lines=[4]}
 run: |
@@ -116,47 +118,47 @@ run: |
    --baseURL "https://${{ github.repository_owner }}.github.io/"
 ```

-اگر می‌خواهید روی دامنه شخصی خود استقرار پیدا کند، لطفا مقدار `--baseURL` را بر این اساس تغییر دهید.
+اگر در دامنه خود مستقر می‌کنید، لطفاً مقدار `--baseURL` را متناسب با آن تغییر دهید.


-## کلودفلر Pages
+## Cloudflare Pages

-1. کد منبع سایت خود را در یک مخزن Git (به عنوان مثال گیت‌هاب) قرار دهید
-2. وارد [پیشخوان کلودفلر](https://dash.cloudflare.com/) شوید و حساب خود را انتخاب کنید
-3. در صفحه اصلی حساب‌کاربری، **Workers & Pages** > **Create application** > **Pages** > **Connect to Git** را انتخاب کنید
-4. مخزن را انتخاب کنید و در بخش Set up builds and Deployments اطلاعات زیر را وارد کنید:
+1. کد منبع سایت را در یک مخزن Git (مثلاً GitHub) قرار دهید.
+2. به [داشبورد Cloudflare](https://dash.cloudflare.com/) وارد شوید و حساب خود را انتخاب کنید.
+3. در صفحه اصلی حساب، **Workers & Pages** > **Create application** > **Pages** > **Connect to Git** را انتخاب کنید.
+4. مخزن را انتخاب کنید و در بخش **Set up builds and deployments** اطلاعات زیر را ارائه دهید:

-| Configuration     | Value                |
-| ----------------- | -------------------- |
-| Production branch | `main`               |
-| Build command     | `hugo --gc --minify` |
-| Build directory   | `public`             |
+| تنظیمات          | مقدار                |
+| ---------------- | -------------------- |
+| شاخه تولید      | `main`               |
+| دستور ساخت      | `hugo --gc --minify` |
+| دایرکتوری ساخت  | `public`             |

 برای جزئیات بیشتر، بررسی کنید:
- [یک سایت هیوگو راه‌اندازی کنید.](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site/#deploy-with-cloudflare-pages).
- [پشتیبانی زبان و ابزار.](https://developers.cloudflare.com/pages/platform/language-support-and-tools/).
+- [استقرار یک سایت Hugo](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site/#deploy-with-cloudflare-pages).
+- [پشتیبانی زبان و ابزارها](https://developers.cloudflare.com/pages/platform/language-support-and-tools/).


 ## Netlify

-1. کد خود را به مخزن Git خود (گیت‌هاب، گیت‌لب و غیره) ارسال کنید.
-2. [وارد کردن پروژه](https://app.netlify.com/start) به Netlify
+1. کد خود را به مخزن Git (GitHub, GitLab و غیره) push کنید.
+2. [پروژه را به Netlify وارد کنید](https://app.netlify.com/start).
 3. اگر از [hextra-starter-template][hextra-starter-template] استفاده نمی‌کنید، موارد زیر را به صورت دستی پیکربندی کنید:
-   - دستور Build را روی `hugo --gc --minify` پیکربندی کنید
-   - دایرکتوری Publish را برای `public` مشخص کنید
-   - `HUGO_VERSION` متغیر محیط استقرار را اضافه کنید و روی `0.119.0` تنظیم کنید
-4. استقرار!
+   - دستور ساخت را روی `hugo --gc --minify` تنظیم کنید.
+   - دایرکتوری انتشار را روی `public` مشخص کنید.
+   - متغیر محیطی `HUGO_VERSION` را اضافه کرده و روی `0.147.7` تنظیم کنید، یا آن را در فایل `netlify.toml` مشخص کنید.
+4. استقرار دهید!

-برای جزئیات بیشتر [Hugo را در Netlify](https://docs.netlify.com/integrations/frameworks/hugo/) بررسی کنید.
+برای جزئیات بیشتر، [Hugo در Netlify](https://docs.netlify.com/integrations/frameworks/hugo/) را بررسی کنید.


 ## Vercel

-1. کد خود را به مخزن Git خود (گیت‌هاب، گیت‌لب و غیره) ارسال کنید.
-2. به [پیشخوان Vercel](https://vercel.com/dashboard) بروید و پروژه Hugo خود را وارد کنید
-3. پروژه را پیکربندی کنید، Hugo را به‌ عنوان چارچوب Preset انتخاب کنید
-4. دستور Build و Install را لغو کنید:
-   1. دستور Build را روی `hugo --gc --minify` تنظیم کنید
-   2. دستور Install را روی `yum install golang` تنظیم کنید
+1. کد خود را به مخزن Git (GitHub, GitLab و غیره) push کنید.
+2. به [داشبورد Vercel](https://vercel.com/dashboard) بروید و پروژه Hugo خود را وارد کنید.
+3. پروژه را پیکربندی کنید، Hugo را به عنوان پیش‌تنظیم فریمورک انتخاب کنید.
+4. دستور ساخت و دستور نصب را بازنویسی کنید:
+   1. دستور ساخت را روی `hugo --gc --minify` تنظیم کنید.
+   2. دستور نصب را روی `yum install golang` تنظیم کنید.

-![پیکربندی استقرار Vercel](https://github.com/imfing/hextra/assets/5097752/887d949b-8d05-413f-a2b4-7ab92192d0b3)
+![پیکربندی استقرار Vercel](https://github.com/imfing/hextra/assets/5097752/887d949b-8d05-413f-a2b4-7ab92192d0b3)