Translation in Post#

Here is a simple routing illustration for using multi language for posts:

1
src/content/posts/
2
├── post-1.md
3
├── post-2/
4
    ├── index.md
5
    └── cover.webp
6
├── post-3.md
7
├── ja/
8
    ├── post-1.md
9
    └── post-2/
10
        ├── index.md
11
        └── cover.webp
12
└── zh-CN/
13
    └── post-1.md

In root of posts directory, it uses the default language (siteConfig.lang) for posts. Create a new directory for locale tag like ja/, zh-CN, etc. The Markdown filename for post must match across languages to link translation. The system will do the rest.

src/config.ts:

1
export const siteConfig: SiteConfig = {
2
  lang: "en", // default locale
3
  supportedLangs: ["en", "ja", "zh_CN"], // selected locales in website
4
};

siteConfig.SupportedLangs list (src/types/config.ts):

1
export type ConfigLang =
2
  | "en"
3
  | "zh_CN"
4
  | "zh_TW"
5
  | "ja"
6
  | "ko"
7
  | "es"
8
  | "th"
9
  | "vi"
10
  | "tr"
11
  | "id"
12
  | "fr"
13
  | "fa";

Supported Locales:

See posts/translation-example. (Shows English as default, Japanese, and Simplified Chinese for example)

And see ja/posts/guide. (For translation with cover image)

Translation in About & Friends Pages#

The spec content follows the exact same pattern as post

1
src/content/spec/
2
├── about.md
3
├── friends.md
4
├── ja/
5
    ├── about.md
6
    └── friends.md
7
└── zh-CN/
8
    ├── about.md
9
    └── friends.md

See about and friends. (English, Japanese, and Simplified Chinese)

NOTE

rtl (right to left) system for Persian (Farsi) translation not set up properly.