"""Django博客项目的主URL配置文件

这个文件定义了整个博客系统的URL路由规则，将不同的URL路径映射到对应的视图函数或类。
主要包含以下功能模块的URL配置：
- 博客文章相关页面
- 用户账户管理
- 评论系统
- OAuth登录
- 搜索功能
- 管理后台
- 静态文件服务

更多信息请参考：
    https://docs.djangoproject.com/en/1.10/topics/http/urls/
"""
from django.conf import settings
from django.conf.urls.i18n import i18n_patterns  # 国际化URL模式
from django.conf.urls.static import static  # 静态文件服务
from django.contrib.sitemaps.views import sitemap  # 站点地图
from django.urls import path, include
from django.urls import re_path
from haystack.views import search_view_factory  # 搜索视图工厂

from blog.views import EsSearchView
from djangoblog.admin_site import admin_site  # 自定义管理后台
from djangoblog.elasticsearch_backend import ElasticSearchModelSearchForm
from djangoblog.feeds import DjangoBlogFeed  # RSS订阅源
from djangoblog.sitemap import ArticleSiteMap, CategorySiteMap, StaticViewSitemap, TagSiteMap, UserSiteMap

# 站点地图配置，用于SEO优化
sitemaps = {
    'blog': ArticleSiteMap,      # 文章站点地图
    'Category': CategorySiteMap, # 分类站点地图
    'Tag': TagSiteMap,          # 标签站点地图
    'User': UserSiteMap,        # 用户站点地图
    'static': StaticViewSitemap # 静态页面站点地图
}

# 错误页面处理器
handler404 = 'blog.views.page_not_found_view'    # 404错误页面
handler500 = 'blog.views.server_error_view'      # 500错误页面
handle403 = 'blog.views.permission_denied_view'  # 403权限拒绝页面

# 基础URL模式（不包含语言前缀）
urlpatterns = [
    path('i18n/', include('django.conf.urls.i18n')),  # 国际化切换
]

# 带语言前缀的URL模式
urlpatterns += i18n_patterns(
    re_path(r'^admin/', admin_site.urls),  # 管理后台
    re_path(r'', include('blog.urls', namespace='blog')),  # 博客相关页面
    re_path(r'mdeditor/', include('mdeditor.urls')),  # Markdown编辑器
    re_path(r'', include('comments.urls', namespace='comment')),  # 评论系统
    re_path(r'', include('accounts.urls', namespace='account')),  # 用户账户
    re_path(r'', include('oauth.urls', namespace='oauth')),  # OAuth登录
    re_path(r'^sitemap\.xml$', sitemap, {'sitemaps': sitemaps},
            name='django.contrib.sitemaps.views.sitemap'),  # 站点地图
    re_path(r'^feed/$', DjangoBlogFeed()),  # RSS订阅源
    re_path(r'^rss/$', DjangoBlogFeed()),  # RSS订阅源（别名）
    re_path('^search', search_view_factory(view_class=EsSearchView, form_class=ElasticSearchModelSearchForm),
            name='search'),  # 搜索功能
    re_path(r'', include('servermanager.urls', namespace='servermanager')),  # 服务器管理
    re_path(r'', include('owntracks.urls', namespace='owntracks')),  # 位置追踪
    prefix_default_language=False) + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

# 开发环境下提供媒体文件服务
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL,
                          document_root=settings.MEDIA_ROOT)
