基础教程已更新完毕！

kingmo888 · kingmo888 · commit 22f42fa26830 · 2024-08-14T09:42:15.000+08:00
diff --git a/docs/zh/docs/tutorials/basic/Inheritance.md b/docs/zh/docs/tutorials/basic/Inheritance.md
@@ -22,21 +22,42 @@ class MyHomeAdmin(admin.HomeAdmin):
         # 获取默认页面
         page = await super().get_page(request)
         # 自定义修改
-        page.body.title = 'MyHome'
+        # page.body.title = 'MyHome' # page.body已改为list类型，该行废弃
+        # 修改后台首页的内页标题
+        page.title = 'MyHome'
+        # 后台首页主体尾部追加内容
+        page.body.append('welcome FastApi-AMIS')
         ...
         return page
 ```
 
 ## 示例-2(自定义模板管理基类)
 
+根目录`templates`文件夹中新建`element.html`，html内容如下：
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ title }}</title>
+</head>
+<body>
+    <h1>{{ title }}</h1>
+    <p>The current time is: {{ current_time }}</p>
+</body>
+</html>
+```
+
+main.py增加如下代码：
 ```python linenums="1" hl_lines="6 7 11 20"
 import datetime
 
 from fastapi_amis_admin import admin, amis
 
 
 class MyJinja2Admin(admin.TemplateAdmin):
-    templates: Jinja2Templates = Jinja2Templates(directory='apps/demo/templates')
+    templates: Jinja2Templates = Jinja2Templates(directory='templates')
 
 
 @site.register_admin
@@ -53,9 +74,44 @@ class ElementTemplateAdmin(MyJinja2Admin):
     page_schema = amis.PageSchema(label='ElementUI', icon='fa fa-link')
     template_name = 'element.html'
 
-```
+    async def get_page(self, request: Request) -> Dict[str, Any]:
+        page = await super().get_page(request)
+        # 有别于示例1中 admin.HomeAdmin 对page的修改，这里的page来自 admin.TemplateAdmin，是一个dict
+        page['title'] = 'Element Title'  # 该行不会生效
+        return {'current_time': datetime.datetime.now(), 'title': 'Element Content'}
 
+```
 ## 示例-3(重用模型管理类)
+我们在*模型管理*-示例2的基础上进行改造，将`Article`类新增一行属性`is_active: bool = False  # add`,如下：
+```python linenums="1" hl_lines="32"
+class Article(Base):
+    __tablename__ = 'article'
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
+    title: Mapped[str] = mapped_column(String(200), nullable=False)
+    description: Mapped[str] = mapped_column(String(400), default='')
+    status: Mapped[bool] = mapped_column(Boolean, default=False)
+    content: Mapped[str] = mapped_column(String, nullable=False)
+    category_id: Mapped[Optional[int]] = mapped_column(Integer, ForeignKey('category.id'))
+    is_active: bool = False  # add
+
+```
+然后我们继承原油`ArticleAdmin`重新实现一个新的page类别：
+```python
+@site.register_admin
+class ActiveArticle(ArticleAdmin):
+    """继承重用`ArticleAdmin`;此示例较为简单,实际应用可能比较复杂."""
+    page_schema = PageSchema(label='文章管理(已激活)', icon='fa fa-file')
+    # 自定义路由前缀
+    router_prefix = '/article.active'
+
+    # 重写基础选择器
+    async def get_select(self, request: Request) -> Select:
+        stmt = await super().get_select(request)
+        return stmt.where(Article.is_active == True)
+```
+此时，page中将分别有`文章管理`以及`文章管理(已激活)`，后者将只显示`is_active`为True的文章。
+## ~~~示例-3(重用模型管理类)~~~
 
 ```python linenums="1" hl_lines="32"
 from fastapi_amis_admin import admin
diff --git a/docs/zh/docs/tutorials/basic/i18n.md b/docs/zh/docs/tutorials/basic/i18n.md
@@ -4,24 +4,16 @@
 
 - 系统默认内置支持语言有:`en_US`,`zh_CN`.其他语言拓展,参考[Amis多语言](https://aisuda.bce.baidu.com/amis/zh-CN/docs/extend/i18n).
 - 从 0.1.1 版本开始系统默认语言依次尝试设置环境变量`LANGUAGE`/`LANG` > 操作系统默认语言 > 英文`en_US`.
-- 可通过在项目入口文件顶部添加如下代码,进行自由切换语言.例如:
+- 可通过在项目入口文件顶部添加如下代码,进行自由切换语言。
 
+在本案例中，可以直接在`adminsite.py`头部添加
 ```python  linenums="1" hl_lines="1 2"
 from fastapi_amis_admin import i18n
 i18n.set_language(language='zh_CN')
+```
+根据自身需要来设置`language`，目前项目中支持：
+ - zh_CN
+ - en_US
+ - de_DE
 
-from fastapi_amis_admin.admin import AdminSite,Settings
-
-from fastapi_amis_admin.amis.components import PageSchema
-
-# 创建AdminSite实例
-site = AdminSite(settings=admin.Settings(database_url_async='sqlite+aiosqlite:///amisadmin.db'))
-
-# 注册管理类
-@site.register_admin
-class GitHubIframeAdmin(admin.IframeAdmin):
-    # 设置页面菜单信息
-    page_schema = PageSchema(label='AmisIframeAdmin', icon='fa fa-github')
-    # 设置跳转链接
-    src = 'https://github.com/amisadmin/fastapi_amis_admin'
-```
+项目国际化翻译文件路径位于`fastapi_amis_admin\locale`，可依据自身需要增加语言文件夹，并通过修改po文件后生成mo文件。
