Localization of The Tile Language Documentation

[hwhsu1231]

Introduction

Hello, TileLang Community,

I’m glad to announce that the 🎉 tilelang-docs-l10n 🎉 project is published now:

• 🚀 Preview: tilelang-docs-l10n
• 🌐 Crowdin: tilelang-docs-l10n
• 🐙 GitHub: tilelang-docs-l10n

The goal of this project is to translate the Tile Language Documentation into multiple languages. Translations are contributed via the Crowdin platform, automatically synchronized with the GitHub repository, and can be previewed on GitHub Pages.

AFAIK, TileLang's core team members are primarily from Peking University, and it is being used by DeepSeek. Therefore, there should be a considerable number of native Chinese speakers among its users. Currently, Tile Language documentation is written in English as the source language, so I believe that the tilelang-docs-l10n project would greatly help in promoting TileLang.

How to Reuse Translations

If the upstream project or anyone wants to reuse the translated .po files prepared by the tilelang-docs-l10n project, they can clone the .po files from the po/${VERSION} branch by using the following command:

git clone --depth=1 --branch=po/${VERSION} https://github.com/localizethedocs/tilelang-docs-l10n.git locale

Those po/${VERSION} branches are created to facilitate reusage by the upstream project. For instance, the zh_TW documentation for the latest version can be generated using the commands below:

BRANCH=main
VERSION=latest
LANGUAGE=zh_TW

# Prepare the repository and environment
git clone --branch=${BRANCH} --depth=1 https://github.com/tile-ai/tilelang.git tilelang-docs
cd tilelang-docs
conda create --prefix ./.conda --yes
conda activate ./.conda
conda install conda-forge::python=3.12 --channel conda-forge --yes
export PYTHONNOUSERSITE=1
pip install -r docs/requirements.txt

# Clone the .po files to the 'locale' directory
git clone --branch=po/${VERSION} --depth=1 https://github.com/localizethedocs/tilelang-docs-l10n.git docs/locale

# Build the documentation
sphinx-build -b html \
    -D language=${LANGUAGE} \
    -D locale_dirs=locale \
    -D gettext_compact=0 \
    -D gettext_additional_targets=index,literal-block,raw \
    docs \
    docs/_build/${LANGUAGE}

# Preview the documentation
firefox docs/_build/${LANGUAGE}/index.html