رفتن به محتوا
هگزترا v0.12 منتشر شد! 🎉 تازه‌ها را ببینید
مستندات
پیشرفته
چند زبانه

چند زبانه

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

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

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

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

Note

از Hugo v0.158.0 به بعد، languageName، languageCode و languageDirection منسوخ شده‌اند. برای سایت‌های جدید به‌ترتیب از label، locale و direction استفاده کنید. مستندات تنظیمات زبان‌های Hugo را ببینید.

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

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

      • _index.md
      • _index.fr.md
      • _index.ja.md

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

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

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

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

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

i18n/fr.yaml
documentation: Documentation
blog: Blog

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

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

i18n/fr.yaml
readMore: Lire la suite

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

مطالعه بیشتر

آخرین به‌روزرسانی در
پیشرفتهصفحات اضافی