Files
hextra_mirror/exampleSite/content/docs/advanced/multi-language.fa.md
2025-08-14 22:07:15 +08:00

3.0 KiB

title, weight, prev
title weight prev
چند زبانه 1 /docs/advanced

Hextra از ایجاد سایت با چندین زبان با استفاده از حالت چندزبانه هوگو پشتیبانی می‌کند.

فعال‌سازی چندزبانه

برای چندزبانه کردن سایت، باید به هوگو زبان‌های پشتیبانی شده را اطلاع دهیم. باید به فایل پیکربندی سایت اضافه کنیم:

defaultContentLanguage: en
languages:
  en:
    languageName: English
    weight: 1
  fr:
    languageName: Français
    weight: 2
  ja:
    languageName: 日本語
    weight: 3

مدیریت ترجمه‌ها بر اساس نام فایل

هوگو از مدیریت ترجمه‌ها بر اساس نام فایل پشتیبانی می‌کند. به عنوان مثال، اگر فایلی به نام content/docs/_index.md به زبان انگلیسی داریم، می‌توانیم فایل content/docs/_index.fr.md را برای ترجمه فرانسوی ایجاد کنیم.

{{< filetree/container >}} {{< filetree/folder name="content" >}} {{< filetree/folder name="docs" state="open" >}} {{< filetree/file name="_index.md" >}} {{< filetree/file name="_index.fr.md" >}} {{< filetree/file name="_index.ja.md" >}} {{< /filetree/folder >}} {{< /filetree/folder >}} {{< /filetree/container >}}

توجه: هوگو از ترجمه بر اساس دایرکتوری محتوا نیز پشتیبانی می‌کند.

ترجمه آیتم‌های منو

برای ترجمه آیتم‌های منو در نوار ناوبری، باید فیلد identifier را تنظیم کنیم:

menu:
  main:
    - identifier: documentation
      name: Documentation
      pageRef: /docs
      weight: 1
    - identifier: blog
      name: Blog
      pageRef: /blog
      weight: 2

و آن‌ها را در فایل i18n مربوطه ترجمه کنیم:

documentation: Documentation
blog: Blog

ترجمه رشته‌ها

برای ترجمه رشته‌ها در سایر قسمت‌ها، باید ترجمه را به فایل i18n مربوطه اضافه کنیم:

readMore: Lire la suite

لیستی از رشته‌های استفاده شده در قالب را می‌توان در فایل i18n/en.yaml یافت.

مطالعه بیشتر