|
|
# 导入Django URL路由核心模块，用于定义路由规则
|
|
|
from django.urls import path
|
|
|
# 导入Django缓存装饰器，用于为视图添加页面缓存（提升访问性能）
|
|
|
from django.views.decorators.cache import cache_page
|
|
|
|
|
|
# 从当前应用（blog）导入视图模块，路由将映射到对应的视图类/函数
|
|
|
from . import views
|
|
|
|
|
|
# 定义应用命名空间（app_name）：用于模板URL反向解析时区分不同应用的路由
|
|
|
# 示例：模板中使用 {% url 'blog:index' %} 反向生成首页URL
|
|
|
app_name = "blog"
|
|
|
|
|
|
# 定义URL路由列表：每个path对应一个路由规则，按匹配优先级排序
|
|
|
urlpatterns = [
|
|
|
# 1. 首页路由：匹配根路径（空字符串）
|
|
|
path(
|
|
|
r'', # 路由路径：根路径（网站首页）
|
|
|
views.IndexView.as_view(), # 关联视图：IndexView类视图的as_view()方法（类视图转为可调用视图）
|
|
|
name='index'), # 路由名称：用于反向解析，名称为'index'
|
|
|
|
|
|
# 2. 分页首页路由：匹配带页码的首页（如/page/2/）
|
|
|
path(
|
|
|
r'page/<int:page>/', # 路由路径：<int:page>为路径参数，int指定参数类型为整数，page为参数名
|
|
|
views.IndexView.as_view(), # 复用首页视图类，视图会通过page参数处理分页逻辑
|
|
|
name='index_page'), # 路由名称：用于反向解析分页首页，名称为'index_page'
|
|
|
|
|
|
# 3. 文章详情页路由（按ID匹配）：匹配带发布日期和文章ID的URL（如/article/2025/11/5/10.html）
|
|
|
path(
|
|
|
r'article/<int:year>/<int:month>/<int:day>/<int:article_id>.html', # 路径参数：年、月、日（整数）、文章ID（整数）
|
|
|
views.ArticleDetailView.as_view(), # 关联文章详情视图类
|
|
|
name='detailbyid'), # 路由名称：用于反向解析文章详情页，名称为'detailbyid'
|
|
|
|
|
|
# 4. 分类详情页路由：匹配分类slug对应的页面（如/category/python.html）
|
|
|
path(
|
|
|
r'category/<slug:category_name>.html', # 路径参数：<slug:category_name>，slug类型支持字母、数字、连字符、下划线
|
|
|
views.CategoryDetailView.as_view(), # 关联分类详情视图类
|
|
|
name='category_detail'), # 路由名称：用于反向解析分类首页，名称为'category_detail'
|
|
|
|
|
|
# 5. 分类分页路由：匹配带页码的分类页（如/category/python/3.html）
|
|
|
path(
|
|
|
r'category/<slug:category_name>/<int:page>.html', # 路径参数：分类slug + 分页页码（整数）
|
|
|
views.CategoryDetailView.as_view(), # 复用分类详情视图类，处理分页逻辑
|
|
|
name='category_detail_page'), # 路由名称：用于反向解析分类分页，名称为'category_detail_page'
|
|
|
|
|
|
# 6. 作者文章列表路由：匹配作者名称对应的文章列表页（如/author/liangliangyy.html）
|
|
|
path(
|
|
|
r'author/<author_name>.html', # 路径参数：author_name（字符串类型，默认不限制字符，匹配作者用户名）
|
|
|
views.AuthorDetailView.as_view(), # 关联作者文章列表视图类
|
|
|
name='author_detail'), # 路由名称：用于反向解析作者首页，名称为'author_detail'
|
|
|
|
|
|
# 7. 作者文章分页路由：匹配带页码的作者文章列表页（如/author/liangliangyy/2.html）
|
|
|
path(
|
|
|
r'author/<author_name>/<int:page>.html', # 路径参数：作者名称 + 分页页码（整数）
|
|
|
views.AuthorDetailView.as_view(), # 复用作者文章列表视图类，处理分页逻辑
|
|
|
name='author_detail_page'), # 路由名称：用于反向解析作者分页，名称为'author_detail_page'
|
|
|
|
|
|
# 8. 标签详情页路由：匹配标签slug对应的文章列表页（如/tag/django.html）
|
|
|
path(
|
|
|
r'tag/<slug:tag_name>.html', # 路径参数：<slug:tag_name>，标签的URL友好标识
|
|
|
views.TagDetailView.as_view(), # 关联标签详情视图类
|
|
|
name='tag_detail'), # 路由名称：用于反向解析标签首页，名称为'tag_detail'
|
|
|
|
|
|
# 9. 标签分页路由：匹配带页码的标签文章列表页（如/tag/django/4.html）
|
|
|
path(
|
|
|
r'tag/<slug:tag_name>/<int:page>.html', # 路径参数：标签slug + 分页页码（整数）
|
|
|
views.TagDetailView.as_view(), # 复用标签详情视图类，处理分页逻辑
|
|
|
name='tag_detail_page'), # 路由名称：用于反向解析标签分页，名称为'tag_detail_page'
|
|
|
|
|
|
# 10. 文章归档页路由：匹配archives.html路径（如/archives.html）
|
|
|
path(
|
|
|
'archives.html', # 路由路径：固定为'archives.html'
|
|
|
cache_page(60 * 60)(views.ArchivesView.as_view()), # 添加页面缓存：缓存60*60=3600秒（1小时），提升访问性能
|
|
|
name='archives'), # 路由名称：用于反向解析归档页，名称为'archives'
|
|
|
|
|
|
# 11. 友情链接页路由：匹配links.html路径（如/links.html）
|
|
|
path(
|
|
|
'links.html', # 路由路径：固定为'links.html'
|
|
|
views.LinkListView.as_view(), # 关联友情链接列表视图类
|
|
|
name='links'), # 路由名称：用于反向解析友情链接页，名称为'links'
|
|
|
|
|
|
# 12. 文件上传接口路由：匹配'upload'路径（如/upload）
|
|
|
path(
|
|
|
r'upload', # 路由路径：固定为'upload'（无后缀）
|
|
|
views.fileupload, # 关联文件上传视图函数（非类视图，直接关联函数）
|
|
|
name='upload'), # 路由名称：用于反向解析上传接口，名称为'upload'
|
|
|
|
|
|
# 13. 清理缓存接口路由：匹配'clean'路径（如/clean）
|
|
|
path(
|
|
|
r'clean', # 路由路径：固定为'clean'（无后缀）
|
|
|
views.clean_cache_view, # 关联清理缓存视图函数
|
|
|
name='clean'), # 路由名称：用于反向解析清理缓存接口，名称为'clean'
|
|
|
] |
