hextra/exampleSite/content/docs/advanced/multi-language.fa.md
Goudarz Jafari 9995617c66
docs(i18n): add Persian translation and support rtl languageDirection (#301)
* feat: add persian translation

* Add Persian translation

* Add fa support, languageDirection method in hugo.yaml

* Add languageDirection method

* Update hugo.yaml

* Update baseof.html
2024-02-19 21:40:50 +00:00

3.1 KiB
Raw Permalink Blame History

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

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

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

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

defaultContentLanguage: en
languages:
  en:
    languageName: English
    weight: 1
  fa:
    languageName: فارسی
    weight: 2
  ja:
    languageName: 日本語
    weight: 3

مدیریت ترجمه‌ها بر اساس نام پرونده

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

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

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

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

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

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

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

documentation: مستندات
blog: وبلاگ

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

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

readMore: ادامه مطلب

فهرستی از رشته‌های استفاده شده در تم را می‌توان در پرونده i18n/en.yaml پیدا کرد.

بیشتر بخوانید