diff --git a/doc/template_relationship_mermaid.md b/doc/template_relationship_mermaid.md new file mode 100644 index 0000000..cf94670 --- /dev/null +++ b/doc/template_relationship_mermaid.md @@ -0,0 +1,107 @@ +# DjangoBlog模板关系UML图 + +## 模板继承关系图 + +```mermaid +graph TD + A[share_layout/base.html
主基础模板] --> B[blog/article_index.html
文章列表页] + A --> C[blog/article_detail.html
文章详情页] + A --> D[blog/article_archives.html
文章归档页] + A --> E[blog/links_list.html
友链页面] + A --> F[blog/error_page.html
错误页面] + A --> G[search/search.html
搜索页面] + + H[share_layout/base_account.html
账户基础模板] --> I[account/login.html
登录页面] + H --> J[account/registration_form.html
注册页面] + H --> K[account/forget_password.html
忘记密码页面] + H --> L[account/result.html
结果页面] + H --> M[oauth/require_email.html
邮箱验证页面] +``` + +## 模板包含关系图 + +```mermaid +graph TD + A[share_layout/base.html] --> B[share_layout/nav.html
导航菜单] + A --> C[share_layout/footer.html
页脚] + + D[blog/article_detail.html] --> E[comments/tags/comment_list.html
评论列表] + D --> F[comments/tags/post_comment.html
发表评论] + + B --> G[share_layout/nav_node.html
导航节点] + + E --> H[comments/tags/comment_item_tree.html
评论树] + H --> I[comments/tags/comment_item.html
评论项] +``` + +## 模板与标签关系图 + +```mermaid +graph LR + A[blog_tags.py
博客标签库] --> B[load_article_detail
文章详情标签] + A --> C[load_sidebar
侧边栏标签] + A --> D[load_breadcrumb
面包屑标签] + A --> E[custom_markdown
Markdown过滤器] + + F[comments_tags.py
评论标签库] --> G[show_comment_item
评论项标签] + F --> H[parse_commenttree
评论树解析] + + I[blog/article_index.html] --> A + J[blog/article_detail.html] --> A + K[comments/tags/comment_list.html] --> F +``` + +## 完整模板架构图 + +```mermaid +graph TB + subgraph "基础层" + A[base.html] + B[base_account.html] + end + + subgraph "博客功能层" + C[article_index.html] + D[article_detail.html] + E[article_archives.html] + end + + subgraph "账户层" + F[login.html] + G[register.html] + end + + subgraph "评论层" + H[comment_list.html] + I[comment_item.html] + end + + subgraph "标签层" + J[article_info.html] + K[sidebar.html] + L[breadcrumb.html] + end + + subgraph "模板标签" + M[blog_tags.py] + N[comments_tags.py] + end + + A --> C + A --> D + A --> E + B --> F + B --> G + + D --> H + H --> I + + M --> J + M --> K + M --> L + N --> I + + C --> M + D --> M + H --> N +``` diff --git a/doc/大学生校园日常博客初步UML图.pdf b/doc/大学生校园日常博客初步UML图.pdf new file mode 100644 index 0000000..3b6ebc4 Binary files /dev/null and b/doc/大学生校园日常博客初步UML图.pdf differ diff --git a/doc/大学生校园日常博客初步思维导图.pdf b/doc/大学生校园日常博客初步思维导图.pdf new file mode 100644 index 0000000..e7d962d Binary files /dev/null and b/doc/大学生校园日常博客初步思维导图.pdf differ diff --git a/src/DjangoBlog/blog/models.py b/src/DjangoBlog/blog/models.py index e3e005c..b70c658 100644 --- a/src/DjangoBlog/blog/models.py +++ b/src/DjangoBlog/blog/models.py @@ -1,5 +1,5 @@ -# 这个文件是博客相关的数据模型,定义了博客系统中所有的数据表结构 +# 这个文件里的是博客相关的数据模型,定义了博客系统中所有的数据表结构 import logging import re from abc import abstractmethod