Skip to content

docs: add Chinese translation for README#116

Open
JasonYeYuhe wants to merge 1 commit intoKittenML:mainfrom
JasonYeYuhe:docs-zh-readme
Open

docs: add Chinese translation for README#116
JasonYeYuhe wants to merge 1 commit intoKittenML:mainfrom
JasonYeYuhe:docs-zh-readme

Conversation

@JasonYeYuhe
Copy link
Copy Markdown

docs: add Chinese translation for README

Description

This PR introduces a high-quality Chinese translation of the README (README.zh.md) and adds a language switcher to the main README.md.

Motivation

Kitten TTS is an impressive lightweight TTS library. Given the rapid growth of edge AI and mobile development in the Chinese developer community, providing localized documentation will help more users integrate this CPU-optimized synthesis engine into their IoT, mobile, and desktop applications.

This translation covers:

  • Core features (ultra-lightweight, CPU-optimized).
  • Model variants and parameter comparisons.
  • Basic and advanced usage examples.
  • API reference and system requirements.

Changes

  • Created README.zh.md with localized terminology.
  • Added English/Chinese language switcher at the top of the main README.

Translated and contributed by @JasonYeYuhe

Copilot AI review requested due to automatic review settings March 22, 2026 08:18
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a Chinese README to make project documentation accessible to Chinese-speaking developers, and updates the main README to link between languages.

Changes:

  • Added README.zh.md with a Chinese translation of the project README content.
  • Added an English/Chinese language switcher line near the top of README.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
README.zh.md New Chinese README translation, including usage/API docs and community links.
README.md Adds a language switcher linking to README.zh.md.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +124 to +135
### `model.generate_to_file(text, output_path, voice, speed, sample_rate, clean_text)`

合成语音并直接写入音频文件。

| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| `text` | `str` | -- | 待合成的输入文本 |
| `output_path` | `str` | -- | 音频文件保存路径 |
| `voice` | `str` | `"expr-voice-5-m"` | 音色名称 |
| `speed` | `float` | `1.0` | 语速倍率 |
| `sample_rate` | `int` | `24000` | 音频采样率 (Hz) |
| `clean_text` | `bool` | `True` | 是否预处理文本 |
Copy link

Copilot AI Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

model.generate_to_file(...) 的文档签名和参数表里包含了 clean_text 参数,但当前 Python API(kittentts/get_model.py 的 KittenTTS.generate_to_file)并不接受该参数;这会导致读者按文档调用时报 TypeError。建议要么在 README 中移除/标注该参数,要么在 API 中补齐并透传到内部实现。

Copilot uses AI. Check for mistakes.

## 社区与支持

- **Discord:** [加入社区](https://discord.gg/VJ86W4SURW)
Copy link

Copilot AI Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

同一份文档里 Discord 邀请链接使用了两种不同格式(上方 badge 是 discord.com/invite/...,这里是 discord.gg/...)。为避免其中一个失效或造成困惑,建议统一为与 README.md / 顶部 badge 相同的链接。

Suggested change
- **Discord:** [加入社区](https://discord.gg/VJ86W4SURW)
- **Discord:** [加入社区](https://discord.com/invite/VJ86W4SURW)

Copilot uses AI. Check for mistakes.

- **Discord:** [加入社区](https://discord.gg/VJ86W4SURW)
- **官网:** [kittenml.com](https://kittenml.com)
- **定制支持:** [申请表单单](https://docs.google.com/forms/d/e/1FAIpQLSc49erSr7jmh3H2yeqH4oZyRRuXm0ROuQdOgWguTzx6SMdUnQ/viewform?usp=preview)
Copy link

Copilot AI Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里的链接文案有重复字:申请表单单。建议更正为 申请表单

Suggested change
- **定制支持:** [申请表单单](https://docs.google.com/forms/d/e/1FAIpQLSc49erSr7jmh3H2yeqH4oZyRRuXm0ROuQdOgWguTzx6SMdUnQ/viewform?usp=preview)
- **定制支持:** [申请表单](https://docs.google.com/forms/d/e/1FAIpQLSc49erSr7jmh3H2yeqH4oZyRRuXm0ROuQdOgWguTzx6SMdUnQ/viewform?usp=preview)

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants