-
## Widgets
Textual's library of [widgets](https://textual.textualize.io/widget_gallery/) covers everything from buttons, tree controls, data tables, inputs, text areas, and more…
@@ -76,13 +97,13 @@ Predefined themes ensure your apps will look good out of the box.
-
-## Installing
-
-Install Textual via pip:
-
-```
-pip install textual textual-dev
-```
-
-See [getting started](https://textual.textualize.io/getting_started/) for details.
-
-
-
-
## Demo
@@ -154,8 +160,6 @@ Or try the [textual demo](https://github.com/textualize/textual-demo) *without*
uvx --python 3.12 textual-demo
```
-
-
## Dev Console
## Command Palette
@@ -181,7 +184,6 @@ It is easy to extend the command palette with [custom commands](https://textual.
-
# Textual ❤️ Web
@@ -203,9 +205,7 @@ Since Textual apps have low system requirements, you can install them anywhere P
No desktop required!
-
-
-
## Join us on Discord
Join the Textual developers and community on our [Discord Server](https://discord.gg/Enf6Z3qhVr).
+
diff --git a/README.zh.md b/README.zh.md
new file mode 100644
index 0000000000..1929f5f5c6
--- /dev/null
+++ b/README.zh.md
@@ -0,0 +1,207 @@
+
+
+[](https://discord.gg/Enf6Z3qhVr)
+[](https://pypi.org/project/textual/)
+[](https://badge.fury.io/py/textual)
+
+
+
+
+# Textual
+
+使用简单的Python API构建终端和Web双平台用户界面。Textual结合了现代Python特性和Web开发的最佳实践，提供高效的跨平台应用开发体验。
+
+## 项目特点
+- 🖥️ 终端+浏览器双渲染引擎 - 一次开发，多端部署
+- 🧩 50+内置组件 - 按钮/表格/树形控件等开箱即用
+- 🎨 主题系统 - 内置多套UI主题，支持自定义样式
+- 🛠️ 开发者工具 - 实时调试终端应用
+- ⚡ 异步核心 - 原生支持async/await语法
+
+需要更多示例？请查看[示例目录](https://github.com/Textualize/textual/tree/main/examples)。
+
+## 安装指南
+
+### 前置条件：
+- Python 3.10+
+- 终端要求：支持TrueColor的终端（如Windows Terminal/iTerm2）
+
+通过pip安装Textual：
+
+```
+pip install textual
+```
+
+开发工具包：
+
+```
+pip install textual textual-dev
+```
+
+```python
+
+
+## 快速入门
+
+"""
+显示当前时间的应用
+"""
+
+from datetime import datetime
+from textual.app import App, ComposeResult
+from textual.widgets import Digits
+
+
+class ClockApp(App):
+ CSS = """
+ Screen { align: center middle; }
+ Digits { width: auto; }
+ """
+
+ def compose(self) -> ComposeResult:
+ yield Digits("")
+
+ def on_ready(self) -> None:
+ self.update_clock()
+ self.set_interval(1, self.update_clock)
+
+ def update_clock(self) -> None:
+ clock = datetime.now().time()
+ self.query_one(Digits).update(f"{clock:%T}")
+
+
+if __name__ == "__main__":
+ app = ClockApp()
+ app.run()
+
+
+
+>[!TIP]
+>Textual底层是异步框架。这意味着您可以将应用与异步库集成——如果您需要的话。
+>如果您不想或不需要使用异步，Textual不会强制您使用。
+
+
+## 组件库
+
+Textual的组件库包含按钮、树形控件、数据表格、输入框、文本区域等等...
+结合灵活的布局系统，您可以实现任何需要的用户界面。
+
+预定义的主题确保您的应用开箱即用，简便美观。
+
+
+| + +  + + | + ++ + + + | + +
| ! + + [数据表格](images/screenshot4.gif) + + | + ++ + + + | + +
| + + + + | + ++ + + + | + + +
^k2m
zmomPO4s_MV$nyxdFPI79TDf2PNpwiEKt7&W#Ag)sEt2~uVopw!x|$IZm~_c;?f{kd
znH3_}I}`{{;T>%K5V;rgVm6T44OoKehP<)=6IMa#Pe8I2bm)U52r*|3SiBIXaDo-;
zxdxr?VG?)1gdj8=>1P3#5{f`>XT@8iPy*ve2QFY#-ggLR23a}h2Ud`6RsaRprU!K3
z1d=cWbZ`eUl?akRNq=An-82CiRSAS31&&r+41ouQ=6=bv0a>>Ob+CcZG-oXm2v~Lq
zcK`)`kb2Be2$aMManN4fRtd~738+;9#Kl|4w0MMYY82prK4uE`)ORK}eRjY|h!6*i
zKz7Uk2_7T`hH!s(-~wRCY9){e3P%SYrc@*52gsCRJID%Q)rBgEcw9(+>jp`jP-vr8
z3XM>Iac~EZ5Pvnres{o4fKY}|fO~fT0EAEYQBswAE|7jw5L%6pejjLq6Of3I;Dw36
ziMZqfjL-;nM+uoUgBYlR92ioVfMQEGR>1Xh0A~t`unEoNZ-9VtrzLQ%1QEzqb~{iA
z>gEJ8_=SKl34%a%5eA4)f&!($cxzOGn_vZTKwFdch`9K6S62|9ux`25SgY6y>X%m}
zSPCYHf}=nsV)%)61_-0~OaYitU6*W2H3X4>dm?xVP+$rpI0S~!g=Uoszi1GRU