\"), 2)\n\n # 测试多个关键词\n text = \"Django web framework with Python\"\n result = highlight_search_term(text, \"django python\")\n self.assertIn(\"Django \", result)\n self.assertIn(\"Python \", result)\n\n # 测试空查询\n text = \"Some text\"\n result = highlight_search_term(text, \"\")\n self.assertEqual(result, text)\n\n # 测试空文本\n result = highlight_search_term(\"\", \"query\")\n self.assertEqual(result, \"\")\n\n def test_highlight_content_filter(self):\n \"\"\"测试正文高亮filter\"\"\"\n # 测试HTML内容高亮\n html = \"Django is a great web framework. Django makes development easy.
\"\n result = highlight_content(html, \"django\")\n\n # 应该包含高亮标记\n self.assertIn(\"\", result)\n self.assertIn(\" \", result)\n\n # HTML标签应该被去除\n self.assertNotIn(\"\", result)\n\n # 应该包含Django关键词（不区分大小写）\n self.assertIn(\"django\", result.lower())\n\n # 测试空查询\n result = highlight_content(html, \"\")\n self.assertEqual(result, html)\n\n def test_search_page_access(self):\n \"\"\"测试搜索页面访问\"\"\"\n # 测试搜索页面可以正常访问\n response = self.client.get('/search', {'q': 'django'})\n self.assertEqual(response.status_code, 200)\n\n # 检查响应中是否有查询参数\n self.assertIn('query', response.context)\n self.assertEqual(response.context['query'], 'django')\n\n def test_chinese_keyword_highlight(self):\n \"\"\"测试中文关键词高亮\"\"\"\n text = \"这是一个Django博客系统\"\n result = highlight_search_term(text, \"Django\")\n self.assertIn(\"Django \", result)\n\n # 测试中文关键词\n text = \"欢迎使用DjangoBlog系统\"\n result = highlight_search_term(text, \"Django\")\n self.assertIn(\"Django \", result)\n"
},
{
"path": "blog/urls.py",
"content": "from django.urls import path\nfrom django.views.decorators.cache import cache_page\n\nfrom . import views\n\napp_name = \"blog\"\nurlpatterns = [\n path(\n r'',\n views.IndexView.as_view(),\n name='index'),\n path(\n r'page//',\n views.IndexView.as_view(),\n name='index_page'),\n path(\n r'article////.html',\n views.ArticleDetailView.as_view(),\n name='detailbyid'),\n path(\n r'category/.html',\n views.CategoryDetailView.as_view(),\n name='category_detail'),\n path(\n r'category//.html',\n views.CategoryDetailView.as_view(),\n name='category_detail_page'),\n path(\n r'author/.html',\n views.AuthorDetailView.as_view(),\n name='author_detail'),\n path(\n r'author//.html',\n views.AuthorDetailView.as_view(),\n name='author_detail_page'),\n path(\n r'tag/.html',\n views.TagDetailView.as_view(),\n name='tag_detail'),\n path(\n r'tag//.html',\n views.TagDetailView.as_view(),\n name='tag_detail_page'),\n path(\n 'archives.html',\n cache_page(\n 60 * 60)(\n views.ArchivesView.as_view()),\n name='archives'),\n path(\n 'links.html',\n views.LinkListView.as_view(),\n name='links'),\n path(\n r'upload',\n views.fileupload,\n name='upload'),\n path(\n r'clean',\n views.clean_cache_view,\n name='clean'),\n]\n"
},
{
"path": "blog/views.py",
"content": "import logging\nimport os\nimport uuid\n\nfrom django.conf import settings\nfrom django.core.paginator import Paginator\nfrom django.http import HttpResponse, HttpResponseForbidden\nfrom django.shortcuts import get_object_or_404\nfrom django.shortcuts import render\nfrom django.templatetags.static import static\nfrom django.utils import timezone\nfrom django.utils.translation import gettext_lazy as _\nfrom django.views.decorators.csrf import csrf_exempt\nfrom django.views.generic.detail import DetailView\nfrom django.views.generic.list import ListView\nfrom haystack.views import SearchView\n\nfrom blog.models import Article, Category, LinkShowType, Links, Tag\nfrom comments.forms import CommentForm\nfrom djangoblog.plugin_manage import hooks\nfrom djangoblog.plugin_manage.hook_constants import ARTICLE_CONTENT_HOOK_NAME\nfrom djangoblog.utils import cache, get_blog_setting, get_sha256\nfrom djangoblog.mixins import (\n SlugCachedMixin,\n ArticleListMixin,\n OptimizedArticleQueryMixin,\n CachedListViewMixin,\n PageNumberMixin\n)\n\nlogger = logging.getLogger(__name__)\n\n\nclass ArticleListView(CachedListViewMixin, PageNumberMixin, ListView):\n \"\"\"\n 文章列表视图基类（重构版）\n\n 使用 Mixin 简化代码，消除重复逻辑\n 子类只需实现 get_queryset_data() 和 get_queryset_cache_key() 方法\n \"\"\"\n # template_name属性用于指定使用哪个模板进行渲染\n template_name = 'blog/article_index.html'\n\n # context_object_name属性用于给上下文变量取名（在模板中使用该名字）\n context_object_name = 'article_list'\n\n # 页面类型，分类目录或标签列表等\n page_type = ''\n paginate_by = settings.PAGINATE_BY\n page_kwarg = 'page'\n link_type = LinkShowType.L\n\n def get_view_cache_key(self):\n return self.request.get['pages']\n\n def get_context_data(self, **kwargs):\n kwargs['linktype'] = self.link_type\n return super(ArticleListView, self).get_context_data(**kwargs)\n\n\nclass IndexView(OptimizedArticleQueryMixin, ArticleListView):\n \"\"\"\n 首页视图（重构版）\n\n 继承 OptimizedArticleQueryMixin 获得优化的查询方法\n \"\"\"\n # 友情链接类型\n link_type = LinkShowType.I\n\n def get_queryset_data(self):\n # 使用 Mixin 提供的优化查询方法\n return self.get_optimized_article_queryset().filter(\n type='a', status='p'\n )\n\n def get_queryset_cache_key(self):\n return f'index_{self.page_number}'\n\n def get_context_data(self, **kwargs):\n context = super().get_context_data(**kwargs)\n blog_setting = get_blog_setting()\n # 提供基础SEO数据\n context['seo_title'] = f\"{blog_setting.site_name} | {blog_setting.site_description}\"\n context['seo_description'] = blog_setting.site_seo_description\n context['seo_keywords'] = blog_setting.site_keywords\n return context\n\n\nclass ArticleDetailView(DetailView):\n '''\n 文章详情页面\n '''\n template_name = 'blog/article_detail.html'\n model = Article\n pk_url_kwarg = 'article_id'\n context_object_name = \"article\"\n\n def get_context_data(self, **kwargs):\n comment_form = CommentForm()\n\n # 优化：直接查询父评论，减少数据库查询\n from comments.models import Comment\n parent_comments = Comment.objects.filter(\n article=self.object,\n parent_comment=None,\n is_enable=True\n ).select_related('author').prefetch_related(\n 'comment_set__author' # 预加载子评论及其作者\n ).order_by('-id')\n\n # 获取所有评论用于总数显示\n article_comments = self.object.comment_list()\n\n blog_setting = get_blog_setting()\n paginator = Paginator(parent_comments, blog_setting.article_comment_count)\n page = self.request.GET.get('comment_page', '1')\n if not page.isnumeric():\n page = 1\n else:\n page = int(page)\n if page < 1:\n page = 1\n if page > paginator.num_pages:\n page = paginator.num_pages\n\n p_comments = paginator.page(page)\n next_page = p_comments.next_page_number() if p_comments.has_next() else None\n prev_page = p_comments.previous_page_number() if p_comments.has_previous() else None\n\n if next_page:\n kwargs[\n 'comment_next_page_url'] = self.object.get_absolute_url() + f'?comment_page={next_page}#commentlist-container'\n if prev_page:\n kwargs[\n 'comment_prev_page_url'] = self.object.get_absolute_url() + f'?comment_page={prev_page}#commentlist-container'\n kwargs['form'] = comment_form\n kwargs['article_comments'] = article_comments\n kwargs['p_comments'] = p_comments\n kwargs['comment_count'] = len(\n article_comments) if article_comments else 0\n\n kwargs['next_article'] = self.object.next_article\n kwargs['prev_article'] = self.object.prev_article\n\n context = super(ArticleDetailView, self).get_context_data(**kwargs)\n article = self.object\n \n # 添加基础SEO数据\n blog_setting = get_blog_setting()\n from django.utils.html import strip_tags\n from django.utils.text import Truncator\n from djangoblog.utils import CommonMarkdown\n \n # 处理description：markdown -> HTML -> 纯文本，彻底去除格式\n html_content = CommonMarkdown.get_markdown(article.body)\n description = strip_tags(html_content)\n description = ' '.join(description.split()) # 规范化空白字符\n description = Truncator(description).chars(150, truncate='...')\n \n # 处理keywords：去除空格，用逗号分隔\n tags = [tag.name.strip() for tag in article.tags.all()]\n keywords = \", \".join(tags) if tags else blog_setting.site_keywords\n \n context['seo_title'] = f\"{article.title} | {blog_setting.site_name}\"\n context['seo_description'] = description\n context['seo_keywords'] = keywords\n \n # 触发文章详情加载钩子，让插件可以添加额外的上下文数据\n from djangoblog.plugin_manage.hook_constants import ARTICLE_DETAIL_LOAD\n hooks.run_action(ARTICLE_DETAIL_LOAD, article=article, context=context, request=self.request)\n \n # Action Hook, 通知插件\"文章详情已获取\"\n hooks.run_action('after_article_body_get', article=article, request=self.request)\n return context\n\n\nclass CategoryDetailView(SlugCachedMixin, OptimizedArticleQueryMixin, ArticleListView):\n \"\"\"\n 分类目录列表（重构版）\n\n 使用 SlugCachedMixin 避免重复查询 Category\n 使用 OptimizedArticleQueryMixin 优化文章查询\n \"\"\"\n page_type = \"分类目录归档\"\n slug_url_kwarg = 'category_name'\n slug_model = Category\n\n def get_queryset_data(self):\n # 使用 Mixin 缓存的对象，只查询一次\n category = self.get_slug_object()\n categorynames = [c.name for c in category.get_sub_categorys()]\n\n return self.get_optimized_article_queryset().filter(\n category__name__in=categorynames, status='p'\n )\n\n def get_queryset_cache_key(self):\n # 复用缓存的对象，不再重复查询数据库\n category = self.get_slug_object()\n return f'category_list_{category.name}_{self.page_number}'\n\n def get_context_data(self, **kwargs):\n category = self.get_slug_object()\n categoryname = category.name\n\n try:\n categoryname = categoryname.split('/')[-1]\n except BaseException:\n pass\n\n kwargs['page_type'] = CategoryDetailView.page_type\n kwargs['tag_name'] = categoryname\n \n # 添加基础SEO数据\n blog_setting = get_blog_setting()\n article_count = self.get_queryset().count()\n kwargs['seo_title'] = f\"{categoryname} | {blog_setting.site_name}\"\n kwargs['seo_description'] = f\"浏览 {categoryname} 分类下的所有文章，共 {article_count} 篇文章。\"\n kwargs['seo_keywords'] = f\"{categoryname}, {blog_setting.site_keywords}\"\n \n return super(CategoryDetailView, self).get_context_data(**kwargs)\n\n\nclass AuthorDetailView(OptimizedArticleQueryMixin, ArticleListView):\n \"\"\"\n 作者详情页（重构版）\n\n 使用 OptimizedArticleQueryMixin 优化文章查询\n \"\"\"\n page_type = '作者文章归档'\n\n def get_queryset_cache_key(self):\n from uuslug import slugify\n author_name = slugify(self.kwargs['author_name'])\n return f'author_{author_name}_{self.page_number}'\n\n def get_queryset_data(self):\n author_name = self.kwargs['author_name']\n return self.get_optimized_article_queryset().filter(\n author__username=author_name, type='a', status='p'\n )\n\n def get_context_data(self, **kwargs):\n author_name = self.kwargs['author_name']\n kwargs['page_type'] = AuthorDetailView.page_type\n kwargs['tag_name'] = author_name\n \n # 添加基础SEO数据\n blog_setting = get_blog_setting()\n article_count = self.get_queryset().count()\n kwargs['seo_title'] = f\"{author_name} 的文章 | {blog_setting.site_name}\"\n kwargs['seo_description'] = f\"浏览 {author_name} 发表的所有文章，共 {article_count} 篇。\"\n kwargs['seo_keywords'] = f\"{author_name}, {blog_setting.site_keywords}\"\n \n return super(AuthorDetailView, self).get_context_data(**kwargs)\n\n\nclass TagDetailView(SlugCachedMixin, OptimizedArticleQueryMixin, ArticleListView):\n \"\"\"\n 标签列表页面（重构版）\n\n 使用 SlugCachedMixin 避免重复查询 Tag\n 使用 OptimizedArticleQueryMixin 优化文章查询\n \"\"\"\n page_type = '分类标签归档'\n slug_url_kwarg = 'tag_name'\n slug_model = Tag\n\n def get_queryset_data(self):\n # 使用 Mixin 缓存的对象，只查询一次\n tag = self.get_slug_object()\n return self.get_optimized_article_queryset().filter(\n tags__name=tag.name, type='a', status='p'\n )\n\n def get_queryset_cache_key(self):\n # 复用缓存的对象，不再重复查询数据库\n tag = self.get_slug_object()\n return f'tag_{tag.name}_{self.page_number}'\n\n def get_context_data(self, **kwargs):\n tag = self.get_slug_object()\n kwargs['page_type'] = TagDetailView.page_type\n kwargs['tag_name'] = tag.name\n \n # 添加基础SEO数据\n blog_setting = get_blog_setting()\n article_count = self.get_queryset().count()\n kwargs['seo_title'] = f\"{tag.name} | {blog_setting.site_name}\"\n kwargs['seo_description'] = f\"浏览所有关于 {tag.name} 的文章，共 {article_count} 篇内容。\"\n kwargs['seo_keywords'] = f\"{tag.name}, {blog_setting.site_keywords}\"\n \n return super(TagDetailView, self).get_context_data(**kwargs)\n\n\nclass ArchivesView(OptimizedArticleQueryMixin, ArticleListView):\n \"\"\"\n 文章归档页面（重构版）\n\n 使用 OptimizedArticleQueryMixin 优化文章查询\n \"\"\"\n page_type = '文章归档'\n paginate_by = None\n page_kwarg = None\n template_name = 'blog/article_archives.html'\n\n def get_queryset_data(self):\n return self.get_optimized_article_queryset().filter(status='p')\n\n def get_queryset_cache_key(self):\n return 'archives'\n\n\nclass LinkListView(ListView):\n model = Links\n template_name = 'blog/links_list.html'\n\n def get_queryset(self):\n return Links.objects.filter(is_enable=True)\n\n\nclass EsSearchView(SearchView):\n def build_form(self, form_kwargs=None):\n \"\"\"Override to enable highlighting\"\"\"\n if form_kwargs is None:\n form_kwargs = {}\n\n # Enable highlighting for search results\n from haystack.query import SearchQuerySet\n if self.searchqueryset is None:\n sqs = SearchQuerySet().highlight()\n else:\n sqs = self.searchqueryset.highlight()\n\n form_kwargs['searchqueryset'] = sqs\n return super().build_form(form_kwargs=form_kwargs)\n\n def get_context(self):\n paginator, page = self.build_page()\n context = {\n \"query\": self.query,\n \"form\": self.form,\n \"page\": page,\n \"paginator\": paginator,\n \"suggestion\": None,\n }\n if hasattr(self.results, \"query\") and self.results.query.backend.include_spelling:\n context[\"suggestion\"] = self.results.query.get_spelling_suggestion()\n context.update(self.extra_context())\n\n return context\n\n\n@csrf_exempt\ndef fileupload(request):\n \"\"\"\n 该方法需自己写调用端来上传图片，该方法仅提供图床功能\n :param request:\n :return:\n \"\"\"\n if request.method == 'POST':\n sign = request.GET.get('sign', None)\n if not sign:\n return HttpResponseForbidden()\n if not sign == get_sha256(get_sha256(settings.SECRET_KEY)):\n return HttpResponseForbidden()\n response = []\n for filename in request.FILES:\n timestr = timezone.now().strftime('%Y/%m/%d')\n imgextensions = ['jpg', 'png', 'jpeg', 'bmp']\n fname = u''.join(str(filename))\n isimage = len([i for i in imgextensions if fname.find(i) >= 0]) > 0\n base_dir = os.path.join(settings.STATICFILES, \"files\" if not isimage else \"image\", timestr)\n if not os.path.exists(base_dir):\n os.makedirs(base_dir)\n savepath = os.path.normpath(os.path.join(base_dir, f\"{uuid.uuid4().hex}{os.path.splitext(filename)[-1]}\"))\n if not savepath.startswith(base_dir):\n return HttpResponse(\"only for post\")\n with open(savepath, 'wb+') as wfile:\n for chunk in request.FILES[filename].chunks():\n wfile.write(chunk)\n if isimage:\n from PIL import Image\n image = Image.open(savepath)\n image.save(savepath, quality=20, optimize=True)\n url = static(savepath)\n response.append(url)\n return HttpResponse(response)\n\n else:\n return HttpResponse(\"only for post\")\n\n\n# ===== 错误处理视图 =====\n# 注意：这些函数保留是为了向后兼容\n# 实际实现已经移动到 djangoblog.error_views\n# 可以在 urls.py 中直接引用新的实现\n\nfrom djangoblog.error_views import (\n page_not_found_view,\n server_error_view,\n permission_denied_view\n)\n\n\ndef clean_cache_view(request):\n cache.clear()\n return HttpResponse('ok')\n"
},
{
"path": "codecov.yml",
"content": "codecov:\n require_ci_to_pass: yes\n\ncoverage:\n precision: 2\n round: down\n range: \"70...100\"\n\n status:\n project:\n default:\n target: auto\n threshold: 1%\n informational: true\n branches:\n - master\n - dev\n patch:\n default:\n target: auto\n threshold: 1%\n informational: true\n\nparsers:\n gcov:\n branch_detection:\n conditional: yes\n loop: yes\n method: no\n macro: no\n\ncomment:\n layout: \"reach,diff,flags,tree\"\n behavior: default\n require_changes: no\n\nignore:\n # Django 相关\n - \"*/migrations/*\"\n - \"manage.py\"\n - \"*/settings.py\"\n - \"*/wsgi.py\"\n - \"*/asgi.py\"\n \n # 测试相关\n - \"*/tests/*\"\n - \"*/test_*.py\"\n - \"*/*test*.py\"\n \n # 静态文件和模板\n - \"*/static/*\"\n - \"*/templates/*\"\n - \"*/collectedstatic/*\"\n \n # 国际化文件\n - \"*/locale/*\"\n - \"**/*.po\"\n - \"**/*.mo\"\n \n # 文档和部署\n - \"*/docs/*\"\n - \"*/deploy/*\"\n - \"README*.md\"\n - \"LICENSE\"\n - \"Dockerfile\"\n - \"docker-compose*.yml\"\n - \"*.yaml\"\n - \"*.yml\"\n \n # 开发环境\n - \"*/venv/*\"\n - \"*/__pycache__/*\"\n - \"*.pyc\"\n - \".coverage\"\n - \"coverage.xml\"\n \n # 日志文件\n - \"*/logs/*\"\n - \"*.log\"\n \n # 特定文件\n - \"*/whoosh_cn_backend.py\" # 搜索后端\n - \"*/elasticsearch_backend.py\" # 搜索后端\n - \"*/MemcacheStorage.py\" # 缓存存储\n - \"*/robot.py\" # 机器人相关\n \n # 配置文件\n - \"codecov.yml\"\n - \".coveragerc\"\n - \"requirements*.txt\"\n"
},
{
"path": "comments/__init__.py",
"content": ""
},
{
"path": "comments/admin.py",
"content": "from django.contrib import admin\nfrom django.urls import reverse\nfrom django.utils.html import format_html\nfrom django.utils.translation import gettext_lazy as _\n\nfrom .models import Comment, CommentReaction\n\n\ndef disable_commentstatus(modeladmin, request, queryset):\n queryset.update(is_enable=False)\n\n\ndef enable_commentstatus(modeladmin, request, queryset):\n queryset.update(is_enable=True)\n\n\ndisable_commentstatus.short_description = _('Disable comments')\nenable_commentstatus.short_description = _('Enable comments')\n\n\nclass CommentAdmin(admin.ModelAdmin):\n list_per_page = 20\n list_display = (\n 'id',\n 'body',\n 'link_to_userinfo',\n 'link_to_article',\n 'is_enable',\n 'creation_time')\n list_display_links = ('id', 'body', 'is_enable')\n list_filter = ('is_enable',)\n exclude = ('creation_time', 'last_modify_time')\n actions = [disable_commentstatus, enable_commentstatus]\n raw_id_fields = ('author', 'article')\n search_fields = ('body',)\n\n def link_to_userinfo(self, obj):\n info = (obj.author._meta.app_label, obj.author._meta.model_name)\n link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))\n return format_html(\n u'%s ' %\n (link, obj.author.nickname if obj.author.nickname else obj.author.email))\n\n def link_to_article(self, obj):\n info = (obj.article._meta.app_label, obj.article._meta.model_name)\n link = reverse('admin:%s_%s_change' % info, args=(obj.article.id,))\n return format_html(\n u'%s ' % (link, obj.article.title))\n\n link_to_userinfo.short_description = _('User')\n link_to_article.short_description = _('Article')\n\n\nclass CommentReactionAdmin(admin.ModelAdmin):\n list_display = ('id', 'reaction_type', 'link_to_comment', 'link_to_user', 'created_at')\n list_display_links = ('id', 'reaction_type')\n list_filter = ('reaction_type', 'created_at')\n raw_id_fields = ('comment', 'user')\n search_fields = ('comment__body', 'user__username')\n date_hierarchy = 'created_at'\n\n def link_to_comment(self, obj):\n info = (obj.comment._meta.app_label, obj.comment._meta.model_name)\n link = reverse('admin:%s_%s_change' % info, args=(obj.comment.id,))\n return format_html(\n u'Comment #%s ' % (link, obj.comment.id))\n\n def link_to_user(self, obj):\n info = (obj.user._meta.app_label, obj.user._meta.model_name)\n link = reverse('admin:%s_%s_change' % info, args=(obj.user.id,))\n return format_html(\n u'%s ' %\n (link, obj.user.nickname if obj.user.nickname else obj.user.username))\n\n link_to_comment.short_description = _('Comment')\n link_to_user.short_description = _('User')\n\n\nadmin.site.register(Comment, CommentAdmin)\nadmin.site.register(CommentReaction, CommentReactionAdmin)\n"
},
{
"path": "comments/apps.py",
"content": "from django.apps import AppConfig\n\n\nclass CommentsConfig(AppConfig):\n name = 'comments'\n"
},
{
"path": "comments/forms.py",
"content": "from django import forms\nfrom django.forms import ModelForm\n\nfrom .models import Comment\n\n\nclass CommentForm(ModelForm):\n parent_comment_id = forms.IntegerField(\n widget=forms.HiddenInput, required=False)\n\n class Meta:\n model = Comment\n fields = ['body']\n"
},
{
"path": "comments/migrations/0001_initial.py",
"content": "# Generated by Django 4.1.7 on 2023-03-02 07:14\n\nfrom django.conf import settings\nfrom django.db import migrations, models\nimport django.db.models.deletion\nimport django.utils.timezone\n\n\nclass Migration(migrations.Migration):\n\n initial = True\n\n dependencies = [\n ('blog', '0001_initial'),\n migrations.swappable_dependency(settings.AUTH_USER_MODEL),\n ]\n\n operations = [\n migrations.CreateModel(\n name='Comment',\n fields=[\n ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),\n ('body', models.TextField(max_length=300, verbose_name='正文')),\n ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')),\n ('last_mod_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='修改时间')),\n ('is_enable', models.BooleanField(default=True, verbose_name='是否显示')),\n ('article', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='blog.article', verbose_name='文章')),\n ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='作者')),\n ('parent_comment', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='comments.comment', verbose_name='上级评论')),\n ],\n options={\n 'verbose_name': '评论',\n 'verbose_name_plural': '评论',\n 'ordering': ['-id'],\n 'get_latest_by': 'id',\n },\n ),\n ]\n"
},
{
"path": "comments/migrations/0002_alter_comment_is_enable.py",
"content": "# Generated by Django 4.1.7 on 2023-04-24 13:48\n\nfrom django.db import migrations, models\n\n\nclass Migration(migrations.Migration):\n\n dependencies = [\n ('comments', '0001_initial'),\n ]\n\n operations = [\n migrations.AlterField(\n model_name='comment',\n name='is_enable',\n field=models.BooleanField(default=False, verbose_name='是否显示'),\n ),\n ]\n"
},
{
"path": "comments/migrations/0003_alter_comment_options_remove_comment_created_time_and_more.py",
"content": "# Generated by Django 4.2.5 on 2023-09-06 13:13\n\nfrom django.conf import settings\nfrom django.db import migrations, models\nimport django.db.models.deletion\nimport django.utils.timezone\n\n\nclass Migration(migrations.Migration):\n\n dependencies = [\n migrations.swappable_dependency(settings.AUTH_USER_MODEL),\n ('blog', '0005_alter_article_options_alter_category_options_and_more'),\n ('comments', '0002_alter_comment_is_enable'),\n ]\n\n operations = [\n migrations.AlterModelOptions(\n name='comment',\n options={'get_latest_by': 'id', 'ordering': ['-id'], 'verbose_name': 'comment', 'verbose_name_plural': 'comment'},\n ),\n migrations.RemoveField(\n model_name='comment',\n name='created_time',\n ),\n migrations.RemoveField(\n model_name='comment',\n name='last_mod_time',\n ),\n migrations.AddField(\n model_name='comment',\n name='creation_time',\n field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='creation time'),\n ),\n migrations.AddField(\n model_name='comment',\n name='last_modify_time',\n field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='last modify time'),\n ),\n migrations.AlterField(\n model_name='comment',\n name='article',\n field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='blog.article', verbose_name='article'),\n ),\n migrations.AlterField(\n model_name='comment',\n name='author',\n field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='author'),\n ),\n migrations.AlterField(\n model_name='comment',\n name='is_enable',\n field=models.BooleanField(default=False, verbose_name='enable'),\n ),\n migrations.AlterField(\n model_name='comment',\n name='parent_comment',\n field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='comments.comment', verbose_name='parent comment'),\n ),\n ]\n"
},
{
"path": "comments/migrations/0004_comment_idx_art_parent_enable_comment_idx_enable_id.py",
"content": "# Generated by Django 5.2.9 on 2025-12-25 14:36\n\nfrom django.conf import settings\nfrom django.db import migrations, models\n\n\nclass Migration(migrations.Migration):\n\n dependencies = [\n ('blog', '0007_article_idx_type_status_pub_article_idx_status_views_and_more'),\n ('comments', '0003_alter_comment_options_remove_comment_created_time_and_more'),\n migrations.swappable_dependency(settings.AUTH_USER_MODEL),\n ]\n\n operations = [\n migrations.AddIndex(\n model_name='comment',\n index=models.Index(fields=['article', 'parent_comment', 'is_enable'], name='idx_art_parent_enable'),\n ),\n migrations.AddIndex(\n model_name='comment',\n index=models.Index(fields=['is_enable', '-id'], name='idx_enable_id'),\n ),\n ]\n"
},
{
"path": "comments/migrations/0005_commentreaction.py",
"content": "# Generated by Django 5.2.9 on 2026-01-22 14:13\n\nimport django.db.models.deletion\nfrom django.conf import settings\nfrom django.db import migrations, models\n\n\nclass Migration(migrations.Migration):\n\n dependencies = [\n ('comments', '0004_comment_idx_art_parent_enable_comment_idx_enable_id'),\n migrations.swappable_dependency(settings.AUTH_USER_MODEL),\n ]\n\n operations = [\n migrations.CreateModel(\n name='CommentReaction',\n fields=[\n ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),\n ('reaction_type', models.CharField(choices=[('👍', 'thumbs_up'), ('👎', 'thumbs_down'), ('❤️', 'heart'), ('😄', 'laugh'), ('🎉', 'hooray'), ('😕', 'confused'), ('🚀', 'rocket'), ('👀', 'eyes')], max_length=10, verbose_name='reaction type')),\n ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='created at')),\n ('comment', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='reactions', to='comments.comment', verbose_name='comment')),\n ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='user')),\n ],\n options={\n 'verbose_name': 'comment reaction',\n 'verbose_name_plural': 'comment reactions',\n 'indexes': [models.Index(fields=['comment', 'reaction_type'], name='idx_comment_reaction')],\n 'unique_together': {('comment', 'user', 'reaction_type')},\n },\n ),\n ]\n"
},
{
"path": "comments/migrations/__init__.py",
"content": ""
},
{
"path": "comments/models.py",
"content": "from django.conf import settings\nfrom django.db import models\nfrom django.utils.timezone import now\nfrom django.utils.translation import gettext_lazy as _\n\nfrom blog.models import Article\n\n\n# Create your models here.\n\nclass Comment(models.Model):\n body = models.TextField('正文', max_length=300)\n creation_time = models.DateTimeField(_('creation time'), default=now)\n last_modify_time = models.DateTimeField(_('last modify time'), default=now)\n author = models.ForeignKey(\n settings.AUTH_USER_MODEL,\n verbose_name=_('author'),\n on_delete=models.CASCADE)\n article = models.ForeignKey(\n Article,\n verbose_name=_('article'),\n on_delete=models.CASCADE)\n parent_comment = models.ForeignKey(\n 'self',\n verbose_name=_('parent comment'),\n blank=True,\n null=True,\n on_delete=models.CASCADE)\n is_enable = models.BooleanField(_('enable'),\n default=False, blank=False, null=False)\n\n class Meta:\n ordering = ['-id']\n verbose_name = _('comment')\n verbose_name_plural = verbose_name\n get_latest_by = 'id'\n indexes = [\n # 优化评论列表查询：article + parent_comment + is_enable组合索引\n models.Index(fields=['article', 'parent_comment', 'is_enable'], name='idx_art_parent_enable'),\n # 优化侧边栏评论查询：is_enable + id组合索引\n models.Index(fields=['is_enable', '-id'], name='idx_enable_id'),\n ]\n\n def __str__(self):\n return self.body\n\n def get_reactions_summary(self, user=None):\n \"\"\"\n 获取评论的 reactions 统计信息\n 返回格式: {\n '👍': {\n 'count': 5,\n 'has_reacted': True,\n 'users': ['Alice', 'Bob', 'Charlie']\n },\n '❤️': {'count': 3, 'has_reacted': False, 'users': [...]},\n ...\n }\n \"\"\"\n from django.db.models import Count\n\n reactions = CommentReaction.objects.filter(\n comment=self\n ).values('reaction_type').annotate(count=Count('id'))\n\n result = {}\n for reaction in reactions:\n emoji = reaction['reaction_type']\n\n # 获取该 emoji 的所有点赞用户\n reaction_users = CommentReaction.objects.filter(\n comment=self,\n reaction_type=emoji\n ).select_related('user')[:10] # 最多显示10个用户\n\n user_names = [r.user.nickname or r.user.username for r in reaction_users]\n\n result[emoji] = {\n 'count': reaction['count'],\n 'has_reacted': False,\n 'users': user_names\n }\n\n if user and user.is_authenticated:\n result[emoji]['has_reacted'] = CommentReaction.objects.filter(\n comment=self,\n user=user,\n reaction_type=emoji\n ).exists()\n\n return result\n\n\nclass CommentReaction(models.Model):\n \"\"\"\n 评论的 Emoji 反应/点赞\n \"\"\"\n REACTION_CHOICES = [\n ('👍', 'thumbs_up'),\n ('👎', 'thumbs_down'),\n ('❤️', 'heart'),\n ('😄', 'laugh'),\n ('🎉', 'hooray'),\n ('😕', 'confused'),\n ('🚀', 'rocket'),\n ('👀', 'eyes'),\n ]\n\n comment = models.ForeignKey(\n Comment,\n verbose_name=_('comment'),\n on_delete=models.CASCADE,\n related_name='reactions'\n )\n user = models.ForeignKey(\n settings.AUTH_USER_MODEL,\n verbose_name=_('user'),\n on_delete=models.CASCADE\n )\n reaction_type = models.CharField(\n _('reaction type'),\n max_length=10,\n choices=REACTION_CHOICES\n )\n created_at = models.DateTimeField(_('created at'), auto_now_add=True)\n\n class Meta:\n verbose_name = _('comment reaction')\n verbose_name_plural = _('comment reactions')\n # 每个用户对同一评论的同一种 emoji 只能点一次\n unique_together = ['comment', 'user', 'reaction_type']\n indexes = [\n models.Index(fields=['comment', 'reaction_type'], name='idx_comment_reaction'),\n ]\n\n def __str__(self):\n return f'{self.user.username} - {self.reaction_type} on comment {self.comment.id}'\n"
},
{
"path": "comments/templatetags/__init__.py",
"content": ""
},
{
"path": "comments/templatetags/comments_tags.py",
"content": "from django import template\n\nregister = template.Library()\n\n\n@register.simple_tag\ndef parse_commenttree(commentlist, comment):\n \"\"\"获得当前评论子评论的列表\n 用法: {% parse_commenttree article_comments comment as childcomments %}\n \"\"\"\n datas = []\n\n def parse(c):\n childs = commentlist.filter(parent_comment=c, is_enable=True)\n for child in childs:\n datas.append(child)\n parse(child)\n\n parse(comment)\n return datas\n\n\n@register.inclusion_tag('comments/tags/comment_item.html')\ndef show_comment_item(comment, ischild):\n \"\"\"评论\"\"\"\n depth = 1 if ischild else 2\n return {\n 'comment_item': comment,\n 'depth': depth\n }\n"
},
{
"path": "comments/test_comment_business_logic.py",
"content": "\"\"\"\nTest cases for comment business logic\n包括评论审核工作流、嵌套回复、权限控制等核心业务逻辑\n\"\"\"\nfrom django.test import TestCase, Client\nfrom django.utils import timezone\n\nfrom accounts.models import BlogUser\nfrom blog.models import Article, Category, BlogSettings\nfrom comments.models import Comment\n\n\nclass CommentCreationTest(TestCase):\n \"\"\"测试评论创建业务逻辑\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o'\n )\n\n def test_comment_created_with_required_fields(self):\n \"\"\"测试评论创建包含必需字段\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article\n )\n\n self.assertIsNotNone(comment.id)\n self.assertEqual(comment.body, 'Test comment')\n self.assertEqual(comment.author, self.commenter)\n self.assertEqual(comment.article, self.article)\n\n def test_comment_has_creation_time(self):\n \"\"\"测试评论有创建时间\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article\n )\n\n self.assertIsNotNone(comment.creation_time)\n # 验证创建时间是最近的\n time_diff = timezone.now() - comment.creation_time\n self.assertLess(time_diff.total_seconds(), 10)\n\n def test_comment_author_is_correct(self):\n \"\"\"测试评论作者正确\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article\n )\n\n self.assertEqual(comment.author, self.commenter)\n\n def test_comment_article_relationship(self):\n \"\"\"测试评论与文章的关系\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article\n )\n\n self.assertEqual(comment.article, self.article)\n # 验证可以通过文章查询到评论\n article_comments = Comment.objects.filter(article=self.article)\n self.assertIn(comment, article_comments)\n\n\nclass CommentModerationTest(TestCase):\n \"\"\"测试评论审核工作流\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o'\n )\n\n # 获取或创建博客设置\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_comment_pending_by_default_when_review_required(self):\n \"\"\"测试需要审核时评论默认为待审状态\"\"\"\n # 启用评论审核\n self.blog_settings.comment_need_review = True\n self.blog_settings.save()\n\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article,\n is_enable=False # 待审状态\n )\n\n self.assertFalse(comment.is_enable)\n\n def test_comment_approved_directly_when_no_review_required(self):\n \"\"\"测试不需要审核时评论直接通过\"\"\"\n # 禁用评论审核\n self.blog_settings.comment_need_review = False\n self.blog_settings.save()\n\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article,\n is_enable=True # 直接启用\n )\n\n self.assertTrue(comment.is_enable)\n\n def test_comment_can_be_approved(self):\n \"\"\"测试评论可以被批准\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article,\n is_enable=False\n )\n\n # 审核通过\n comment.is_enable = True\n comment.save()\n\n comment.refresh_from_db()\n self.assertTrue(comment.is_enable)\n\n def test_comment_can_be_rejected(self):\n \"\"\"测试评论可以被拒绝\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n # 拒绝评论\n comment.is_enable = False\n comment.save()\n\n comment.refresh_from_db()\n self.assertFalse(comment.is_enable)\n\n def test_only_approved_comments_in_public_list(self):\n \"\"\"测试只有已批准的评论在公开列表中\"\"\"\n # 创建已批准的评论\n approved_comment = Comment.objects.create(\n body='Approved comment',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n # 创建待审的评论\n pending_comment = Comment.objects.create(\n body='Pending comment',\n author=self.commenter,\n article=self.article,\n is_enable=False\n )\n\n # 查询已批准的评论\n approved_comments = Comment.objects.filter(\n article=self.article,\n is_enable=True\n )\n\n self.assertIn(approved_comment, approved_comments)\n self.assertNotIn(pending_comment, approved_comments)\n\n\nclass CommentReplyTest(TestCase):\n \"\"\"测试评论回复业务逻辑\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter1 = BlogUser.objects.create_user(\n username='commenter1',\n email='commenter1@example.com',\n password='password'\n )\n\n self.commenter2 = BlogUser.objects.create_user(\n username='commenter2',\n email='commenter2@example.com',\n password='password'\n )\n\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o'\n )\n\n def test_comment_can_have_no_parent(self):\n \"\"\"测试评论可以没有父评论（根评论）\"\"\"\n comment = Comment.objects.create(\n body='Root comment',\n author=self.commenter1,\n article=self.article,\n parent_comment=None\n )\n\n self.assertIsNone(comment.parent_comment)\n\n def test_comment_can_have_parent(self):\n \"\"\"测试评论可以有父评论（回复）\"\"\"\n parent_comment = Comment.objects.create(\n body='Parent comment',\n author=self.commenter1,\n article=self.article,\n is_enable=True\n )\n\n reply_comment = Comment.objects.create(\n body='Reply comment',\n author=self.commenter2,\n article=self.article,\n parent_comment=parent_comment,\n is_enable=True\n )\n\n self.assertEqual(reply_comment.parent_comment, parent_comment)\n\n def test_parent_comment_has_replies(self):\n \"\"\"测试父评论有回复\"\"\"\n parent_comment = Comment.objects.create(\n body='Parent comment',\n author=self.commenter1,\n article=self.article,\n is_enable=True\n )\n\n reply1 = Comment.objects.create(\n body='Reply 1',\n author=self.commenter2,\n article=self.article,\n parent_comment=parent_comment,\n is_enable=True\n )\n\n reply2 = Comment.objects.create(\n body='Reply 2',\n author=self.commenter1,\n article=self.article,\n parent_comment=parent_comment,\n is_enable=True\n )\n\n # 查询父评论的所有回复\n replies = Comment.objects.filter(parent_comment=parent_comment)\n\n self.assertEqual(replies.count(), 2)\n self.assertIn(reply1, replies)\n self.assertIn(reply2, replies)\n\n def test_nested_comment_structure(self):\n \"\"\"测试嵌套评论结构\"\"\"\n # 创建根评论\n root = Comment.objects.create(\n body='Root',\n author=self.commenter1,\n article=self.article,\n is_enable=True\n )\n\n # 创建一级回复\n level1 = Comment.objects.create(\n body='Level 1',\n author=self.commenter2,\n article=self.article,\n parent_comment=root,\n is_enable=True\n )\n\n # 创建二级回复\n level2 = Comment.objects.create(\n body='Level 2',\n author=self.commenter1,\n article=self.article,\n parent_comment=level1,\n is_enable=True\n )\n\n # 验证嵌套关系\n self.assertIsNone(root.parent_comment)\n self.assertEqual(level1.parent_comment, root)\n self.assertEqual(level2.parent_comment, level1)\n\n def test_multiple_replies_to_same_comment(self):\n \"\"\"测试同一评论的多个回复\"\"\"\n parent = Comment.objects.create(\n body='Parent',\n author=self.commenter1,\n article=self.article,\n is_enable=True\n )\n\n # 创建多个回复\n replies = []\n for i in range(5):\n reply = Comment.objects.create(\n body=f'Reply {i+1}',\n author=self.commenter2,\n article=self.article,\n parent_comment=parent,\n is_enable=True\n )\n replies.append(reply)\n\n # 验证所有回复都关联到同一父评论\n parent_replies = Comment.objects.filter(parent_comment=parent)\n self.assertEqual(parent_replies.count(), 5)\n\n for reply in replies:\n self.assertIn(reply, parent_replies)\n\n\nclass CommentArticleStatusTest(TestCase):\n \"\"\"测试评论与文章状态的关系\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n def test_can_comment_on_open_comment_article(self):\n \"\"\"测试可以在开放评论的文章上评论\"\"\"\n article = Article.objects.create(\n title='Open Comment Article',\n body='Content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o' # 开放评论\n )\n\n # 业务逻辑层面：评论状态开放\n self.assertEqual(article.comment_status, 'o')\n\n # 创建评论应该成功\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=article,\n is_enable=True\n )\n\n self.assertIsNotNone(comment.id)\n\n def test_comment_status_closed_validation(self):\n \"\"\"测试关闭评论的文章状态\"\"\"\n article = Article.objects.create(\n title='Closed Comment Article',\n body='Content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='c' # 关闭评论\n )\n\n # 验证文章评论状态\n self.assertEqual(article.comment_status, 'c')\n\n # 注意：实际的验证应该在视图层进行\n # 这里我们只测试模型层面的状态\n\n def test_comments_belong_to_correct_article(self):\n \"\"\"测试评论属于正确的文章\"\"\"\n article1 = Article.objects.create(\n title='Article 1',\n body='Content 1',\n author=self.author,\n category=self.category,\n status='p',\n type='a'\n )\n\n article2 = Article.objects.create(\n title='Article 2',\n body='Content 2',\n author=self.author,\n category=self.category,\n status='p',\n type='a'\n )\n\n comment1 = Comment.objects.create(\n body='Comment on Article 1',\n author=self.commenter,\n article=article1,\n is_enable=True\n )\n\n comment2 = Comment.objects.create(\n body='Comment on Article 2',\n author=self.commenter,\n article=article2,\n is_enable=True\n )\n\n # 验证评论属于正确的文章\n article1_comments = Comment.objects.filter(article=article1)\n article2_comments = Comment.objects.filter(article=article2)\n\n self.assertIn(comment1, article1_comments)\n self.assertNotIn(comment2, article1_comments)\n\n self.assertIn(comment2, article2_comments)\n self.assertNotIn(comment1, article2_comments)\n\n\nclass CommentQueryTest(TestCase):\n \"\"\"测试评论查询业务逻辑\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a'\n )\n\n def test_query_comments_by_article(self):\n \"\"\"测试按文章查询评论\"\"\"\n # 创建多个评论\n for i in range(5):\n Comment.objects.create(\n body=f'Comment {i+1}',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n comments = Comment.objects.filter(article=self.article)\n self.assertEqual(comments.count(), 5)\n\n def test_query_comments_by_author(self):\n \"\"\"测试按作者查询评论\"\"\"\n # 创建评论\n for i in range(3):\n Comment.objects.create(\n body=f'Comment {i+1}',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n comments = Comment.objects.filter(author=self.commenter)\n self.assertEqual(comments.count(), 3)\n\n def test_query_root_comments_only(self):\n \"\"\"测试只查询根评论（无父评论的评论）\"\"\"\n # 创建根评论\n root1 = Comment.objects.create(\n body='Root 1',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n root2 = Comment.objects.create(\n body='Root 2',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n # 创建回复\n Comment.objects.create(\n body='Reply to Root 1',\n author=self.commenter,\n article=self.article,\n parent_comment=root1,\n is_enable=True\n )\n\n # 查询根评论\n root_comments = Comment.objects.filter(\n article=self.article,\n parent_comment__isnull=True\n )\n\n self.assertEqual(root_comments.count(), 2)\n self.assertIn(root1, root_comments)\n self.assertIn(root2, root_comments)\n\n def test_comment_ordering(self):\n \"\"\"测试评论排序\"\"\"\n # 创建多个评论\n comments = []\n for i in range(3):\n comment = Comment.objects.create(\n body=f'Comment {i+1}',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n comments.append(comment)\n\n # 查询评论（应该按照模型定义的ordering排序）\n ordered_comments = list(Comment.objects.filter(article=self.article))\n\n # 验证至少返回了正确数量的评论\n self.assertEqual(len(ordered_comments), 3)\n\n\nclass CommentDeletionTest(TestCase):\n \"\"\"测试评论删除业务逻辑\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a'\n )\n\n def test_comment_can_be_deleted(self):\n \"\"\"测试评论可以被删除\"\"\"\n comment = Comment.objects.create(\n body='Test comment',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n comment_id = comment.id\n\n # 删除评论\n comment.delete()\n\n # 验证评论已被删除\n with self.assertRaises(Comment.DoesNotExist):\n Comment.objects.get(id=comment_id)\n\n def test_deleting_parent_comment_with_replies(self):\n \"\"\"测试删除有回复的父评论\"\"\"\n parent = Comment.objects.create(\n body='Parent',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n reply = Comment.objects.create(\n body='Reply',\n author=self.commenter,\n article=self.article,\n parent_comment=parent,\n is_enable=True\n )\n\n parent_id = parent.id\n reply_id = reply.id\n\n # 删除父评论\n parent.delete()\n\n # 验证父评论被删除\n with self.assertRaises(Comment.DoesNotExist):\n Comment.objects.get(id=parent_id)\n\n # 验证回复的处理（取决于模型的on_delete设置）\n # 如果是CASCADE，回复也应该被删除\n # 如果是SET_NULL，回复的parent应该为None\n"
},
{
"path": "comments/test_views.py",
"content": "\"\"\"\nComments Views 测试\n测试评论功能的错误处理和边界条件\n\"\"\"\nfrom django.test import TransactionTestCase\nfrom django.urls import reverse\n\nfrom comments.models import Comment\nfrom djangoblog.test_base import BaseTestCase, ViewTestMixin\n\n\nclass CommentViewTest(TransactionTestCase, ViewTestMixin):\n \"\"\"测试评论视图\"\"\"\n\n def setUp(self):\n from django.test import Client\n from accounts.models import BlogUser\n from blog.models import Article, Category, BlogSettings\n from django.utils import timezone\n\n self.client = Client()\n self.user = BlogUser.objects.create_user(\n username='testuser',\n email='test@test.com',\n password='testpass123'\n )\n self.category = Category.objects.create(\n name='测试分类',\n creation_time=timezone.now(),\n last_modify_time=timezone.now()\n )\n self.article = Article.objects.create(\n title='测试文章',\n body='测试内容',\n author=self.user,\n category=self.category,\n type='a',\n status='p'\n )\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': '测试博客',\n 'site_description': '测试描述',\n 'comment_need_review': False,\n }\n )\n\n def login_user(self):\n \"\"\"登录测试用户\"\"\"\n return self.client.login(username='testuser', password='testpass123')\n\n def test_post_comment_authenticated(self):\n \"\"\"测试已登录用户发表评论\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n response = self.client.post(url, {'body': '这是一条测试评论'})\n self.assertEqual(response.status_code, 302)\n\n # 验证评论已创建\n comments = Comment.objects.filter(article=self.article)\n self.assertGreater(comments.count(), 0)\n\n def test_post_comment_unauthenticated(self):\n \"\"\"测试未登录用户发表评论\"\"\"\n self.client.logout()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n response = self.client.post(url, {'body': '匿名评论'})\n # 未登录用户会被视图处理，可能返回错误或重定向\n # 由于视图会尝试获取用户，会产生错误，这是预期的\n self.assertIn(response.status_code, [200, 302, 403, 500])\n\n def test_post_comment_empty_body(self):\n \"\"\"测试提交空评论\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n response = self.client.post(url, {'body': ''})\n # 应该返回表单错误\n self.assertIn(response.status_code, [200, 302])\n\n def test_post_comment_invalid_article(self):\n \"\"\"测试对不存在的文章评论\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': 99999})\n response = self.client.post(url, {'body': '评论'})\n self.assertEqual(response.status_code, 404)\n\n def test_post_reply_comment(self):\n \"\"\"测试回复评论\"\"\"\n self.login_user()\n # 先创建一条评论\n parent_comment = Comment.objects.create(\n body='父评论',\n author=self.user,\n article=self.article\n )\n parent_comment.is_enable = True\n parent_comment.save()\n\n # 回复这条评论\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n response = self.client.post(url, {\n 'body': '这是回复',\n 'parent_comment_id': parent_comment.id\n })\n self.assertIn(response.status_code, [200, 302])\n\n def test_comment_moderation(self):\n \"\"\"测试评论审核\"\"\"\n # 设置需要审核\n self.blog_settings.comment_need_review = True\n self.blog_settings.save()\n\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n response = self.client.post(url, {'body': '待审核的评论'})\n self.assertEqual(response.status_code, 302)\n\n # 验证评论需要审核\n comment = Comment.objects.filter(article=self.article).latest('id')\n self.assertFalse(comment.is_enable)\n\n def test_comment_display_on_article(self):\n \"\"\"测试评论在文章页显示\"\"\"\n comment = Comment.objects.create(\n body='测试显示评论',\n author=self.user,\n article=self.article,\n is_enable=True\n )\n\n response = self.client.get(self.article.get_absolute_url())\n self.assertEqual(response.status_code, 200)\n\n def test_disabled_comment_not_display(self):\n \"\"\"测试未启用的评论不显示\"\"\"\n comment = Comment.objects.create(\n body='未启用的评论',\n author=self.user,\n article=self.article,\n is_enable=False\n )\n\n response = self.client.get(self.article.get_absolute_url())\n self.assertEqual(response.status_code, 200)\n\n\nclass CommentSpamTest(TransactionTestCase, ViewTestMixin):\n \"\"\"测试评论垃圾防护\"\"\"\n\n def setUp(self):\n from django.test import Client\n from accounts.models import BlogUser\n from blog.models import Article, Category, BlogSettings\n from django.utils import timezone\n\n self.client = Client()\n self.user = BlogUser.objects.create_user(\n username='testuser',\n email='test@test.com',\n password='testpass123'\n )\n self.category = Category.objects.create(\n name='测试分类',\n creation_time=timezone.now(),\n last_modify_time=timezone.now()\n )\n self.article = Article.objects.create(\n title='测试文章',\n body='测试内容',\n author=self.user,\n category=self.category,\n type='a',\n status='p'\n )\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={'comment_need_review': False}\n )\n\n def login_user(self):\n return self.client.login(username='testuser', password='testpass123')\n\n def test_duplicate_comment(self):\n \"\"\"测试重复评论\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n comment_data = {'body': '重复的评论内容'}\n\n # 第一次提交\n response1 = self.client.post(url, comment_data)\n self.assertEqual(response1.status_code, 302)\n\n # 第二次提交相同内容\n response2 = self.client.post(url, comment_data)\n # 应该被阻止或显示错误\n self.assertIn(response2.status_code, [200, 302])\n\n def test_comment_rate_limit(self):\n \"\"\"测试评论频率限制\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n\n # 快速连续发表多条评论\n for i in range(5):\n response = self.client.post(url, {'body': f'评论{i}'})\n # 后续评论可能被限制\n self.assertIn(response.status_code, [200, 302, 429])\n\n\nclass CommentSecurityTest(TransactionTestCase, ViewTestMixin):\n \"\"\"测试评论安全性\"\"\"\n\n def setUp(self):\n from django.test import Client\n from accounts.models import BlogUser\n from blog.models import Article, Category, BlogSettings\n from django.utils import timezone\n\n self.client = Client()\n self.user = BlogUser.objects.create_user(\n username='testuser',\n email='test@test.com',\n password='testpass123'\n )\n self.category = Category.objects.create(\n name='测试分类',\n creation_time=timezone.now(),\n last_modify_time=timezone.now()\n )\n self.article = Article.objects.create(\n title='测试文章',\n body='测试内容',\n author=self.user,\n category=self.category,\n type='a',\n status='p'\n )\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={'comment_need_review': False}\n )\n\n def login_user(self):\n return self.client.login(username='testuser', password='testpass123')\n\n def test_xss_protection(self):\n \"\"\"测试 XSS 防护\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n\n # 提交包含 script 标签的评论\n xss_body = '普通内容'\n response = self.client.post(url, {'body': xss_body})\n self.assertEqual(response.status_code, 302)\n\n # 验证评论已创建（XSS 过滤在渲染时处理）\n comment = Comment.objects.filter(article=self.article).latest('id')\n self.assertIsNotNone(comment)\n\n def test_sql_injection_protection(self):\n \"\"\"测试 SQL 注入防护\"\"\"\n self.login_user()\n url = reverse('comments:postcomment', kwargs={'article_id': self.article.id})\n\n # 提交包含 SQL 注入尝试的评论\n sql_body = \"'; DROP TABLE comments; --\"\n response = self.client.post(url, {'body': sql_body})\n # 应该正常处理，不会执行 SQL\n self.assertIn(response.status_code, [200, 302])\n\n # 验证表仍然存在\n self.assertTrue(Comment.objects.exists())\n"
},
{
"path": "comments/tests.py",
"content": "from django.test import Client, RequestFactory, TransactionTestCase\nfrom django.urls import reverse\n\nfrom accounts.models import BlogUser\nfrom blog.models import Category, Article\nfrom comments.models import Comment\nfrom comments.templatetags.comments_tags import *\nfrom djangoblog.utils import get_max_articleid_commentid\n\n\n# Create your tests here.\n\nclass CommentsTest(TransactionTestCase):\n def setUp(self):\n self.client = Client()\n self.factory = RequestFactory()\n from blog.models import BlogSettings\n value = BlogSettings()\n value.comment_need_review = True\n value.save()\n\n self.user = BlogUser.objects.create_superuser(\n email=\"liangliangyy1@gmail.com\",\n username=\"liangliangyy1\",\n password=\"liangliangyy1\")\n\n def update_article_comment_status(self, article):\n comments = article.comment_set.all()\n for comment in comments:\n comment.is_enable = True\n comment.save()\n\n def test_validate_comment(self):\n self.client.login(username='liangliangyy1', password='liangliangyy1')\n\n category = Category()\n category.name = \"categoryccc\"\n category.save()\n\n article = Article()\n article.title = \"nicetitleccc\"\n article.body = \"nicecontentccc\"\n article.author = self.user\n article.category = category\n article.type = 'a'\n article.status = 'p'\n article.save()\n\n comment_url = reverse(\n 'comments:postcomment', kwargs={\n 'article_id': article.id})\n\n response = self.client.post(comment_url,\n {\n 'body': '123ffffffffff'\n })\n\n self.assertEqual(response.status_code, 302)\n\n article = Article.objects.get(pk=article.pk)\n self.assertEqual(len(article.comment_list()), 0)\n self.update_article_comment_status(article)\n\n self.assertEqual(len(article.comment_list()), 1)\n\n response = self.client.post(comment_url,\n {\n 'body': '123ffffffffff',\n })\n\n self.assertEqual(response.status_code, 302)\n\n article = Article.objects.get(pk=article.pk)\n self.update_article_comment_status(article)\n self.assertEqual(len(article.comment_list()), 2)\n parent_comment_id = article.comment_list()[0].id\n\n response = self.client.post(comment_url,\n {\n 'body': '''\n # Title1\n\n ```python\n import os\n ```\n\n [url](https://www.lylinux.net/)\n\n [ddd](http://www.baidu.com)\n\n\n ''',\n 'parent_comment_id': parent_comment_id\n })\n\n self.assertEqual(response.status_code, 302)\n self.update_article_comment_status(article)\n article = Article.objects.get(pk=article.pk)\n self.assertEqual(len(article.comment_list()), 3)\n comment = Comment.objects.get(id=parent_comment_id)\n tree = parse_commenttree(article.comment_list(), comment)\n self.assertEqual(len(tree), 1)\n data = show_comment_item(comment, True)\n self.assertIsNotNone(data)\n s = get_max_articleid_commentid()\n self.assertIsNotNone(s)\n\n from comments.utils import send_comment_email\n send_comment_email(comment)\n"
},
{
"path": "comments/urls.py",
"content": "from django.urls import path\n\nfrom . import views\n\napp_name = \"comments\"\nurlpatterns = [\n path(\n 'article//postcomment',\n views.CommentPostView.as_view(),\n name='postcomment'),\n path(\n 'comment//react',\n views.CommentReactionView.as_view(),\n name='comment_react'),\n]\n"
},
{
"path": "comments/utils.py",
"content": "import logging\n\nfrom django.utils.translation import gettext_lazy as _\n\nfrom djangoblog.utils import get_current_site\nfrom djangoblog.utils import send_email\n\nlogger = logging.getLogger(__name__)\n\n\ndef send_comment_email(comment):\n site = get_current_site().domain\n subject = _('Thanks for your comment')\n article_url = f\"https://{site}{comment.article.get_absolute_url()}\"\n html_content = _(\"\"\"Thank you very much for your comments on this site
\n You can visit %(article_title)s \n to review your comments,\n Thank you again!\n %(article_title)s /react - 获取 reactions（公开）\n POST /comment//react - 切换 reaction（需要登录）\n \"\"\"\n\n def get(self, request, comment_id):\n \"\"\"获取评论的 reactions 数据（公开访问）\"\"\"\n comment = get_object_or_404(Comment, id=comment_id, is_enable=True)\n\n # 传递用户信息，如果未登录则传递 None\n user = request.user if request.user.is_authenticated else None\n reactions_data = comment.get_reactions_summary(user)\n\n return JsonResponse({\n 'success': True,\n 'reactions': reactions_data\n })\n\n def post(self, request, comment_id):\n # POST 需要登录验证\n if not request.user.is_authenticated:\n return JsonResponse({\n 'success': False,\n 'error': 'Authentication required'\n }, status=401)\n # 获取评论（只有已启用的评论才能点赞）\n comment = get_object_or_404(Comment, id=comment_id, is_enable=True)\n\n # 获取 reaction 类型\n reaction_type = request.POST.get('reaction_type')\n\n # 验证 reaction_type 是否合法\n valid_reactions = [choice[0] for choice in CommentReaction.REACTION_CHOICES]\n if reaction_type not in valid_reactions:\n return JsonResponse({\n 'error': 'Invalid reaction type'\n }, status=400)\n\n # 切换 reaction（如果已存在则删除，否则创建）\n reaction, created = CommentReaction.objects.get_or_create(\n comment=comment,\n user=request.user,\n reaction_type=reaction_type\n )\n\n if not created:\n # 已存在，删除它（取消点赞）\n reaction.delete()\n action = 'removed'\n else:\n action = 'added'\n\n # 返回该评论的所有 reactions 统计\n reactions_data = comment.get_reactions_summary(request.user)\n\n return JsonResponse({\n 'success': True,\n 'action': action,\n 'reactions': reactions_data\n })\n"
},
{
"path": "deploy/docker-compose/docker-compose.es.yml",
"content": "version: '3'\n\nservices:\n es:\n image: liangliangyy/elasticsearch-analysis-ik:8.6.1\n container_name: es\n restart: always\n environment:\n - discovery.type=single-node\n - \"ES_JAVA_OPTS=-Xms512m -Xmx512m\"\n ports:\n - 9200:9200\n volumes:\n - ./bin/datas/es/:/usr/share/elasticsearch/data/\n\n kibana:\n image: kibana:8.6.1\n restart: always\n container_name: kibana\n ports:\n - 5601:5601\n environment:\n - ELASTICSEARCH_HOSTS=http://es:9200\n\n djangoblog:\n build: .\n restart: always\n command: bash -c 'sh /code/djangoblog/bin/docker_start.sh'\n ports:\n - \"8000:8000\"\n volumes:\n - ./collectedstatic:/code/djangoblog/collectedstatic\n - ./uploads:/code/djangoblog/uploads\n environment:\n - DJANGO_MYSQL_DATABASE=djangoblog\n - DJANGO_MYSQL_USER=root\n - DJANGO_MYSQL_PASSWORD=QQQQwww123!@#\n - DJANGO_MYSQL_HOST=db\n - DJANGO_MYSQL_PORT=3306\n - DJANGO_MEMCACHED_LOCATION=memcached:11211\n - DJANGO_ELASTICSEARCH_HOST=es:9200\n links:\n - db\n - memcached\n depends_on:\n - db\n container_name: djangoblog\n\n"
},
{
"path": "deploy/docker-compose/docker-compose.yml",
"content": "version: '3'\n\nservices:\n db:\n image: mysql:latest\n restart: always\n environment:\n - MYSQL_DATABASE=djangoblog\n - MYSQL_ROOT_PASSWORD=QQQQwww123!@#\n ports:\n - 3306:3306\n volumes:\n - mysql_data:/var/lib/mysql\n depends_on:\n - redis\n container_name: db\n\n djangoblog:\n build:\n context: ../../\n dockerfile: Dockerfile\n restart: always\n command: bash -c 'sh /code/djangoblog/deploy/entrypoint.sh'\n ports:\n - \"8000:8000\"\n volumes:\n # 使用named volume共享静态文件给nginx\n - static_files:/code/djangoblog/collectedstatic\n - ./logs:/code/djangoblog/logs\n - ./uploads:/code/djangoblog/uploads\n environment:\n - DJANGO_DEBUG=False\n - DJANGO_MYSQL_DATABASE=djangoblog\n - DJANGO_MYSQL_USER=root\n - DJANGO_MYSQL_PASSWORD=QQQQwww123!@#\n - DJANGO_MYSQL_HOST=db\n - DJANGO_MYSQL_PORT=3306\n - DJANGO_REDIS_URL=redis:6379\n links:\n - db\n - redis\n depends_on:\n - db\n container_name: djangoblog\n nginx:\n restart: always\n image: nginx:latest\n ports:\n - \"80:80\"\n - \"443:443\"\n volumes:\n - ../nginx.conf:/etc/nginx/nginx.conf\n # 使用同一个named volume访问静态文件\n - static_files:/code/djangoblog/collectedstatic:ro\n links:\n - djangoblog:djangoblog\n container_name: nginx\n\n redis:\n restart: always\n image: redis:latest\n container_name: redis\n ports:\n - \"6379:6379\"\n\nvolumes:\n mysql_data:\n static_files:\n"
},
{
"path": "deploy/entrypoint.sh",
"content": "#!/usr/bin/env bash\nNAME=\"djangoblog\"\nDJANGODIR=/code/djangoblog\nUSER=root\nGROUP=root\nNUM_WORKERS=1\nDJANGO_WSGI_MODULE=djangoblog.wsgi\n\n\necho \"Starting $NAME as `whoami`\"\n\ncd $DJANGODIR\n\nexport PYTHONPATH=$DJANGODIR:$PYTHONPATH\n\npython manage.py makemigrations && \\\n python manage.py migrate && \\\n python manage.py collectstatic --noinput && \\\n echo \"Verifying Vite build artifacts...\" && \\\n ls -la blog/static/blog/dist/css/ && \\\n ls -la blog/static/blog/dist/js/ && \\\n echo \"Vite manifest content:\" && \\\n cat blog/static/blog/dist/.vite/manifest.json && \\\n echo \"Copying .vite directory to collectedstatic...\" && \\\n mkdir -p collectedstatic/blog/dist/.vite && \\\n cp -r blog/static/blog/dist/.vite/* collectedstatic/blog/dist/.vite/ && \\\n python manage.py compress --force && \\\n python manage.py build_index && \\\n python manage.py compilemessages || exit 1\n\nexec gunicorn ${DJANGO_WSGI_MODULE}:application \\\n--name $NAME \\\n--workers $NUM_WORKERS \\\n--user=$USER --group=$GROUP \\\n--bind 0.0.0.0:8000 \\\n--log-level=debug \\\n--log-file=- \\\n--worker-class gevent \\\n--threads 4\n"
},
{
"path": "deploy/k8s/configmap.yaml",
"content": "apiVersion: v1\nkind: ConfigMap\nmetadata:\n name: web-nginx-config\n namespace: djangoblog\ndata:\n nginx.conf: |\n user nginx;\n worker_processes auto;\n error_log /var/log/nginx/error.log notice;\n pid /var/run/nginx.pid;\n\n events {\n worker_connections 1024;\n multi_accept on;\n use epoll;\n }\n\n http {\n include /etc/nginx/mime.types;\n default_type application/octet-stream;\n\n log_format main '$remote_addr - $remote_user [$time_local] \"$request\" '\n '$status $body_bytes_sent \"$http_referer\" '\n '\"$http_user_agent\" \"$http_x_forwarded_for\"';\n\n access_log /var/log/nginx/access.log main;\n\n sendfile on;\n keepalive_timeout 65;\n gzip on;\n gzip_disable \"msie6\";\n\n gzip_vary on;\n gzip_proxied any;\n gzip_comp_level 8;\n gzip_buffers 16 8k;\n gzip_http_version 1.1;\n gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;\n\n # Include server configurations\n include /etc/nginx/conf.d/*.conf;\n }\n djangoblog.conf: |\n server {\n server_name lylinux.net;\n root /code/djangoblog/collectedstatic/;\n listen 80;\n keepalive_timeout 70;\n location /static/ {\n expires max;\n alias /code/djangoblog/collectedstatic/;\n }\n\n location ~* (robots\\.txt|ads\\.txt|favicon\\.ico|favion\\.ico|crossdomain\\.xml|google93fd32dbd906620a\\.html|BingSiteAuth\\.xml|baidu_verify_Ijeny6KrmS\\.html)$ {\n root /resource/djangopub;\n expires 1d;\n access_log off;\n error_log off;\n }\n\n location / {\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header Host $http_host;\n proxy_set_header X-NginX-Proxy true;\n proxy_redirect off;\n if (!-f $request_filename) {\n proxy_pass http://djangoblog:8000;\n break;\n }\n }\n }\n server {\n server_name www.lylinux.net;\n listen 80;\n return 301 https://lylinux.net$request_uri;\n }\n resource.lylinux.net.conf: |\n server {\n index index.html index.htm;\n server_name resource.lylinux.net;\n root /resource/;\n\n location /djangoblog/ {\n alias /code/djangoblog/collectedstatic/;\n }\n\n access_log off;\n error_log off;\n include lylinux/resource.conf;\n }\n lylinux.resource.conf: |\n expires max;\n access_log off;\n log_not_found off;\n add_header Pragma public;\n add_header Cache-Control \"public\";\n add_header \"Access-Control-Allow-Origin\" \"*\";\n\n---\napiVersion: v1\nkind: ConfigMap\nmetadata:\n name: djangoblog-env\n namespace: djangoblog\ndata:\n DJANGO_MYSQL_DATABASE: djangoblog\n DJANGO_MYSQL_USER: root\n DJANGO_MYSQL_PASSWORD: QQQQwww123!@#\n DJANGO_MYSQL_HOST: db\n DJANGO_MYSQL_PORT: \"3306\"\n DJANGO_REDIS_URL: \"redis:6379\"\n DJANGO_DEBUG: \"False\"\n MYSQL_ROOT_PASSWORD: QQQQwww123!@#\n MYSQL_DATABASE: djangoblog\n MYSQL_PASSWORD: QQQQwww123!@#\n DJANGO_SECRET_KEY: k8s-test-secret-key-12345678\n\n"
},
{
"path": "deploy/k8s/deployment.yaml",
"content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: djangoblog\n namespace: djangoblog\n labels:\n app: djangoblog\nspec:\n replicas: 3\n selector:\n matchLabels:\n app: djangoblog\n template:\n metadata:\n labels:\n app: djangoblog\n spec:\n containers:\n - name: djangoblog\n image: liangliangyy/djangoblog:latest\n imagePullPolicy: Always\n ports:\n - containerPort: 8000\n envFrom:\n - configMapRef:\n name: djangoblog-env\n readinessProbe:\n httpGet:\n path: /health/\n port: 8000\n initialDelaySeconds: 60\n periodSeconds: 30\n livenessProbe:\n httpGet:\n path: /health/\n port: 8000\n initialDelaySeconds: 60\n periodSeconds: 30\n resources:\n requests:\n cpu: 10m\n memory: 100Mi\n limits:\n cpu: \"2\"\n memory: 2Gi\n volumeMounts:\n - name: djangoblog\n mountPath: /code/djangoblog/collectedstatic\n - name: resource\n mountPath: /resource\n volumes:\n - name: djangoblog\n persistentVolumeClaim:\n claimName: djangoblog-pvc\n - name: resource\n persistentVolumeClaim:\n claimName: resource-pvc\n\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: redis\n namespace: djangoblog\n labels:\n app: redis\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: redis\n template:\n metadata:\n labels:\n app: redis\n spec:\n containers:\n - name: redis\n image: redis:latest\n imagePullPolicy: IfNotPresent\n ports:\n - containerPort: 6379\n resources:\n requests:\n cpu: 10m\n memory: 100Mi\n limits:\n cpu: 200m\n memory: 2Gi\n \n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: db\n namespace: djangoblog\n labels:\n app: db\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: db\n template:\n metadata:\n labels:\n app: db\n spec:\n containers:\n - name: db\n image: mysql:latest\n imagePullPolicy: IfNotPresent\n ports:\n - containerPort: 3306\n envFrom:\n - configMapRef:\n name: djangoblog-env\n readinessProbe:\n exec:\n command:\n - mysqladmin\n - ping\n - \"-h\"\n - \"127.0.0.1\"\n - \"-u\"\n - \"root\"\n - \"-p$MYSQL_ROOT_PASSWORD\"\n initialDelaySeconds: 30\n periodSeconds: 10\n livenessProbe:\n exec:\n command:\n - mysqladmin\n - ping\n - \"-h\"\n - \"127.0.0.1\"\n - \"-u\"\n - \"root\"\n - \"-p$MYSQL_ROOT_PASSWORD\"\n initialDelaySeconds: 30\n periodSeconds: 10\n resources:\n requests:\n cpu: 10m\n memory: 100Mi\n limits:\n cpu: \"2\"\n memory: 2Gi\n volumeMounts:\n - name: db-data\n mountPath: /var/lib/mysql\n volumes:\n - name: db-data\n persistentVolumeClaim:\n claimName: db-pvc\n \n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx\n namespace: djangoblog\n labels:\n app: nginx\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n spec:\n containers:\n - name: nginx\n image: nginx:latest\n imagePullPolicy: IfNotPresent\n ports:\n - containerPort: 80\n resources:\n requests:\n cpu: 10m\n memory: 100Mi\n limits:\n cpu: \"2\"\n memory: 2Gi\n volumeMounts:\n - name: nginx-config\n mountPath: /etc/nginx/nginx.conf\n subPath: nginx.conf\n - name: nginx-config\n mountPath: /etc/nginx/conf.d/default.conf\n subPath: djangoblog.conf\n - name: nginx-config\n mountPath: /etc/nginx/conf.d/resource.lylinux.net.conf\n subPath: resource.lylinux.net.conf\n - name: nginx-config\n mountPath: /etc/nginx/lylinux/resource.conf\n subPath: lylinux.resource.conf\n - name: djangoblog-pvc\n mountPath: /code/djangoblog/collectedstatic\n - name: resource-pvc\n mountPath: /resource\n volumes:\n - name: nginx-config\n configMap:\n name: web-nginx-config\n - name: djangoblog-pvc\n persistentVolumeClaim:\n claimName: djangoblog-pvc\n - name: resource-pvc\n persistentVolumeClaim:\n claimName: resource-pvc\n\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: elasticsearch\n namespace: djangoblog\n labels:\n app: elasticsearch\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: elasticsearch\n template:\n metadata:\n labels:\n app: elasticsearch\n spec:\n containers:\n - name: elasticsearch\n image: liangliangyy/elasticsearch-analysis-ik:8.6.1\n imagePullPolicy: IfNotPresent\n env:\n - name: discovery.type\n value: single-node\n - name: ES_JAVA_OPTS\n value: \"-Xms256m -Xmx256m\"\n - name: xpack.security.enabled\n value: \"false\"\n - name: xpack.monitoring.templates.enabled\n value: \"false\"\n ports:\n - containerPort: 9200\n resources:\n requests:\n cpu: 10m\n memory: 100Mi\n limits:\n cpu: \"2\"\n memory: 2Gi\n readinessProbe:\n httpGet:\n path: /\n port: 9200\n initialDelaySeconds: 15\n periodSeconds: 30\n livenessProbe:\n httpGet:\n path: /\n port: 9200\n initialDelaySeconds: 15\n periodSeconds: 30\n volumeMounts:\n - name: elasticsearch-data\n mountPath: /usr/share/elasticsearch/data/\n volumes:\n - name: elasticsearch-data\n persistentVolumeClaim:\n claimName: elasticsearch-pvc\n"
},
{
"path": "deploy/k8s/gateway.yaml",
"content": "apiVersion: networking.k8s.io/v1\nkind: Ingress\nmetadata:\n name: nginx\n namespace: djangoblog\nspec:\n ingressClassName: nginx\n rules:\n - http:\n paths:\n - path: /\n pathType: Prefix\n backend:\n service:\n name: nginx\n port:\n number: 80"
},
{
"path": "deploy/k8s/pv.yaml",
"content": "apiVersion: v1\nkind: PersistentVolume\nmetadata:\n name: local-pv-db\nspec:\n capacity:\n storage: 10Gi\n volumeMode: Filesystem\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Retain\n storageClassName: local-storage\n local:\n path: /mnt/local-storage-db\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n - master \n---\napiVersion: v1\nkind: PersistentVolume\nmetadata:\n name: local-pv-djangoblog\nspec:\n capacity:\n storage: 5Gi\n volumeMode: Filesystem\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Retain\n storageClassName: local-storage\n local:\n path: /mnt/local-storage-djangoblog\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n - master \n\n\n---\napiVersion: v1\nkind: PersistentVolume\nmetadata:\n name: local-pv-resource\nspec:\n capacity:\n storage: 5Gi\n volumeMode: Filesystem\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Retain\n storageClassName: local-storage\n local:\n path: /mnt/resource/\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n - master \n\n---\napiVersion: v1\nkind: PersistentVolume\nmetadata:\n name: local-pv-elasticsearch\nspec:\n capacity:\n storage: 5Gi\n volumeMode: Filesystem\n accessModes:\n - ReadWriteOnce\n persistentVolumeReclaimPolicy: Retain\n storageClassName: local-storage\n local:\n path: /mnt/local-storage-elasticsearch\n nodeAffinity:\n required:\n nodeSelectorTerms:\n - matchExpressions:\n - key: kubernetes.io/hostname\n operator: In\n values:\n - master"
},
{
"path": "deploy/k8s/pvc.yaml",
"content": "apiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n name: db-pvc\n namespace: djangoblog\nspec:\n storageClassName: local-storage\n volumeName: local-pv-db\n accessModes:\n - ReadWriteOnce\n resources:\n requests:\n storage: 10Gi\n\n\n---\napiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n name: djangoblog-pvc\n namespace: djangoblog\nspec:\n volumeName: local-pv-djangoblog\n storageClassName: local-storage\n accessModes:\n - ReadWriteOnce\n resources:\n requests:\n storage: 5Gi\n\n---\napiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n name: resource-pvc\n namespace: djangoblog\nspec:\n volumeName: local-pv-resource\n storageClassName: local-storage\n accessModes:\n - ReadWriteOnce\n resources:\n requests:\n storage: 5Gi\n\n---\napiVersion: v1\nkind: PersistentVolumeClaim\nmetadata:\n name: elasticsearch-pvc\n namespace: djangoblog\nspec:\n volumeName: local-pv-elasticsearch\n storageClassName: local-storage\n accessModes:\n - ReadWriteOnce\n resources:\n requests:\n storage: 5Gi\n "
},
{
"path": "deploy/k8s/service.yaml",
"content": "apiVersion: v1\nkind: Service\nmetadata:\n name: djangoblog\n namespace: djangoblog\n labels:\n app: djangoblog\nspec:\n selector:\n app: djangoblog\n ports:\n - protocol: TCP\n port: 8000\n targetPort: 8000\n type: ClusterIP\n---\napiVersion: v1\nkind: Service\nmetadata:\n name: nginx\n namespace: djangoblog\n labels:\n app: nginx\nspec:\n selector:\n app: nginx\n ports:\n - protocol: TCP\n port: 80\n targetPort: 80\n type: ClusterIP \n---\napiVersion: v1\nkind: Service\nmetadata:\n name: redis\n namespace: djangoblog\n labels:\n app: redis\nspec:\n selector:\n app: redis\n ports:\n - protocol: TCP\n port: 6379\n targetPort: 6379\n type: ClusterIP\n---\napiVersion: v1\nkind: Service\nmetadata:\n name: db\n namespace: djangoblog\n labels:\n app: db\nspec:\n selector:\n app: db\n ports:\n - protocol: TCP\n port: 3306\n targetPort: 3306\n type: ClusterIP\n---\napiVersion: v1\nkind: Service\nmetadata:\n name: elasticsearch\n namespace: djangoblog\n labels:\n app: elasticsearch\nspec:\n selector:\n app: elasticsearch\n ports:\n - protocol: TCP\n port: 9200\n targetPort: 9200\n type: ClusterIP\n\n"
},
{
"path": "deploy/k8s/storageclass.yaml",
"content": "apiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\n name: local-storage\n annotations:\n storageclass.kubernetes.io/is-default-class: \"true\" \nprovisioner: kubernetes.io/no-provisioner\nvolumeBindingMode: Immediate \n\n\n"
},
{
"path": "deploy/nginx.conf",
"content": "user nginx;\nworker_processes auto;\n\nerror_log /var/log/nginx/error.log notice;\npid /var/run/nginx.pid;\n\n\nevents {\n worker_connections 1024;\n}\n\n\nhttp {\n include /etc/nginx/mime.types;\n default_type application/octet-stream;\n\n log_format main '$remote_addr - $remote_user [$time_local] \"$request\" '\n '$status $body_bytes_sent \"$http_referer\" '\n '\"$http_user_agent\" \"$http_x_forwarded_for\"';\n\n access_log /var/log/nginx/access.log main;\n\n sendfile on;\n #tcp_nopush on;\n\n keepalive_timeout 65;\n\n #gzip on;\n\n server {\n root /code/djangoblog/collectedstatic/;\n listen 80;\n keepalive_timeout 70;\n location /static/ {\n expires max;\n alias /code/djangoblog/collectedstatic/;\n }\n location / {\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header Host $http_host;\n proxy_set_header X-NginX-Proxy true;\n proxy_redirect off;\n if (!-f $request_filename) {\n proxy_pass http://djangoblog:8000;\n break;\n }\n }\n }\n}\n"
},
{
"path": "djangoblog/__init__.py",
"content": "default_app_config = 'djangoblog.apps.DjangoblogAppConfig'\n"
},
{
"path": "djangoblog/admin_site.py",
"content": "from django.contrib.admin import AdminSite\nfrom django.contrib.admin.models import LogEntry\nfrom django.contrib.sites.admin import SiteAdmin\nfrom django.contrib.sites.models import Site\n\nfrom accounts.admin import *\nfrom blog.admin import *\nfrom blog.models import *\nfrom comments.admin import *\nfrom comments.models import *\nfrom djangoblog.logentryadmin import LogEntryAdmin\nfrom oauth.admin import *\nfrom oauth.models import *\nfrom owntracks.admin import *\nfrom owntracks.models import *\nfrom servermanager.admin import *\nfrom servermanager.models import *\n\n\nclass DjangoBlogAdminSite(AdminSite):\n site_header = 'djangoblog administration'\n site_title = 'djangoblog site admin'\n\n def __init__(self, name='admin'):\n super().__init__(name)\n\n def has_permission(self, request):\n return request.user.is_superuser\n\n # def get_urls(self):\n # urls = super().get_urls()\n # from django.urls import path\n # from blog.views import refresh_memcache\n #\n # my_urls = [\n # path('refresh/', self.admin_view(refresh_memcache), name=\"refresh\"),\n # ]\n # return urls + my_urls\n\n\nadmin_site = DjangoBlogAdminSite(name='admin')\n\nadmin_site.register(Article, ArticlelAdmin)\nadmin_site.register(Category, CategoryAdmin)\nadmin_site.register(Tag, TagAdmin)\nadmin_site.register(Links, LinksAdmin)\nadmin_site.register(SideBar, SideBarAdmin)\nadmin_site.register(BlogSettings, BlogSettingsAdmin)\n\nadmin_site.register(commands, CommandsAdmin)\nadmin_site.register(EmailSendLog, EmailSendLogAdmin)\n\nadmin_site.register(BlogUser, BlogUserAdmin)\n\nadmin_site.register(Comment, CommentAdmin)\n\nadmin_site.register(OAuthUser, OAuthUserAdmin)\nadmin_site.register(OAuthConfig, OAuthConfigAdmin)\n\nadmin_site.register(OwnTrackLog, OwnTrackLogsAdmin)\n\nadmin_site.register(Site, SiteAdmin)\n\nadmin_site.register(LogEntry, LogEntryAdmin)\n"
},
{
"path": "djangoblog/apps.py",
"content": "from django.apps import AppConfig\n\nclass DjangoblogAppConfig(AppConfig):\n default_auto_field = 'django.db.models.BigAutoField'\n name = 'djangoblog'\n\n def ready(self):\n super().ready()\n # Import and load plugins here\n from .plugin_manage.loader import load_plugins\n load_plugins() "
},
{
"path": "djangoblog/base_views.py",
"content": "#!/usr/bin/env python\n# encoding: utf-8\n\n\"\"\"\nDjango Blog 基础视图类\n提供带有常用装饰器的视图基类，减少重复的 dispatch 方法定义\n\"\"\"\n\nfrom django.contrib.auth.decorators import login_required\nfrom django.utils.decorators import method_decorator\nfrom django.views.decorators.cache import never_cache\nfrom django.views.decorators.csrf import csrf_protect\nfrom django.views.decorators.debug import sensitive_post_parameters\nfrom django.views.generic import FormView, RedirectView\n\n\nclass SecureFormView(FormView):\n \"\"\"\n 安全的 FormView 基类\n\n 自动添加 CSRF 保护，适用于所有需要表单提交的视图\n\n Usage:\n class MyFormView(SecureFormView):\n form_class = MyForm\n template_name = 'my_form.html'\n\n def form_valid(self, form):\n # 处理表单数据\n return super().form_valid(form)\n \"\"\"\n\n @method_decorator(csrf_protect)\n def dispatch(self, *args, **kwargs):\n \"\"\"添加 CSRF 保护\"\"\"\n return super().dispatch(*args, **kwargs)\n\n\nclass AuthenticatedFormView(FormView):\n \"\"\"\n 需要登录的 FormView\n\n 自动检查用户登录状态并添加 CSRF 保护\n 未登录用户会被重定向到登录页面\n\n Usage:\n class MyAuthFormView(AuthenticatedFormView):\n form_class = MyForm\n template_name = 'my_form.html'\n \"\"\"\n\n @method_decorator(login_required)\n @method_decorator(csrf_protect)\n def dispatch(self, *args, **kwargs):\n \"\"\"添加登录要求和 CSRF 保护\"\"\"\n return super().dispatch(*args, **kwargs)\n\n\nclass LoginFormView(FormView):\n \"\"\"\n 登录专用 FormView\n\n 包含以下保护措施：\n - 敏感参数保护（password 等）\n - CSRF 保护\n - 禁用缓存（防止登录状态被缓存）\n\n Usage:\n class LoginView(LoginFormView):\n form_class = LoginForm\n template_name = 'login.html'\n\n def form_valid(self, form):\n # 处理登录逻辑\n return super().form_valid(form)\n \"\"\"\n\n @method_decorator(sensitive_post_parameters('password'))\n @method_decorator(csrf_protect)\n @method_decorator(never_cache)\n def dispatch(self, request, *args, **kwargs):\n \"\"\"添加敏感参数保护、CSRF 保护和禁用缓存\"\"\"\n return super().dispatch(request, *args, **kwargs)\n\n\nclass LogoutRedirectView(RedirectView):\n \"\"\"\n 登出专用 RedirectView\n\n 自动禁用缓存，确保登出操作不会被缓存\n\n Usage:\n class LogoutView(LogoutRedirectView):\n url = '/login/'\n\n def get(self, request, *args, **kwargs):\n logout(request)\n return super().get(request, *args, **kwargs)\n \"\"\"\n\n @method_decorator(never_cache)\n def dispatch(self, request, *args, **kwargs):\n \"\"\"禁用缓存\"\"\"\n return super().dispatch(request, *args, **kwargs)\n\n\nclass NoCacheFormView(FormView):\n \"\"\"\n 禁用缓存的 FormView\n\n 适用于需要实时数据的表单（如验证码、动态内容等）\n\n Usage:\n class MyCacheDisabledFormView(NoCacheFormView):\n form_class = MyForm\n template_name = 'my_form.html'\n \"\"\"\n\n @method_decorator(never_cache)\n @method_decorator(csrf_protect)\n def dispatch(self, request, *args, **kwargs):\n \"\"\"禁用缓存并添加 CSRF 保护\"\"\"\n return super().dispatch(request, *args, **kwargs)\n"
},
{
"path": "djangoblog/blog_signals.py",
"content": "import _thread\nimport logging\n\nimport django.dispatch\nfrom django.conf import settings\nfrom django.contrib.admin.models import LogEntry\nfrom django.contrib.auth.signals import user_logged_in, user_logged_out\nfrom django.core.mail import EmailMultiAlternatives\nfrom django.db.models.signals import post_save\nfrom django.dispatch import receiver\n\nfrom comments.models import Comment\nfrom comments.utils import send_comment_email\nfrom djangoblog.spider_notify import SpiderNotify\nfrom djangoblog.utils import cache, expire_view_cache, delete_sidebar_cache, delete_view_cache\nfrom djangoblog.utils import get_current_site\nfrom oauth.models import OAuthUser\n\nlogger = logging.getLogger(__name__)\n\noauth_user_login_signal = django.dispatch.Signal(['id'])\nsend_email_signal = django.dispatch.Signal(\n ['emailto', 'title', 'content'])\n\n\n@receiver(send_email_signal)\ndef send_email_signal_handler(sender, **kwargs):\n emailto = kwargs['emailto']\n title = kwargs['title']\n content = kwargs['content']\n\n msg = EmailMultiAlternatives(\n title,\n content,\n from_email=settings.DEFAULT_FROM_EMAIL,\n to=emailto)\n msg.content_subtype = \"html\"\n\n from servermanager.models import EmailSendLog\n log = EmailSendLog()\n log.title = title\n log.content = content\n log.emailto = ','.join(emailto)\n\n try:\n result = msg.send()\n log.send_result = result > 0\n except Exception as e:\n logger.error(f\"失败邮箱号: {emailto}, {e}\")\n log.send_result = False\n log.save()\n\n\n@receiver(oauth_user_login_signal)\ndef oauth_user_login_signal_handler(sender, **kwargs):\n id = kwargs['id']\n oauthuser = OAuthUser.objects.get(id=id)\n site = get_current_site().domain\n if oauthuser.picture and not oauthuser.picture.find(site) >= 0:\n from djangoblog.utils import save_user_avatar\n oauthuser.picture = save_user_avatar(oauthuser.picture)\n oauthuser.save()\n\n delete_sidebar_cache()\n\n\n@receiver(post_save)\ndef model_post_save_callback(\n sender,\n instance,\n created,\n raw,\n using,\n update_fields,\n **kwargs):\n if isinstance(instance, LogEntry):\n return\n\n # 检查是否只更新了浏览量\n is_update_views = update_fields == {'views'}\n if is_update_views:\n return # 浏览量更新不需要清理缓存\n\n # 搜索引擎通知\n if 'get_full_url' in dir(instance):\n if not settings.TESTING:\n try:\n notify_url = instance.get_full_url()\n SpiderNotify.baidu_notify([notify_url])\n except Exception as ex:\n logger.error(\"notify sipder\", ex)\n\n # 评论相关的缓存清理\n if isinstance(instance, Comment):\n if instance.is_enable:\n path = instance.article.get_absolute_url()\n site = get_current_site().domain\n if site.find(':') > 0:\n site = site[0:site.find(':')]\n\n expire_view_cache(\n path,\n servername=site,\n serverport=80,\n key_prefix='blogdetail')\n\n # 清理评论相关缓存\n comment_cache_key = 'article_comments_{id}'.format(\n id=instance.article.id)\n cache.delete(comment_cache_key)\n delete_view_cache('article_comments', [str(instance.article.pk)])\n delete_sidebar_cache()\n cache.delete('seo_processor')\n\n _thread.start_new_thread(send_comment_email, (instance,))\n\n # 文章相关的精细化缓存清理\n elif 'get_full_url' in dir(instance):\n from blog.models import Article, Category, Tag\n\n if isinstance(instance, Article):\n # 清理文章列表首页缓存\n cache.delete('index_1')\n\n # 清理文章详情缓存\n article_cache_key = f'article_comments_{instance.id}'\n cache.delete(article_cache_key)\n\n # 清理分类相关缓存\n if instance.category:\n category_name = instance.category.name\n cache.delete(f'category_list_{category_name}_1')\n\n # 清理标签相关缓存\n try:\n for tag in instance.tags.all():\n cache.delete(f'tag_{tag.name}_1')\n except Exception:\n pass # 可能在创建时tags还未关联\n\n # 清理作者相关缓存\n if instance.author:\n from uuslug import slugify\n author_slug = slugify(instance.author.username)\n cache.delete(f'author_{author_slug}_1')\n\n # 清理归档缓存\n cache.delete('archives')\n\n # 清理侧边栏和上下文处理器缓存\n delete_sidebar_cache()\n cache.delete('seo_processor')\n\n elif isinstance(instance, Category):\n # 清理分类相关缓存\n cache.delete(f'category_list_{instance.name}_1')\n delete_sidebar_cache()\n cache.delete('seo_processor')\n\n elif isinstance(instance, Tag):\n # 清理标签相关缓存\n cache.delete(f'tag_{instance.name}_1')\n delete_sidebar_cache()\n\n # 其他模型的缓存清理\n else:\n # 对于其他有get_full_url的模型，清理基础缓存\n delete_sidebar_cache()\n cache.delete('seo_processor')\n\n\n@receiver(user_logged_in)\n@receiver(user_logged_out)\ndef user_auth_callback(sender, request, user, **kwargs):\n if user and user.username:\n logger.info(user)\n delete_sidebar_cache()\n # cache.clear()\n"
},
{
"path": "djangoblog/constants.py",
"content": "#!/usr/bin/env python\n# encoding: utf-8\n\n\"\"\"\nDjango Blog 全局常量定义\n包含缓存超时时间、缓存键模板等配置\n\"\"\"\n\n\n# ===== 缓存过期时间（秒）=====\nclass CacheTimeout:\n \"\"\"\n 缓存超时时间常量\n 集中管理所有缓存过期时间，便于统一调整缓存策略\n \"\"\"\n # 分钟级\n MINUTE_1 = 60\n MINUTE_5 = 60 * 5\n MINUTE_10 = 60 * 10\n MINUTE_30 = 60 * 30\n\n # 小时级\n HOUR_1 = 60 * 60\n HOUR_2 = 60 * 60 * 2\n HOUR_10 = 60 * 60 * 10\n HOUR_24 = 60 * 60 * 24\n\n # 天级\n DAY_7 = 60 * 60 * 24 * 7\n DAY_30 = 60 * 60 * 24 * 30\n\n # 默认缓存时间\n DEFAULT = HOUR_10 # 10小时\n\n\n# ===== 缓存键前缀 =====\nclass CacheKey:\n \"\"\"\n 缓存键模板\n 使用字符串格式化模板，避免缓存键拼写错误\n \"\"\"\n # 文章相关\n ARTICLE_COMMENTS = 'article_comments_{article_id}'\n ARTICLE_NEXT = 'article_next_{article_id}'\n ARTICLE_PREV = 'article_prev_{article_id}'\n ARTICLE_CATEGORY_TREE = 'article_category_tree_{article_id}'\n\n # 列表页缓存\n INDEX_LIST = 'index_{page}'\n CATEGORY_LIST = 'category_list_{name}_{page}'\n TAG_LIST = 'tag_{name}_{page}'\n AUTHOR_LIST = 'author_{name}_{page}'\n ARCHIVES = 'archives'\n\n # 分类和标签\n CATEGORY_TREE = 'category_tree_{category_id}'\n SUB_CATEGORIES = 'sub_categories_{category_id}'\n TAG_ARTICLE_COUNT = 'tag_article_count_{tag_id}'\n\n # 全局设置\n BLOG_SETTINGS = 'blog_settings'\n CURRENT_SITE = 'current_site'\n SIDEBAR = 'sidebar_{type}'\n\n # 侧边栏相关\n SIDEBAR_LATEST_ARTICLES = 'sidebar_latest_articles'\n SIDEBAR_HOT_ARTICLES = 'sidebar_hot_articles'\n SIDEBAR_LATEST_COMMENTS = 'sidebar_latest_comments'\n\n\n# ===== HTTP 状态码 =====\nclass HttpStatus:\n \"\"\"HTTP 状态码常量\"\"\"\n OK = 200\n CREATED = 201\n NO_CONTENT = 204\n\n BAD_REQUEST = 400\n UNAUTHORIZED = 401\n FORBIDDEN = 403\n NOT_FOUND = 404\n\n INTERNAL_SERVER_ERROR = 500\n BAD_GATEWAY = 502\n SERVICE_UNAVAILABLE = 503\n\n\n# ===== 分页配置 =====\nclass Pagination:\n \"\"\"分页相关常量\"\"\"\n DEFAULT_PAGE_SIZE = 10\n MAX_PAGE_SIZE = 100\n PAGE_QUERY_PARAM = 'page'\n"
},
{
"path": "djangoblog/elasticsearch_backend.py",
"content": "from django.utils.encoding import force_str\nfrom elasticsearch_dsl import Q\nfrom haystack.backends import BaseEngine, BaseSearchBackend, BaseSearchQuery, log_query\nfrom haystack.forms import ModelSearchForm\nfrom haystack.models import SearchResult\nfrom haystack.utils import log as logging\n\nfrom blog.documents import ArticleDocument, ArticleDocumentManager\nfrom blog.models import Article\n\nlogger = logging.getLogger(__name__)\n\n\nclass ElasticSearchBackend(BaseSearchBackend):\n def __init__(self, connection_alias, **connection_options):\n super(\n ElasticSearchBackend,\n self).__init__(\n connection_alias,\n **connection_options)\n self.manager = ArticleDocumentManager()\n self.include_spelling = True\n\n def _get_models(self, iterable):\n models = iterable if iterable and iterable[0] else Article.objects.all()\n docs = self.manager.convert_to_doc(models)\n return docs\n\n def _create(self, models):\n self.manager.create_index()\n docs = self._get_models(models)\n self.manager.rebuild(docs)\n\n def _delete(self, models):\n for m in models:\n m.delete()\n return True\n\n def _rebuild(self, models):\n models = models if models else Article.objects.all()\n docs = self.manager.convert_to_doc(models)\n self.manager.update_docs(docs)\n\n def update(self, index, iterable, commit=True):\n\n models = self._get_models(iterable)\n self.manager.update_docs(models)\n\n def remove(self, obj_or_string):\n models = self._get_models([obj_or_string])\n self._delete(models)\n\n def clear(self, models=None, commit=True):\n self.remove(None)\n\n @staticmethod\n def get_suggestion(query: str) -> str:\n \"\"\"获取推荐词, 如果没有找到添加原搜索词\"\"\"\n\n search = ArticleDocument.search() \\\n .query(\"match\", body=query) \\\n .suggest('suggest_search', query, term={'field': 'body'}) \\\n .execute()\n\n keywords = []\n for suggest in search.suggest.suggest_search:\n if suggest[\"options\"]:\n keywords.append(suggest[\"options\"][0][\"text\"])\n else:\n keywords.append(suggest[\"text\"])\n\n return ' '.join(keywords)\n\n @log_query\n def search(self, query_string, **kwargs):\n logger.info('search query_string:' + query_string)\n\n start_offset = kwargs.get('start_offset')\n end_offset = kwargs.get('end_offset')\n highlight = kwargs.get('highlight', True) # 默认启用高亮\n\n # 推荐词搜索\n if getattr(self, \"is_suggest\", None):\n suggestion = self.get_suggestion(query_string)\n else:\n suggestion = query_string\n\n q = Q('bool',\n should=[Q('match', body=suggestion), Q('match', title=suggestion)],\n minimum_should_match=1) # 至少匹配1个should子句\n\n search = ArticleDocument.search() \\\n .query('bool', filter=[q]) \\\n .filter('term', status='p') \\\n .filter('term', type='a')\n\n # 添加高亮配置\n if highlight:\n search = search.highlight('title', 'body',\n fragment_size=150, # 片段大小\n number_of_fragments=3, # 片段数量\n pre_tags=[''], # 高亮开始标签\n post_tags=[' ']) # 高亮结束标签\n\n search = search.source(False)[start_offset: end_offset]\n\n results = search.execute()\n # ES 8.x: total 现在是对象 {'value': 123, 'relation': 'eq'}\n hits_total = results['hits']['total']\n hits = hits_total['value'] if isinstance(hits_total, dict) else hits_total\n raw_results = []\n for raw_result in results['hits']['hits']:\n app_label = 'blog'\n model_name = 'Article'\n additional_fields = {}\n\n # 添加高亮内容\n if highlight and 'highlight' in raw_result:\n highlighted = {}\n if 'title' in raw_result['highlight']:\n highlighted['title'] = raw_result['highlight']['title']\n if 'body' in raw_result['highlight']:\n highlighted['body'] = raw_result['highlight']['body']\n\n if highlighted:\n additional_fields['highlighted'] = highlighted\n\n result_class = SearchResult\n\n result = result_class(\n app_label,\n model_name,\n raw_result['_id'],\n raw_result['_score'],\n **additional_fields)\n raw_results.append(result)\n facets = {}\n spelling_suggestion = None if query_string == suggestion else suggestion\n\n return {\n 'results': raw_results,\n 'hits': hits,\n 'facets': facets,\n 'spelling_suggestion': spelling_suggestion,\n }\n\n\nclass ElasticSearchQuery(BaseSearchQuery):\n def _convert_datetime(self, date):\n if hasattr(date, 'hour'):\n return force_str(date.strftime('%Y%m%d%H%M%S'))\n else:\n return force_str(date.strftime('%Y%m%d000000'))\n\n def clean(self, query_fragment):\n \"\"\"\n Provides a mechanism for sanitizing user input before presenting the\n value to the backend.\n\n Whoosh 1.X differs here in that you can no longer use a backslash\n to escape reserved characters. Instead, the whole word should be\n quoted.\n \"\"\"\n words = query_fragment.split()\n cleaned_words = []\n\n for word in words:\n if word in self.backend.RESERVED_WORDS:\n word = word.replace(word, word.lower())\n\n for char in self.backend.RESERVED_CHARACTERS:\n if char in word:\n word = \"'%s'\" % word\n break\n\n cleaned_words.append(word)\n\n return ' '.join(cleaned_words)\n\n def build_query_fragment(self, field, filter_type, value):\n return value.query_string\n\n def get_count(self):\n results = self.get_results()\n return len(results) if results else 0\n\n def get_spelling_suggestion(self, preferred_query=None):\n return self._spelling_suggestion\n\n def build_params(self, spelling_query=None):\n kwargs = super(ElasticSearchQuery, self).build_params(spelling_query=spelling_query)\n return kwargs\n\n\nclass ElasticSearchModelSearchForm(ModelSearchForm):\n\n def search(self):\n # 是否建议搜索\n self.searchqueryset.query.backend.is_suggest = self.data.get(\"is_suggest\") != \"no\"\n sqs = super().search()\n return sqs\n\n\nclass ElasticSearchEngine(BaseEngine):\n backend = ElasticSearchBackend\n query = ElasticSearchQuery\n"
},
{
"path": "djangoblog/error_views.py",
"content": "#!/usr/bin/env python\n# encoding: utf-8\n\n\"\"\"\nDjango Blog 统一错误处理视图\n提供统一的错误页面渲染，减少重复代码\n\"\"\"\n\nimport logging\nfrom django.shortcuts import render\nfrom django.utils.translation import gettext_lazy as _\n\nlogger = logging.getLogger(__name__)\n\n\ndef render_error_page(request, status_code, message, exception=None):\n \"\"\"\n 通用错误页面渲染函数\n\n 统一处理各种 HTTP 错误，提供一致的错误页面展示\n\n Args:\n request: HTTP 请求对象\n status_code: HTTP 状态码（404, 403, 500等）\n message: 错误消息（支持国际化）\n exception: 异常对象（可选），会被记录到日志\n\n Returns:\n HttpResponse: 渲染后的错误页面\n\n Usage:\n def my_error_handler(request, exception):\n return render_error_page(request, 404, \"Page not found\", exception)\n \"\"\"\n if exception:\n logger.error(\n f'HTTP {status_code} Error: {exception}',\n exc_info=True,\n extra={\n 'request': request,\n 'status_code': status_code\n }\n )\n\n return render(\n request,\n 'blog/error_page.html',\n {\n 'message': message,\n 'statuscode': str(status_code)\n },\n status=status_code\n )\n\n\ndef page_not_found_view(request, exception, template_name='blog/error_page.html'):\n \"\"\"\n 404 错误页面处理器\n\n 当用户访问不存在的页面时显示\n\n Args:\n request: HTTP 请求对象\n exception: 异常对象\n template_name: 模板名称（保留参数以兼容 Django 标准）\n\n Returns:\n HttpResponse: 404 错误页面\n \"\"\"\n return render_error_page(\n request,\n 404,\n _('Sorry, the page you requested is not found, please click the home page to see other?'),\n exception\n )\n\n\ndef server_error_view(request, template_name='blog/error_page.html'):\n \"\"\"\n 500 错误页面处理器\n\n 当服务器内部错误时显示\n\n Args:\n request: HTTP 请求对象\n template_name: 模板名称（保留参数以兼容 Django 标准）\n\n Returns:\n HttpResponse: 500 错误页面\n \"\"\"\n return render_error_page(\n request,\n 500,\n _('Sorry, the server is busy, please click the home page to see other?')\n )\n\n\ndef permission_denied_view(request, exception, template_name='blog/error_page.html'):\n \"\"\"\n 403 错误页面处理器\n\n 当用户无权限访问时显示\n\n Args:\n request: HTTP 请求对象\n exception: 异常对象\n template_name: 模板名称（保留参数以兼容 Django 标准）\n\n Returns:\n HttpResponse: 403 错误页面\n \"\"\"\n return render_error_page(\n request,\n 403,\n _('Sorry, you do not have permission to access this page?'),\n exception\n )\n\n\ndef bad_request_view(request, exception, template_name='blog/error_page.html'):\n \"\"\"\n 400 错误页面处理器\n\n 当请求格式错误时显示\n\n Args:\n request: HTTP 请求对象\n exception: 异常对象\n template_name: 模板名称（保留参数以兼容 Django 标准）\n\n Returns:\n HttpResponse: 400 错误页面\n \"\"\"\n return render_error_page(\n request,\n 400,\n _('Sorry, the request was invalid?'),\n exception\n )\n"
},
{
"path": "djangoblog/feeds.py",
"content": "from django.contrib.auth import get_user_model\nfrom django.contrib.syndication.views import Feed\nfrom django.utils import timezone\nfrom django.utils.feedgenerator import Rss201rev2Feed\n\nfrom blog.models import Article\nfrom djangoblog.utils import CommonMarkdown\n\n\nclass DjangoBlogFeed(Feed):\n feed_type = Rss201rev2Feed\n\n description = '大巧无工,重剑无锋.'\n title = \"且听风吟 大巧无工,重剑无锋. \"\n link = \"/feed/\"\n\n def author_name(self):\n return get_user_model().objects.first().nickname\n\n def author_link(self):\n return get_user_model().objects.first().get_absolute_url()\n\n def items(self):\n return Article.objects.filter(type='a', status='p').order_by('-pub_time')[:5]\n\n def item_title(self, item):\n return item.title\n\n def item_description(self, item):\n return CommonMarkdown.get_markdown(item.body)\n\n def feed_copyright(self):\n now = timezone.now()\n return \"Copyright© {year} 且听风吟\".format(year=now.year)\n\n def item_link(self, item):\n return item.get_absolute_url()\n\n def item_guid(self, item):\n return\n"
},
{
"path": "djangoblog/logentryadmin.py",
"content": "from django.contrib import admin\nfrom django.contrib.admin.models import DELETION\nfrom django.contrib.contenttypes.models import ContentType\nfrom django.urls import reverse, NoReverseMatch\nfrom django.utils.encoding import force_str\nfrom django.utils.html import escape\nfrom django.utils.safestring import mark_safe\nfrom django.utils.translation import gettext_lazy as _\n\n\nclass LogEntryAdmin(admin.ModelAdmin):\n list_filter = [\n 'content_type'\n ]\n\n search_fields = [\n 'object_repr',\n 'change_message'\n ]\n\n list_display_links = [\n 'action_time',\n 'get_change_message',\n ]\n list_display = [\n 'action_time',\n 'user_link',\n 'content_type',\n 'object_link',\n 'get_change_message',\n ]\n\n def has_add_permission(self, request):\n return False\n\n def has_change_permission(self, request, obj=None):\n return (\n request.user.is_superuser or\n request.user.has_perm('admin.change_logentry')\n ) and request.method != 'POST'\n\n def has_delete_permission(self, request, obj=None):\n return False\n\n def object_link(self, obj):\n object_link = escape(obj.object_repr)\n content_type = obj.content_type\n\n if obj.action_flag != DELETION and content_type is not None:\n # try returning an actual link instead of object repr string\n try:\n url = reverse(\n 'admin:{}_{}_change'.format(content_type.app_label,\n content_type.model),\n args=[obj.object_id]\n )\n object_link = '{} '.format(url, object_link)\n except NoReverseMatch:\n pass\n return mark_safe(object_link)\n\n object_link.admin_order_field = 'object_repr'\n object_link.short_description = _('object')\n\n def user_link(self, obj):\n content_type = ContentType.objects.get_for_model(type(obj.user))\n user_link = escape(force_str(obj.user))\n try:\n # try returning an actual link instead of object repr string\n url = reverse(\n 'admin:{}_{}_change'.format(content_type.app_label,\n content_type.model),\n args=[obj.user.pk]\n )\n user_link = '{} '.format(url, user_link)\n except NoReverseMatch:\n pass\n return mark_safe(user_link)\n\n user_link.admin_order_field = 'user'\n user_link.short_description = _('user')\n\n def get_queryset(self, request):\n queryset = super(LogEntryAdmin, self).get_queryset(request)\n return queryset.prefetch_related('content_type')\n\n def get_actions(self, request):\n actions = super(LogEntryAdmin, self).get_actions(request)\n if 'delete_selected' in actions:\n del actions['delete_selected']\n return actions\n"
},
{
"path": "djangoblog/mixins.py",
"content": "#!/usr/bin/env python\n# encoding: utf-8\n\n\"\"\"\nDjango Blog 混入类 (Mixins)\n提供可复用的功能模块，减少代码重复\n\"\"\"\n\nimport logging\nfrom django.db import models\nfrom django.shortcuts import get_object_or_404\nfrom django.utils.timezone import now\nfrom django.utils.translation import gettext_lazy as _\n\nlogger = logging.getLogger(__name__)\n\n\n# ===== 模型层 Mixin =====\n\nclass TimeStampedModel(models.Model):\n \"\"\"\n 抽象模型：为所有模型提供统一的时间戳字段\n\n 提供 created_at 和 updated_at 字段，自动管理时间戳\n 继承此模型可以消除重复的时间字段定义\n\n Usage:\n class MyModel(TimeStampedModel):\n name = models.CharField(max_length=100)\n \"\"\"\n created_at = models.DateTimeField(\n _('creation time'),\n default=now,\n db_index=True,\n help_text=_('The date and time when this object was created')\n )\n updated_at = models.DateTimeField(\n _('last modify time'),\n default=now,\n help_text=_('The date and time when this object was last modified')\n )\n\n class Meta:\n abstract = True\n ordering = ['-created_at']\n get_latest_by = 'created_at'\n\n def save(self, *args, **kwargs):\n \"\"\"\n 重写 save 方法，自动更新 updated_at 字段\n\n 注意：如果使用 update_fields 参数，需要明确包含 updated_at\n \"\"\"\n # 检查是否是部分更新（指定了 update_fields）\n update_fields = kwargs.get('update_fields')\n if update_fields:\n # 如果指定了 update_fields 但不包含 updated_at，则添加它\n if 'updated_at' not in update_fields:\n update_fields = list(update_fields) + ['updated_at']\n kwargs['update_fields'] = update_fields\n\n # 更新时间戳\n self.updated_at = now()\n\n super().save(*args, **kwargs)\n\n\n# ===== 视图层 Mixin =====\n\nclass SlugCachedMixin:\n \"\"\"\n Mixin: 缓存 slug 查询结果，避免重复数据库查询\n\n 在同一个请求周期内，多次获取同一个 slug 对应的对象时，\n 只会执行一次数据库查询，后续调用会使用缓存的对象\n\n Attributes:\n slug_url_kwarg: URL 参数名，默认为 'slug'\n slug_model: 要查询的模型类\n\n Usage:\n class MyView(SlugCachedMixin, ListView):\n slug_url_kwarg = 'category_slug'\n slug_model = Category\n\n def get_queryset(self):\n category = self.get_slug_object()\n return Article.objects.filter(category=category)\n \"\"\"\n slug_url_kwarg = 'slug'\n slug_model = None\n\n def get_slug_object(self):\n \"\"\"\n 获取并缓存 slug 对应的对象\n\n Returns:\n Model instance: slug 对应的模型实例\n\n Raises:\n Http404: 如果 slug 对应的对象不存在\n \"\"\"\n if not hasattr(self, '_slug_object'):\n if self.slug_model is None:\n raise ValueError(\n f'{self.__class__.__name__} must define slug_model attribute'\n )\n\n slug = self.kwargs.get(self.slug_url_kwarg)\n self._slug_object = get_object_or_404(self.slug_model, slug=slug)\n logger.debug(\n f'Loaded {self.slug_model.__name__} object: {self._slug_object} (slug={slug})'\n )\n\n return self._slug_object\n\n\nclass OptimizedArticleQueryMixin:\n \"\"\"\n Mixin: 优化文章查询（预加载关联对象）\n\n 使用 select_related 和 prefetch_related 优化文章查询，\n 减少数据库查询次数，避免 N+1 查询问题\n\n Usage:\n class MyView(OptimizedArticleQueryMixin, ListView):\n def get_queryset(self):\n return self.get_optimized_article_queryset().filter(status='p')\n \"\"\"\n\n def get_optimized_article_queryset(self):\n \"\"\"\n 返回优化后的 Article queryset\n\n 使用 select_related 预加载外键关联：\n - author: 文章作者\n - category: 文章分类\n\n 使用 prefetch_related 预加载多对多关联：\n - tags: 文章标签\n\n Returns:\n QuerySet: 优化后的 Article queryset\n \"\"\"\n from blog.models import Article\n\n return Article.objects.select_related(\n 'author', # 预加载作者（ForeignKey）\n 'category' # 预加载分类（ForeignKey）\n ).prefetch_related(\n 'tags' # 预加载标签（ManyToMany）\n )\n\n\nclass CachedListViewMixin:\n \"\"\"\n Mixin: 为 ListView 提供统一的缓存逻辑\n\n 自动缓存 queryset 结果，减少数据库查询\n 子类需要实现 get_queryset_cache_key() 和 get_queryset_data() 方法\n\n Usage:\n class MyView(CachedListViewMixin, ListView):\n def get_queryset_cache_key(self):\n return f'my_list_{self.page_number}'\n\n def get_queryset_data(self):\n return Article.objects.filter(status='p')\n \"\"\"\n\n def get_queryset_cache_key(self):\n \"\"\"\n 子类实现：返回缓存 key\n\n Returns:\n str: 缓存键\n\n Raises:\n NotImplementedError: 子类必须实现此方法\n \"\"\"\n raise NotImplementedError(\n f'{self.__class__.__name__} must implement get_queryset_cache_key()'\n )\n\n def get_queryset_data(self):\n \"\"\"\n 子类实现：返回实际数据\n\n Returns:\n QuerySet: 要缓存的 queryset\n\n Raises:\n NotImplementedError: 子类必须实现此方法\n \"\"\"\n raise NotImplementedError(\n f'{self.__class__.__name__} must implement get_queryset_data()'\n )\n\n def get_queryset_from_cache(self, cache_key):\n \"\"\"\n 从缓存获取 queryset，如果缓存不存在则查询并缓存\n\n Args:\n cache_key: 缓存键\n\n Returns:\n QuerySet: 查询结果\n \"\"\"\n from djangoblog.utils import cache\n\n value = cache.get(cache_key)\n if value:\n logger.info(f'Cache HIT: {cache_key}')\n return value\n\n queryset = self.get_queryset_data()\n cache.set(cache_key, queryset)\n logger.info(f'Cache MISS: {cache_key}')\n return queryset\n\n def get_queryset(self):\n \"\"\"\n 重写 get_queryset，使用缓存\n\n Returns:\n QuerySet: 查询结果（从缓存或数据库）\n \"\"\"\n key = self.get_queryset_cache_key()\n return self.get_queryset_from_cache(key)\n\n\nclass PageNumberMixin:\n \"\"\"\n Mixin: 提供页码获取功能\n\n 从 URL 参数或 GET 参数中获取当前页码\n\n Usage:\n class MyView(PageNumberMixin, ListView):\n def get_queryset_cache_key(self):\n return f'list_{self.page_number}'\n \"\"\"\n page_kwarg = 'page'\n\n @property\n def page_number(self):\n \"\"\"\n 获取当前页码\n\n 从 URL kwargs 或 GET 参数中获取页码，默认为 1\n\n Returns:\n int: 当前页码\n \"\"\"\n page = self.kwargs.get(self.page_kwarg) or \\\n self.request.GET.get(self.page_kwarg) or 1\n\n try:\n return int(page)\n except (ValueError, TypeError):\n return 1\n\n\nclass ArticleListMixin(\n OptimizedArticleQueryMixin,\n CachedListViewMixin,\n PageNumberMixin\n):\n \"\"\"\n Mixin: 组合多个 Mixin，提供完整的文章列表功能\n\n 继承此 Mixin 的视图自动具备：\n - 优化的文章查询\n - 缓存支持\n - 页码处理\n\n Usage:\n class MyArticleListView(ArticleListMixin, ListView):\n def get_queryset_data(self):\n return self.get_optimized_article_queryset().filter(status='p')\n\n def get_queryset_cache_key(self):\n return f'my_list_{self.page_number}'\n \"\"\"\n pass\n"
},
{
"path": "djangoblog/plugin_manage/base_plugin.py",
"content": "import logging\nfrom pathlib import Path\n\nfrom django.template import TemplateDoesNotExist\nfrom django.template.loader import render_to_string\n\nlogger = logging.getLogger(__name__)\n\n\nclass BasePlugin:\n # 插件元数据\n PLUGIN_NAME = None\n PLUGIN_DESCRIPTION = None\n PLUGIN_VERSION = None\n PLUGIN_AUTHOR = None\n\n # 插件配置\n SUPPORTED_POSITIONS = [] # 支持的显示位置\n DEFAULT_PRIORITY = 100 # 默认优先级（数字越小优先级越高）\n POSITION_PRIORITIES = {} # 各位置的优先级 {'sidebar': 50, 'article_bottom': 80}\n\n def __init__(self):\n if not all([self.PLUGIN_NAME, self.PLUGIN_DESCRIPTION, self.PLUGIN_VERSION]):\n raise ValueError(\"Plugin metadata (PLUGIN_NAME, PLUGIN_DESCRIPTION, PLUGIN_VERSION) must be defined.\")\n\n # 设置插件路径\n self.plugin_dir = self._get_plugin_directory()\n self.plugin_slug = self._get_plugin_slug()\n\n self.init_plugin()\n self.register_hooks()\n\n def _get_plugin_directory(self):\n \"\"\"获取插件目录路径\"\"\"\n import inspect\n plugin_file = inspect.getfile(self.__class__)\n return Path(plugin_file).parent\n\n def _get_plugin_slug(self):\n \"\"\"获取插件标识符（目录名）\"\"\"\n return self.plugin_dir.name\n\n def init_plugin(self):\n \"\"\"\n 插件初始化逻辑\n 子类可以重写此方法来实现特定的初始化操作\n \"\"\"\n logger.info(f'{self.PLUGIN_NAME} initialized.')\n\n def register_hooks(self):\n \"\"\"\n 注册插件钩子\n 子类可以重写此方法来注册特定的钩子\n \"\"\"\n pass\n\n # === 位置渲染系统 ===\n def render_position_widget(self, position, context, **kwargs):\n \"\"\"\n 根据位置渲染插件组件\n \n Args:\n position: 位置标识\n context: 模板上下文\n **kwargs: 额外参数\n \n Returns:\n dict: {'html': 'HTML内容', 'priority': 优先级} 或 None\n \"\"\"\n if position not in self.SUPPORTED_POSITIONS:\n return None\n\n # 检查条件显示\n if not self.should_display(position, context, **kwargs):\n return None\n\n # 调用具体的位置渲染方法\n method_name = f'render_{position}_widget'\n if hasattr(self, method_name):\n html = getattr(self, method_name)(context, **kwargs)\n if html:\n priority = self.POSITION_PRIORITIES.get(position, self.DEFAULT_PRIORITY)\n return {\n 'html': html,\n 'priority': priority,\n 'plugin_name': self.PLUGIN_NAME\n }\n\n return None\n\n def should_display(self, position, context, **kwargs):\n \"\"\"\n 判断插件是否应该在指定位置显示\n 子类可重写此方法实现条件显示逻辑\n \n Args:\n position: 位置标识\n context: 模板上下文\n **kwargs: 额外参数\n \n Returns:\n bool: 是否显示\n \"\"\"\n return True\n\n # === 各位置渲染方法 - 子类重写 ===\n def render_sidebar_widget(self, context, **kwargs):\n \"\"\"渲染侧边栏组件\"\"\"\n return None\n\n def render_article_bottom_widget(self, context, **kwargs):\n \"\"\"渲染文章底部组件\"\"\"\n return None\n\n def render_article_top_widget(self, context, **kwargs):\n \"\"\"渲染文章顶部组件\"\"\"\n return None\n\n def render_header_widget(self, context, **kwargs):\n \"\"\"渲染页头组件\"\"\"\n return None\n\n def render_footer_widget(self, context, **kwargs):\n \"\"\"渲染页脚组件\"\"\"\n return None\n\n def render_comment_before_widget(self, context, **kwargs):\n \"\"\"渲染评论前组件\"\"\"\n return None\n\n def render_comment_after_widget(self, context, **kwargs):\n \"\"\"渲染评论后组件\"\"\"\n return None\n\n # === 模板系统 ===\n def render_template(self, template_name, context=None):\n \"\"\"\n 渲染插件模板\n \n Args:\n template_name: 模板文件名\n context: 模板上下文\n \n Returns:\n HTML字符串\n \"\"\"\n if context is None:\n context = {}\n\n template_path = f\"plugins/{self.plugin_slug}/{template_name}\"\n\n try:\n return render_to_string(template_path, context)\n except TemplateDoesNotExist:\n logger.warning(f\"Plugin template not found: {template_path}\")\n return \"\"\n\n # === 静态资源系统 ===\n def get_static_url(self, static_file):\n \"\"\"获取插件静态文件URL\"\"\"\n from django.templatetags.static import static\n return static(f\"{self.plugin_slug}/static/{self.plugin_slug}/{static_file}\")\n\n def get_css_files(self):\n \"\"\"获取插件CSS文件列表\"\"\"\n return []\n\n def get_js_files(self):\n \"\"\"获取插件JavaScript文件列表\"\"\"\n return []\n\n def get_critical_head_html(self, context=None):\n \"\"\"\n 获取需要在最早执行的关键HTML内容（阻塞式加载）\n\n 用于防闪烁脚本等必须在页面渲染前执行的关键代码。\n 此方法返回的内容会在所有CSS和其他资源之前加载。\n\n 注意：此方法应该只用于真正需要阻塞加载的关键资源，\n 普通资源请使用 get_head_html()\n \"\"\"\n return \"\"\n\n def get_head_html(self, context=None):\n \"\"\"获取需要插入到中的HTML内容（在CSS之后）\"\"\"\n return \"\"\n\n def get_body_html(self, context=None):\n \"\"\"获取需要插入到底部的HTML内容\"\"\"\n return \"\"\n\n def get_plugin_info(self):\n \"\"\"\n 获取插件信息\n :return: 包含插件元数据的字典\n \"\"\"\n return {\n 'name': self.PLUGIN_NAME,\n 'description': self.PLUGIN_DESCRIPTION,\n 'version': self.PLUGIN_VERSION,\n 'author': self.PLUGIN_AUTHOR,\n 'slug': self.plugin_slug,\n 'directory': str(self.plugin_dir),\n 'supported_positions': self.SUPPORTED_POSITIONS,\n 'priorities': self.POSITION_PRIORITIES\n }\n"
},
{
"path": "djangoblog/plugin_manage/hook_constants.py",
"content": "ARTICLE_DETAIL_LOAD = 'article_detail_load'\nARTICLE_CREATE = 'article_create'\nARTICLE_UPDATE = 'article_update'\nARTICLE_DELETE = 'article_delete'\n\nARTICLE_CONTENT_HOOK_NAME = \"the_content\"\n\n# 位置钩子常量\nPOSITION_HOOKS = {\n 'article_top': 'article_top_widgets',\n 'article_bottom': 'article_bottom_widgets',\n 'sidebar': 'sidebar_widgets',\n 'header': 'header_widgets',\n 'footer': 'footer_widgets',\n 'comment_before': 'comment_before_widgets',\n 'comment_after': 'comment_after_widgets',\n}\n\n# 资源注入钩子\nHEAD_RESOURCES_HOOK = 'head_resources'\nBODY_RESOURCES_HOOK = 'body_resources'\n\n"
},
{
"path": "djangoblog/plugin_manage/hooks.py",
"content": "import logging\n\nlogger = logging.getLogger(__name__)\n\n_hooks = {}\n\n\ndef register(hook_name: str, callback: callable):\n \"\"\"\n 注册一个钩子回调。\n \"\"\"\n if hook_name not in _hooks:\n _hooks[hook_name] = []\n _hooks[hook_name].append(callback)\n logger.debug(f\"Registered hook '{hook_name}' with callback '{callback.__name__}'\")\n\n\ndef run_action(hook_name: str, *args, **kwargs):\n \"\"\"\n 执行一个 Action Hook。\n 它会按顺序执行所有注册到该钩子上的回调函数。\n \"\"\"\n if hook_name in _hooks:\n logger.debug(f\"Running action hook '{hook_name}'\")\n for callback in _hooks[hook_name]:\n try:\n callback(*args, **kwargs)\n except Exception as e:\n logger.error(f\"Error running action hook '{hook_name}' callback '{callback.__name__}': {e}\", exc_info=True)\n\n\ndef apply_filters(hook_name: str, value, *args, **kwargs):\n \"\"\"\n 执行一个 Filter Hook。\n 它会把 value 依次传递给所有注册的回调函数进行处理。\n \"\"\"\n if hook_name in _hooks:\n logger.debug(f\"Applying filter hook '{hook_name}'\")\n for callback in _hooks[hook_name]:\n try:\n value = callback(value, *args, **kwargs)\n except Exception as e:\n logger.error(f\"Error applying filter hook '{hook_name}' callback '{callback.__name__}': {e}\", exc_info=True)\n return value\n"
},
{
"path": "djangoblog/plugin_manage/loader.py",
"content": "import os\nimport logging\nfrom django.conf import settings\n\nlogger = logging.getLogger(__name__)\n\n# 全局插件注册表\n_loaded_plugins = []\n\ndef load_plugins():\n \"\"\"\n Dynamically loads and initializes plugins from the 'plugins' directory.\n This function is intended to be called when the Django app registry is ready.\n \"\"\"\n global _loaded_plugins\n _loaded_plugins = []\n\n for plugin_name in settings.ACTIVE_PLUGINS:\n plugin_path = os.path.join(settings.PLUGINS_DIR, plugin_name)\n if os.path.isdir(plugin_path) and os.path.exists(os.path.join(plugin_path, 'plugin.py')):\n try:\n # 导入插件模块\n plugin_module = __import__(f'plugins.{plugin_name}.plugin', fromlist=['plugin'])\n\n # 获取插件实例\n if hasattr(plugin_module, 'plugin'):\n plugin_instance = plugin_module.plugin\n _loaded_plugins.append(plugin_instance)\n logger.info(f\"Successfully loaded plugin: {plugin_name} - {plugin_instance.PLUGIN_NAME}\")\n else:\n logger.warning(f\"Plugin {plugin_name} does not have 'plugin' instance\")\n\n except ImportError as e:\n logger.error(f\"Failed to import plugin: {plugin_name}\", exc_info=e)\n except AttributeError as e:\n logger.error(f\"Failed to get plugin instance: {plugin_name}\", exc_info=e)\n except Exception as e:\n logger.error(f\"Unexpected error loading plugin: {plugin_name}\", exc_info=e)\n\n return _loaded_plugins\n\ndef get_loaded_plugins():\n \"\"\"获取所有已加载的插件\"\"\"\n return _loaded_plugins\n\ndef get_plugin_by_name(plugin_name):\n \"\"\"根据名称获取插件\"\"\"\n for plugin in _loaded_plugins:\n if plugin.plugin_slug == plugin_name:\n return plugin\n return None\n\ndef get_plugin_by_slug(plugin_slug):\n \"\"\"根据slug获取插件\"\"\"\n for plugin in _loaded_plugins:\n if plugin.plugin_slug == plugin_slug:\n return plugin\n return None\n\ndef get_plugins_info():\n \"\"\"获取所有插件的信息\"\"\"\n return [plugin.get_plugin_info() for plugin in _loaded_plugins]\n\ndef get_plugins_by_position(position):\n \"\"\"获取支持指定位置的插件\"\"\"\n return [plugin for plugin in _loaded_plugins if position in plugin.SUPPORTED_POSITIONS] "
},
{
"path": "djangoblog/settings.py",
"content": "\"\"\"\nDjango settings for djangoblog project.\n\nGenerated by 'django-admin startproject' using Django 1.10.2.\n\nFor more information on this file, see\nhttps://docs.djangoproject.com/en/1.10/topics/settings/\n\nFor the full list of settings and their values, see\nhttps://docs.djangoproject.com/en/1.10/ref/settings/\n\"\"\"\nimport os\nimport sys\nfrom pathlib import Path\n\nfrom django.utils.translation import gettext_lazy as _\n\n\ndef env_to_bool(env, default):\n str_val = os.environ.get(env)\n return default if str_val is None else str_val == 'True'\n\n\n# Build paths inside the project like this: BASE_DIR / 'subdir'.\nBASE_DIR = Path(__file__).resolve().parent.parent\n\n# Quick-start development settings - unsuitable for production\n# See https://docs.djangoproject.com/en/1.10/howto/deployment/checklist/\n\n# SECURITY WARNING: keep the secret key used in production secret!\nSECRET_KEY = os.environ.get(\n 'DJANGO_SECRET_KEY') or 'n9ceqv38)#&mwuat@(mjb_p%em$e8$qyr#fw9ot!=ba6lijx-6'\n# SECURITY WARNING: don't run with debug turned on in production!\nDEBUG = env_to_bool('DJANGO_DEBUG', True)\n# DEBUG = False\nTESTING = len(sys.argv) > 1 and sys.argv[1] == 'test'\n\n# ALLOWED_HOSTS = []\nALLOWED_HOSTS = ['*', '127.0.0.1', 'example.com']\n# django 4.0新增配置\nCSRF_TRUSTED_ORIGINS = ['http://example.com']\n# Application definition\n\n\nINSTALLED_APPS = [\n # 'django.contrib.admin',\n 'django.contrib.admin.apps.SimpleAdminConfig',\n 'django.contrib.auth',\n 'django.contrib.contenttypes',\n 'django.contrib.sessions',\n 'django.contrib.messages',\n 'django.contrib.staticfiles',\n 'django.contrib.sites',\n 'django.contrib.sitemaps',\n 'mdeditor',\n 'haystack',\n 'blog',\n 'accounts',\n 'comments',\n 'oauth',\n 'servermanager',\n 'owntracks',\n 'compressor',\n 'djangoblog'\n]\n\nMIDDLEWARE = [\n\n 'django.middleware.security.SecurityMiddleware',\n 'django.contrib.sessions.middleware.SessionMiddleware',\n 'django.middleware.locale.LocaleMiddleware',\n 'django.middleware.gzip.GZipMiddleware',\n # 'django.middleware.cache.UpdateCacheMiddleware',\n 'django.middleware.common.CommonMiddleware',\n # 'django.middleware.cache.FetchFromCacheMiddleware',\n 'django.middleware.csrf.CsrfViewMiddleware',\n 'django.contrib.auth.middleware.AuthenticationMiddleware',\n 'django.contrib.messages.middleware.MessageMiddleware',\n 'django.middleware.clickjacking.XFrameOptionsMiddleware',\n 'django.middleware.http.ConditionalGetMiddleware',\n 'blog.middleware.OnlineMiddleware'\n]\n\nROOT_URLCONF = 'djangoblog.urls'\n\nTEMPLATES = [\n {\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'DIRS': [os.path.join(BASE_DIR, 'templates')],\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': [\n 'django.template.context_processors.debug',\n 'django.template.context_processors.request',\n 'django.contrib.auth.context_processors.auth',\n 'django.contrib.messages.context_processors.messages',\n 'blog.context_processors.seo_processor'\n ],\n },\n },\n]\n\nWSGI_APPLICATION = 'djangoblog.wsgi.application'\n\n# Database\n# https://docs.djangoproject.com/en/1.10/ref/settings/#databases\n\n\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.mysql',\n 'NAME': os.environ.get('DJANGO_MYSQL_DATABASE') or 'djangoblog',\n 'USER': os.environ.get('DJANGO_MYSQL_USER') or 'root',\n 'PASSWORD': os.environ.get('DJANGO_MYSQL_PASSWORD') or 'root',\n 'HOST': os.environ.get('DJANGO_MYSQL_HOST') or '127.0.0.1',\n 'PORT': int(\n os.environ.get('DJANGO_MYSQL_PORT') or 3306),\n 'OPTIONS': {\n 'charset': 'utf8mb4'},\n }}\n\n# Password validation\n# https://docs.djangoproject.com/en/1.10/ref/settings/#auth-password-validators\n\nAUTH_PASSWORD_VALIDATORS = [\n {\n 'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',\n },\n {\n 'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',\n },\n {\n 'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',\n },\n {\n 'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',\n },\n]\n\nLANGUAGES = (\n ('en', _('English')),\n ('zh-hans', _('Simplified Chinese')),\n ('zh-hant', _('Traditional Chinese')),\n)\nLOCALE_PATHS = (\n os.path.join(BASE_DIR, 'locale'),\n)\n\nLANGUAGE_CODE = 'zh-hans'\n\nTIME_ZONE = 'Asia/Shanghai'\n\nUSE_I18N = True\n\nUSE_L10N = True\n\nUSE_TZ = False\n\n# Session settings\nSESSION_COOKIE_AGE = 1209600 # 2周（Django默认值）\nREMEMBER_ME_LOGIN_TTL = 2626560 # 30天（勾选\"记住我\"时使用）\n\n# Static files (CSS, JavaScript, Images)\n# https://docs.djangoproject.com/en/1.10/howto/static-files/\n\n\n# ==================== 搜索引擎配置 ====================\n# 支持 Whoosh 和 Elasticsearch 两种搜索引擎\n# 优先级：环境变量 > 手动配置 > 默认 Whoosh\n\n# === Elasticsearch 配置 ===\n# 1. 生产环境：通过环境变量配置（见下方）\n# 2. 开发环境：手动配置（取消下面注释）\n\n# ELASTICSEARCH_DSL = {\n# 'default': {\n# 'hosts': 'http://127.0.0.1:9200',\n# 'verify_certs': False, # 是否验证SSL证书\n#\n# # === 认证方式（根据实际情况选择一种） ===\n#\n# # 方式1: 无认证（安全功能已禁用的开发环境）\n# # 不需要额外配置\n#\n# # 方式2: 用户名密码认证（ES 8.x 默认方式，推荐）\n# # 'username': 'elastic',\n# # 'password': 'your_password',\n#\n# # 方式3: API Key 认证\n# # 'api_key': 'your_api_key_here',\n#\n# # 方式4: 证书认证\n# # 'ca_certs': '/path/to/ca.crt',\n# # 'client_cert': '/path/to/client.crt',\n# # 'client_key': '/path/to/client.key',\n# },\n# }\n\n# === 环境变量配置 (生产环境，优先级最高) ===\n# 如果设置了 DJANGO_ELASTICSEARCH_HOST 环境变量，将覆盖上面的手动配置\n# 支持的环境变量：\n# - DJANGO_ELASTICSEARCH_HOST: ES主机地址（必需）\n# - ELASTICSEARCH_VERIFY_CERTS: 是否验证证书 (True/False)\n# - ELASTICSEARCH_USERNAME: 用户名\n# - ELASTICSEARCH_PASSWORD: 密码\n# - ELASTICSEARCH_API_KEY: API Key\n# - ELASTICSEARCH_CA_CERTS: CA证书路径\n# - ELASTICSEARCH_CLIENT_CERT: 客户端证书路径\n# - ELASTICSEARCH_CLIENT_KEY: 客户端私钥路径\n\nif os.environ.get('DJANGO_ELASTICSEARCH_HOST'):\n # 通过环境变量配置 Elasticsearch（生产环境）\n _es_config = {\n 'hosts': os.environ.get('DJANGO_ELASTICSEARCH_HOST'),\n 'verify_certs': os.environ.get('ELASTICSEARCH_VERIFY_CERTS', 'False').lower() == 'true',\n }\n\n # 用户名密码认证\n if os.environ.get('ELASTICSEARCH_USERNAME') and os.environ.get('ELASTICSEARCH_PASSWORD'):\n _es_config['username'] = os.environ.get('ELASTICSEARCH_USERNAME')\n _es_config['password'] = os.environ.get('ELASTICSEARCH_PASSWORD')\n\n # API Key 认证\n if os.environ.get('ELASTICSEARCH_API_KEY'):\n _es_config['api_key'] = os.environ.get('ELASTICSEARCH_API_KEY')\n\n # 证书认证\n if os.environ.get('ELASTICSEARCH_CA_CERTS'):\n _es_config['ca_certs'] = os.environ.get('ELASTICSEARCH_CA_CERTS')\n if os.environ.get('ELASTICSEARCH_CLIENT_CERT') and os.environ.get('ELASTICSEARCH_CLIENT_KEY'):\n _es_config['client_cert'] = os.environ.get('ELASTICSEARCH_CLIENT_CERT')\n _es_config['client_key'] = os.environ.get('ELASTICSEARCH_CLIENT_KEY')\n\n ELASTICSEARCH_DSL = {'default': _es_config}\n\n# === Haystack 配置 ===\nif 'ELASTICSEARCH_DSL' in locals():\n # 使用 Elasticsearch\n HAYSTACK_CONNECTIONS = {\n 'default': {\n 'ENGINE': 'djangoblog.elasticsearch_backend.ElasticSearchEngine',\n }\n }\nelse:\n # 默认使用 Whoosh\n HAYSTACK_CONNECTIONS = {\n 'default': {\n 'ENGINE': 'djangoblog.whoosh_cn_backend.WhooshEngine',\n 'PATH': os.path.join(BASE_DIR, 'whoosh_index'),\n },\n }\n\n# Automatically update searching index\nHAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'\n# Allow user login with username and password\nAUTHENTICATION_BACKENDS = [\n 'accounts.user_login_backend.EmailOrUsernameModelBackend']\n\nSTATIC_ROOT = os.path.join(BASE_DIR, 'collectedstatic')\n\nSTATIC_URL = '/static/'\nSTATICFILES = os.path.join(BASE_DIR, 'static')\n\n# 添加插件静态文件目录\nSTATICFILES_DIRS = [\n os.path.join(BASE_DIR, 'plugins'), # 让Django能找到插件的静态文件\n]\n\n# Vite开发服务器URL（开发模式）\nVITE_DEV_SERVER_URL = 'http://localhost:5173'\n\nAUTH_USER_MODEL = 'accounts.BlogUser'\nLOGIN_URL = '/login/'\n\nTIME_FORMAT = '%Y-%m-%d %H:%M:%S'\nDATE_TIME_FORMAT = '%Y-%m-%d'\n\n# bootstrap color styles\nBOOTSTRAP_COLOR_TYPES = [\n 'default', 'primary', 'success', 'info', 'warning', 'danger'\n]\n\n# paginate\nPAGINATE_BY = 10\n# http cache timeout\nCACHE_CONTROL_MAX_AGE = 2592000\n# cache setting\nCACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',\n 'TIMEOUT': 10800,\n 'LOCATION': 'unique-snowflake',\n }\n}\n# 使用redis作为缓存\nif os.environ.get(\"DJANGO_REDIS_URL\"):\n CACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.redis.RedisCache',\n 'LOCATION': f'redis://{os.environ.get(\"DJANGO_REDIS_URL\")}',\n }\n }\n\nSITE_ID = 1\nBAIDU_NOTIFY_URL = os.environ.get('DJANGO_BAIDU_NOTIFY_URL') \\\n or 'http://data.zz.baidu.com/urls?site=https://www.lylinux.net&token=1uAOGrMsUm5syDGn'\n\n# Email:\nEMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'\nEMAIL_USE_TLS = env_to_bool('DJANGO_EMAIL_TLS', False)\nEMAIL_USE_SSL = env_to_bool('DJANGO_EMAIL_SSL', True)\nEMAIL_HOST = os.environ.get('DJANGO_EMAIL_HOST') or 'smtp.mxhichina.com'\nEMAIL_PORT = int(os.environ.get('DJANGO_EMAIL_PORT') or 465)\nEMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER')\nEMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD')\nDEFAULT_FROM_EMAIL = EMAIL_HOST_USER\nSERVER_EMAIL = EMAIL_HOST_USER\n# Setting debug=false did NOT handle except email notifications\nADMINS = [('admin', os.environ.get('DJANGO_ADMIN_EMAIL') or 'admin@admin.com')]\n# WX ADMIN password(Two times md5)\nWXADMIN = os.environ.get(\n 'DJANGO_WXADMIN_PASSWORD') or '995F03AC401D6CABABAEF756FC4D43C7'\n\nLOG_PATH = os.path.join(BASE_DIR, 'logs')\nif not os.path.exists(LOG_PATH):\n os.makedirs(LOG_PATH, exist_ok=True)\n\nLOGGING = {\n 'version': 1,\n 'disable_existing_loggers': False,\n 'root': {\n 'level': 'INFO',\n 'handlers': ['console', 'log_file'],\n },\n 'formatters': {\n 'verbose': {\n 'format': '[%(asctime)s] %(levelname)s [%(name)s.%(funcName)s:%(lineno)d %(module)s] %(message)s',\n }\n },\n 'filters': {\n 'require_debug_false': {\n '()': 'django.utils.log.RequireDebugFalse',\n },\n 'require_debug_true': {\n '()': 'django.utils.log.RequireDebugTrue',\n },\n },\n 'handlers': {\n 'log_file': {\n 'level': 'INFO',\n 'class': 'logging.handlers.TimedRotatingFileHandler',\n 'filename': os.path.join(LOG_PATH, 'djangoblog.log'),\n 'when': 'D',\n 'formatter': 'verbose',\n 'interval': 1,\n 'delay': True,\n 'backupCount': 5,\n 'encoding': 'utf-8'\n },\n 'console': {\n 'level': 'DEBUG',\n 'filters': ['require_debug_true'],\n 'class': 'logging.StreamHandler',\n 'formatter': 'verbose'\n },\n 'null': {\n 'class': 'logging.NullHandler',\n },\n 'mail_admins': {\n 'level': 'ERROR',\n 'filters': ['require_debug_false'],\n 'class': 'django.utils.log.AdminEmailHandler'\n }\n },\n 'loggers': {\n 'djangoblog': {\n 'handlers': ['log_file', 'console'],\n 'level': 'INFO',\n 'propagate': True,\n }\n }\n}\n\nSTATICFILES_FINDERS = (\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n # other\n 'compressor.finders.CompressorFinder',\n)\n# 开发模式下禁用压缩，使用Vite处理静态资源\nCOMPRESS_ENABLED = not DEBUG\n# 根据环境变量决定是否启用离线压缩\nCOMPRESS_OFFLINE = os.environ.get('COMPRESS_OFFLINE', 'False').lower() == 'true'\n\n# 压缩输出目录\nCOMPRESS_OUTPUT_DIR = 'compressed'\n\n# 压缩文件名模板 - 包含哈希值用于缓存破坏\nCOMPRESS_CSS_HASHING_METHOD = 'mtime'\nCOMPRESS_JS_HASHING_METHOD = 'mtime'\n\n# 高级CSS压缩过滤器\nCOMPRESS_CSS_FILTERS = [\n # 创建绝对URL\n 'compressor.filters.css_default.CssAbsoluteFilter',\n # CSS压缩器 - 高压缩等级\n 'compressor.filters.cssmin.CSSCompressorFilter',\n]\n\n# 高级JS压缩过滤器\nCOMPRESS_JS_FILTERS = [\n # JS压缩器 - 高压缩等级\n 'compressor.filters.jsmin.SlimItFilter',\n]\n\n# 压缩缓存配置\nCOMPRESS_CACHE_BACKEND = 'default'\nCOMPRESS_CACHE_KEY_FUNCTION = 'compressor.cache.simple_cachekey'\n\n# 预压缩配置\nCOMPRESS_PRECOMPILERS = (\n # 支持SCSS/SASS\n ('text/x-scss', 'django_libsass.SassCompiler'),\n ('text/x-sass', 'django_libsass.SassCompiler'),\n)\n\n# 压缩性能优化\nCOMPRESS_MINT_DELAY = 30 # 压缩延迟（秒）\nCOMPRESS_MTIME_DELAY = 10 # 修改时间检查延迟\nCOMPRESS_REBUILD_TIMEOUT = 2592000 # 重建超时（30天）\n\n# 压缩等级配置\nCOMPRESS_CSS_COMPRESSOR = 'compressor.css.CssCompressor'\nCOMPRESS_JS_COMPRESSOR = 'compressor.js.JsCompressor'\n\n# 静态文件缓存配置\nSTATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'\n\n# 浏览器缓存配置（通过中间件或服务器配置）\nCOMPRESS_URL = STATIC_URL\nCOMPRESS_ROOT = STATIC_ROOT\n\nMEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')\nMEDIA_URL = '/media/'\nX_FRAME_OPTIONS = 'SAMEORIGIN'\n\n\n\nDEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'\n\n# Plugin System\nPLUGINS_DIR = BASE_DIR / 'plugins'\nACTIVE_PLUGINS = [\n 'article_copyright',\n 'reading_time',\n 'external_links',\n 'view_count',\n 'seo_optimizer',\n 'image_lazy_loading',\n 'article_recommendation',\n 'cloudflare_cache', # Cloudflare缓存管理插件\n]\n\n"
},
{
"path": "djangoblog/sitemap.py",
"content": "from django.contrib.sitemaps import Sitemap\nfrom django.urls import reverse\n\nfrom blog.models import Article, Category, Tag\n\n\nclass StaticViewSitemap(Sitemap):\n priority = 0.5\n changefreq = 'daily'\n\n def items(self):\n return ['blog:index', ]\n\n def location(self, item):\n return reverse(item)\n\n\nclass ArticleSiteMap(Sitemap):\n changefreq = \"monthly\"\n priority = \"0.6\"\n\n def items(self):\n return Article.objects.filter(status='p')\n\n def lastmod(self, obj):\n return obj.last_modify_time\n\n\nclass CategorySiteMap(Sitemap):\n changefreq = \"Weekly\"\n priority = \"0.6\"\n\n def items(self):\n return Category.objects.all()\n\n def lastmod(self, obj):\n return obj.last_modify_time\n\n\nclass TagSiteMap(Sitemap):\n changefreq = \"Weekly\"\n priority = \"0.3\"\n\n def items(self):\n return Tag.objects.all()\n\n def lastmod(self, obj):\n return obj.last_modify_time\n\n\nclass UserSiteMap(Sitemap):\n changefreq = \"Weekly\"\n priority = \"0.3\"\n\n def items(self):\n return list(set(map(lambda x: x.author, Article.objects.all())))\n\n def lastmod(self, obj):\n return obj.date_joined\n"
},
{
"path": "djangoblog/spider_notify.py",
"content": "import logging\n\nimport requests\nfrom django.conf import settings\n\nlogger = logging.getLogger(__name__)\n\n\nclass SpiderNotify():\n @staticmethod\n def baidu_notify(urls):\n try:\n data = '\\n'.join(urls)\n result = requests.post(settings.BAIDU_NOTIFY_URL, data=data)\n logger.info(result.text)\n except Exception as e:\n logger.error(e)\n\n @staticmethod\n def notify(url):\n SpiderNotify.baidu_notify(url)\n"
},
{
"path": "djangoblog/test_base.py",
"content": "\"\"\"\n可复用的测试基类和工具\n提供通用的测试数据创建和断言方法\n\"\"\"\nfrom django.contrib.auth.models import Permission\nfrom django.test import TestCase, Client, RequestFactory\nfrom django.utils import timezone\n\nfrom accounts.models import BlogUser\nfrom blog.models import Article, Category, Tag, BlogSettings\nfrom comments.models import Comment\n\n\nclass BaseTestCase(TestCase):\n \"\"\"\n 通用测试基类\n 提供常用的测试数据创建方法\n \"\"\"\n\n def setUp(self):\n self.client = Client()\n self.factory = RequestFactory()\n self.user = self.create_user()\n self.admin_user = self.create_admin_user()\n self.category = self.create_category()\n self.tag = self.create_tag()\n self.article = self.create_article()\n self.blog_settings = self.create_blog_settings()\n\n def create_user(self, username='testuser', email='test@test.com', password='testpass123'):\n \"\"\"创建普通用户\"\"\"\n user = BlogUser.objects.create_user(\n username=username,\n email=email,\n password=password\n )\n return user\n\n def create_admin_user(self, username='admin', email='admin@admin.com', password='admin123'):\n \"\"\"创建管理员用户\"\"\"\n user = BlogUser.objects.create_superuser(\n username=username,\n email=email,\n password=password\n )\n return user\n\n def create_staff_user(self, username='staff', email='staff@test.com', password='staff123'):\n \"\"\"创建员工用户\"\"\"\n user = BlogUser.objects.create_user(\n username=username,\n email=email,\n password=password,\n is_staff=True\n )\n return user\n\n def create_category(self, name='测试分类'):\n \"\"\"创建分类\"\"\"\n category = Category.objects.create(\n name=name,\n creation_time=timezone.now(),\n last_modify_time=timezone.now()\n )\n return category\n\n def create_tag(self, name='测试标签'):\n \"\"\"创建标签\"\"\"\n tag = Tag.objects.create(name=name)\n return tag\n\n def create_article(self, title='测试文章', body='测试内容', author=None,\n category=None, status='p', article_type='a'):\n \"\"\"创建文章\"\"\"\n if author is None:\n author = self.user if hasattr(self, 'user') else self.create_user()\n if category is None:\n category = self.category if hasattr(self, 'category') else self.create_category()\n\n article = Article.objects.create(\n title=title,\n body=body,\n author=author,\n category=category,\n type=article_type,\n status=status\n )\n return article\n\n def create_comment(self, article=None, author=None, body='测试评论', parent=None):\n \"\"\"创建评论\"\"\"\n if article is None:\n article = self.article if hasattr(self, 'article') else self.create_article()\n if author is None:\n author = self.user if hasattr(self, 'user') else self.create_user()\n\n comment = Comment.objects.create(\n body=body,\n author=author,\n article=article,\n parent_comment=parent\n )\n return comment\n\n def create_blog_settings(self):\n \"\"\"创建博客设置\"\"\"\n settings, created = BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': '测试博客',\n 'site_description': '测试描述',\n 'comment_need_review': False,\n }\n )\n return settings\n\n def login_user(self, user=None, password='testpass123'):\n \"\"\"登录用户\"\"\"\n if user is None:\n user = self.user\n return self.client.login(username=user.username, password=password)\n\n def login_admin(self):\n \"\"\"登录管理员\"\"\"\n return self.client.login(username='admin', password='admin123')\n\n def assert_redirect_to_login(self, response):\n \"\"\"断言重定向到登录页\"\"\"\n self.assertEqual(response.status_code, 302)\n self.assertIn('/login/', response.url)\n\n def assert_permission_denied(self, response):\n \"\"\"断言权限拒绝\"\"\"\n self.assertIn(response.status_code, [403, 302])\n\n\nclass ViewTestMixin:\n \"\"\"\n 视图测试混入类\n 提供视图测试的通用方法\n \"\"\"\n\n def assert_view_success(self, url, status_code=200):\n \"\"\"断言视图访问成功\"\"\"\n response = self.client.get(url)\n self.assertEqual(response.status_code, status_code)\n return response\n\n def assert_view_redirect(self, url, redirect_url=None):\n \"\"\"断言视图重定向\"\"\"\n response = self.client.get(url)\n self.assertEqual(response.status_code, 302)\n if redirect_url:\n self.assertRedirects(response, redirect_url)\n return response\n\n def assert_view_forbidden(self, url):\n \"\"\"断言视图禁止访问\"\"\"\n response = self.client.get(url)\n self.assertIn(response.status_code, [403, 302])\n return response\n\n def assert_post_success(self, url, data, status_code=200):\n \"\"\"断言 POST 请求成功\"\"\"\n response = self.client.post(url, data)\n self.assertEqual(response.status_code, status_code)\n return response\n\n def assert_ajax_success(self, url, data=None):\n \"\"\"断言 AJAX 请求成功\"\"\"\n response = self.client.post(\n url,\n data or {},\n HTTP_X_REQUESTED_WITH='XMLHttpRequest'\n )\n self.assertEqual(response.status_code, 200)\n return response\n\n\nclass AdminTestMixin:\n \"\"\"\n Admin 测试混入类\n 提供 Admin 测试的通用方法\n \"\"\"\n\n def get_admin_url(self, model, action='changelist'):\n \"\"\"获取 Admin URL\"\"\"\n app_label = model._meta.app_label\n model_name = model._meta.model_name\n from django.urls import reverse\n return reverse(f'admin:{app_label}_{model_name}_{action}')\n\n def get_admin_change_url(self, obj):\n \"\"\"获取对象的 Admin 修改 URL\"\"\"\n app_label = obj._meta.app_label\n model_name = obj._meta.model_name\n from django.urls import reverse\n return reverse(f'admin:{app_label}_{model_name}_change', args=[obj.pk])\n\n def assert_admin_accessible(self, model):\n \"\"\"断言管理员可以访问 Admin 页面\"\"\"\n url = self.get_admin_url(model)\n response = self.client.get(url)\n self.assertEqual(response.status_code, 200)\n return response\n\n def assert_admin_forbidden_for_user(self, model):\n \"\"\"断言普通用户无法访问 Admin 页面\"\"\"\n url = self.get_admin_url(model)\n response = self.client.get(url)\n self.assertIn(response.status_code, [302, 403])\n return response\n\n\nclass PluginTestMixin:\n \"\"\"\n 插件测试混入类\n 提供插件测试的通用方法\n \"\"\"\n\n def create_plugin_context(self, **kwargs):\n \"\"\"创建插件上下文\"\"\"\n from django.http import HttpRequest\n request = HttpRequest()\n request.user = kwargs.get('user', self.user if hasattr(self, 'user') else None)\n\n context = {\n 'request': request,\n 'article': kwargs.get('article', None),\n 'content': kwargs.get('content', ''),\n }\n return context\n\n def assert_plugin_hook_registered(self, plugin, hook_name):\n \"\"\"断言插件钩子已注册\"\"\"\n from djangoblog.plugin_manage import hooks\n registered_hooks = hooks._hooks.get(hook_name, [])\n self.assertTrue(len(registered_hooks) > 0, f\"No hooks registered for {hook_name}\")\n\n def mock_plugin_config(self, plugin_name, **config):\n \"\"\"Mock 插件配置\"\"\"\n import os\n for key, value in config.items():\n os.environ[key] = str(value)\n\n\nclass MockExternalService:\n \"\"\"\n 外部服务 Mock 工具\n 提供常用外部服务的 Mock\n \"\"\"\n\n @staticmethod\n def mock_http_response(status_code=200, content='', json_data=None):\n \"\"\"Mock HTTP 响应\"\"\"\n from unittest.mock import Mock\n response = Mock()\n response.status_code = status_code\n response.content = content\n if json_data:\n response.json.return_value = json_data\n return response\n\n @staticmethod\n def mock_elasticsearch_response(hits=None):\n \"\"\"Mock Elasticsearch 响应\"\"\"\n from unittest.mock import Mock\n response = Mock()\n response.hits = hits or []\n response.hits.total = Mock()\n response.hits.total.value = len(hits) if hits else 0\n return response\n\n @staticmethod\n def mock_cache_get(return_value=None):\n \"\"\"Mock 缓存获取\"\"\"\n from unittest.mock import patch\n return patch('django.core.cache.cache.get', return_value=return_value)\n\n @staticmethod\n def mock_cache_set():\n \"\"\"Mock 缓存设置\"\"\"\n from unittest.mock import patch\n return patch('django.core.cache.cache.set')\n"
},
{
"path": "djangoblog/test_email_integration.py",
"content": "\"\"\"\nEmail Integration Tests\n邮件集成测试 - 测试完整的邮件发送流程\n包括：注册验证、密码重置、评论通知等\n\"\"\"\nimport re\nfrom django.test import TestCase, Client, override_settings\nfrom django.core import mail\nfrom django.urls import reverse\nfrom django.utils import timezone\n\nfrom accounts.models import BlogUser\nfrom blog.models import Article, Category, BlogSettings\nfrom comments.models import Comment\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True, # 立即执行异步任务\n)\nclass UserRegistrationEmailTest(TestCase):\n \"\"\"测试用户注册邮件验证完整流程\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n # 清空邮件outbox\n mail.outbox = []\n\n # 确保博客设置存在\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_user_registration_sends_verification_email(self):\n \"\"\"测试用户注册发送验证邮件\"\"\"\n # 注册数据\n registration_data = {\n 'username': 'newuser',\n 'email': 'newuser@example.com',\n 'password1': 'TestPassword123!',\n 'password2': 'TestPassword123!',\n }\n\n # 提交注册表单\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n # 验证响应\n self.assertEqual(response.status_code, 200)\n\n # 验证用户已创建\n user = BlogUser.objects.filter(email='newuser@example.com').first()\n self.assertIsNotNone(user)\n\n # 验证发送了邮件\n self.assertEqual(len(mail.outbox), 1)\n\n # 验证邮件内容\n sent_email = mail.outbox[0]\n self.assertIn('newuser@example.com', sent_email.to)\n self.assertIn('验证', sent_email.subject.lower() or sent_email.body.lower())\n\n def test_registration_email_contains_verification_link(self):\n \"\"\"测试注册邮件包含验证链接\"\"\"\n registration_data = {\n 'username': 'testuser',\n 'email': 'test@example.com',\n 'password1': 'TestPassword123!',\n 'password2': 'TestPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n # 检查是否发送了邮件\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n email_body = sent_email.body\n\n # 验证邮件中包含链接（通常包含http或https）\n self.assertTrue(\n 'http' in email_body.lower() or\n '链接' in email_body or\n '验证' in email_body\n )\n\n def test_multiple_registrations_send_separate_emails(self):\n \"\"\"测试多个注册发送独立的邮件\"\"\"\n users_data = [\n {\n 'username': 'user1',\n 'email': 'user1@example.com',\n 'password1': 'Password123!',\n 'password2': 'Password123!',\n },\n {\n 'username': 'user2',\n 'email': 'user2@example.com',\n 'password1': 'Password123!',\n 'password2': 'Password123!',\n }\n ]\n\n for user_data in users_data:\n self.client.post(\n reverse('account:register'),\n user_data,\n follow=True\n )\n\n # 应该发送了2封邮件\n self.assertGreaterEqual(len(mail.outbox), 2)\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass PasswordResetEmailTest(TestCase):\n \"\"\"测试密码重置邮件流程\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n # 创建测试用户\n self.user = BlogUser.objects.create_user(\n username='testuser',\n email='test@example.com',\n password='OldPassword123!'\n )\n\n # 确保博客设置存在\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_forgot_password_sends_reset_email(self):\n \"\"\"测试忘记密码发送重置邮件\"\"\"\n # 提交忘记密码表单\n response = self.client.post(\n reverse('account:forget_password'),\n {'email': 'test@example.com'},\n follow=True\n )\n\n # 验证响应\n self.assertEqual(response.status_code, 200)\n\n # 注意：根据实际实现，邮件可能是异步发送的\n # 或者需要特定的配置才能发送\n # 这里我们验证邮件发送的预期行为\n # 如果实现了邮件发送，应该有邮件\n # 如果没有实现或异步处理，这个测试会记录状态\n\n # 验证邮件内容（如果有发送）\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n self.assertIn('test@example.com', sent_email.to)\n # 邮件应该包含重置密码相关的内容\n self.assertTrue(\n '重置' in sent_email.subject or\n '密码' in sent_email.subject or\n '重置' in sent_email.body or\n '密码' in sent_email.body\n )\n else:\n # 如果没有发送邮件，可能是因为：\n # 1. 邮件发送是异步的\n # 2. 需要配置SMTP设置\n # 3. 使用了其他通知方式\n # 这里我们只验证响应成功\n pass\n\n def test_reset_email_contains_verification_code(self):\n \"\"\"测试重置邮件包含验证码\"\"\"\n response = self.client.post(\n reverse('account:forget_password'),\n {'email': 'test@example.com'},\n follow=True\n )\n\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n email_body = sent_email.body\n\n # 验证邮件中包含验证码（通常是数字）\n # 或者包含重置链接\n has_code_or_link = bool(\n re.search(r'\\d{4,6}', email_body) or # 验证码\n 'http' in email_body.lower() # 链接\n )\n self.assertTrue(has_code_or_link)\n\n def test_reset_email_not_sent_for_nonexistent_email(self):\n \"\"\"测试不存在的邮箱不发送重置邮件\"\"\"\n response = self.client.post(\n reverse('account:forget_password'),\n {'email': 'nonexistent@example.com'},\n follow=True\n )\n\n # 根据业务逻辑，可能仍然返回200但不发送邮件\n # 或者返回错误信息\n # 这里我们检查是否发送了邮件到不存在的地址\n sent_to_nonexistent = any(\n 'nonexistent@example.com' in email.to\n for email in mail.outbox\n )\n\n # 不应该发送到不存在的邮箱\n # 注意：有些系统为了安全会假装发送，这里根据实际情况调整\n # self.assertFalse(sent_to_nonexistent)\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass CommentNotificationEmailTest(TestCase):\n \"\"\"测试评论通知邮件流程\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n # 创建文章作者\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n # 创建评论者\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n # 创建分类\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n # 创建文章\n self.article = Article.objects.create(\n title='Test Article',\n body='Test content',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o'\n )\n\n # 确保博客设置存在\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': 'Test Blog',\n 'comment_need_review': False # 评论不需要审核\n }\n )\n\n def test_comment_sends_notification_to_author(self):\n \"\"\"测试评论发送通知给文章作者\"\"\"\n # 评论者登录\n self.client.login(username='commenter', password='password')\n\n # 发表评论\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': 'This is a test comment',\n 'email': 'commenter@example.com',\n 'name': 'Commenter'\n },\n follow=True\n )\n\n # 验证评论已创建\n comment = Comment.objects.filter(\n article=self.article,\n body='This is a test comment'\n ).first()\n self.assertIsNotNone(comment)\n\n # 验证是否发送了通知邮件\n # 注意：根据实际实现，可能需要异步任务或信号触发\n # 如果发送了邮件，应该有作者的邮箱\n if len(mail.outbox) > 0:\n author_notified = any(\n 'author@example.com' in email.to\n for email in mail.outbox\n )\n # 如果有邮件通知功能，应该通知作者\n # self.assertTrue(author_notified)\n\n def test_reply_comment_sends_notification_to_parent_author(self):\n \"\"\"测试回复评论发送通知给被回复者\"\"\"\n # 创建父评论\n parent_comment = Comment.objects.create(\n body='Parent comment',\n author=self.commenter,\n article=self.article,\n is_enable=True\n )\n\n # 创建另一个用户来回复\n replier = BlogUser.objects.create_user(\n username='replier',\n email='replier@example.com',\n password='password'\n )\n\n # 回复者登录\n self.client.login(username='replier', password='password')\n\n # 清空之前的邮件\n mail.outbox = []\n\n # 回复评论\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': 'Reply to comment',\n 'email': 'replier@example.com',\n 'name': 'Replier',\n 'parent_comment_id': parent_comment.id\n },\n follow=True\n )\n\n # 验证回复已创建\n reply = Comment.objects.filter(\n article=self.article,\n body='Reply to comment',\n parent_comment=parent_comment\n ).first()\n\n if reply:\n # 如果有邮件通知功能，应该通知被回复者\n if len(mail.outbox) > 0:\n commenter_notified = any(\n 'commenter@example.com' in email.to\n for email in mail.outbox\n )\n # self.assertTrue(commenter_notified)\n\n def test_comment_with_review_required_does_not_send_immediate_notification(self):\n \"\"\"测试需要审核的评论不会立即发送通知\"\"\"\n # 启用评论审核\n self.blog_settings.comment_need_review = True\n self.blog_settings.save()\n\n # 评论者登录\n self.client.login(username='commenter', password='password')\n\n # 清空邮件\n mail.outbox = []\n\n # 发表评论\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': 'Comment awaiting review',\n 'email': 'commenter@example.com',\n 'name': 'Commenter'\n },\n follow=True\n )\n\n # 验证评论已创建但未启用\n comment = Comment.objects.filter(\n article=self.article,\n body='Comment awaiting review'\n ).first()\n\n if comment:\n # 如果需要审核，评论应该是未启用状态\n # self.assertFalse(comment.is_enable)\n\n # 根据业务逻辑，可能不会立即发送通知\n # 而是在审核通过后才发送\n pass\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass EmailIntegrationWorkflowTest(TestCase):\n \"\"\"测试完整的邮件工作流集成\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n # 确保博客设置存在\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': 'Test Blog',\n 'comment_need_review': False\n }\n )\n\n def test_complete_user_journey_with_emails(self):\n \"\"\"测试完整的用户旅程包含邮件\"\"\"\n # 1. 用户注册\n registration_data = {\n 'username': 'journeyuser',\n 'email': 'journey@example.com',\n 'password1': 'JourneyPassword123!',\n 'password2': 'JourneyPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n # 验证注册成功\n user = BlogUser.objects.filter(email='journey@example.com').first()\n self.assertIsNotNone(user)\n\n # 验证发送了注册邮件\n registration_email_count = len(mail.outbox)\n self.assertGreaterEqual(registration_email_count, 0)\n\n # 2. 用户登录\n self.client.login(username='journeyuser', password='JourneyPassword123!')\n\n # 3. 创建文章（如果用户有权限）\n category = Category.objects.create(\n name='Journey Category',\n slug='journey-category'\n )\n\n article = Article.objects.create(\n title='Journey Article',\n body='Journey content',\n author=user,\n category=category,\n status='p',\n type='a'\n )\n\n # 4. 发表评论（作为另一个用户）\n commenter = BlogUser.objects.create_user(\n username='journeycommenter',\n email='journeycommenter@example.com',\n password='password'\n )\n\n self.client.logout()\n self.client.login(username='journeycommenter', password='password')\n\n # 清空之前的邮件\n mail.outbox = []\n\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': article.id}),\n {\n 'body': 'Journey comment',\n 'email': 'journeycommenter@example.com',\n 'name': 'Journey Commenter'\n },\n follow=True\n )\n\n # 验证整个流程执行成功\n comment = Comment.objects.filter(article=article).first()\n # 根据实际实现，可能会或不会发送评论通知邮件\n\n def test_email_sending_does_not_block_operations(self):\n \"\"\"测试邮件发送不会阻塞操作\"\"\"\n # 注册用户\n start_time = timezone.now()\n\n registration_data = {\n 'username': 'speeduser',\n 'email': 'speed@example.com',\n 'password1': 'SpeedPassword123!',\n 'password2': 'SpeedPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n end_time = timezone.now()\n elapsed_time = (end_time - start_time).total_seconds()\n\n # 注册操作应该很快完成（即使发送邮件）\n # 如果使用异步任务，应该在合理时间内完成\n self.assertLess(elapsed_time, 10) # 10秒内完成\n\n # 验证用户已创建\n user = BlogUser.objects.filter(email='speed@example.com').first()\n self.assertIsNotNone(user)\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n)\nclass EmailContentValidationTest(TestCase):\n \"\"\"测试邮件内容验证\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_email_has_proper_from_address(self):\n \"\"\"测试邮件有正确的发件人地址\"\"\"\n registration_data = {\n 'username': 'emailuser',\n 'email': 'emailtest@example.com',\n 'password1': 'EmailPassword123!',\n 'password2': 'EmailPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n # 验证发件人地址存在或者为空字符串（使用默认值）\n # Django允许from_email为None或空字符串，会使用DEFAULT_FROM_EMAIL\n self.assertTrue(\n sent_email.from_email is None or\n isinstance(sent_email.from_email, str)\n )\n # 如果有发件人地址，验证格式正确\n if sent_email.from_email:\n self.assertIn('@', sent_email.from_email)\n\n def test_email_has_subject(self):\n \"\"\"测试邮件有主题\"\"\"\n registration_data = {\n 'username': 'subjectuser',\n 'email': 'subject@example.com',\n 'password1': 'SubjectPassword123!',\n 'password2': 'SubjectPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n # 验证邮件有主题\n self.assertIsNotNone(sent_email.subject)\n self.assertTrue(len(sent_email.subject) > 0)\n\n def test_email_has_body(self):\n \"\"\"测试邮件有正文\"\"\"\n registration_data = {\n 'username': 'bodyuser',\n 'email': 'body@example.com',\n 'password1': 'BodyPassword123!',\n 'password2': 'BodyPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n # 验证邮件有正文\n self.assertIsNotNone(sent_email.body)\n self.assertTrue(len(sent_email.body) > 0)\n\n def test_email_recipient_is_correct(self):\n \"\"\"测试邮件收件人正确\"\"\"\n test_email = 'recipient@example.com'\n registration_data = {\n 'username': 'recipientuser',\n 'email': test_email,\n 'password1': 'RecipientPassword123!',\n 'password2': 'RecipientPassword123!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n if len(mail.outbox) > 0:\n sent_email = mail.outbox[0]\n # 验证收件人是注册的邮箱\n self.assertIn(test_email, sent_email.to)\n"
},
{
"path": "djangoblog/test_email_integration_complete.py",
"content": "\"\"\"\nComplete Email Integration Tests - End to End\n完整的邮件集成测试 - 端到端测试完整业务流程\n\"\"\"\nimport re\nfrom django.test import TestCase, Client, override_settings\nfrom django.core import mail\nfrom django.urls import reverse\nfrom django.contrib.auth import authenticate\n\nfrom accounts.models import BlogUser\nfrom accounts.utils import get_code, verify\nfrom blog.models import Article, Category, BlogSettings\nfrom comments.models import Comment\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass CompleteUserRegistrationFlowTest(TestCase):\n \"\"\"完整的用户注册流程集成测试\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_complete_registration_verification_flow(self):\n \"\"\"测试完整的注册验证流程：注册 → 发邮件 → 验证 → 成功\"\"\"\n\n # ============ 步骤1: 用户注册 ============\n registration_data = {\n 'username': 'testuser2024',\n 'email': 'integration@example.com',\n 'password1': 'ComplexPassword@2024!',\n 'password2': 'ComplexPassword@2024!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n # 验证注册响应成功\n self.assertEqual(response.status_code, 200)\n\n # 验证用户已创建（可能是未激活状态）\n user = BlogUser.objects.filter(username='testuser2024').first()\n\n # 如果用户未创建，可能是表单验证失败\n if user is None:\n # 检查响应中是否有错误信息\n if hasattr(response, 'context') and response.context and 'form' in response.context:\n form_errors = response.context['form'].errors\n print(f\"表单错误: {form_errors}\")\n\n # 尝试按邮箱查找\n user = BlogUser.objects.filter(email='integration@example.com').first()\n\n self.assertIsNotNone(user, \"用户应该被创建\")\n # 用户可能是未激活状态\n # self.assertFalse(user.is_active, \"新注册用户应该是未激活状态\")\n\n # ============ 步骤2: 验证邮件已发送 ============\n self.assertGreaterEqual(len(mail.outbox), 1, \"应该发送了验证邮件\")\n\n verification_email = mail.outbox[0]\n self.assertIn('integration@example.com', verification_email.to)\n\n # ============ 步骤3: 从邮件中提取验证链接 ============\n email_body = verification_email.body\n\n # 提取验证链接（注册发送的是链接，不是验证码）\n link_match = re.search(r'https?://[^\\s<>\"]+', email_body)\n\n if link_match:\n verification_link = link_match.group(0)\n self.assertIsNotNone(verification_link, \"邮件中应该包含验证链接\")\n\n # ============ 步骤4: 访问验证链接 ============\n # 提取链接中的参数\n # URL格式: http://site/result?type=validation&id={id}&sign={sign}\n import urllib.parse\n parsed = urllib.parse.urlparse(verification_link)\n params = urllib.parse.parse_qs(parsed.query)\n\n if 'id' in params and 'sign' in params:\n # 构造验证URL路径\n verification_path = f\"{parsed.path}?{parsed.query}\"\n\n # 访问验证链接\n verify_response = self.client.get(verification_path, follow=True)\n self.assertEqual(verify_response.status_code, 200)\n\n # ============ 步骤5: 验证用户已被激活 ============\n user.refresh_from_db()\n # 验证后用户应该被激活\n if user.is_active:\n # ============ 步骤6: 激活后用户可以登录 ============\n login_success = self.client.login(\n username='testuser2024',\n password='ComplexPassword@2024!'\n )\n self.assertTrue(login_success, \"验证后用户应该可以登录\")\n else:\n # 至少验证邮件包含相关内容\n self.assertTrue(\n '验证' in email_body or '激活' in email_body or 'http' in email_body,\n \"邮件应该包含验证相关的内容或链接\"\n )\n\n def test_registration_with_duplicate_email_fails(self):\n \"\"\"测试重复邮箱注册失败\"\"\"\n\n # 第一次注册\n first_registration = {\n 'username': 'firstuser',\n 'email': 'duplicate@example.com',\n 'password1': 'Password123!',\n 'password2': 'Password123!',\n }\n\n self.client.post(\n reverse('account:register'),\n first_registration,\n follow=True\n )\n\n # 第二次用相同邮箱注册\n second_registration = {\n 'username': 'seconduser',\n 'email': 'duplicate@example.com', # 相同邮箱\n 'password1': 'Password456!',\n 'password2': 'Password456!',\n }\n\n response = self.client.post(\n reverse('account:register'),\n second_registration,\n follow=True\n )\n\n # 应该只有一个用户\n user_count = BlogUser.objects.filter(email='duplicate@example.com').count()\n # 根据业务逻辑，可能允许或不允许重复邮箱\n # 这里验证逻辑是否正确处理\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass CompletePasswordResetFlowTest(TestCase):\n \"\"\"完整的密码重置流程集成测试\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n # 创建测试用户\n self.user = BlogUser.objects.create_user(\n username='resetuser',\n email='reset@example.com',\n password='OldPassword123!'\n )\n\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={'site_name': 'Test Blog'}\n )\n\n def test_complete_password_reset_flow(self):\n \"\"\"测试完整的密码重置流程：忘记密码 → 发邮件 → 重置 → 新密码登录\"\"\"\n\n # ============ 步骤1: 用户提交忘记密码 ============\n response = self.client.post(\n reverse('account:forget_password'),\n {'email': 'reset@example.com'},\n follow=True\n )\n\n self.assertEqual(response.status_code, 200)\n\n # ============ 步骤2: 验证邮件已发送（如果实现了） ============\n if len(mail.outbox) > 0:\n reset_email = mail.outbox[0]\n self.assertIn('reset@example.com', reset_email.to)\n\n email_body = reset_email.body\n\n # ============ 步骤3: 从邮件中提取验证码 ============\n verification_code_match = re.search(r'\\b(\\d{4,6})\\b', email_body)\n\n if verification_code_match:\n verification_code = verification_code_match.group(1)\n\n # ============ 步骤4: 提交新密码和验证码 ============\n new_password = 'NewPassword456!'\n\n reset_response = self.client.post(\n reverse('account:forget_password'),\n {\n 'email': 'reset@example.com',\n 'code': verification_code,\n 'password1': new_password,\n 'password2': new_password,\n },\n follow=True\n )\n\n # ============ 步骤5: 验证可以用新密码登录 ============\n # 首先验证旧密码不能用了\n old_password_works = authenticate(\n username='resetuser',\n password='OldPassword123!'\n )\n\n # 验证新密码可以用\n new_password_works = authenticate(\n username='resetuser',\n password=new_password\n )\n\n if new_password_works:\n # 如果密码重置成功，新密码应该可以用\n self.assertIsNotNone(new_password_works)\n\n # 使用新密码登录\n login_success = self.client.login(\n username='resetuser',\n password=new_password\n )\n self.assertTrue(login_success, \"应该可以用新密码登录\")\n\n def test_password_reset_with_invalid_code_fails(self):\n \"\"\"测试使用无效验证码重置密码失败\"\"\"\n\n # 提交忘记密码\n self.client.post(\n reverse('account:forget_password'),\n {'email': 'reset@example.com'},\n follow=True\n )\n\n # 使用错误的验证码尝试重置\n response = self.client.post(\n reverse('account:forget_password'),\n {\n 'email': 'reset@example.com',\n 'code': '999999', # 错误的验证码\n 'password1': 'NewPassword456!',\n 'password2': 'NewPassword456!',\n },\n follow=True\n )\n\n # 密码不应该被改变\n user_still_has_old_password = authenticate(\n username='resetuser',\n password='OldPassword123!'\n )\n\n # 旧密码应该仍然有效\n self.assertIsNotNone(user_still_has_old_password)\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass CompleteCommentNotificationFlowTest(TestCase):\n \"\"\"完整的评论通知流程集成测试\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n # 创建文章作者\n self.author = BlogUser.objects.create_user(\n username='author',\n email='author@example.com',\n password='password'\n )\n\n # 创建评论者\n self.commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n # 创建分类和文章\n self.category = Category.objects.create(\n name='Test Category',\n slug='test-category'\n )\n\n self.article = Article.objects.create(\n title='Test Article for Comments',\n body='Article content that will receive comments',\n author=self.author,\n category=self.category,\n status='p',\n type='a',\n comment_status='o'\n )\n\n self.blog_settings, _ = BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': 'Test Blog',\n 'comment_need_review': False\n }\n )\n\n def test_complete_comment_notification_flow(self):\n \"\"\"测试完整的评论通知流程：发表评论 → 通知作者 → 作者查看 → 回复\"\"\"\n\n # ============ 步骤1: 评论者登录并发表评论 ============\n self.client.login(username='commenter', password='password')\n\n comment_text = '这是一条测试评论，期待作者的回复！'\n\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': comment_text,\n 'email': 'commenter@example.com',\n 'name': 'Commenter'\n },\n follow=True\n )\n\n # 验证评论已创建\n comment = Comment.objects.filter(\n article=self.article,\n body=comment_text\n ).first()\n self.assertIsNotNone(comment, \"评论应该被创建\")\n\n # ============ 步骤2: 验证通知邮件已发送给作者 ============\n if len(mail.outbox) > 0:\n # 查找发给作者的邮件\n author_email = None\n for email in mail.outbox:\n if 'author@example.com' in email.to:\n author_email = email\n break\n\n if author_email:\n # 验证邮件内容包含评论信息\n email_body = author_email.body\n self.assertIn('评论', email_body, \"邮件应该提到评论\")\n\n # 邮件中应该包含评论内容或链接\n has_comment_info = (\n comment_text in email_body or\n '新评论' in email_body or\n self.article.title in email_body\n )\n self.assertTrue(has_comment_info, \"邮件应该包含评论相关信息\")\n\n # ============ 步骤3: 从邮件中提取文章链接 ============\n article_link_match = re.search(r'https?://[^\\s]+', email_body)\n\n # ============ 步骤4: 作者查看评论 ============\n self.client.logout()\n self.client.login(username='author', password='password')\n\n # 访问文章页面查看评论\n article_response = self.client.get(\n self.article.get_absolute_url()\n )\n\n self.assertEqual(article_response.status_code, 200)\n # 页面应该显示评论（如果评论已启用）\n if comment.is_enable:\n self.assertContains(article_response, comment_text)\n\n # ============ 步骤5: 作者回复评论 ============\n mail.outbox = [] # 清空之前的邮件\n\n reply_text = '感谢你的评论！这是我的回复。'\n\n reply_response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': reply_text,\n 'email': 'author@example.com',\n 'name': 'Author',\n 'parent_comment_id': comment.id\n },\n follow=True\n )\n\n # 验证回复已创建\n reply = Comment.objects.filter(\n article=self.article,\n body=reply_text,\n parent_comment=comment\n ).first()\n\n if reply:\n # ============ 步骤6: 验证回复通知发送给原评论者 ============\n if len(mail.outbox) > 0:\n commenter_email = None\n for email in mail.outbox:\n if 'commenter@example.com' in email.to:\n commenter_email = email\n break\n\n if commenter_email:\n reply_email_body = commenter_email.body\n # 验证邮件包含回复信息\n has_reply_info = (\n '回复' in reply_email_body or\n reply_text in reply_email_body\n )\n self.assertTrue(has_reply_info, \"回复通知邮件应该包含回复信息\")\n\n def test_comment_notification_respects_review_setting(self):\n \"\"\"测试评论通知尊重审核设置：需要审核时不立即通知\"\"\"\n\n # ============ 步骤1: 启用评论审核 ============\n self.blog_settings.comment_need_review = True\n self.blog_settings.save()\n\n # ============ 步骤2: 发表评论 ============\n self.client.login(username='commenter', password='password')\n\n mail.outbox = [] # 清空邮件\n\n response = self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': self.article.id}),\n {\n 'body': '这条评论需要审核',\n 'email': 'commenter@example.com',\n 'name': 'Commenter'\n },\n follow=True\n )\n\n # ============ 步骤3: 验证评论处于待审核状态 ============\n comment = Comment.objects.filter(\n article=self.article,\n body='这条评论需要审核'\n ).first()\n\n if comment:\n # 评论应该未启用（待审核）\n # self.assertFalse(comment.is_enable, \"需要审核的评论应该未启用\")\n\n # ============ 步骤4: 验证不会立即发送通知 ============\n # 根据业务逻辑，待审核的评论可能不会立即通知\n # 或者只通知管理员，不通知作者\n\n # ============ 步骤5: 管理员审核通过 ============\n self.client.logout()\n admin = BlogUser.objects.create_superuser(\n username='admin',\n email='admin@example.com',\n password='adminpass'\n )\n self.client.login(username='admin', password='adminpass')\n\n # 审核通过\n comment.is_enable = True\n comment.save()\n\n # ============ 步骤6: 审核通过后应该通知作者 ============\n # 根据业务逻辑，可能在审核通过时发送通知\n\n\n@override_settings(\n EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend',\n CELERY_TASK_ALWAYS_EAGER=True,\n)\nclass CompleteUserJourneyIntegrationTest(TestCase):\n \"\"\"完整的用户旅程集成测试\"\"\"\n\n def setUp(self):\n \"\"\"设置测试环境\"\"\"\n self.client = Client()\n mail.outbox = []\n\n BlogSettings.objects.get_or_create(\n id=1,\n defaults={\n 'site_name': 'Test Blog',\n 'comment_need_review': False\n }\n )\n\n def test_complete_user_lifecycle(self):\n \"\"\"\n 测试完整的用户生命周期：\n 注册 → 验证 → 登录 → 创建内容 → 接收通知 → 互动\n \"\"\"\n\n # ============ 阶段1: 用户注册和验证 ============\n registration_data = {\n 'username': 'journeyuser',\n 'email': 'journey@example.com',\n 'password1': 'JourneyPass123!',\n 'password2': 'JourneyPass123!',\n }\n\n register_response = self.client.post(\n reverse('account:register'),\n registration_data,\n follow=True\n )\n\n user = BlogUser.objects.filter(email='journey@example.com').first()\n self.assertIsNotNone(user, \"阶段1：用户应该被创建\")\n\n # 验证邮件\n if len(mail.outbox) > 0:\n verification_email = mail.outbox[0]\n # 从邮件提取验证码\n code_match = re.search(r'\\b(\\d{4,6})\\b', verification_email.body)\n if code_match:\n code = code_match.group(1)\n # 验证\n verify('journey@example.com', code)\n\n # ============ 阶段2: 用户登录 ============\n login_success = self.client.login(\n username='journeyuser',\n password='JourneyPass123!'\n )\n self.assertTrue(login_success, \"阶段2：用户应该能够登录\")\n\n # ============ 阶段3: 用户创建文章 ============\n category = Category.objects.create(\n name='Journey Category',\n slug='journey-category'\n )\n\n article = Article.objects.create(\n title='My First Article',\n body='This is my first article content',\n author=user,\n category=category,\n status='p',\n type='a'\n )\n\n self.assertIsNotNone(article, \"阶段3：文章应该被创建\")\n\n # ============ 阶段4: 其他用户发现并评论文章 ============\n self.client.logout()\n\n commenter = BlogUser.objects.create_user(\n username='commenter',\n email='commenter@example.com',\n password='password'\n )\n\n self.client.login(username='commenter', password='password')\n\n mail.outbox = [] # 清空邮件\n\n self.client.post(\n reverse('comments:postcomment', kwargs={'article_id': article.id}),\n {\n 'body': 'Great article!',\n 'email': 'commenter@example.com',\n 'name': 'Commenter'\n },\n follow=True\n )\n\n # ============ 阶段5: 原作者收到通知并回复 ============\n # 验证作者收到评论通知（如果实现了）\n if len(mail.outbox) > 0:\n author_notified = any(\n 'journey@example.com' in email.to\n for email in mail.outbox\n )\n # 如果有邮件通知功能\n # self.assertTrue(author_notified, \"阶段5：作者应该收到评论通知\")\n\n # 作者登录并查看评论\n self.client.logout()\n self.client.login(username='journeyuser', password='JourneyPass123!')\n\n article_page = self.client.get(article.get_absolute_url())\n self.assertEqual(article_page.status_code, 200)\n\n # ============ 验证完整流程成功 ============\n # 用户成功完成：注册、验证、登录、发布、互动的完整流程\n final_user = BlogUser.objects.get(email='journey@example.com')\n self.assertIsNotNone(final_user)\n self.assertEqual(Article.objects.filter(author=final_user).count(), 1)\n self.assertGreater(Comment.objects.filter(article=article).count(), 0)\n"
},
{
"path": "djangoblog/test_plugins.py",
"content": "\"\"\"\n插件系统测试\n测试插件加载、钩子注册和执行\n\"\"\"\nimport os\nfrom unittest.mock import Mock, patch\n\nfrom django.test import TestCase\n\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\nfrom djangoblog.plugin_manage.hook_constants import *\nfrom djangoblog.plugin_manage import hooks\nfrom djangoblog.plugin_manage.loader import load_plugins\nfrom djangoblog.test_base import BaseTestCase, PluginTestMixin\n\n# 导入钩子常量\nfrom djangoblog.plugin_manage.hook_constants import HEAD_RESOURCES_HOOK, BODY_RESOURCES_HOOK\n\n\nclass PluginHooksTest(TestCase, PluginTestMixin):\n \"\"\"测试插件钩子系统\"\"\"\n\n def setUp(self):\n # 清空插件钩子\n hooks._hooks = {}\n\n def test_register_hook(self):\n \"\"\"测试注册钩子\"\"\"\n def test_hook(context):\n return \"test\"\n\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, test_hook)\n self.assertIn(ARTICLE_CONTENT_HOOK_NAME, hooks._hooks)\n self.assertEqual(len(hooks._hooks[ARTICLE_CONTENT_HOOK_NAME]), 1)\n\n def test_apply_filters(self):\n \"\"\"测试应用过滤器\"\"\"\n def test_filter(value):\n return value + \" modified\"\n\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, test_filter)\n result = hooks.apply_filters(ARTICLE_CONTENT_HOOK_NAME, \"original\")\n self.assertEqual(result, \"original modified\")\n\n def test_run_action(self):\n \"\"\"测试运行动作钩子\"\"\"\n executed = []\n\n def test_action():\n executed.append(True)\n\n hooks.register(ARTICLE_CREATE, test_action)\n hooks.run_action(ARTICLE_CREATE)\n self.assertTrue(len(executed) > 0)\n\n def test_multiple_hooks(self):\n \"\"\"测试多个钩子\"\"\"\n results = []\n\n def hook1(value):\n results.append('hook1')\n return value + '1'\n\n def hook2(value):\n results.append('hook2')\n return value + '2'\n\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, hook1)\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, hook2)\n\n result = hooks.apply_filters(ARTICLE_CONTENT_HOOK_NAME, 'base')\n self.assertEqual(result, 'base12')\n self.assertEqual(len(results), 2)\n\n def test_hook_error_handling(self):\n \"\"\"测试钩子错误处理\"\"\"\n def error_hook(value):\n raise Exception(\"Hook error\")\n\n def normal_hook(value):\n return value + ' success'\n\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, error_hook)\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, normal_hook)\n\n # 即使有钩子出错，其他钩子也应该继续执行\n result = hooks.apply_filters(ARTICLE_CONTENT_HOOK_NAME, 'test')\n # 错误钩子不会修改值，但正常钩子会\n self.assertIn('success', result)\n\n\nclass BasePluginTest(BaseTestCase):\n \"\"\"测试基础插件类\"\"\"\n\n def _create_test_plugin(self):\n \"\"\"创建一个测试用的插件实例\"\"\"\n class TestPlugin(BasePlugin):\n PLUGIN_NAME = '测试插件'\n PLUGIN_DESCRIPTION = '用于测试的插件'\n PLUGIN_VERSION = '1.0.0'\n PLUGIN_AUTHOR = 'test'\n\n return TestPlugin()\n\n def test_plugin_initialization(self):\n \"\"\"测试插件初始化\"\"\"\n plugin = self._create_test_plugin()\n self.assertIsNotNone(plugin.PLUGIN_NAME)\n self.assertIsNotNone(plugin.PLUGIN_VERSION)\n\n def test_plugin_config(self):\n \"\"\"测试插件配置\"\"\"\n plugin = self._create_test_plugin()\n # 插件应该有配置属性\n self.assertIsNotNone(plugin.PLUGIN_NAME)\n\n def test_plugin_register_hooks(self):\n \"\"\"测试插件注册钩子\"\"\"\n plugin = self._create_test_plugin()\n # 基类的 register_hooks 应该可以被调用\n plugin.register_hooks()\n\n def test_plugin_get_context(self):\n \"\"\"测试获取插件信息\"\"\"\n plugin = self._create_test_plugin()\n plugin_info = plugin.get_plugin_info()\n self.assertIsInstance(plugin_info, dict)\n self.assertEqual(plugin_info['name'], '测试插件')\n\n\nclass PluginLoaderTest(TestCase):\n \"\"\"测试插件加载器\"\"\"\n\n @patch('djangoblog.plugin_manage.loader.logger')\n def test_load_plugins(self, mock_logger):\n \"\"\"测试加载插件\"\"\"\n plugins = load_plugins()\n self.assertIsInstance(plugins, list)\n\n def test_load_plugins_handles_errors(self):\n \"\"\"测试插件加载错误处理\"\"\"\n # 测试当插件目录不存在或插件有错误时的处理\n with patch('os.path.exists', return_value=False):\n plugins = load_plugins()\n # 应该返回空列表或处理错误\n self.assertIsInstance(plugins, list)\n\n\nclass ReadingTimePluginTest(BaseTestCase, PluginTestMixin):\n \"\"\"测试阅读时间插件\"\"\"\n\n def test_reading_time_plugin_loaded(self):\n \"\"\"测试阅读时间插件已加载\"\"\"\n from plugins.reading_time.plugin import ReadingTimePlugin\n plugin = ReadingTimePlugin()\n self.assertEqual(plugin.PLUGIN_NAME, '阅读时间预测')\n\n def test_calculate_reading_time(self):\n \"\"\"测试计算阅读时间\"\"\"\n from plugins.reading_time.plugin import ReadingTimePlugin\n plugin = ReadingTimePlugin()\n\n # 测试短文本\n short_text = '这是一段短文本
' * 10\n result = plugin.add_reading_time(short_text)\n self.assertIn('预计阅读时间', result)\n self.assertIn('分钟', result)\n\n # 测试长文本\n long_text = '这是一段长文本
' * 1000\n long_result = plugin.add_reading_time(long_text)\n self.assertIn('预计阅读时间', long_result)\n # 长文本应该比短文本有更多内容\n self.assertGreater(len(long_result), len(result))\n\n\nclass ViewCountPluginTest(BaseTestCase, PluginTestMixin):\n \"\"\"测试浏览次数插件\"\"\"\n\n def test_view_count_plugin_loaded(self):\n \"\"\"测试浏览次数插件已加载\"\"\"\n from plugins.view_count.plugin import ViewCountPlugin\n plugin = ViewCountPlugin()\n self.assertEqual(plugin.PLUGIN_NAME, '文章浏览次数统计')\n\n def test_view_count_increment(self):\n \"\"\"测试浏览次数增加\"\"\"\n initial_views = self.article.views\n # 模拟访问文章\n self.client.get(self.article.get_absolute_url())\n self.article.refresh_from_db()\n # 浏览次数应该增加\n self.assertGreaterEqual(self.article.views, initial_views)\n\n\nclass SEOOptimizerPluginTest(BaseTestCase, PluginTestMixin):\n \"\"\"测试 SEO 优化插件\"\"\"\n\n def test_seo_optimizer_plugin_loaded(self):\n \"\"\"测试 SEO 优化插件已加载\"\"\"\n from plugins.seo_optimizer.plugin import SeoOptimizerPlugin\n plugin = SeoOptimizerPlugin()\n self.assertEqual(plugin.PLUGIN_NAME, 'SEO 优化器')\n\n def test_seo_meta_tags(self):\n \"\"\"测试 SEO meta 标签\"\"\"\n from plugins.seo_optimizer.plugin import SeoOptimizerPlugin\n plugin = SeoOptimizerPlugin()\n\n response = self.client.get(self.article.get_absolute_url())\n self.assertEqual(response.status_code, 200)\n # 应该包含 meta 标签\n self.assertContains(response, ' str:\n \"\"\"生成随机数验证码\"\"\"\n return ''.join(random.sample(string.digits, 6))\n\n\ndef parse_dict_to_url(dict):\n from urllib.parse import quote\n url = '&'.join(['{}={}'.format(quote(k, safe='/'), quote(v, safe='/'))\n for k, v in dict.items()])\n return url\n\n\ndef get_blog_setting():\n value = cache.get('get_blog_setting')\n if value:\n return value\n else:\n from blog.models import BlogSettings\n if not BlogSettings.objects.count():\n setting = BlogSettings()\n setting.site_name = 'djangoblog'\n setting.site_description = '基于Django的博客系统'\n setting.site_seo_description = '基于Django的博客系统'\n setting.site_keywords = 'Django,Python'\n setting.article_sub_length = 300\n setting.sidebar_article_count = 10\n setting.sidebar_comment_count = 5\n setting.show_google_adsense = False\n setting.open_site_comment = True\n setting.analytics_code = ''\n setting.beian_code = ''\n setting.show_gongan_code = False\n setting.comment_need_review = False\n setting.save()\n value = BlogSettings.objects.first()\n logger.info('set cache get_blog_setting')\n cache.set('get_blog_setting', value)\n return value\n\n\ndef save_user_avatar(url):\n '''\n 保存用户头像\n :param url:头像url\n :return: 本地路径\n '''\n logger.info(url)\n\n try:\n basedir = os.path.join(settings.STATICFILES, 'avatar')\n rsp = requests.get(url, timeout=2)\n if rsp.status_code == 200:\n if not os.path.exists(basedir):\n os.makedirs(basedir)\n\n image_extensions = ['.jpg', '.png', 'jpeg', '.gif']\n isimage = len([i for i in image_extensions if url.endswith(i)]) > 0\n ext = os.path.splitext(url)[1] if isimage else '.jpg'\n save_filename = str(uuid.uuid4().hex) + ext\n logger.info('保存用户头像:' + basedir + save_filename)\n with open(os.path.join(basedir, save_filename), 'wb+') as file:\n file.write(rsp.content)\n return static('avatar/' + save_filename)\n except Exception as e:\n logger.error(e)\n return static('blog/img/avatar.png')\n\n\ndef delete_sidebar_cache():\n from blog.models import LinkShowType\n keys = [\"sidebar\" + x for x in LinkShowType.values]\n for k in keys:\n logger.info('delete sidebar key:' + k)\n cache.delete(k)\n\n\ndef delete_view_cache(prefix, keys):\n from django.core.cache.utils import make_template_fragment_key\n key = make_template_fragment_key(prefix, keys)\n cache.delete(key)\n\n\ndef get_resource_url():\n if settings.STATIC_URL:\n return settings.STATIC_URL\n else:\n site = get_current_site()\n return 'http://' + site.domain + '/static/'\n\n\n# 允许的HTML标签白名单 - 支持markdown常用元素\nALLOWED_TAGS = [\n 'a', 'abbr', 'acronym', 'b', 'blockquote', 'code', 'em', 'i', 'li', 'ol', 'ul', 'pre', 'strong',\n 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', # 标题\n 'p', 'span', 'div', 'br', 'hr', # 段落和分隔\n 'table', 'thead', 'tbody', 'tr', 'th', 'td', # 表格\n 'dl', 'dt', 'dd', # 定义列表\n 'img', # 图片（需配合ALLOWED_ATTRIBUTES限制src）\n 'del', 'ins', 'sub', 'sup', # 文本修饰\n]\n\n# 安全的class值白名单 - 只允许代码高亮相关的class\nALLOWED_CLASSES = [\n 'codehilite', 'highlight', 'hll', 'c', 'err', 'k', 'l', 'n', 'o', 'p', 'cm', 'cp', 'c1', 'cs',\n 'gd', 'ge', 'gr', 'gh', 'gi', 'go', 'gp', 'gs', 'gu', 'gt', 'kc', 'kd', 'kn', 'kp', 'kr', 'kt',\n 'ld', 'm', 'mf', 'mh', 'mi', 'mo', 'na', 'nb', 'nc', 'no', 'nd', 'ni', 'ne', 'nf', 'nl', 'nn',\n 'nt', 'nv', 'ow', 'w', 'mb', 'mh', 'mi', 'mo', 'sb', 'sc', 'sd', 'se', 'sh', 'si', 'sx', 's2',\n 's1', 'ss', 'bp', 'vc', 'vg', 'vi', 'il'\n]\n\ndef class_filter(tag, name, value):\n \"\"\"自定义class属性过滤器\"\"\"\n if name == 'class':\n # 只允许预定义的安全class值\n allowed_classes = [cls for cls in value.split() if cls in ALLOWED_CLASSES]\n return ' '.join(allowed_classes) if allowed_classes else False\n return value\n\n# 安全的属性白名单\nALLOWED_ATTRIBUTES = {\n 'a': ['href', 'title', 'rel'], # rel=\"nofollow\" 用于外部链接\n 'abbr': ['title'], \n 'acronym': ['title'],\n 'img': ['src', 'alt', 'title', 'width', 'height'], # 图片属性\n 'table': ['border', 'cellpadding', 'cellspacing'],\n 'th': ['align', 'valign'],\n 'td': ['align', 'valign'],\n 'span': class_filter,\n 'div': class_filter,\n 'pre': class_filter,\n 'code': class_filter\n}\n\n# 安全的协议白名单 - 防止javascript:等危险协议\nALLOWED_PROTOCOLS = ['http', 'https', 'mailto']\n\ndef sanitize_html(html):\n \"\"\"\n 安全的HTML清理函数\n 使用bleach库进行白名单过滤，防止XSS攻击\n \"\"\"\n cleaned = bleach.clean(\n html, \n tags=ALLOWED_TAGS, \n attributes=ALLOWED_ATTRIBUTES,\n protocols=ALLOWED_PROTOCOLS, # 限制允许的协议\n strip=True, # 移除不允许的标签而不是转义\n strip_comments=True # 移除HTML注释\n )\n \n # 移除空的 style 属性（bleach 有时会保留 style=\"\"）\n import re\n cleaned = re.sub(r'\\s*style\\s*=\\s*[\"\\'][\\s]*[\"\\']', '', cleaned)\n \n return cleaned\n"
},
{
"path": "djangoblog/whoosh_cn_backend.py",
"content": "# encoding: utf-8\n\nfrom __future__ import absolute_import, division, print_function, unicode_literals\n\nimport json\nimport os\nimport re\nimport shutil\nimport threading\nimport warnings\n\nimport six\nfrom django.conf import settings\nfrom django.core.exceptions import ImproperlyConfigured\nfrom datetime import datetime\nfrom django.utils.encoding import force_str\nfrom haystack.backends import BaseEngine, BaseSearchBackend, BaseSearchQuery, EmptyResults, log_query\nfrom haystack.constants import DJANGO_CT, DJANGO_ID, ID\nfrom haystack.exceptions import MissingDependency, SearchBackendError, SkipDocument\nfrom haystack.inputs import Clean, Exact, PythonData, Raw\nfrom haystack.models import SearchResult\nfrom haystack.utils import get_identifier, get_model_ct\nfrom haystack.utils import log as logging\nfrom haystack.utils.app_loading import haystack_get_model\nfrom jieba.analyse import ChineseAnalyzer\nfrom whoosh import index\nfrom whoosh.analysis import StemmingAnalyzer\nfrom whoosh.fields import BOOLEAN, DATETIME, IDLIST, KEYWORD, NGRAM, NGRAMWORDS, NUMERIC, Schema, TEXT\nfrom whoosh.fields import ID as WHOOSH_ID\nfrom whoosh.filedb.filestore import FileStorage, RamStorage\nfrom whoosh.highlight import ContextFragmenter, HtmlFormatter\nfrom whoosh.highlight import highlight as whoosh_highlight\nfrom whoosh.qparser import QueryParser\nfrom whoosh.searching import ResultsPage\nfrom whoosh.writing import AsyncWriter\n\ntry:\n import whoosh\nexcept ImportError:\n raise MissingDependency(\n \"The 'whoosh' backend requires the installation of 'Whoosh'. Please refer to the documentation.\")\n\n# Handle minimum requirement.\nif not hasattr(whoosh, '__version__') or whoosh.__version__ < (2, 5, 0):\n raise MissingDependency(\n \"The 'whoosh' backend requires version 2.5.0 or greater.\")\n\n# Bubble up the correct error.\n\nDATETIME_REGEX = re.compile(\n '^(?P\\d{4})-(?P\\d{2})-(?P\\d{2})T(?P\\d{2}):(?P\\d{2}):(?P\\d{2})(\\.\\d{3,6}Z?)?$')\nLOCALS = threading.local()\nLOCALS.RAM_STORE = None\n\n\nclass WhooshHtmlFormatter(HtmlFormatter):\n \"\"\"\n This is a HtmlFormatter simpler than the whoosh.HtmlFormatter.\n We use it to have consistent results across backends. Specifically,\n Solr, Xapian and Elasticsearch are using this formatting.\n \"\"\"\n template = '<%(tag)s>%(t)s'\n\n\nclass WhooshSearchBackend(BaseSearchBackend):\n # Word reserved by Whoosh for special use.\n RESERVED_WORDS = (\n 'AND',\n 'NOT',\n 'OR',\n 'TO',\n )\n\n # Characters reserved by Whoosh for special use.\n # The '\\\\' must come first, so as not to overwrite the other slash\n # replacements.\n RESERVED_CHARACTERS = (\n '\\\\', '+', '-', '&&', '||', '!', '(', ')', '{', '}',\n '[', ']', '^', '\"', '~', '*', '?', ':', '.',\n )\n\n def __init__(self, connection_alias, **connection_options):\n super(\n WhooshSearchBackend,\n self).__init__(\n connection_alias,\n **connection_options)\n self.setup_complete = False\n self.use_file_storage = True\n self.post_limit = getattr(\n connection_options,\n 'POST_LIMIT',\n 128 * 1024 * 1024)\n self.path = connection_options.get('PATH')\n\n if connection_options.get('STORAGE', 'file') != 'file':\n self.use_file_storage = False\n\n if self.use_file_storage and not self.path:\n raise ImproperlyConfigured(\n \"You must specify a 'PATH' in your settings for connection '%s'.\" %\n connection_alias)\n\n self.log = logging.getLogger('haystack')\n\n def setup(self):\n \"\"\"\n Defers loading until needed.\n \"\"\"\n from haystack import connections\n new_index = False\n\n # Make sure the index is there.\n if self.use_file_storage and not os.path.exists(self.path):\n os.makedirs(self.path)\n new_index = True\n\n if self.use_file_storage and not os.access(self.path, os.W_OK):\n raise IOError(\n \"The path to your Whoosh index '%s' is not writable for the current user/group.\" %\n self.path)\n\n if self.use_file_storage:\n self.storage = FileStorage(self.path)\n else:\n global LOCALS\n\n if getattr(LOCALS, 'RAM_STORE', None) is None:\n LOCALS.RAM_STORE = RamStorage()\n\n self.storage = LOCALS.RAM_STORE\n\n self.content_field_name, self.schema = self.build_schema(\n connections[self.connection_alias].get_unified_index().all_searchfields())\n self.parser = QueryParser(self.content_field_name, schema=self.schema)\n\n if new_index is True:\n self.index = self.storage.create_index(self.schema)\n else:\n try:\n self.index = self.storage.open_index(schema=self.schema)\n except index.EmptyIndexError:\n self.index = self.storage.create_index(self.schema)\n\n self.setup_complete = True\n\n def build_schema(self, fields):\n schema_fields = {\n ID: WHOOSH_ID(stored=True, unique=True),\n DJANGO_CT: WHOOSH_ID(stored=True),\n DJANGO_ID: WHOOSH_ID(stored=True),\n }\n # Grab the number of keys that are hard-coded into Haystack.\n # We'll use this to (possibly) fail slightly more gracefully later.\n initial_key_count = len(schema_fields)\n content_field_name = ''\n\n for field_name, field_class in fields.items():\n if field_class.is_multivalued:\n if field_class.indexed is False:\n schema_fields[field_class.index_fieldname] = IDLIST(\n stored=True, field_boost=field_class.boost)\n else:\n schema_fields[field_class.index_fieldname] = KEYWORD(\n stored=True, commas=True, scorable=True, field_boost=field_class.boost)\n elif field_class.field_type in ['date', 'datetime']:\n schema_fields[field_class.index_fieldname] = DATETIME(\n stored=field_class.stored, sortable=True)\n elif field_class.field_type == 'integer':\n schema_fields[field_class.index_fieldname] = NUMERIC(\n stored=field_class.stored, numtype=int, field_boost=field_class.boost)\n elif field_class.field_type == 'float':\n schema_fields[field_class.index_fieldname] = NUMERIC(\n stored=field_class.stored, numtype=float, field_boost=field_class.boost)\n elif field_class.field_type == 'boolean':\n # Field boost isn't supported on BOOLEAN as of 1.8.2.\n schema_fields[field_class.index_fieldname] = BOOLEAN(\n stored=field_class.stored)\n elif field_class.field_type == 'ngram':\n schema_fields[field_class.index_fieldname] = NGRAM(\n minsize=3, maxsize=15, stored=field_class.stored, field_boost=field_class.boost)\n elif field_class.field_type == 'edge_ngram':\n schema_fields[field_class.index_fieldname] = NGRAMWORDS(minsize=2, maxsize=15, at='start',\n stored=field_class.stored,\n field_boost=field_class.boost)\n else:\n # schema_fields[field_class.index_fieldname] = TEXT(stored=True, analyzer=StemmingAnalyzer(), field_boost=field_class.boost, sortable=True)\n schema_fields[field_class.index_fieldname] = TEXT(\n stored=True, analyzer=ChineseAnalyzer(), field_boost=field_class.boost, sortable=True)\n if field_class.document is True:\n content_field_name = field_class.index_fieldname\n schema_fields[field_class.index_fieldname].spelling = True\n\n # Fail more gracefully than relying on the backend to die if no fields\n # are found.\n if len(schema_fields) <= initial_key_count:\n raise SearchBackendError(\n \"No fields were found in any search_indexes. Please correct this before attempting to search.\")\n\n return (content_field_name, Schema(**schema_fields))\n\n def update(self, index, iterable, commit=True):\n if not self.setup_complete:\n self.setup()\n\n self.index = self.index.refresh()\n writer = AsyncWriter(self.index)\n\n for obj in iterable:\n try:\n doc = index.full_prepare(obj)\n except SkipDocument:\n self.log.debug(u\"Indexing for object `%s` skipped\", obj)\n else:\n # Really make sure it's unicode, because Whoosh won't have it any\n # other way.\n for key in doc:\n doc[key] = self._from_python(doc[key])\n\n # Document boosts aren't supported in Whoosh 2.5.0+.\n if 'boost' in doc:\n del doc['boost']\n\n try:\n writer.update_document(**doc)\n except Exception as e:\n if not self.silently_fail:\n raise\n\n # We'll log the object identifier but won't include the actual object\n # to avoid the possibility of that generating encoding errors while\n # processing the log message:\n self.log.error(\n u\"%s while preparing object for update\" %\n e.__class__.__name__,\n exc_info=True,\n extra={\n \"data\": {\n \"index\": index,\n \"object\": get_identifier(obj)}})\n\n if len(iterable) > 0:\n # For now, commit no matter what, as we run into locking issues\n # otherwise.\n writer.commit()\n\n def remove(self, obj_or_string, commit=True):\n if not self.setup_complete:\n self.setup()\n\n self.index = self.index.refresh()\n whoosh_id = get_identifier(obj_or_string)\n\n try:\n self.index.delete_by_query(\n q=self.parser.parse(\n u'%s:\"%s\"' %\n (ID, whoosh_id)))\n except Exception as e:\n if not self.silently_fail:\n raise\n\n self.log.error(\n \"Failed to remove document '%s' from Whoosh: %s\",\n whoosh_id,\n e,\n exc_info=True)\n\n def clear(self, models=None, commit=True):\n if not self.setup_complete:\n self.setup()\n\n self.index = self.index.refresh()\n\n if models is not None:\n assert isinstance(models, (list, tuple))\n\n try:\n if models is None:\n self.delete_index()\n else:\n models_to_delete = []\n\n for model in models:\n models_to_delete.append(\n u\"%s:%s\" %\n (DJANGO_CT, get_model_ct(model)))\n\n self.index.delete_by_query(\n q=self.parser.parse(\n u\" OR \".join(models_to_delete)))\n except Exception as e:\n if not self.silently_fail:\n raise\n\n if models is not None:\n self.log.error(\n \"Failed to clear Whoosh index of models '%s': %s\",\n ','.join(models_to_delete),\n e,\n exc_info=True)\n else:\n self.log.error(\n \"Failed to clear Whoosh index: %s\", e, exc_info=True)\n\n def delete_index(self):\n # Per the Whoosh mailing list, if wiping out everything from the index,\n # it's much more efficient to simply delete the index files.\n if self.use_file_storage and os.path.exists(self.path):\n shutil.rmtree(self.path)\n elif not self.use_file_storage:\n self.storage.clean()\n\n # Recreate everything.\n self.setup()\n\n def optimize(self):\n if not self.setup_complete:\n self.setup()\n\n self.index = self.index.refresh()\n self.index.optimize()\n\n def calculate_page(self, start_offset=0, end_offset=None):\n # Prevent against Whoosh throwing an error. Requires an end_offset\n # greater than 0.\n if end_offset is not None and end_offset <= 0:\n end_offset = 1\n\n # Determine the page.\n page_num = 0\n\n if end_offset is None:\n end_offset = 1000000\n\n if start_offset is None:\n start_offset = 0\n\n page_length = end_offset - start_offset\n\n if page_length and page_length > 0:\n page_num = int(start_offset / page_length)\n\n # Increment because Whoosh uses 1-based page numbers.\n page_num += 1\n return page_num, page_length\n\n @log_query\n def search(\n self,\n query_string,\n sort_by=None,\n start_offset=0,\n end_offset=None,\n fields='',\n highlight=False,\n facets=None,\n date_facets=None,\n query_facets=None,\n narrow_queries=None,\n spelling_query=None,\n within=None,\n dwithin=None,\n distance_point=None,\n models=None,\n limit_to_registered_models=None,\n result_class=None,\n **kwargs):\n if not self.setup_complete:\n self.setup()\n\n # A zero length query should return no results.\n if len(query_string) == 0:\n return {\n 'results': [],\n 'hits': 0,\n }\n\n query_string = force_str(query_string)\n\n # A one-character query (non-wildcard) gets nabbed by a stopwords\n # filter and should yield zero results.\n if len(query_string) <= 1 and query_string != u'*':\n return {\n 'results': [],\n 'hits': 0,\n }\n\n reverse = False\n\n if sort_by is not None:\n # Determine if we need to reverse the results and if Whoosh can\n # handle what it's being asked to sort by. Reversing is an\n # all-or-nothing action, unfortunately.\n sort_by_list = []\n reverse_counter = 0\n\n for order_by in sort_by:\n if order_by.startswith('-'):\n reverse_counter += 1\n\n if reverse_counter and reverse_counter != len(sort_by):\n raise SearchBackendError(\"Whoosh requires all order_by fields\"\n \" to use the same sort direction\")\n\n for order_by in sort_by:\n if order_by.startswith('-'):\n sort_by_list.append(order_by[1:])\n\n if len(sort_by_list) == 1:\n reverse = True\n else:\n sort_by_list.append(order_by)\n\n if len(sort_by_list) == 1:\n reverse = False\n\n sort_by = sort_by_list[0]\n\n if facets is not None:\n warnings.warn(\n \"Whoosh does not handle faceting.\",\n Warning,\n stacklevel=2)\n\n if date_facets is not None:\n warnings.warn(\n \"Whoosh does not handle date faceting.\",\n Warning,\n stacklevel=2)\n\n if query_facets is not None:\n warnings.warn(\n \"Whoosh does not handle query faceting.\",\n Warning,\n stacklevel=2)\n\n narrowed_results = None\n self.index = self.index.refresh()\n\n if limit_to_registered_models is None:\n limit_to_registered_models = getattr(\n settings, 'HAYSTACK_LIMIT_TO_REGISTERED_MODELS', True)\n\n if models and len(models):\n model_choices = sorted(get_model_ct(model) for model in models)\n elif limit_to_registered_models:\n # Using narrow queries, limit the results to only models handled\n # with the current routers.\n model_choices = self.build_models_list()\n else:\n model_choices = []\n\n if len(model_choices) > 0:\n if narrow_queries is None:\n narrow_queries = set()\n\n narrow_queries.add(' OR '.join(\n ['%s:%s' % (DJANGO_CT, rm) for rm in model_choices]))\n\n narrow_searcher = None\n\n if narrow_queries is not None:\n # Potentially expensive? I don't see another way to do it in\n # Whoosh...\n narrow_searcher = self.index.searcher()\n\n for nq in narrow_queries:\n recent_narrowed_results = narrow_searcher.search(\n self.parser.parse(force_str(nq)), limit=None)\n\n if len(recent_narrowed_results) <= 0:\n return {\n 'results': [],\n 'hits': 0,\n }\n\n if narrowed_results:\n narrowed_results.filter(recent_narrowed_results)\n else:\n narrowed_results = recent_narrowed_results\n\n self.index = self.index.refresh()\n\n if self.index.doc_count():\n searcher = self.index.searcher()\n parsed_query = self.parser.parse(query_string)\n\n # In the event of an invalid/stopworded query, recover gracefully.\n if parsed_query is None:\n return {\n 'results': [],\n 'hits': 0,\n }\n\n page_num, page_length = self.calculate_page(\n start_offset, end_offset)\n\n search_kwargs = {\n 'pagelen': page_length,\n 'sortedby': sort_by,\n 'reverse': reverse,\n }\n\n # Handle the case where the results have been narrowed.\n if narrowed_results is not None:\n search_kwargs['filter'] = narrowed_results\n\n try:\n raw_page = searcher.search_page(\n parsed_query,\n page_num,\n **search_kwargs\n )\n except ValueError:\n if not self.silently_fail:\n raise\n\n return {\n 'results': [],\n 'hits': 0,\n 'spelling_suggestion': None,\n }\n\n # Because as of Whoosh 2.5.1, it will return the wrong page of\n # results if you request something too high. :(\n if raw_page.pagenum < page_num:\n return {\n 'results': [],\n 'hits': 0,\n 'spelling_suggestion': None,\n }\n\n results = self._process_results(\n raw_page,\n highlight=highlight,\n query_string=query_string,\n spelling_query=spelling_query,\n result_class=result_class)\n searcher.close()\n\n if hasattr(narrow_searcher, 'close'):\n narrow_searcher.close()\n\n return results\n else:\n if self.include_spelling:\n if spelling_query:\n spelling_suggestion = self.create_spelling_suggestion(\n spelling_query)\n else:\n spelling_suggestion = self.create_spelling_suggestion(\n query_string)\n else:\n spelling_suggestion = None\n\n return {\n 'results': [],\n 'hits': 0,\n 'spelling_suggestion': spelling_suggestion,\n }\n\n def more_like_this(\n self,\n model_instance,\n additional_query_string=None,\n start_offset=0,\n end_offset=None,\n models=None,\n limit_to_registered_models=None,\n result_class=None,\n **kwargs):\n if not self.setup_complete:\n self.setup()\n\n # Deferred models will have a different class (\"RealClass_Deferred_fieldname\")\n # which won't be in our registry:\n model_klass = model_instance._meta.concrete_model\n\n field_name = self.content_field_name\n narrow_queries = set()\n narrowed_results = None\n self.index = self.index.refresh()\n\n if limit_to_registered_models is None:\n limit_to_registered_models = getattr(\n settings, 'HAYSTACK_LIMIT_TO_REGISTERED_MODELS', True)\n\n if models and len(models):\n model_choices = sorted(get_model_ct(model) for model in models)\n elif limit_to_registered_models:\n # Using narrow queries, limit the results to only models handled\n # with the current routers.\n model_choices = self.build_models_list()\n else:\n model_choices = []\n\n if len(model_choices) > 0:\n if narrow_queries is None:\n narrow_queries = set()\n\n narrow_queries.add(' OR '.join(\n ['%s:%s' % (DJANGO_CT, rm) for rm in model_choices]))\n\n if additional_query_string and additional_query_string != '*':\n narrow_queries.add(additional_query_string)\n\n narrow_searcher = None\n\n if narrow_queries is not None:\n # Potentially expensive? I don't see another way to do it in\n # Whoosh...\n narrow_searcher = self.index.searcher()\n\n for nq in narrow_queries:\n recent_narrowed_results = narrow_searcher.search(\n self.parser.parse(force_str(nq)), limit=None)\n\n if len(recent_narrowed_results) <= 0:\n return {\n 'results': [],\n 'hits': 0,\n }\n\n if narrowed_results:\n narrowed_results.filter(recent_narrowed_results)\n else:\n narrowed_results = recent_narrowed_results\n\n page_num, page_length = self.calculate_page(start_offset, end_offset)\n\n self.index = self.index.refresh()\n raw_results = EmptyResults()\n\n if self.index.doc_count():\n query = \"%s:%s\" % (ID, get_identifier(model_instance))\n searcher = self.index.searcher()\n parsed_query = self.parser.parse(query)\n results = searcher.search(parsed_query)\n\n if len(results):\n raw_results = results[0].more_like_this(\n field_name, top=end_offset)\n\n # Handle the case where the results have been narrowed.\n if narrowed_results is not None and hasattr(raw_results, 'filter'):\n raw_results.filter(narrowed_results)\n\n try:\n raw_page = ResultsPage(raw_results, page_num, page_length)\n except ValueError:\n if not self.silently_fail:\n raise\n\n return {\n 'results': [],\n 'hits': 0,\n 'spelling_suggestion': None,\n }\n\n # Because as of Whoosh 2.5.1, it will return the wrong page of\n # results if you request something too high. :(\n if raw_page.pagenum < page_num:\n return {\n 'results': [],\n 'hits': 0,\n 'spelling_suggestion': None,\n }\n\n results = self._process_results(raw_page, result_class=result_class)\n searcher.close()\n\n if hasattr(narrow_searcher, 'close'):\n narrow_searcher.close()\n\n return results\n\n def _process_results(\n self,\n raw_page,\n highlight=False,\n query_string='',\n spelling_query=None,\n result_class=None):\n from haystack import connections\n results = []\n\n # It's important to grab the hits first before slicing. Otherwise, this\n # can cause pagination failures.\n hits = len(raw_page)\n\n if result_class is None:\n result_class = SearchResult\n\n facets = {}\n spelling_suggestion = None\n unified_index = connections[self.connection_alias].get_unified_index()\n indexed_models = unified_index.get_indexed_models()\n\n for doc_offset, raw_result in enumerate(raw_page):\n score = raw_page.score(doc_offset) or 0\n app_label, model_name = raw_result[DJANGO_CT].split('.')\n additional_fields = {}\n model = haystack_get_model(app_label, model_name)\n\n if model and model in indexed_models:\n for key, value in raw_result.items():\n index = unified_index.get_index(model)\n string_key = str(key)\n\n if string_key in index.fields and hasattr(\n index.fields[string_key], 'convert'):\n # Special-cased due to the nature of KEYWORD fields.\n if index.fields[string_key].is_multivalued:\n if value is None or len(value) == 0:\n additional_fields[string_key] = []\n else:\n additional_fields[string_key] = value.split(\n ',')\n else:\n additional_fields[string_key] = index.fields[string_key].convert(\n value)\n else:\n additional_fields[string_key] = self._to_python(value)\n\n del (additional_fields[DJANGO_CT])\n del (additional_fields[DJANGO_ID])\n\n if highlight:\n # 使用中文分词器\n ca = ChineseAnalyzer()\n\n highlighted = {}\n\n # 高亮标题（如果存在）\n if 'title' in additional_fields and additional_fields['title']:\n import re\n title_text = additional_fields['title']\n # 使用正则表达式高亮，不转义HTML\n for term in query_string.split():\n if len(term) >= 2:\n # 不区分大小写地替换\n title_text = re.sub(\n r'(' + re.escape(term) + r')',\n r'\\1 ',\n title_text,\n flags=re.IGNORECASE\n )\n if '' in title_text:\n highlighted['title'] = [title_text]\n\n # 高亮正文 - 返回markdown片段，让模板处理\n if 'body' in additional_fields and additional_fields['body']:\n import re\n from djangoblog.utils import CommonMarkdown\n\n # 先转换为HTML，便于提取摘要\n html_content = CommonMarkdown.get_markdown(additional_fields['body'])\n\n # 提取纯文本用于搜索匹配的上下文\n from django.utils.html import strip_tags\n plain_text = strip_tags(html_content)\n\n # 找到关键词的位置，提取上下文\n match_pos = -1\n for term in query_string.split():\n if len(term) >= 2:\n pos = plain_text.lower().find(term.lower())\n if pos >= 0:\n match_pos = pos\n break\n\n if match_pos >= 0:\n # 提取匹配位置前后的内容\n start = max(0, match_pos - 150)\n end = min(len(plain_text), match_pos + 350)\n snippet = plain_text[start:end]\n\n # 对snippet进行高亮\n for term in query_string.split():\n if len(term) >= 2:\n snippet = re.sub(\n r'(' + re.escape(term) + r')',\n r'\\1 ',\n snippet,\n flags=re.IGNORECASE\n )\n\n highlighted['body'] = [snippet]\n\n if highlighted:\n additional_fields['highlighted'] = highlighted\n\n result = result_class(\n app_label,\n model_name,\n raw_result[DJANGO_ID],\n score,\n **additional_fields)\n results.append(result)\n else:\n hits -= 1\n\n if self.include_spelling:\n if spelling_query:\n spelling_suggestion = self.create_spelling_suggestion(\n spelling_query)\n else:\n spelling_suggestion = self.create_spelling_suggestion(\n query_string)\n\n return {\n 'results': results,\n 'hits': hits,\n 'facets': facets,\n 'spelling_suggestion': spelling_suggestion,\n }\n\n def create_spelling_suggestion(self, query_string):\n spelling_suggestion = None\n reader = self.index.reader()\n corrector = reader.corrector(self.content_field_name)\n cleaned_query = force_str(query_string)\n\n if not query_string:\n return spelling_suggestion\n\n # Clean the string.\n for rev_word in self.RESERVED_WORDS:\n cleaned_query = cleaned_query.replace(rev_word, '')\n\n for rev_char in self.RESERVED_CHARACTERS:\n cleaned_query = cleaned_query.replace(rev_char, '')\n\n # Break it down.\n query_words = cleaned_query.split()\n suggested_words = []\n\n for word in query_words:\n suggestions = corrector.suggest(word, limit=1)\n\n if len(suggestions) > 0:\n suggested_words.append(suggestions[0])\n\n spelling_suggestion = ' '.join(suggested_words)\n return spelling_suggestion\n\n def _from_python(self, value):\n \"\"\"\n Converts Python values to a string for Whoosh.\n\n Code courtesy of pysolr.\n \"\"\"\n if hasattr(value, 'strftime'):\n if not hasattr(value, 'hour'):\n value = datetime(value.year, value.month, value.day, 0, 0, 0)\n elif isinstance(value, bool):\n if value:\n value = 'true'\n else:\n value = 'false'\n elif isinstance(value, (list, tuple)):\n value = u','.join([force_str(v) for v in value])\n elif isinstance(value, (six.integer_types, float)):\n # Leave it alone.\n pass\n else:\n value = force_str(value)\n return value\n\n def _to_python(self, value):\n \"\"\"\n Converts values from Whoosh to native Python values.\n\n A port of the same method in pysolr, as they deal with data the same way.\n \"\"\"\n if value == 'true':\n return True\n elif value == 'false':\n return False\n\n if value and isinstance(value, six.string_types):\n possible_datetime = DATETIME_REGEX.search(value)\n\n if possible_datetime:\n date_values = possible_datetime.groupdict()\n\n for dk, dv in date_values.items():\n date_values[dk] = int(dv)\n\n return datetime(\n date_values['year'],\n date_values['month'],\n date_values['day'],\n date_values['hour'],\n date_values['minute'],\n date_values['second'])\n\n try:\n # Attempt to use json to load the values.\n converted_value = json.loads(value)\n\n # Try to handle most built-in types.\n if isinstance(\n converted_value,\n (list,\n tuple,\n set,\n dict,\n six.integer_types,\n float,\n complex)):\n return converted_value\n except BaseException:\n # If it fails (SyntaxError or its ilk) or we don't trust it,\n # continue on.\n pass\n\n return value\n\n\nclass WhooshSearchQuery(BaseSearchQuery):\n def _convert_datetime(self, date):\n if hasattr(date, 'hour'):\n return force_str(date.strftime('%Y%m%d%H%M%S'))\n else:\n return force_str(date.strftime('%Y%m%d000000'))\n\n def clean(self, query_fragment):\n \"\"\"\n Provides a mechanism for sanitizing user input before presenting the\n value to the backend.\n\n Whoosh 1.X differs here in that you can no longer use a backslash\n to escape reserved characters. Instead, the whole word should be\n quoted.\n \"\"\"\n words = query_fragment.split()\n cleaned_words = []\n\n for word in words:\n if word in self.backend.RESERVED_WORDS:\n word = word.replace(word, word.lower())\n\n for char in self.backend.RESERVED_CHARACTERS:\n if char in word:\n word = \"'%s'\" % word\n break\n\n cleaned_words.append(word)\n\n return ' '.join(cleaned_words)\n\n def build_query_fragment(self, field, filter_type, value):\n from haystack import connections\n query_frag = ''\n is_datetime = False\n\n if not hasattr(value, 'input_type_name'):\n # Handle when we've got a ``ValuesListQuerySet``...\n if hasattr(value, 'values_list'):\n value = list(value)\n\n if hasattr(value, 'strftime'):\n is_datetime = True\n\n if isinstance(value, six.string_types) and value != ' ':\n # It's not an ``InputType``. Assume ``Clean``.\n value = Clean(value)\n else:\n value = PythonData(value)\n\n # Prepare the query using the InputType.\n prepared_value = value.prepare(self)\n\n if not isinstance(prepared_value, (set, list, tuple)):\n # Then convert whatever we get back to what pysolr wants if needed.\n prepared_value = self.backend._from_python(prepared_value)\n\n # 'content' is a special reserved word, much like 'pk' in\n # Django's ORM layer. It indicates 'no special field'.\n if field == 'content':\n index_fieldname = ''\n else:\n index_fieldname = u'%s:' % connections[self._using].get_unified_index(\n ).get_index_fieldname(field)\n\n filter_types = {\n 'content': '%s',\n 'contains': '*%s*',\n 'endswith': \"*%s\",\n 'startswith': \"%s*\",\n 'exact': '%s',\n 'gt': \"{%s to}\",\n 'gte': \"[%s to]\",\n 'lt': \"{to %s}\",\n 'lte': \"[to %s]\",\n 'fuzzy': u'%s~',\n }\n\n if value.post_process is False:\n query_frag = prepared_value\n else:\n if filter_type in [\n 'content',\n 'contains',\n 'startswith',\n 'endswith',\n 'fuzzy']:\n if value.input_type_name == 'exact':\n query_frag = prepared_value\n else:\n # Iterate over terms & incorportate the converted form of\n # each into the query.\n terms = []\n\n if isinstance(prepared_value, six.string_types):\n possible_values = prepared_value.split(' ')\n else:\n if is_datetime is True:\n prepared_value = self._convert_datetime(\n prepared_value)\n\n possible_values = [prepared_value]\n\n for possible_value in possible_values:\n terms.append(\n filter_types[filter_type] %\n self.backend._from_python(possible_value))\n\n if len(terms) == 1:\n query_frag = terms[0]\n else:\n query_frag = u\"(%s)\" % \" AND \".join(terms)\n elif filter_type == 'in':\n in_options = []\n\n for possible_value in prepared_value:\n is_datetime = False\n\n if hasattr(possible_value, 'strftime'):\n is_datetime = True\n\n pv = self.backend._from_python(possible_value)\n\n if is_datetime is True:\n pv = self._convert_datetime(pv)\n\n if isinstance(pv, six.string_types) and not is_datetime:\n in_options.append('\"%s\"' % pv)\n else:\n in_options.append('%s' % pv)\n\n query_frag = \"(%s)\" % \" OR \".join(in_options)\n elif filter_type == 'range':\n start = self.backend._from_python(prepared_value[0])\n end = self.backend._from_python(prepared_value[1])\n\n if hasattr(prepared_value[0], 'strftime'):\n start = self._convert_datetime(start)\n\n if hasattr(prepared_value[1], 'strftime'):\n end = self._convert_datetime(end)\n\n query_frag = u\"[%s to %s]\" % (start, end)\n elif filter_type == 'exact':\n if value.input_type_name == 'exact':\n query_frag = prepared_value\n else:\n prepared_value = Exact(prepared_value).prepare(self)\n query_frag = filter_types[filter_type] % prepared_value\n else:\n if is_datetime is True:\n prepared_value = self._convert_datetime(prepared_value)\n\n query_frag = filter_types[filter_type] % prepared_value\n\n if len(query_frag) and not isinstance(value, Raw):\n if not query_frag.startswith('(') and not query_frag.endswith(')'):\n query_frag = \"(%s)\" % query_frag\n\n return u\"%s%s\" % (index_fieldname, query_frag)\n\n # if not filter_type in ('in', 'range'):\n # # 'in' is a bit of a special case, as we don't want to\n # # convert a valid list/tuple to string. Defer handling it\n # # until later...\n # value = self.backend._from_python(value)\n\n\nclass WhooshEngine(BaseEngine):\n backend = WhooshSearchBackend\n query = WhooshSearchQuery\n"
},
{
"path": "djangoblog/wsgi.py",
"content": "\"\"\"\nWSGI config for djangoblog project.\n\nIt exposes the WSGI callable as a module-level variable named ``application``.\n\nFor more information on this file, see\nhttps://docs.djangoproject.com/en/1.10/howto/deployment/wsgi/\n\"\"\"\n\nimport os\n\nfrom django.core.wsgi import get_wsgi_application\n\nos.environ.setdefault(\"DJANGO_SETTINGS_MODULE\", \"djangoblog.settings\")\n\napplication = get_wsgi_application()\n"
},
{
"path": "docs/README-en.md",
"content": "# DjangoBlog\n\n\n
\n\n\n A powerful, elegant, and modern blog system. \n English • 简体中文 \n
\n\n---\n\nDjangoBlog is a high-performance blog platform built with Python 3.10+ and Django 5.2. It not only provides all the core functionalities of a traditional blog but also features a flexible plugin system, allowing you to easily extend and customize your website. Whether you are a personal blogger, a tech enthusiast, or a content creator, DjangoBlog aims to provide a stable, efficient, and easy-to-maintain environment for writing and publishing.\n\n## ✨ Features\n\n- **Powerful Content Management**: Full support for managing articles, standalone pages, categories, and tags. Comes with a powerful built-in Markdown editor with syntax highlighting.\n- **Full-Text Search**: Integrated Elasticsearch/Whoosh search engine for fast and accurate content searching, with keyword highlighting support.\n- **Interactive Comment System**: Supports replies, email notifications, and Markdown formatting in comments. Modern comment interface with infinite nested replies.\n- **Flexible Sidebar**: Customizable modules for displaying recent articles, most viewed posts, tag cloud, and more.\n- **Social Login**: Built-in OAuth support, with integrations for Google, GitHub, Facebook, Weibo, QQ, and other major platforms.\n- **Dark Mode Support**: Toggle between light and dark themes with system preference support for comfortable reading experience. Anti-FOUC (Flash of Unstyled Content) implementation.\n- **Modern Frontend**: Built with Alpine.js + Tailwind CSS + HTMX, providing SPA-like navigation experience with HTML-over-the-wire architecture.\n- **High-Performance Caching**: Native support for Redis caching with an automatic refresh mechanism to ensure high-speed website responses.\n- **SEO Friendly**: Basic SEO features are included, with automatic notifications to Google and Baidu upon new content publication.\n- **Extensible Plugin System**: Extend blog functionalities by creating standalone plugins, ensuring decoupled and maintainable code. 8 built-in plugins including view counting, SEO optimization, article recommendations, lazy image loading, and more!\n- **Integrated Image Hosting**: A simple, built-in image hosting feature for easy uploads and management.\n- **Automated Build**: Uses Vite to build frontend assets with hot reload and automatic optimization.\n- **Robust Operations**: Built-in email notifications for website exceptions and management capabilities through a WeChat Official Account.\n\n## 🛠️ Tech Stack\n\n- **Backend**: Python 3.10+, Django 5.2\n- **Database**: MySQL, SQLite (configurable)\n- **Cache**: Redis, LocalMem (configurable)\n- **Frontend**: Alpine.js 3.13, Tailwind CSS 3.4, HTMX 2.0, Vite 5.4\n- **Search**: Whoosh, Elasticsearch (configurable)\n- **Editor**: Markdown (mdeditor)\n\n## 🚀 Getting Started\n\n### 1. Prerequisites\n\nEnsure you have Python 3.10+ and MySQL/MariaDB installed on your system.\n\n### 2. Clone & Installation\n\n```bash\n# Clone the project to your local machine\ngit clone https://github.com/liangliangyy/DjangoBlog.git\ncd DjangoBlog\n\n# Install dependencies\npip install -r requirements.txt\n```\n\n### 3. Project Configuration\n\n- **Database**:\n Open `djangoblog/settings.py`, locate the `DATABASES` section, and update it with your MySQL connection details.\n\n ```python\n DATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.mysql',\n 'NAME': 'djangoblog',\n 'USER': 'root',\n 'PASSWORD': 'your_password',\n 'HOST': '127.0.0.1',\n 'PORT': 3306,\n }\n }\n ```\n Create the database in MySQL:\n ```sql\n CREATE DATABASE `djangoblog` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\n ```\n\n- **More Configurations**:\n For advanced settings such as email, OAuth, caching, and more, please refer to our [Detailed Configuration Guide](/docs/config-en.md).\n\n### 4. Database Initialization\n\n```bash\npython manage.py makemigrations\npython manage.py migrate\n\n# Create a superuser account\npython manage.py createsuperuser\n```\n\n### 5. Build Frontend Assets\n\n```bash\n# Navigate to frontend directory\ncd frontend\n\n# Install dependencies (required for first run)\nnpm install\n\n# Build production assets\nnpm run build\n\n# Return to project root\ncd ..\n```\n\n### 6. Running the Project\n\n```bash\n# (Optional) Generate some test data\npython manage.py create_testdata\n\n# Collect static files\npython manage.py collectstatic --noinput\n\n# (Optional) Compress static files\npython manage.py compress --force\n\n# Start the development server\npython manage.py runserver\n```\n\nNow, open your browser and navigate to `http://127.0.0.1:8000/`. You should see the DjangoBlog homepage!\n\n### Development Mode\n\nIf you need to develop frontend code, you can use Vite's hot reload feature:\n\n```bash\n# Start development server in frontend directory\ncd frontend\nnpm run dev\n```\n\nThis will start the Vite development server, and frontend code changes will be automatically rebuilt.\n\n## Deployment\n\n- **Traditional Deployment**: A detailed guide for server deployment is available here: [Deployment Tutorial](https://www.lylinux.net/article/2019/8/5/58.html) (in Chinese).\n- **Docker Deployment**: This project fully supports Docker. If you are familiar with containerization, please refer to the [Docker Deployment Guide](/docs/docker-en.md) for a quick start.\n- **Kubernetes Deployment**: We also provide a complete [Kubernetes Deployment Guide](/docs/k8s-en.md) to help you go cloud-native easily.\n\n## 🧩 Plugin System\n\nThe plugin system is a core feature of DjangoBlog. It allows you to add new functionalities to your blog without modifying the core codebase by writing standalone plugins.\n\n- **How it Works**: Plugins operate by registering callback functions to predefined \"hooks\". For instance, when an article is rendered, the `after_article_body_get` hook is triggered, and all functions registered to this hook are executed.\n\n- **Built-in Plugins**: The project includes the following useful plugins\n - `view_count` - Article view counter\n - `seo_optimizer` - SEO optimization enhancements\n - `article_copyright` - Article copyright notices (modern style)\n - `article_recommendation` - Smart article recommendations (responsive card layout)\n - `external_links` - External link handling (automatic icon addition)\n - `image_lazy_loading` - Image lazy loading optimization (fade-in animation)\n - `reading_time` - Article reading time estimation\n - `cloudflare_cache` - Cloudflare cache management\n\n- **Develop Your Own Plugin**: Simply create a new folder under the `plugins` directory and write your `plugin.py`. We welcome you to explore and contribute your creative ideas to the DjangoBlog community!\n\n## 🤝 Contributing\n\nWe warmly welcome contributions of any kind! If you have great ideas or have found a bug, please feel free to open an issue or submit a pull request.\n\n## 📄 License\n\nThis project is open-sourced under the [MIT License](LICENSE).\n\n---\n\n## ❤️ Support & Sponsorship\n\nIf you find this project helpful and wish to support its continued maintenance and development, please consider buying me a coffee! Your support is my greatest motivation.\n\n\n
\n\n (Left) Alipay / (Right) WeChat \n
\n\n## 🙏 Acknowledgements\n\nA special thanks to **JetBrains** for providing a free open-source license for this project.\n\n\n \n \n
\n\n---\n> If this project has helped you, please leave your website URL [here](https://github.com/liangliangyy/DjangoBlog/issues/214) to let more people see it. Your feedback is the driving force for my continued updates and maintenance.\n"
},
{
"path": "docs/config-en.md",
"content": "# Introduction to Main Features Settings\n\n## Cache Configuration\n\nThe cache uses `localmem` (local memory cache) by default. If you have a Redis environment, you can automatically switch to Redis cache by setting the `DJANGO_REDIS_URL` environment variable.\n\n### Using Redis Cache\n\nSet the environment variable:\n```bash\nexport DJANGO_REDIS_URL=\"127.0.0.1:6379/0\"\n```\n\nOr directly modify the cache configuration in `settings.py`:\n```python\nCACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.redis.RedisCache',\n 'LOCATION': 'redis://127.0.0.1:6379/0',\n }\n}\n```\n\nReference code: https://github.com/liangliangyy/DjangoBlog/blob/master/djangoblog/settings.py#L201-L215\n\n## OAuth Login:\nQQ, Weibo, Google, GitHub and Facebook are now supported for OAuth login. Fetch OAuth login permissions from the corresponding open platform, and save them with `appkey`, `appsecret` and callback address in **Backend->OAuth** configuration.\n\n### Callback address examples:\nQQ: http://your-domain-name/oauth/authorize?type=qq\nWeibo: http://your-domain-name/oauth/authorize?type=weibo\ntype is in the type field of `oauthmanager`.\n\n## owntracks:\nowntracks is a location tracking application. It will send your locaiton to the server by timing.Simple support owntracks features. Just install owntracks app and set api address as `your-domain-name/owntracks/logtracks`. Visit `your-domain-name/owntracks/show_dates` and you will see the date with latitude and langitude, click it and see the motion track. The map is drawn by AMap.\n\n## Email feature:\nSame as before, Configure your own error msg recvie email information with`ADMINS = [('liangliang', 'liangliangyy@gmail.com')]` in `settings.py`. And modify:\n```python\nEMAIL_HOST = 'smtp.zoho.com'\nEMAIL_PORT = 587\nEMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER')\nEMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD')\nDEFAULT_FROM_EMAIL = EMAIL_HOST_USER\nSERVER_EMAIL = os.environ.get('DJANGO_EMAIL_USER')\n```\nwith your email account information.\n\n## WeChat Official Account\nSimple wechat official account features integrated. Set token as `your-domain-name/robot` in wechat backend. Default token is `lylinux`, you can change it to your own in `servermanager/robot.py`. Add a new command in `Backend->Servermanager->command`, in this way, you can manage the system through wechat official account.\n\n## Introduction to website configuration\nYou can add website configuration in **Backend->BLOG->WebSiteConfiguration**. Such as: keywords, description, Google Ad, website stats code, case number, etc.\nOAuth user avatar path is saved in *StaticFileSavedAddress*. Please input absolute path, code directory for default.\n\n## Source code highlighting\nIf the code block in your article didn't show hightlight, please write the code blocks as following:\n\n\n\nThat is, you should add the corresponding language name before the code block.\n\n## Update & Version Notes\n\n### Database Migration Errors\nIf you encounter errors while executing database migrations:\n```python\ndjango.db.migrations.exceptions.MigrationSchemaMissing: Unable to create the django_migrations table ((1064, \"You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '(6) NOT NULL)' at line 1\"))\n```\nThis problem may be caused by MySQL version < 5.6. Please upgrade to MySQL >= 5.6.\n\n### Django Version Configuration\n\n#### Django 4.0+ CSRF Configuration\n\nDjango 4.0 and above require `CSRF_TRUSTED_ORIGINS` configuration, otherwise you may encounter CSRF errors during login.\n\nConfigure your domain in `settings.py`:\n```python\nCSRF_TRUSTED_ORIGINS = [\n 'http://example.com',\n 'https://example.com',\n 'http://www.example.com',\n 'https://www.example.com',\n]\n```\n\n**Note**: Replace `example.com` with your actual domain, including the protocol (http/https).\n\nReference code: https://github.com/liangliangyy/DjangoBlog/blob/master/djangoblog/settings.py#L41\n\n#### Django 5.2 Notes\n\nThis project currently uses Django 5.2.9, which has been thoroughly tested and runs stably. If upgrading from an older version, please note:\n- Ensure Python version >= 3.10\n- Run database migrations: `python manage.py migrate`\n- Update dependencies: `pip install -r requirements.txt`\n\n## Frontend Development Configuration\n\n### Tech Stack\n\n- **Alpine.js 3.13**: Lightweight reactive framework\n- **Tailwind CSS 3.4**: Utility-first CSS framework\n- **HTMX 2.0**: HTML-over-the-wire architecture\n- **Vite 5.4**: Modern build tool\n\n### Development Mode\n\nWhen developing frontend code, you can use Vite's hot reload feature:\n\n```bash\ncd frontend\nnpm run dev\n```\n\nThis will start the Vite development server (default port 5173), and frontend code changes will be automatically rebuilt and refreshed in the browser.\n\n### Production Build\n\n```bash\ncd frontend\nnpm run build\n```\n\nBuild outputs will be generated to `blog/static/blog/dist/` directory, including:\n- CSS files (compiled with Tailwind JIT and compressed)\n- JavaScript files (code-split and minified)\n- Vite manifest file (for asset mapping)\n\n### Dark Mode\n\nThe project has built-in dark mode support:\n\n- **Auto-switching**: Follows system theme preferences automatically\n- **Persistence**: User choice is saved to localStorage\n- **No Flash**: Seamless theme loading without white screen flash\n- **Keyboard Shortcut**: `Ctrl+Shift+D` / `Cmd+Shift+D` for quick toggling\n\nUsers can manually toggle the theme using the button in the top-right corner of the page.\n\n### Color Schemes\n\nSupports 8 color themes, configurable in `djangoblog/settings.py`:\n\n```python\n# Set in template context\nCOLOR_SCHEME = 'purple' # purple, blue, green, orange, pink, red, indigo, teal\n```\n\nColor schemes are implemented through CSS variables system and do not require rebuilding frontend assets after changes.\n\n"
},
{
"path": "docs/config.md",
"content": "# 主要功能配置介绍\n\n## 缓存配置\n\n缓存默认使用 `localmem`（本地内存缓存）。如果你有 Redis 环境，可以通过设置 `DJANGO_REDIS_URL` 环境变量来自动切换到 Redis 缓存。\n\n### 使用 Redis 缓存\n\n设置环境变量：\n```bash\nexport DJANGO_REDIS_URL=\"127.0.0.1:6379/0\"\n```\n\n或者在 `settings.py` 中直接修改缓存配置：\n```python\nCACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.redis.RedisCache',\n 'LOCATION': 'redis://127.0.0.1:6379/0',\n }\n}\n```\n\n参考代码：https://github.com/liangliangyy/DjangoBlog/blob/master/djangoblog/settings.py#L201-L215\n\n\n## oauth登录:\n\n现在已经支持QQ，微博，Google，GitHub，Facebook登录，需要在其对应的开放平台申请oauth登录权限，然后在 \n**后台->Oauth** 配置中新增配置，填写对应的`appkey`和`appsecret`以及回调地址。 \n### 回调地址示例：\nqq：http://你的域名/oauth/authorize?type=qq \n微博：http://你的域名/oauth/authorize?type=weibo \ntype对应在`oauthmanager`中的type字段。\n\n## owntracks：\nowntracks是一个位置追踪软件，可以定时的将你的坐标提交到你的服务器上，现在简单的支持owntracks功能，需要安装owntracks的app，然后将api地址设置为:\n`你的域名/owntracks/logtracks`就可以了。然后访问`你的域名/owntracks/show_dates`就可以看到有经纬度记录的日期，点击之后就可以看到运动轨迹了。地图是使用高德地图绘制。\n\n## 邮件功能：\n同样，将`settings.py`中的`ADMINS = [('liangliang', 'liangliangyy@gmail.com')]`配置为你自己的错误接收邮箱，另外修改:\n```python\nEMAIL_HOST = 'smtp.zoho.com'\nEMAIL_PORT = 587\nEMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER')\nEMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD')\nDEFAULT_FROM_EMAIL = EMAIL_HOST_USER\nSERVER_EMAIL = os.environ.get('DJANGO_EMAIL_USER')\n```\n为你自己的邮箱配置。\n\n## 微信公众号\n集成了简单的微信公众号功能，在微信后台将token地址设置为:`你的域名/robot` 即可，默认token为`lylinux`，当然你可以修改为你自己的，在`servermanager/robot.py`中。\n然后在**后台->Servermanager->命令**中新增命令，这样就可以使用微信公众号来管理了。 \n## 网站配置介绍 \n在**后台->BLOG->网站配置**中,可以新增网站配置，比如关键字，描述等，以及谷歌广告，网站统计代码及备案号等等。 \n其中的*静态文件保存地址*是保存oauth用户登录的头像路径，填写绝对路径，默认是代码目录。\n## 代码高亮\n如果你发现你文章的代码没有高亮，请这样书写代码块: \n\n \n\n\n也就是说，需要在代码块开始位置加入这段代码对应的语言。\n\n## update\n如果你发现执行数据库迁移的时候出现如下报错：\n```python\ndjango.db.migrations.exceptions.MigrationSchemaMissing: Unable to create the django_migrations table ((1064, \"You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '(6) NOT NULL)' at line 1\"))\n```\n可能是因为你的mysql版本低于5.6，需要升级mysql版本>=5.6即可。\n\n\n## Django 版本配置说明\n\n### Django 4.0+ CSRF 配置\n\nDjango 4.0 及以上版本需要配置 `CSRF_TRUSTED_ORIGINS`，否则可能会在登录时报 CSRF 错误。\n\n在 `settings.py` 中配置您的域名：\n```python\nCSRF_TRUSTED_ORIGINS = [\n 'http://example.com',\n 'https://example.com',\n 'http://www.example.com',\n 'https://www.example.com',\n]\n```\n\n**注意**：请将 `example.com` 替换为您的实际域名，包括协议（http/https）。\n\n参考代码：https://github.com/liangliangyy/DjangoBlog/blob/master/djangoblog/settings.py#L41\n\n### Django 5.2 说明\n\n本项目目前使用 Django 5.2.9，已经过充分测试，运行稳定。如果从旧版本升级，请注意：\n- 确保 Python 版本 >= 3.10\n- 运行数据库迁移：`python manage.py migrate`\n- 更新依赖：`pip install -r requirements.txt`\n\n## 前端开发配置\n\n### 技术栈\n\n- **Alpine.js 3.13**: 轻量级响应式框架\n- **Tailwind CSS 3.4**: 实用优先的 CSS 框架\n- **HTMX 2.0**: HTML-over-the-wire 架构\n- **Vite 5.4**: 现代化构建工具\n\n### 开发模式\n\n在开发前端代码时，可以使用 Vite 的热更新功能：\n\n```bash\ncd frontend\nnpm run dev\n```\n\n这将启动 Vite 开发服务器（默认端口 5173），修改前端代码后会自动重新构建和刷新浏览器。\n\n### 生产构建\n\n```bash\ncd frontend\nnpm run build\n```\n\n构建产物将输出到 `blog/static/blog/dist/` 目录，包括：\n- CSS 文件（经过 Tailwind JIT 编译和压缩）\n- JavaScript 文件（经过代码分割和压缩）\n- Vite manifest 文件（用于资源映射）\n\n### 深色模式\n\n项目内置深色模式功能：\n\n- **自动切换**: 支持跟随系统主题自动切换\n- **持久化**: 用户选择会保存到 localStorage\n- **防闪烁**: 页面加载时无白屏闪烁\n- **快捷键**: 支持 `Ctrl+Shift+D` / `Cmd+Shift+D` 快速切换\n\n用户可以通过页面右上角的按钮手动切换主题。\n\n### 配色方案\n\n支持 8 种配色主题，可在 `djangoblog/settings.py` 中配置：\n\n```python\n# 在模板中设置\nCOLOR_SCHEME = 'purple' # purple, blue, green, orange, pink, red, indigo, teal\n```\n\n配色方案通过 CSS 变量系统实现，修改后无需重新构建前端资源。\n\n"
},
{
"path": "docs/docker-en.md",
"content": "# Deploying DjangoBlog with Docker\n\n\n\n\n\nThis project fully supports containerized deployment using Docker, providing you with a fast, consistent, and isolated runtime environment. We recommend using `docker-compose` to launch the entire blog service stack with a single command.\n\n## 1. Prerequisites\n\nBefore you begin, please ensure you have the following software installed on your system:\n- [Docker Engine](https://docs.docker.com/engine/install/)\n- [Docker Compose](https://docs.docker.com/compose/install/) (Included with Docker Desktop for Mac and Windows)\n\n## 2. Recommended Method: Using `docker-compose` (One-Click Deployment)\n\nThis is the simplest and most recommended way to deploy. It automatically creates and manages the Django application, a MySQL database, and an optional Elasticsearch service for you.\n\n### Step 1: Start the Basic Services\n\nFrom the project's root directory, run the following command:\n\n```bash\n# Build and start the containers in detached mode (includes Django app and MySQL)\ndocker-compose up -d --build\n```\n\n`docker-compose` will read the `docker-compose.yml` file, pull the necessary images, build the project image, and start all services.\n\n- **Access Your Blog**: Once the services are up, you can access the blog by navigating to `http://127.0.0.1` in your browser.\n- **Data Persistence**: MySQL data files will be stored in the `data/mysql` directory within the project root, ensuring that your data persists across container restarts.\n\n### Step 2: (Optional) Enable Elasticsearch for Full-Text Search\n\nIf you want to use Elasticsearch for more powerful full-text search capabilities, you can include the `docker-compose.es.yml` configuration file:\n\n```bash\n# Build and start all services in detached mode (Django, MySQL, Elasticsearch)\ndocker-compose -f docker-compose.yml -f deploy/docker-compose/docker-compose.es.yml up -d --build\n```\n- **Data Persistence**: Elasticsearch data will be stored in the `data/elasticsearch` directory.\n\n### Step 3: First-Time Initialization\n\nAfter the containers start for the first time, you'll need to execute some initialization commands inside the application container.\n\n```bash\n# Get a shell inside the djangoblog application container (named 'web')\ndocker-compose exec web bash\n\n# Inside the container, run the following commands:\n# Create a superuser account (follow the prompts to set username, email, and password)\npython manage.py createsuperuser\n\n# (Optional) Create some test data\npython manage.py create_testdata\n\n# (Optional, if ES is enabled) Create the search index\npython manage.py rebuild_index\n\n# Exit the container\nexit\n```\n\n## 3. Alternative Method: Using the Standalone Docker Image\n\nIf you already have an external MySQL database running, you can run the DjangoBlog application image by itself.\n\n```bash\n# Pull the latest image from Docker Hub\ndocker pull liangliangyy/djangoblog:latest\n\n# Run the container and connect it to your external database\ndocker run -d \\\n -p 8000:8000 \\\n -e DJANGO_SECRET_KEY='your-strong-secret-key' \\\n -e DJANGO_MYSQL_HOST='your-mysql-host' \\\n -e DJANGO_MYSQL_USER='your-mysql-user' \\\n -e DJANGO_MYSQL_PASSWORD='your-mysql-password' \\\n -e DJANGO_MYSQL_DATABASE='djangoblog' \\\n --name djangoblog \\\n liangliangyy/djangoblog:latest\n```\n\n- **Access Your Blog**: After startup, visit `http://127.0.0.1:8000`.\n- **Create Superuser**: `docker exec -it djangoblog python manage.py createsuperuser`\n\n## 4. Configuration (Environment Variables)\n\nMost of the project's configuration is managed through environment variables. You can modify them in the `docker-compose.yml` file or pass them using the `-e` flag with the `docker run` command.\n\n| Environment Variable | Default/Example Value | Notes |\n|---------------------------|--------------------------------------------------------------------------|---------------------------------------------------------------------|\n| `DJANGO_SECRET_KEY` | `your-strong-secret-key` | **Must be changed to a random, complex string!** |\n| `DJANGO_DEBUG` | `False` | Toggles Django's debug mode. |\n| `DJANGO_MYSQL_HOST` | `mysql` | Database hostname. |\n| `DJANGO_MYSQL_PORT` | `3306` | Database port. |\n| `DJANGO_MYSQL_DATABASE` | `djangoblog` | Database name. |\n| `DJANGO_MYSQL_USER` | `root` | Database username. |\n| `DJANGO_MYSQL_PASSWORD` | `djangoblog_123` | Database password. |\n| `DJANGO_REDIS_URL` | `redis:6379/0` | Redis connection URL (for caching). |\n| `DJANGO_ELASTICSEARCH_HOST`| `elasticsearch:9200` | Elasticsearch host address. |\n| `DJANGO_EMAIL_HOST` | `smtp.example.org` | Email server address. |\n| `DJANGO_EMAIL_PORT` | `465` | Email server port. |\n| `DJANGO_EMAIL_USER` | `user@example.org` | Email account username. |\n| `DJANGO_EMAIL_PASSWORD` | `your-email-password` | Email account password. |\n| `DJANGO_EMAIL_USE_SSL` | `True` | Whether to use SSL. |\n| `DJANGO_EMAIL_USE_TLS` | `False` | Whether to use TLS. |\n| `DJANGO_ADMIN_EMAIL` | `admin@example.org` | Admin email for receiving error reports. |\n| `DJANGO_BAIDU_NOTIFY_URL` | `http://data.zz.baidu.com/...` | Push API from [Baidu Webmaster Tools](https://ziyuan.baidu.com/linksubmit/index). |\n\n---\n\nAfter deployment, please review and adjust these environment variables according to your needs, especially `DJANGO_SECRET_KEY` and the database and email settings. "
},
{
"path": "docs/docker.md",
"content": "# 使用 Docker 部署 DjangoBlog\n\n\n\n\n\n本项目全面支持使用 Docker 进行容器化部署，为您提供了快速、一致且隔离的运行环境。我们推荐使用 `docker-compose` 来一键启动整个博客服务栈。\n\n## 1. 环境准备\n\n在开始之前，请确保您的系统中已经安装了以下软件：\n- [Docker Engine](https://docs.docker.com/engine/install/)\n- [Docker Compose](https://docs.docker.com/compose/install/) (对于 Docker Desktop 用户，它已内置)\n\n## 2. 推荐方式：使用 `docker-compose` (一键部署)\n\n这是最简单、最推荐的部署方式。它会自动为您创建并管理 Django 应用、MySQL 数据库，以及可选的 Elasticsearch 服务。\n\n### 步骤 1: 启动基础服务\n\n在项目根目录下，执行以下命令：\n\n```bash\n# 构建并以后台模式启动容器 (包含 Django 应用和 MySQL)\ndocker-compose up -d --build\n```\n\n`docker-compose` 会读取 `docker-compose.yml` 文件，自动拉取所需镜像、构建项目镜像，并启动所有服务。\n\n- **访问您的博客**: 服务启动后，在浏览器中访问 `http://127.0.0.1` 即可看到博客首页。\n- **数据持久化**: MySQL 的数据文件将存储在项目根目录下的 `data/mysql` 文件夹中，确保数据在容器重启后不丢失。\n\n### 步骤 2: (可选) 启用 Elasticsearch 全文搜索\n\n如果您希望使用 Elasticsearch 提供更强大的全文搜索功能，可以额外加载 `docker-compose.es.yml` 配置文件：\n\n```bash\n# 构建并以后台模式启动所有服务 (Django, MySQL, Elasticsearch)\ndocker-compose -f docker-compose.yml -f deploy/docker-compose/docker-compose.es.yml up -d --build\n```\n- **数据持久化**: Elasticsearch 的数据将存储在 `data/elasticsearch` 文件夹中。\n\n### 步骤 3: 首次运行的初始化操作\n\n当容器首次启动后，您需要进入容器来执行一些初始化命令。\n\n```bash\n# 进入 djangoblog 应用容器\ndocker-compose exec web bash\n\n# 在容器内执行以下命令:\n# 创建超级管理员账户 (请按照提示设置用户名、邮箱和密码)\npython manage.py createsuperuser\n\n# (可选) 创建一些测试数据\npython manage.py create_testdata\n\n# (可选，如果启用了 ES) 创建索引\npython manage.py rebuild_index\n\n# 退出容器\nexit\n```\n\n## 3. 备选方式：使用独立的 Docker 镜像\n\n如果您已经拥有一个正在运行的外部 MySQL 数据库，您也可以只运行 DjangoBlog 的应用镜像。\n\n```bash\n# 从 Docker Hub 拉取最新镜像\ndocker pull liangliangyy/djangoblog:latest\n\n# 运行容器，并链接到您的外部数据库\ndocker run -d \\\n -p 8000:8000 \\\n -e DJANGO_SECRET_KEY='your-strong-secret-key' \\\n -e DJANGO_MYSQL_HOST='your-mysql-host' \\\n -e DJANGO_MYSQL_USER='your-mysql-user' \\\n -e DJANGO_MYSQL_PASSWORD='your-mysql-password' \\\n -e DJANGO_MYSQL_DATABASE='djangoblog' \\\n --name djangoblog \\\n liangliangyy/djangoblog:latest\n```\n\n- **访问您的博客**: 启动完成后，访问 `http://127.0.0.1:8000`。\n- **创建管理员**: `docker exec -it djangoblog python manage.py createsuperuser`\n\n## 4. 配置说明 (环境变量)\n\n本项目的大部分配置都通过环境变量来管理。您可以在 `docker-compose.yml` 文件中修改它们，或者在使用 `docker run` 命令时通过 `-e` 参数传入。\n\n| 环境变量名称 | 默认值/示例 | 备注 |\n|-------------------------|--------------------------------------------------------------------------|---------------------------------------------------------------------|\n| `DJANGO_SECRET_KEY` | `your-strong-secret-key` | **请务必修改为一个随机且复杂的字符串！** |\n| `DJANGO_DEBUG` | `False` | 是否开启 Django 的调试模式 |\n| `DJANGO_MYSQL_HOST` | `mysql` | 数据库主机名 |\n| `DJANGO_MYSQL_PORT` | `3306` | 数据库端口 |\n| `DJANGO_MYSQL_DATABASE` | `djangoblog` | 数据库名称 |\n| `DJANGO_MYSQL_USER` | `root` | 数据库用户名 |\n| `DJANGO_MYSQL_PASSWORD` | `djangoblog_123` | 数据库密码 |\n| `DJANGO_REDIS_URL` | `redis:6379/0` | Redis 连接地址 (用于缓存) |\n| `DJANGO_ELASTICSEARCH_HOST` | `elasticsearch:9200` | Elasticsearch 主机地址 |\n| `DJANGO_EMAIL_HOST` | `smtp.example.org` | 邮件服务器地址 |\n| `DJANGO_EMAIL_PORT` | `465` | 邮件服务器端口 |\n| `DJANGO_EMAIL_USER` | `user@example.org` | 邮件账户 |\n| `DJANGO_EMAIL_PASSWORD` | `your-email-password` | 邮件密码 |\n| `DJANGO_EMAIL_USE_SSL` | `True` | 是否使用 SSL |\n| `DJANGO_EMAIL_USE_TLS` | `False` | 是否使用 TLS |\n| `DJANGO_ADMIN_EMAIL` | `admin@example.org` | 接收异常报告的管理员邮箱 |\n| `DJANGO_BAIDU_NOTIFY_URL` | `http://data.zz.baidu.com/...` | [百度站长平台](https://ziyuan.baidu.com/linksubmit/index) 的推送接口 |\n\n---\n\n部署完成后，请务必检查并根据您的实际需求调整这些环境变量，特别是 `DJANGO_SECRET_KEY` 和数据库、邮件相关的配置。\n"
},
{
"path": "docs/es.md",
"content": "# 集成Elasticsearch\n如果你已经有了`Elasticsearch`环境，那么可以将搜索从`Whoosh`换成`Elasticsearch`，集成方式也很简单，\n首先需要注意如下几点:\n1. 你的`Elasticsearch`支持`ik`中文分词\n2. 你的`Elasticsearch`版本>=7.3.0\n\n接下来在`settings.py`做如下改动即可：\n- 增加es链接，如下所示：\n```python\nELASTICSEARCH_DSL = {\n 'default': {\n 'hosts': '127.0.0.1:9200'\n },\n}\n```\n- 修改`HAYSTACK`配置：\n```python\nHAYSTACK_CONNECTIONS = {\n 'default': {\n 'ENGINE': 'djangoblog.elasticsearch_backend.ElasticSearchEngine',\n },\n}\n```\n然后终端执行:\n```shell script\n./manage.py build_index\n```\n这将会在你的es中创建两个索引，分别是`blog`和`performance`，其中`blog`索引就是搜索所使用的，而`performance`会记录每个请求的响应时间，以供将来优化使用。"
},
{
"path": "docs/k8s-en.md",
"content": "# Deploying DjangoBlog with Kubernetes\n\nThis document guides you through deploying the DjangoBlog application on a Kubernetes (K8s) cluster. We provide a complete set of `.yaml` configuration files in the `deploy/k8s` directory to deploy a full service stack, including the DjangoBlog application, Nginx, MySQL, Redis, and Elasticsearch.\n\n## Architecture Overview\n\nThis deployment utilizes a microservices-based, cloud-native architecture:\n\n- **Core Components**: Each core service (DjangoBlog, Nginx, MySQL, Redis, Elasticsearch) runs as a separate `Deployment`.\n- **Configuration Management**: Nginx configurations and Django application environment variables are managed via `ConfigMap`. **Note: For sensitive information like passwords, using `Secret` is highly recommended.**\n- **Service Discovery**: All services are exposed internally within the cluster as `ClusterIP` type `Service`, enabling communication via service names.\n- **External Access**: An `Ingress` resource is used to route external HTTP traffic to the Nginx service, which acts as the single entry point for the entire blog application.\n- **Data Persistence**: A `local-storage` solution based on node-local paths is used. This requires you to manually create storage directories on a specific K8s node and statically bind them using `PersistentVolume` (PV) and `PersistentVolumeClaim` (PVC).\n\n## 1. Prerequisites\n\nBefore you begin, please ensure you have the following:\n\n- A running Kubernetes cluster.\n- The `kubectl` command-line tool configured to connect to your cluster.\n- An [Nginx Ingress Controller](https://kubernetes.github.io/ingress-nginx/deploy/) installed and configured in your cluster.\n- Filesystem access to one of the nodes in your cluster (defaulted to `master` in the configs) to create local storage directories.\n\n## 2. Deployment Steps\n\n### Step 1: Create a Namespace\n\nWe recommend deploying all DjangoBlog-related resources in a dedicated namespace for better management.\n\n```bash\n# Create a namespace named 'djangoblog'\nkubectl create namespace djangoblog\n```\n\n### Step 2: Configure Persistent Storage\n\nThis setup uses Local Persistent Volumes. You need to create the data storage directories on a node within your cluster (the default is the `master` node in `pv.yaml`).\n\n```bash\n# Log in to your master node\nssh user@master-node\n\n# Create the required storage directories\nsudo mkdir -p /mnt/local-storage-db\nsudo mkdir -p /mnt/local-storage-djangoblog\nsudo mkdir -p /mnt/resource/\nsudo mkdir -p /mnt/local-storage-elasticsearch\n\n# Log out from the node\nexit\n```\n**Note**: If you wish to store data on a different node or use different paths, you must modify the `nodeAffinity` and `local.path` settings in the `deploy/k8s/pv.yaml` file.\n\nAfter creating the directories, apply the storage-related configurations:\n\n```bash\n# Apply the StorageClass\nkubectl apply -f deploy/k8s/storageclass.yaml\n\n# Apply the PersistentVolumes (PVs)\nkubectl apply -f deploy/k8s/pv.yaml\n\n# Apply the PersistentVolumeClaims (PVCs)\nkubectl apply -f deploy/k8s/pvc.yaml\n```\n\n### Step 3: Configure the Application\n\nBefore deploying the application, you need to edit the `deploy/k8s/configmap.yaml` file to modify sensitive information and custom settings.\n\n**It is strongly recommended to change the following fields:**\n- `DJANGO_SECRET_KEY`: Change to a random, complex string.\n- `DJANGO_MYSQL_PASSWORD` and `MYSQL_ROOT_PASSWORD`: Change to your own secure database password.\n\n```bash\n# Edit the ConfigMap file\nvim deploy/k8s/configmap.yaml\n\n# Apply the configuration\nkubectl apply -f deploy/k8s/configmap.yaml\n```\n\n### Step 4: Deploy the Application Stack\n\nNow, we can deploy all the core services.\n\n```bash\n# Deploy the Deployments (DjangoBlog, MySQL, Redis, Nginx, ES)\nkubectl apply -f deploy/k8s/deployment.yaml\n\n# Deploy the Services (to create internal endpoints for the Deployments)\nkubectl apply -f deploy/k8s/service.yaml\n```\n\nThe deployment may take some time. You can run the following command to check if all Pods are running successfully (STATUS should be `Running`):\n\n```bash\nkubectl get pods -n djangoblog -w\n```\n\n### Step 5: Expose the Application Externally\n\nFinally, expose the Nginx service to external traffic by applying the `Ingress` rule.\n\n```bash\n# Apply the Ingress rule\nkubectl apply -f deploy/k8s/gateway.yaml\n```\n\nOnce deployed, you can access your blog via the external IP address of your Ingress Controller. Use the following command to find the address:\n\n```bash\nkubectl get ingress -n djangoblog\n```\n\n### Step 6: First-Time Initialization\n\nSimilar to the Docker deployment, you need to get a shell into the DjangoBlog application Pod to perform database initialization and create a superuser on the first run.\n\n```bash\n# First, get the name of a djangoblog pod\nkubectl get pods -n djangoblog | grep djangoblog\n\n# Exec into one of the Pods (replace [pod-name] with the name from the previous step)\nkubectl exec -it [pod-name] -n djangoblog -- bash\n\n# Inside the Pod, run the following commands:\n# Create a superuser account (follow the prompts)\npython manage.py createsuperuser\n\n# (Optional) Create some test data\npython manage.py create_testdata\n\n# (Optional, if ES is enabled) Create the search index\npython manage.py rebuild_index\n\n# Exit the Pod\nexit\n```\n\nCongratulations! You have successfully deployed DjangoBlog on your Kubernetes cluster. "
},
{
"path": "docs/k8s.md",
"content": "# 使用 Kubernetes 部署 DjangoBlog\n\n本文档将指导您如何在 Kubernetes (K8s) 集群上部署 DjangoBlog 应用。我们提供了一套完整的 `.yaml` 配置文件，位于 `deploy/k8s` 目录下，用于部署一个包含 DjangoBlog 应用、Nginx、MySQL、Redis 和 Elasticsearch 的完整服务栈。\n\n## 架构概览\n\n本次部署采用的是微服务化的云原生架构：\n\n- **核心组件**: 每个核心服务 (DjangoBlog, Nginx, MySQL, Redis, Elasticsearch) 都将作为独立的 `Deployment` 运行。\n- **配置管理**: Nginx 的配置文件和 Django 应用的环境变量通过 `ConfigMap` 进行管理。**注意：敏感信息（如密码）建议使用 `Secret` 进行管理。**\n- **服务发现**: 所有服务都通过 `ClusterIP` 类型的 `Service` 在集群内部暴露，并通过服务名相互通信。\n- **外部访问**: 使用 `Ingress` 资源将外部的 HTTP 流量路由到 Nginx 服务，作为整个博客应用的统一入口。\n- **数据持久化**: 采用基于节点本地路径的 `local-storage` 方案。这需要您在指定的 K8s 节点上手动创建存储目录，并通过 `PersistentVolume` (PV) 和 `PersistentVolumeClaim` (PVC) 进行静态绑定。\n\n## 1. 环境准备\n\n在开始之前，请确保您已具备以下环境：\n\n- 一个正在运行的 Kubernetes 集群。\n- `kubectl` 命令行工具已配置并能够连接到您的集群。\n- 集群中已安装并配置好 [Nginx Ingress Controller](https://kubernetes.github.io/ingress-nginx/deploy/)。\n- 对集群中的一个节点（默认为 `master`）拥有文件系统访问权限，用于创建本地存储目录。\n\n## 2. 部署步骤\n\n### 步骤 1: 创建命名空间\n\n我们建议将 DjangoBlog 相关的所有资源都部署在一个独立的命名空间中，便于管理。\n\n```bash\n# 创建一个名为 djangoblog 的命名空间\nkubectl create namespace djangoblog\n```\n\n### 步骤 2: 配置持久化存储\n\n此方案使用本地持久卷 (Local Persistent Volume)。您需要在集群的一个节点上（在 `pv.yaml` 文件中默认为 `master` 节点）创建用于数据存储的目录。\n\n```bash\n# 登录到您的 master 节点\nssh user@master-node\n\n# 创建所需的存储目录\nsudo mkdir -p /mnt/local-storage-db\nsudo mkdir -p /mnt/local-storage-djangoblog\nsudo mkdir -p /mnt/resource/\nsudo mkdir -p /mnt/local-storage-elasticsearch\n\n# 退出节点\nexit\n```\n**注意**: 如果您希望将数据存储在其他节点或使用不同的路径，请务必修改 `deploy/k8s/pv.yaml` 文件中 `nodeAffinity` 和 `local.path` 的配置。\n\n创建目录后，应用存储相关的配置文件：\n\n```bash\n# 应用 StorageClass\nkubectl apply -f deploy/k8s/storageclass.yaml\n\n# 应用 PersistentVolume (PV)\nkubectl apply -f deploy/k8s/pv.yaml\n\n# 应用 PersistentVolumeClaim (PVC)\nkubectl apply -f deploy/k8s/pvc.yaml\n```\n\n### 步骤 3: 配置应用\n\n在部署应用之前，您需要编辑 `deploy/k8s/configmap.yaml` 文件，修改其中的敏感信息和个性化配置。\n\n**强烈建议修改以下字段：**\n- `DJANGO_SECRET_KEY`: 修改为一个随机且复杂的字符串。\n- `DJANGO_MYSQL_PASSWORD` 和 `MYSQL_ROOT_PASSWORD`: 修改为您自己的数据库密码。\n\n```bash\n# 编辑 ConfigMap 文件\nvim deploy/k8s/configmap.yaml\n\n# 应用配置\nkubectl apply -f deploy/k8s/configmap.yaml\n```\n\n### 步骤 4: 部署应用服务栈\n\n现在，我们可以部署所有的核心服务了。\n\n```bash\n# 部署 Deployments (DjangoBlog, MySQL, Redis, Nginx, ES)\nkubectl apply -f deploy/k8s/deployment.yaml\n\n# 部署 Services (为 Deployments 创建内部访问端点)\nkubectl apply -f deploy/k8s/service.yaml\n```\n\n部署需要一些时间，您可以运行以下命令检查所有 Pod 是否都已成功运行 (STATUS 为 `Running`)：\n\n```bash\nkubectl get pods -n djangoblog -w\n```\n\n### 步骤 5: 暴露应用到外部\n\n最后，通过应用 `Ingress` 规则来将外部流量引导至我们的 Nginx 服务。\n\n```bash\n# 应用 Ingress 规则\nkubectl apply -f deploy/k8s/gateway.yaml\n```\n\n部署完成后，您可以通过 Ingress Controller 的外部 IP 地址来访问您的博客。执行以下命令获取地址：\n\n```bash\nkubectl get ingress -n djangoblog\n```\n\n### 步骤 6: 首次运行的初始化操作\n\n与 Docker 部署类似，首次运行时，您需要进入 DjangoBlog 应用的 Pod 来执行数据库初始化和创建管理员账户。\n\n```bash\n# 首先，获取 djangoblog pod 的名称\nkubectl get pods -n djangoblog | grep djangoblog\n\n# 进入其中一个 Pod (将 [pod-name] 替换为上一步获取到的名称)\nkubectl exec -it [pod-name] -n djangoblog -- bash\n\n# 在 Pod 内部执行以下命令:\n# 创建超级管理员账户 (请按照提示操作)\npython manage.py createsuperuser\n\n# (可选) 创建测试数据\npython manage.py create_testdata\n\n# (可选，如果启用了 ES) 创建索引\npython manage.py rebuild_index\n\n# 退出 Pod\nexit\n```\n\n至此，您已成功在 Kubernetes 集群上完成了 DjangoBlog 的部署！ "
},
{
"path": "docs/search-engine-config.md",
"content": "# 搜索引擎配置说明\n\n## 概述\n\nDjangoBlog 支持两种搜索引擎：\n- **Whoosh** - 纯 Python 实现，开箱即用（默认）\n- **Elasticsearch** - 高性能分布式搜索引擎（推荐生产环境）\n\n配置优先级：**环境变量 > 手动配置 > 默认 Whoosh**\n\n## 快速开始\n\n### 使用 Whoosh（默认）\n\n无需配置，直接使用：\n\n```bash\npython manage.py rebuild_index\npython manage.py runserver\n```\n\n索引存储在 `whoosh_index/` 目录。\n\n### 使用 Elasticsearch（开发环境）\n\n1. **启动 ES 服务：**\n```bash\n# Docker 方式\ndocker run -d -p 9200:9200 -e \"discovery.type=single-node\" elasticsearch:8.6.1\n\n# 或直接运行 ES\n./bin/elasticsearch\n```\n\n2. **编辑 `djangoblog/settings.py`：**\n\n取消以下配置的注释：\n\n```python\nELASTICSEARCH_DSL = {\n 'default': {\n # hosts 必须包含 http:// 或 https://（如果忘记会自动添加http://）\n 'hosts': 'http://127.0.0.1:9200',\n 'verify_certs': False,\n\n # 如果启用了安全特性，添加认证信息\n # 'username': 'elastic',\n # 'password': 'your_password',\n },\n}\n```\n\n**提示**：`hosts` 参数支持以下格式：\n- 单个主机：`'http://127.0.0.1:9200'` 或 `'127.0.0.1:9200'`（自动添加http://）\n- 多个主机：`['http://es1:9200', 'http://es2:9200']`（ES集群）\n\n3. **重建索引：**\n```bash\npython manage.py rebuild_index\n```\n\n### 使用 Elasticsearch（生产环境）\n\n通过环境变量配置，无需修改代码：\n\n```bash\n# 基本配置\nexport DJANGO_ELASTICSEARCH_HOST=https://es.example.com:9200\nexport ELASTICSEARCH_VERIFY_CERTS=True\n\n# 用户名密码认证\nexport ELASTICSEARCH_USERNAME=elastic\nexport ELASTICSEARCH_PASSWORD=your_password\n\n# 启动应用\npython manage.py runserver\n```\n\n## 配置详解\n\n### 开发环境手动配置\n\n编辑 `djangoblog/settings.py`，在搜索引擎配置部分添加：\n\n```python\nELASTICSEARCH_DSL = {\n 'default': {\n 'hosts': 'http://127.0.0.1:9200',\n 'verify_certs': False,\n\n # === 选择一种认证方式 ===\n\n # 方式1: 无认证（开发环境）\n # 不需要额外配置\n\n # 方式2: 用户名密码认证\n 'username': 'elastic',\n 'password': 'changeme',\n\n # 方式3: API Key 认证\n # 'api_key': 'your_api_key',\n\n # 方式4: 证书认证\n # 'ca_certs': '/path/to/ca.crt',\n # 'client_cert': '/path/to/client.crt',\n # 'client_key': '/path/to/client.key',\n },\n}\n```\n\n### 生产环境环境变量\n\n| 环境变量 | 说明 | 必需 | 示例 |\n|---------|------|------|------|\n| `DJANGO_ELASTICSEARCH_HOST` | ES 主机地址 | ✅ | `https://es.example.com:9200` |\n| `ELASTICSEARCH_VERIFY_CERTS` | 验证 SSL 证书 | ❌ | `True` / `False` |\n| `ELASTICSEARCH_USERNAME` | 用户名 | ❌ | `elastic` |\n| `ELASTICSEARCH_PASSWORD` | 密码 | ❌ | `your_password` |\n| `ELASTICSEARCH_API_KEY` | API Key | ❌ | `your_api_key` |\n| `ELASTICSEARCH_CA_CERTS` | CA 证书路径 | ❌ | `/etc/ssl/certs/ca.crt` |\n| `ELASTICSEARCH_CLIENT_CERT` | 客户端证书 | ❌ | `/etc/ssl/certs/client.crt` |\n| `ELASTICSEARCH_CLIENT_KEY` | 客户端私钥 | ❌ | `/etc/ssl/private/client.key` |\n\n### Docker Compose 示例\n\n```yaml\nversion: '3.8'\n\nservices:\n web:\n build: .\n environment:\n - DJANGO_ELASTICSEARCH_HOST=http://elasticsearch:9200\n - ELASTICSEARCH_USERNAME=elastic\n - ELASTICSEARCH_PASSWORD=${ES_PASSWORD}\n depends_on:\n - elasticsearch\n\n elasticsearch:\n image: elasticsearch:8.6.1\n environment:\n - discovery.type=single-node\n - xpack.security.enabled=true\n - ELASTIC_PASSWORD=${ES_PASSWORD}\n ports:\n - \"9200:9200\"\n```\n\n### Kubernetes 示例\n\n```yaml\napiVersion: v1\nkind: ConfigMap\nmetadata:\n name: djangoblog-es-config\ndata:\n DJANGO_ELASTICSEARCH_HOST: \"http://elasticsearch-service:9200\"\n ELASTICSEARCH_VERIFY_CERTS: \"false\"\n\n---\napiVersion: v1\nkind: Secret\nmetadata:\n name: djangoblog-es-secret\ntype: Opaque\nstringData:\n ELASTICSEARCH_USERNAME: elastic\n ELASTICSEARCH_PASSWORD: your_password_here\n\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: djangoblog\nspec:\n template:\n spec:\n containers:\n - name: web\n envFrom:\n - configMapRef:\n name: djangoblog-es-config\n - secretRef:\n name: djangoblog-es-secret\n```\n\n## 切换搜索引擎\n\n### 从 Whoosh 切换到 Elasticsearch\n\n1. 配置 ES（见上文）\n2. 重建索引：\n```bash\npython manage.py rebuild_index\n```\n\n### 从 Elasticsearch 切换回 Whoosh\n\n1. 注释掉 `ELASTICSEARCH_DSL` 配置\n2. 或删除 `DJANGO_ELASTICSEARCH_HOST` 环境变量\n3. 重建索引：\n```bash\npython manage.py rebuild_index\n```\n\n## 维护命令\n\n```bash\n# 重建索引（清空后重建）\npython manage.py rebuild_index\n\n# 更新索引（增量更新）\npython manage.py update_index\n\n# 清空索引\npython manage.py clear_index\n\n# 仅针对 ES：手动构建索引\npython manage.py build_index\n```\n\n## 性能对比\n\n| 特性 | Whoosh | Elasticsearch |\n|------|--------|--------------|\n| 安装难度 | ⭐ 简单 | ⭐⭐⭐ 复杂 |\n| 性能 | 中等（适合小型博客） | 极高（适合大规模） |\n| 中文分词 | ✅ jieba | ✅ ik_analyzer |\n| 分布式 | ❌ | ✅ |\n| 实时性 | 一般 | 近实时 |\n| 资源占用 | 低 | 较高 |\n\n## 故障排查\n\n### 问题：索引不更新\n\n**解决：**\n```bash\n# 检查 Haystack 信号处理器\npython manage.py shell\n>>> from django.conf import settings\n>>> print(settings.HAYSTACK_SIGNAL_PROCESSOR)\n\n# 应该输出：haystack.signals.RealtimeSignalProcessor\n```\n\n### 问题：搜索无结果\n\n**解决：**\n```bash\n# 重建索引\npython manage.py rebuild_index --noinput\n\n# 检查索引文档数量\npython manage.py shell\n>>> from haystack.query import SearchQuerySet\n>>> print(SearchQuerySet().count())\n```\n\n### 问题：ES 连接失败\n\n**解决：**\n1. 确认 ES 正在运行：`curl http://localhost:9200`\n2. 检查防火墙设置\n3. 验证认证信息是否正确\n\n## 更多信息\n\n- [Elasticsearch 配置详解](./elasticsearch-config.md)\n- [Haystack 官方文档](https://django-haystack.readthedocs.io/)\n- [Whoosh 文档](https://whoosh.readthedocs.io/)\n"
},
{
"path": "frontend/.gitignore",
"content": "node_modules/\ndist/\n.DS_Store\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\n.vite/\n"
},
{
"path": "frontend/package.json",
"content": "{\n \"name\": \"djangoblog-frontend\",\n \"version\": \"1.0.0\",\n \"description\": \"Modern frontend for DjangoBlog\",\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"vite build\",\n \"watch\": \"vite build --watch\",\n \"preview\": \"vite preview\"\n },\n \"dependencies\": {\n \"@alpinejs/collapse\": \"^3.15.8\",\n \"@alpinejs/focus\": \"^3.15.8\",\n \"@alpinejs/intersect\": \"^3.15.8\",\n \"alpinejs\": \"^3.15.8\"\n },\n \"devDependencies\": {\n \"@tailwindcss/typography\": \"^0.5.19\",\n \"autoprefixer\": \"^10.4.27\",\n \"cssnano\": \"^7.1.3\",\n \"cssnano-preset-advanced\": \"^7.0.11\",\n \"htmx.org\": \"^2.0.8\",\n \"postcss\": \"^8.5.8\",\n \"tailwindcss\": \"^3.4.1\",\n \"terser\": \"^5.46.0\",\n \"vite\": \"^5.1.0\"\n },\n \"overrides\": {\n \"esbuild\": \">=0.25.0\"\n }\n}\n"
},
{
"path": "frontend/postcss.config.js",
"content": "export default {\n plugins: {\n tailwindcss: {},\n autoprefixer: {},\n // 生产环境 CSS 压缩\n ...(process.env.NODE_ENV === 'production' ? {\n cssnano: {\n preset: ['advanced', {\n // 最激进的优化\n discardComments: { removeAll: true },\n // 规范化显示值\n normalizeDisplayValues: true,\n // 规范化位置\n normalizePositions: true,\n // 规范化重复样式\n normalizeRepeatStyle: true,\n // 规范化字符串\n normalizeString: true,\n // 规范化时间\n normalizeTiming: true,\n // 规范化 Unicode\n normalizeUnicode: true,\n // 规范化 URL\n normalizeUrl: true,\n // 规范化空白\n normalizeWhitespace: true,\n // 合并长手属性\n mergeLonghand: true,\n // 合并规则\n mergeRules: true,\n // 最小化选择器\n minifySelectors: true,\n // 最小化字体值\n minifyFontValues: true,\n // 最小化渐变\n minifyGradients: true,\n // 最小化参数\n minifyParams: true,\n // 转换颜色为最短形式\n colormin: true,\n // 转换字体粗细\n convertValues: true,\n // 丢弃重复项\n discardDuplicates: true,\n // 丢弃空规则\n discardEmpty: true,\n // 丢弃覆盖的声明\n discardOverridden: true,\n // 丢弃未使用的规则\n discardUnused: true,\n // 合并媒体查询\n mergeMedia: true,\n // 减少初始值\n reduceInitial: true,\n // 减少变换\n reduceTransforms: true,\n // SVG 优化\n svgo: {\n encode: true,\n plugins: [\n { removeViewBox: false },\n { cleanupIDs: true }\n ]\n },\n // Z-index 优化 - 启用但排除重要的z-index值\n zindex: {\n // 排除需要保持原值的z-index（fixed元素等）\n exclude: [9999]\n },\n // 排序属性\n cssDeclarationSorter: { order: 'smacss' }\n }]\n }\n } : {})\n },\n};\n"
},
{
"path": "frontend/src/components/backToTop.js",
"content": "/**\n * 回到顶部组件\n * 替代原有的jQuery实现\n */\n\nexport default () => ({\n // ==================== 状态 ====================\n isVisible: false,\n isAnimating: false,\n\n // ==================== 初始化 ====================\n init() {\n // 初始检查滚动位置\n this.checkScroll();\n\n // 监听滚动事件（使用防抖）\n this.handleScroll = this.debounce(this.checkScroll.bind(this), 100);\n window.addEventListener('scroll', this.handleScroll);\n\n console.log('🚀 Back to Top Initialized');\n },\n\n // ==================== 销毁 ====================\n destroy() {\n window.removeEventListener('scroll', this.handleScroll);\n },\n\n // ==================== 检查滚动位置 ====================\n checkScroll() {\n const scrollTop = window.pageYOffset || document.documentElement.scrollTop;\n this.isVisible = scrollTop > 200;\n },\n\n // ==================== 滚动到顶部 ====================\n scrollToTop() {\n if (this.isAnimating) return;\n\n this.isAnimating = true;\n\n // 使用现代API平滑滚动\n window.scrollTo({\n top: 0,\n behavior: 'smooth'\n });\n\n // 添加火箭动画效果\n const rocket = this.$el;\n rocket.classList.add('move');\n\n setTimeout(() => {\n rocket.classList.remove('move');\n this.isAnimating = false;\n }, 800);\n\n console.log('🚀 Scrolling to top');\n },\n\n // ==================== 工具函数 ====================\n debounce(func, wait) {\n let timeout;\n return function executedFunction(...args) {\n const later = () => {\n clearTimeout(timeout);\n func(...args);\n };\n clearTimeout(timeout);\n timeout = setTimeout(later, wait);\n };\n },\n});\n"
},
{
"path": "frontend/src/components/commentSystem.js",
"content": "/**\n * 评论系统组件\n * 使用Alpine.js重构，替代原有的jQuery实现\n */\n\nexport default () => ({\n // ==================== 状态管理 ====================\n comments: [],\n replyingTo: null,\n replyContent: '',\n isLoading: false,\n error: null,\n articleId: null,\n\n // ==================== 初始化 ====================\n init() {\n // 从DOM中获取文章ID\n this.articleId = this.$el.dataset.articleId;\n\n if (this.articleId) {\n this.loadComments();\n }\n\n console.log('💬 Comment System Initialized');\n },\n\n // ==================== 加载评论 ====================\n async loadComments() {\n this.isLoading = true;\n this.error = null;\n\n try {\n // 如果需要通过API加载，取消注释以下代码\n // const response = await fetch(`/api/comments/?article_id=${this.articleId}`);\n // if (!response.ok) throw new Error('Failed to load comments');\n // this.comments = await response.json();\n\n // 目前评论由Django模板渲染，这里只是占位\n console.log('📝 Comments loaded from Django template');\n } catch (err) {\n this.error = err.message;\n console.error('Error loading comments:', err);\n } finally {\n this.isLoading = false;\n }\n },\n\n // ==================== 回复评论 ====================\n startReply(commentId) {\n this.replyingTo = commentId;\n this.replyContent = '';\n\n // 等待DOM更新后聚焦到textarea\n this.$nextTick(() => {\n const textarea = document.querySelector(`#reply-textarea-${commentId}`);\n if (textarea) {\n textarea.focus();\n }\n });\n\n console.log('💬 Replying to comment:', commentId);\n },\n\n cancelReply() {\n this.replyingTo = null;\n this.replyContent = '';\n console.log('❌ Reply cancelled');\n },\n\n // ==================== 提交回复 ====================\n async submitReply(commentId) {\n if (!this.replyContent.trim()) {\n alert('回复内容不能为空');\n return;\n }\n\n // 使用HTMX提交表单，不会导致整页刷新\n const form = document.getElementById('commentform');\n if (!form) {\n console.error('❌ Comment form not found');\n alert('评论表单未找到，请刷新页面重试');\n return;\n }\n\n // 设置父评论ID\n const parentField = document.getElementById('id_parent_comment_id');\n if (parentField) {\n parentField.value = commentId;\n }\n\n // 设置评论内容\n const bodyField = document.querySelector('[name=\"body\"]');\n if (bodyField) {\n bodyField.value = this.replyContent;\n }\n\n // 触发HTMX提交（表单上已有hx-post属性）\n console.log('💬 Submitting reply via HTMX...');\n window.htmx.trigger(form, 'submit');\n },\n\n // ==================== 发布新评论 ====================\n async submitComment() {\n if (!this.replyContent.trim()) {\n alert('评论内容不能为空');\n return;\n }\n\n this.isLoading = true;\n this.error = null;\n\n try {\n const csrfToken = this.getCsrfToken();\n\n const response = await fetch('/api/comments/', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-CSRFToken': csrfToken,\n },\n body: JSON.stringify({\n article_id: this.articleId,\n content: this.replyContent,\n }),\n });\n\n if (!response.ok) {\n throw new Error('提交失败');\n }\n\n const data = await response.json();\n console.log('✅ Comment submitted:', data);\n\n // 重新加载评论列表\n await this.loadComments();\n\n // 清空表单\n this.replyContent = '';\n\n // 提示成功\n this.showNotification('评论成功！');\n } catch (err) {\n this.error = err.message;\n console.error('Error submitting comment:', err);\n alert('提交失败：' + err.message);\n } finally {\n this.isLoading = false;\n }\n },\n\n // ==================== 工具函数 ====================\n getCsrfToken() {\n // 从cookie中获取CSRF token\n const name = 'csrftoken';\n let cookieValue = null;\n if (document.cookie && document.cookie !== '') {\n const cookies = document.cookie.split(';');\n for (let i = 0; i < cookies.length; i++) {\n const cookie = cookies[i].trim();\n if (cookie.substring(0, name.length + 1) === (name + '=')) {\n cookieValue = decodeURIComponent(cookie.substring(name.length + 1));\n break;\n }\n }\n }\n return cookieValue;\n },\n\n showNotification(message) {\n // 简单的通知实现，可以后续优化\n const notification = document.createElement('div');\n notification.className = 'fixed top-4 right-4 bg-green-500 text-white px-6 py-3 rounded-lg shadow-lg z-50 animate-fade-in';\n notification.textContent = message;\n document.body.appendChild(notification);\n\n setTimeout(() => {\n notification.classList.add('opacity-0', 'transition-opacity', 'duration-300');\n setTimeout(() => notification.remove(), 300);\n }, 3000);\n },\n\n // ==================== 判断方法 ====================\n isReplying(commentId) {\n return this.replyingTo === commentId;\n },\n\n canReply() {\n return !this.isLoading;\n },\n});\n"
},
{
"path": "frontend/src/components/imageLightbox.js",
"content": "/**\n * 图片灯箱组件\n * 点击文章内容中的图片可以查看大图\n */\nexport default function imageLightbox() {\n return {\n showLightbox: false,\n currentImage: '',\n currentAlt: '',\n\n init() {\n // 为所有文章内容中的图片添加点击事件\n this.$nextTick(() => {\n const images = document.querySelectorAll('.entry-content img');\n images.forEach(img => {\n // 排除badge图片和小图片（不需要查看大图）\n const isBadge = img.src.includes('badge.svg') ||\n img.src.includes('shields.io') ||\n img.src.includes('/badge/') ||\n img.alt.toLowerCase().includes('badge');\n\n // 排除小于200px的图片\n const isSmallImage = img.naturalWidth < 200 || img.naturalHeight < 200;\n\n if (!isBadge && !isSmallImage) {\n img.addEventListener('click', (e) => {\n e.preventDefault();\n this.openLightbox(img.src, img.alt || '');\n });\n }\n });\n });\n },\n\n openLightbox(src, alt) {\n this.currentImage = src;\n this.currentAlt = alt;\n this.showLightbox = true;\n document.body.style.overflow = 'hidden';\n },\n\n closeLightbox() {\n this.showLightbox = false;\n document.body.style.overflow = '';\n },\n\n handleKeydown(e) {\n if (e.key === 'Escape') {\n this.closeLightbox();\n }\n }\n };\n}\n"
},
{
"path": "frontend/src/components/navigation.js",
"content": "/**\n * 导航栏组件\n * 处理移动端菜单、搜索等交互\n */\n\nexport default () => ({\n // ==================== 状态 ====================\n menuOpen: false,\n windowWidth: window.innerWidth,\n isSearchOpen: false,\n searchQuery: '',\n\n // ==================== 初始化 ====================\n init() {\n console.log('🧭 Navigation Initialized');\n\n // 监听窗口大小变化\n window.addEventListener('resize', () => {\n this.windowWidth = window.innerWidth;\n if (window.innerWidth >= 768 && this.menuOpen) {\n this.menuOpen = false;\n document.body.style.overflow = '';\n }\n });\n\n // 监听HTMX导航事件，自动关闭移动端菜单\n document.body.addEventListener('htmx:beforeRequest', (event) => {\n // 如果是导航链接触发的请求，并且在移动端模式，则关闭菜单\n if (this.windowWidth < 768 && this.menuOpen) {\n console.log('🔗 HTMX navigation detected, closing mobile menu');\n this.closeMobileMenu();\n }\n });\n },\n\n // ==================== 移动端菜单 ====================\n toggleMenu() {\n this.menuOpen = !this.menuOpen;\n\n // 移动端防止背景滚动\n if (this.windowWidth < 768) {\n if (this.menuOpen) {\n document.body.style.overflow = 'hidden';\n } else {\n document.body.style.overflow = '';\n }\n }\n\n console.log('📱 Mobile menu:', this.menuOpen ? 'opened' : 'closed');\n },\n\n closeMobileMenu() {\n this.menuOpen = false;\n document.body.style.overflow = '';\n },\n\n // ==================== 搜索功能 ====================\n toggleSearch() {\n this.isSearchOpen = !this.isSearchOpen;\n\n if (this.isSearchOpen) {\n // 聚焦到搜索框\n this.$nextTick(() => {\n this.$refs.searchInput?.focus();\n });\n }\n\n console.log('🔍 Search:', this.isSearchOpen ? 'opened' : 'closed');\n },\n\n submitSearch() {\n if (this.searchQuery.trim()) {\n window.location.href = `/search/?q=${encodeURIComponent(this.searchQuery)}`;\n }\n },\n\n // ==================== 主题切换（与dark_mode插件配合） ====================\n toggleTheme() {\n const html = document.documentElement;\n const currentTheme = html.getAttribute('data-theme');\n const newTheme = currentTheme === 'dark' ? 'light' : 'dark';\n\n html.setAttribute('data-theme', newTheme);\n localStorage.setItem('theme', newTheme);\n\n console.log('🌓 Theme switched to:', newTheme);\n },\n});\n"
},
{
"path": "frontend/src/components/reactionPicker.js",
"content": "/**\n * Emoji Reaction Picker 组件\n * 为评论添加 GitHub 风格的 emoji 反应功能\n */\n\nexport default (commentId) => {\n return {\n // ==================== 状态管理 ====================\n reactions: {},\n showPicker: false,\n isLoading: false,\n\n // ==================== 初始化 ====================\n init() {\n // 优先从 data 属性读取初始数据（SSR）\n this.loadFromDataAttribute();\n },\n\n // ==================== 从 data 属性加载（SSR 数据）====================\n loadFromDataAttribute() {\n try {\n const dataAttr = this.$el.dataset.reactions;\n if (dataAttr) {\n this.reactions = JSON.parse(dataAttr);\n } else {\n // 如果没有 SSR 数据，降级到 API 加载\n this.loadFromAPI();\n }\n } catch (error) {\n console.error('Error parsing reactions from data attribute:', error);\n // 解析失败，降级到 API 加载\n this.loadFromAPI();\n }\n },\n\n // ==================== 从 API 加载（降级方案）====================\n async loadFromAPI() {\n try {\n this.isLoading = true;\n const response = await fetch(`/comment/${commentId}/react`);\n\n if (!response.ok) {\n throw new Error('Failed to load reactions');\n }\n\n const data = await response.json();\n if (data.success) {\n this.reactions = data.reactions || {};\n }\n } catch (error) {\n console.error('Error loading reactions from API:', error);\n this.reactions = {};\n } finally {\n this.isLoading = false;\n }\n },\n\n // ==================== 格式化用户列表 ====================\n /**\n * 格式化用户列表文本，用于 tooltip 显示\n * @param {Array} users - 用户名数组\n * @param {number} totalCount - 总点赞数\n * @returns {string} 格式化后的文本\n */\n formatUsersText(users, totalCount) {\n if (!users || users.length === 0) {\n return '暂无';\n }\n\n if (users.length === totalCount) {\n // 显示所有用户\n return users.join(', ');\n } else {\n // 显示前几个用户，并标注还有多少人\n const displayUsers = users.slice(0, 5).join(', ');\n const remaining = totalCount - users.length;\n if (remaining > 0) {\n return `${displayUsers} 和其他 ${remaining} 人`;\n }\n return displayUsers;\n }\n },\n\n // ==================== 检查登录状态 ====================\n /**\n * 检查用户是否已登录\n * @returns {boolean}\n */\n isAuthenticated() {\n return document.body.dataset.authenticated === 'true';\n },\n\n // ==================== 显示登录提示 ====================\n showLoginPrompt() {\n const loginUrl = `/login/?next=${encodeURIComponent(window.location.pathname)}`;\n\n // 创建美观的提示框\n const modal = document.createElement('div');\n modal.className = 'fixed inset-0 z-50 flex items-center justify-center p-4 bg-black bg-opacity-50 animate-fade-in';\n modal.innerHTML = `\n \n
\n
\n 点赞功能需要登录后才能使用，是否前往登录页面？\n
\n
\n \n 取消\n \n \n 前往登录\n \n
\n
\n ${icons[type]}\n \n ${message} \n `;\n\n document.body.appendChild(notification);\n\n setTimeout(() => {\n notification.classList.add('animate-fade-out');\n setTimeout(() => notification.remove(), 300);\n }, 3000);\n },\n\n // ==================== 工具函数 ====================\n /**\n * 从 cookie 中获取 CSRF token\n * @returns {string|null} CSRF token\n */\n getCsrfToken() {\n const name = 'csrftoken';\n let cookieValue = null;\n if (document.cookie && document.cookie !== '') {\n const cookies = document.cookie.split(';');\n for (let i = 0; i < cookies.length; i++) {\n const cookie = cookies[i].trim();\n if (cookie.substring(0, name.length + 1) === (name + '=')) {\n cookieValue = decodeURIComponent(cookie.substring(name.length + 1));\n break;\n }\n }\n }\n return cookieValue;\n },\n };\n};\n"
},
{
"path": "frontend/src/features/darkMode.js",
"content": "/**\n * Dark Mode 核心功能\n * 实现主题切换、持久化存储和系统主题跟随\n */\n\nconst STORAGE_KEY = 'dark-mode-enabled';\nconst THEME_ATTR = 'data-theme';\nconst ENABLE_SYSTEM = true;\n\n/**\n * 获取首选主题\n */\nfunction getPreferredTheme() {\n // 1. 优先使用用户保存的偏好\n const saved = localStorage.getItem(STORAGE_KEY);\n if (saved !== null) {\n return saved === 'dark' ? 'dark' : 'light';\n }\n\n // 2. 如果启用系统偏好跟随，检测系统设置\n if (ENABLE_SYSTEM && window.matchMedia) {\n if (window.matchMedia('(prefers-color-scheme: dark)').matches) {\n return 'dark';\n }\n }\n\n // 3. 默认主题\n return 'light';\n}\n\n/**\n * 应用主题\n */\nfunction applyTheme(theme) {\n if (theme === 'dark') {\n document.documentElement.setAttribute(THEME_ATTR, 'dark');\n document.body.setAttribute(THEME_ATTR, 'dark');\n } else {\n document.documentElement.removeAttribute(THEME_ATTR);\n document.body.removeAttribute(THEME_ATTR);\n }\n}\n\n/**\n * 获取当前主题\n */\nfunction getCurrentTheme() {\n return document.documentElement.getAttribute(THEME_ATTR) || 'light';\n}\n\n/**\n * 设置主题\n */\nfunction setTheme(theme) {\n const validTheme = theme === 'dark' ? 'dark' : 'light';\n\n // 应用主题\n applyTheme(validTheme);\n\n // 保存到localStorage\n localStorage.setItem(STORAGE_KEY, validTheme);\n\n // 触发自定义事件\n const event = new CustomEvent('themeChanged', {\n detail: { theme: validTheme }\n });\n document.dispatchEvent(event);\n\n return validTheme;\n}\n\n/**\n * 切换主题\n */\nfunction toggleTheme() {\n const current = getCurrentTheme();\n const next = current === 'dark' ? 'light' : 'dark';\n return setTheme(next);\n}\n\n/**\n * 初始化（防闪烁）\n * 必须在DOM渲染前执行\n */\nfunction initTheme() {\n const theme = getPreferredTheme();\n applyTheme(theme);\n}\n\n/**\n * 设置键盘快捷键\n */\nfunction setupKeyboardShortcut() {\n document.addEventListener('keydown', function(e) {\n if ((e.ctrlKey || e.metaKey) && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n toggleTheme();\n }\n });\n}\n\n/**\n * 监听系统主题变化\n */\nfunction setupSystemThemeListener() {\n if (!ENABLE_SYSTEM || !window.matchMedia) return;\n\n const darkModeQuery = window.matchMedia('(prefers-color-scheme: dark)');\n\n const listener = function(e) {\n // 只有在用户未手动设置时才跟随系统\n if (localStorage.getItem(STORAGE_KEY) === null) {\n setTheme(e.matches ? 'dark' : 'light');\n }\n };\n\n if (darkModeQuery.addEventListener) {\n darkModeQuery.addEventListener('change', listener);\n } else if (darkModeQuery.addListener) {\n darkModeQuery.addListener(listener);\n }\n}\n\n/**\n * 初始化Dark Mode\n */\nexport function initDarkMode() {\n // 设置全局API\n window.DarkMode = {\n getCurrentTheme,\n setTheme,\n toggle: toggleTheme\n };\n\n // 设置键盘快捷键\n setupKeyboardShortcut();\n\n // 监听系统主题变化\n setupSystemThemeListener();\n\n console.log('🌗 Dark Mode initialized');\n}\n\n// 立即执行防闪烁初始化（在模块加载时）\ninitTheme();\n"
},
{
"path": "frontend/src/main.js",
"content": "/**\n * DjangoBlog 前端主入口文件\n * 使用 Alpine.js + HTMX 实现现代化服务端渲染\n */\n\n// 导入样式文件（Vite开发模式必需）\nimport './styles/main.css';\n\nimport Alpine from 'alpinejs';\nimport focus from '@alpinejs/focus';\nimport intersect from '@alpinejs/intersect';\nimport collapse from '@alpinejs/collapse';\nimport htmx from 'htmx.org';\n\n// 导入Dark Mode（会自动初始化防闪烁）\nimport { initDarkMode } from './features/darkMode.js';\n\n// 注册Alpine插件\nAlpine.plugin(focus);\nAlpine.plugin(intersect);\nAlpine.plugin(collapse);\n\n// 导入组件\nimport commentSystem from './components/commentSystem.js';\nimport backToTop from './components/backToTop.js';\nimport navigation from './components/navigation.js';\nimport imageLightbox from './components/imageLightbox.js';\nimport reactionPicker from './components/reactionPicker.js';\n\n// 注册全局Alpine数据\nAlpine.data('commentSystem', commentSystem);\nAlpine.data('backToTop', backToTop);\nAlpine.data('navigation', navigation);\nAlpine.data('imageLightbox', imageLightbox);\nAlpine.data('reactionPicker', reactionPicker);\n\n// 全局工具函数\nwindow.Alpine = Alpine;\nwindow.htmx = htmx;\n\n// 启动Alpine\nAlpine.start();\n\n// 初始化Dark Mode\ninitDarkMode();\n\n// HTMX 配置\nhtmx.config.defaultSwapStyle = 'innerHTML';\nhtmx.config.defaultSwapDelay = 0;\nhtmx.config.defaultSettleDelay = 20;\n\n// HTMX boost 配置：自动提取 #main 内容\ndocument.body.addEventListener('htmx:beforeSwap', function(evt) {\n // 对于 boost 的请求，确保正确提取内容\n if (evt.detail.boosted && evt.detail.target.id === 'main') {\n console.log('HTMX boost navigation:', evt.detail.pathInfo.requestPath);\n }\n});\n\n// HTMX 加载完成后重新初始化 Alpine 组件\ndocument.body.addEventListener('htmx:afterSwap', function(evt) {\n // Alpine 会自动检测新的 DOM 元素并初始化\n console.log('Content swapped, Alpine auto-initializing new components');\n\n // 滚动到顶部（可选）\n if (evt.detail.boosted) {\n window.scrollTo({ top: 0, behavior: 'smooth' });\n }\n});\n\n// NProgress页面加载进度条（保留原有功能）\nimport NProgress from './utils/nprogress.js';\nNProgress.configure({ showSpinner: false });\n\n// 页面加载时的进度条\nNProgress.start();\nNProgress.set(0.4);\n\nconst interval = setInterval(() => {\n NProgress.inc();\n}, 1000);\n\nwindow.addEventListener('DOMContentLoaded', () => {\n NProgress.done();\n clearInterval(interval);\n});\n\n// 页面导航时的进度条\nwindow.addEventListener('beforeunload', () => {\n NProgress.start();\n});\n\n// HTMX 事件监听 - 配合 NProgress\ndocument.body.addEventListener('htmx:beforeRequest', () => {\n NProgress.start();\n});\n\ndocument.body.addEventListener('htmx:afterRequest', () => {\n NProgress.done();\n});\n\nconsole.log('✨ DjangoBlog Frontend Loaded (Alpine.js + HTMX + Tailwind CSS)');\n"
},
{
"path": "frontend/src/styles/main.css",
"content": "/**\n * DjangoBlog 现代化样式系统\n * 完全基于 Tailwind CSS 重写，移除所有旧的CSS依赖\n *\n * 架构：\n * 1. Tailwind 基础层 - 重置和基础样式\n * 2. 组件层 - 可复用的组件类\n * 3. 工具层 - Tailwind 工具类\n * 4. 插件适配 - 兼容现有插件样式\n *\n * 响应式断点 (Mobile-First策略):\n * - Base (0px): 超小手机基准,所有设备\n * - sm (640px): 大手机/小平板\n * - md (768px): 平板竖屏\n * - lg (1024px): 平板横屏/小桌面 [侧边栏切换点]\n * - xl (1280px): 桌面\n * - 2xl (1536px): 大桌面\n *\n * 关键断点验证: 320px, 375px, 768px, 1024px, 1920px\n */\n\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n\n/* ==================== 主题配色方案 CSS 变量 ==================== */\n:root {\n /* 默认主题：紫色 Purple Dream */\n --color-primary-50: 240 249 255;\n --color-primary-100: 224 242 254;\n --color-primary-200: 186 230 253;\n --color-primary-300: 125 211 252;\n --color-primary-400: 102 126 234;\n --color-primary-500: 102 126 234;\n --color-primary-600: 118 75 162;\n --color-primary-700: 91 33 182;\n --color-primary-800: 76 29 149;\n --color-primary-900: 59 7 100;\n}\n\n/* 紫色主题 - Purple Dream */\n:root[data-color-scheme=\"purple\"],\nbody[data-color-scheme=\"purple\"] {\n --color-primary-50: 250 245 255;\n --color-primary-100: 243 232 255;\n --color-primary-200: 233 213 255;\n --color-primary-300: 216 180 254;\n --color-primary-400: 192 132 252;\n --color-primary-500: 168 85 247;\n --color-primary-600: 147 51 234;\n --color-primary-700: 126 34 206;\n --color-primary-800: 107 33 168;\n --color-primary-900: 88 28 135;\n}\n\n/* 蓝色主题 - Ocean Blue */\n:root[data-color-scheme=\"blue\"],\nbody[data-color-scheme=\"blue\"] {\n --color-primary-50: 239 246 255;\n --color-primary-100: 219 234 254;\n --color-primary-200: 191 219 254;\n --color-primary-300: 147 197 253;\n --color-primary-400: 96 165 250;\n --color-primary-500: 59 130 246;\n --color-primary-600: 37 99 235;\n --color-primary-700: 29 78 216;\n --color-primary-800: 30 64 175;\n --color-primary-900: 30 58 138;\n}\n\n/* 绿色主题 - Forest Green */\n:root[data-color-scheme=\"green\"],\nbody[data-color-scheme=\"green\"] {\n --color-primary-50: 240 253 244;\n --color-primary-100: 220 252 231;\n --color-primary-200: 187 247 208;\n --color-primary-300: 134 239 172;\n --color-primary-400: 74 222 128;\n --color-primary-500: 34 197 94;\n --color-primary-600: 22 163 74;\n --color-primary-700: 21 128 61;\n --color-primary-800: 22 101 52;\n --color-primary-900: 20 83 45;\n}\n\n/* 橙色主题 - Sunset Orange */\n:root[data-color-scheme=\"orange\"],\nbody[data-color-scheme=\"orange\"] {\n --color-primary-50: 255 247 237;\n --color-primary-100: 255 237 213;\n --color-primary-200: 254 215 170;\n --color-primary-300: 253 186 116;\n --color-primary-400: 251 146 60;\n --color-primary-500: 249 115 22;\n --color-primary-600: 234 88 12;\n --color-primary-700: 194 65 12;\n --color-primary-800: 154 52 18;\n --color-primary-900: 124 45 18;\n}\n\n/* 粉色主题 - Cherry Blossom */\n:root[data-color-scheme=\"pink\"],\nbody[data-color-scheme=\"pink\"] {\n --color-primary-50: 253 242 248;\n --color-primary-100: 252 231 243;\n --color-primary-200: 251 207 232;\n --color-primary-300: 249 168 212;\n --color-primary-400: 244 114 182;\n --color-primary-500: 236 72 153;\n --color-primary-600: 219 39 119;\n --color-primary-700: 190 24 93;\n --color-primary-800: 157 23 77;\n --color-primary-900: 131 24 67;\n}\n\n/* 红色主题 - Ruby Red */\n:root[data-color-scheme=\"red\"],\nbody[data-color-scheme=\"red\"] {\n --color-primary-50: 254 242 242;\n --color-primary-100: 254 226 226;\n --color-primary-200: 254 202 202;\n --color-primary-300: 252 165 165;\n --color-primary-400: 248 113 113;\n --color-primary-500: 239 68 68;\n --color-primary-600: 220 38 38;\n --color-primary-700: 185 28 28;\n --color-primary-800: 153 27 27;\n --color-primary-900: 127 29 29;\n}\n\n/* 靛蓝主题 - Midnight Indigo */\n:root[data-color-scheme=\"indigo\"],\nbody[data-color-scheme=\"indigo\"] {\n --color-primary-50: 238 242 255;\n --color-primary-100: 224 231 255;\n --color-primary-200: 199 210 254;\n --color-primary-300: 165 180 252;\n --color-primary-400: 129 140 248;\n --color-primary-500: 99 102 241;\n --color-primary-600: 79 70 229;\n --color-primary-700: 67 56 202;\n --color-primary-800: 55 48 163;\n --color-primary-900: 49 46 129;\n}\n\n/* 青色主题 - Teal Wave */\n:root[data-color-scheme=\"teal\"],\nbody[data-color-scheme=\"teal\"] {\n --color-primary-50: 240 253 250;\n --color-primary-100: 204 251 241;\n --color-primary-200: 153 246 228;\n --color-primary-300: 94 234 212;\n --color-primary-400: 45 212 191;\n --color-primary-500: 20 184 166;\n --color-primary-600: 13 148 136;\n --color-primary-700: 15 118 110;\n --color-primary-800: 17 94 89;\n --color-primary-900: 19 78 74;\n}\n\n/* ==================== 语义化 CSS 变量系统 (对标 Next.js) ==================== */\n:root {\n /* 基础色 - 亮色模式 - 使用OKLCH色彩空间获得更好的感知均匀性 */\n --background: 249 250 251; /* rgb(249 250 251) - 柔和的灰白背景 */\n --foreground: 17 24 39; /* rgb(17 24 39) - 深灰色文本 */\n\n /* 卡片 */\n --card: 255 255 255; /* rgb(255 255 255) - 纯白卡片 */\n --card-foreground: 17 24 39; /* rgb(17 24 39) - 卡片文本色 */\n\n /* Popover浮层 */\n --popover: 255 255 255; /* rgb(255 255 255) */\n --popover-foreground: 17 24 39; /* rgb(17 24 39) */\n\n /* 边框和输入 */\n --border: 229 231 235; /* rgb(229 231 235) - 边框色 */\n --input: 229 231 235; /* rgb(229 231 235) - 输入框边框 */\n --ring: var(--color-primary-500); /* 使用主题色作为聚焦环 */\n\n /* 静音色 */\n --muted: 243 244 246; /* rgb(243 244 246) - 静音背景 */\n --muted-foreground: 107 114 128; /* rgb(107 114 128) - 静音文本 */\n\n /* 主色 - 使用现有的 primary 变量 */\n --primary: var(--color-primary-500);\n --primary-foreground: 255 255 255; /* rgb(255 255 255) - 主色上的白色文本 */\n\n /* 次要色 */\n --secondary: 243 244 246; /* rgb(243 244 246) - 次要背景 */\n --secondary-foreground: 31 41 55; /* rgb(31 41 55) - 次要文本 */\n\n /* 强调色 */\n --accent: var(--color-primary-400);\n --accent-foreground: 255 255 255; /* rgb(255 255 255) - 强调色上的白色文本 */\n\n /* 破坏性操作 */\n --destructive: 239 68 68; /* rgb(239 68 68) - 红色 */\n --destructive-foreground: 255 255 255;\n\n /* 圆角系统 */\n --radius: 0.5rem; /* 8px - 基准圆角 */\n\n /* 阴影系统 - 使用更柔和的阴影 */\n --shadow-card: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);\n --shadow-card-hover: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);\n --shadow-elevated: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);\n}\n\n/* 深色模式变量 */\n.dark,\n[data-theme=\"dark\"] {\n --background: 15 23 42; /* rgb(15 23 42) - Slate-900 深灰背景 */\n --foreground: 226 232 240; /* rgb(226 232 240) - Slate-200 亮灰文本 */\n\n --card: 30 41 59; /* rgb(30 41 59) - Slate-800 深色卡片 */\n --card-foreground: 226 232 240; /* rgb(226 232 240) - 卡片文本 */\n\n --popover: 30 41 59; /* rgb(30 41 59) */\n --popover-foreground: 226 232 240; /* rgb(226 232 240) */\n\n --border: 51 65 85; /* rgb(51 65 85) - Slate-700 深色边框 */\n --input: 51 65 85; /* rgb(51 65 85) - 输入框边框 */\n\n --muted: 51 65 85; /* rgb(51 65 85) - 静音背景 */\n --muted-foreground: 148 163 184; /* rgb(148 163 184) - Slate-400 静音文本 */\n\n --secondary: 51 65 85; /* rgb(51 65 85) - 次要背景 */\n --secondary-foreground: 226 232 240; /* rgb(226 232 240) - 次要文本 */\n\n /* 深色模式阴影 - 使用更深更自然的阴影 */\n --shadow-card: 0 1px 3px 0 rgb(0 0 0 / 0.3), 0 1px 2px -1px rgb(0 0 0 / 0.3);\n --shadow-card-hover: 0 10px 15px -3px rgb(0 0 0 / 0.4), 0 4px 6px -4px rgb(0 0 0 / 0.4);\n --shadow-elevated: 0 20px 25px -5px rgb(0 0 0 / 0.5), 0 8px 10px -6px rgb(0 0 0 / 0.5);\n}\n\n/* ==================== 基础样式层 ==================== */\n@layer base {\n /* Nav header search input — reset global input styles injected by component layer */\n #header-search-input {\n padding: 0 !important;\n border: none !important;\n background: transparent !important;\n box-shadow: none !important;\n }\n\n /* Suppress browser-default search field decorations */\n input[type=\"search\"]::-webkit-search-decoration,\n input[type=\"search\"]::-webkit-search-cancel-button,\n input[type=\"search\"]::-webkit-search-results-button,\n input[type=\"search\"]::-webkit-search-results-decoration {\n -webkit-appearance: none;\n display: none;\n }\n\n /* HTML根元素 */\n html {\n @apply scroll-smooth antialiased;\n }\n\n /* Body基础样式 - 现代化柔和配色 */\n body {\n /* 亮色模式：柔和的灰白背景(#f9fafb)，避免纯白刺眼 */\n @apply bg-gray-50;\n /* 暗色模式：深Slate背景(#0f172a)，比纯黑更现代 */\n @apply dark:bg-slate-900;\n /* 文本色：深灰色而非纯黑，更柔和 */\n @apply text-gray-800;\n /* 暗色模式文本：柔和的灰白色(#e2e8f0) */\n @apply dark:text-slate-100;\n @apply font-sans;\n line-height: 1.75; /* 舒适的阅读行高 */\n font-size: 1rem; /* 16px基准字体 */\n }\n\n /* 链接样式 */\n a {\n @apply text-primary-500 hover:text-primary-600 transition-colors duration-200;\n @apply dark:text-primary-400 dark:hover:text-primary-300;\n }\n\n /* 标题样式 - 清晰的视觉层次，现代化柔和配色 */\n h1, h2, h3, h4, h5, h6 {\n @apply font-bold;\n /* 亮色模式：深灰色(#1f2937)而非纯黑，更柔和现代 */\n @apply text-gray-800;\n /* 暗色模式：亮灰白色(#f1f5f9)，高对比但不刺眼 */\n @apply dark:text-slate-100;\n line-height: 1.25; /* 紧凑的标题行高 */\n }\n\n /* 排版比例 - 明显的层次梯度 */\n h1 {\n font-size: 2.5rem; /* 40px */\n @apply mt-0 mb-6;\n }\n h2 {\n font-size: 2rem; /* 32px */\n @apply mt-12 mb-4;\n }\n h3 {\n font-size: 1.5rem; /* 24px */\n @apply mt-8 mb-4;\n }\n h4 {\n font-size: 1.25rem; /* 20px */\n @apply mt-6 mb-3;\n }\n\n /* 侧边栏标题重置 - 移除默认的 margin */\n aside h3 {\n @apply mt-0 mb-0;\n font-size: 0.875rem; /* 14px - 与模板中的 text-sm 一致 */\n line-height: 1.5;\n }\n h5 {\n font-size: 1.125rem; /* 18px */\n @apply mt-4 mb-2;\n }\n h6 {\n font-size: 1rem; /* 16px */\n @apply mt-4 mb-2;\n }\n\n /* 段落和文本 */\n p {\n @apply mb-4;\n line-height: 1.75; /* 继承body的行高 */\n }\n\n /* 段落间距优化 */\n .prose p,\n .entry-content p {\n @apply mb-6; /* 增加段落间距，提高可读性 */\n }\n\n /* 列表样式 */\n ul, ol {\n @apply mb-4;\n }\n\n /* 图片 */\n img {\n @apply max-w-full h-auto;\n }\n\n /* 代码块 */\n /* 内联代码 */\n code {\n @apply px-1.5 py-0.5 bg-gray-100 rounded text-sm;\n color: #24292e;\n font-family: 'Consolas', 'Monaco', 'Courier New', monospace;\n }\n\n /* 深色模式 - 内联代码 */\n [data-theme=\"dark\"] code,\n [data-theme=\"dark\"] kbd,\n [data-theme=\"dark\"] tt,\n [data-theme=\"dark\"] var {\n background-color: #2d2d2d !important;\n color: #d4d4d4 !important;\n }\n\n /* 代码块容器 */\n pre {\n @apply p-3 md:p-4 rounded-lg overflow-x-auto mb-4;\n @apply text-sm md:text-base;\n background-color: #f9f9f9;\n border: 1px solid #e1e4e8;\n max-width: 100%;\n -webkit-overflow-scrolling: touch;\n }\n\n /* 代码块自定义scrollbar样式 - 细小、半透明 */\n pre::-webkit-scrollbar {\n height: 6px;\n }\n\n pre::-webkit-scrollbar-track {\n background: rgba(0, 0, 0, 0.05);\n border-radius: 3px;\n }\n\n pre::-webkit-scrollbar-thumb {\n background: rgba(0, 0, 0, 0.2);\n border-radius: 3px;\n }\n\n pre::-webkit-scrollbar-thumb:hover {\n background: rgba(0, 0, 0, 0.3);\n }\n\n /* 深色模式的scrollbar */\n [data-theme=\"dark\"] pre::-webkit-scrollbar-track {\n background: rgba(255, 255, 255, 0.05);\n }\n\n [data-theme=\"dark\"] pre::-webkit-scrollbar-thumb {\n background: rgba(255, 255, 255, 0.2);\n }\n\n [data-theme=\"dark\"] pre::-webkit-scrollbar-thumb:hover {\n background: rgba(255, 255, 255, 0.3);\n }\n\n /* 深色模式 - 代码块容器 */\n [data-theme=\"dark\"] pre {\n background-color: #1e1e1e !important;\n color: #d4d4d4 !important;\n border-color: #30363d;\n }\n\n /* 代码块中的code标签 */\n pre code {\n @apply p-0 bg-transparent;\n @apply text-sm md:text-base;\n font-family: 'Consolas', 'Monaco', 'Courier New', monospace;\n color: #24292e;\n border: none;\n display: block;\n }\n\n /* 深色模式 - 代码块中的code */\n [data-theme=\"dark\"] pre code {\n background-color: transparent !important;\n color: #d4d4d4 !important;\n padding: 0;\n border: none;\n }\n\n /* 表格 */\n table {\n @apply w-full mb-4 border-collapse;\n }\n\n th, td {\n @apply border border-gray-300 dark:border-gray-700 px-4 py-2;\n }\n\n th {\n @apply bg-gray-100 dark:bg-gray-800 font-semibold;\n }\n\n /* 引用块 */\n blockquote {\n @apply pl-4 py-2 border-l-4 border-primary-500 italic;\n @apply bg-gray-50 dark:bg-gray-800 mb-4;\n }\n\n /* HR分隔线 */\n hr {\n @apply my-6 border-t border-border/60;\n }\n}\n\n/* ==================== 组件层 - 通用组件 ==================== */\n@layer components {\n /* ========== 按钮组件 ========== */\n .btn {\n @apply inline-flex items-center justify-center;\n @apply px-4 py-2 rounded-md font-medium;\n @apply min-h-[44px] min-w-[44px]; /* 触摸目标最小尺寸 */\n @apply transition-all duration-200;\n @apply focus:outline-none focus:ring-2 focus:ring-offset-2;\n @apply disabled:opacity-50 disabled:cursor-not-allowed;\n }\n\n .btn-primary {\n @apply bg-primary-500 text-white hover:bg-primary-600;\n @apply focus:ring-primary-500;\n @apply shadow-md hover:shadow-lg;\n }\n\n .btn-secondary {\n @apply bg-gray-200 text-gray-900 hover:bg-gray-300;\n @apply dark:bg-gray-700 dark:text-gray-100 dark:hover:bg-gray-600;\n @apply focus:ring-gray-500;\n }\n\n .btn-sm {\n @apply px-3 py-1.5 text-sm;\n }\n\n .btn-lg {\n @apply px-6 py-3 text-lg;\n }\n\n /* ========== 表单组件 ========== */\n .input, .textarea {\n @apply w-full px-3 py-2 border border-gray-300 rounded-md;\n @apply focus:outline-none focus:ring-2 focus:ring-primary-500 focus:border-transparent;\n @apply bg-white dark:bg-gray-800 dark:border-gray-600;\n @apply text-gray-900 dark:text-gray-100;\n @apply transition-all duration-200;\n }\n\n .textarea {\n @apply resize-y min-h-[100px];\n }\n\n .input:disabled, .textarea:disabled {\n @apply bg-gray-100 dark:bg-gray-900 cursor-not-allowed opacity-60;\n }\n\n /* ========== 卡片组件 - 增强视觉层次，现代化配色 ========== */\n .card {\n /* 使用语义化变量 */\n background-color: rgb(var(--card));\n color: rgb(var(--card-foreground));\n border-color: rgb(var(--border));\n @apply rounded-xl p-6;\n @apply border;\n @apply transition-all duration-300;\n /* 增强阴影效果 - 使用变量 */\n box-shadow: var(--shadow-card);\n }\n\n .card:hover {\n /* hover时边框更明显 */\n border-color: rgb(var(--primary) / 0.2);\n box-shadow: var(--shadow-card-hover);\n transform: translateY(-2px);\n }\n\n /* ========== 使用语义化变量的工具类 ========== */\n .bg-background {\n background-color: rgb(var(--background));\n }\n\n .bg-foreground {\n background-color: rgb(var(--foreground));\n }\n\n .bg-card {\n background-color: rgb(var(--card));\n }\n\n .bg-muted {\n background-color: rgb(var(--muted));\n }\n\n .bg-secondary {\n background-color: rgb(var(--secondary));\n }\n\n .bg-accent {\n background-color: rgb(var(--accent));\n }\n\n .text-foreground {\n color: rgb(var(--foreground));\n }\n\n .text-card-foreground {\n color: rgb(var(--card-foreground));\n }\n\n .text-muted-foreground {\n color: rgb(var(--muted-foreground));\n }\n\n .text-secondary-foreground {\n color: rgb(var(--secondary-foreground));\n }\n\n .border-border {\n border-color: rgb(var(--border));\n }\n\n /* ========== 毛玻璃效果类 ========== */\n .backdrop-blur-header {\n @apply backdrop-blur-xl;\n background-color: rgba(255, 255, 255, 0.8);\n border-color: rgba(229, 231, 235, 0.6);\n }\n\n [data-theme=\"dark\"] .backdrop-blur-header {\n background-color: rgba(31, 41, 55, 0.8);\n border-color: rgba(55, 65, 81, 0.6);\n }\n\n /* 毛玻璃效果降级方案 */\n @supports not (backdrop-filter: blur(0)) {\n .backdrop-blur-header {\n background-color: rgb(255, 255, 255);\n }\n\n [data-theme=\"dark\"] .backdrop-blur-header {\n background-color: rgb(31, 41, 55);\n }\n }\n\n /* ========== 阴影工具类 ========== */\n .shadow-card {\n box-shadow: var(--shadow-card);\n }\n\n .shadow-card-hover {\n box-shadow: var(--shadow-card-hover);\n }\n\n .shadow-elevated {\n box-shadow: var(--shadow-elevated);\n }\n\n /* ========== 站点布局 ========== */\n /* 网站容器 */\n .site {\n @apply min-h-screen flex flex-col;\n }\n\n /* 头部 - 毛玻璃效果和渐变背景 */\n .site-header {\n @apply shadow-md;\n @apply sticky top-0 z-40;\n @apply relative;\n /* 毛玻璃效果 */\n @apply backdrop-blur-xl;\n background: linear-gradient(135deg,\n rgba(var(--color-primary-500), 0.08) 0%,\n rgba(var(--color-primary-600), 0.08) 50%,\n rgba(var(--color-primary-400), 0.06) 100%),\n rgba(255, 255, 255, 0.8);\n border-bottom: 1px solid rgba(229, 231, 235, 0.6);\n }\n\n /* 深色模式的渐变 */\n [data-theme=\"dark\"] .site-header {\n background: linear-gradient(135deg,\n rgba(var(--color-primary-500), 0.15) 0%,\n rgba(var(--color-primary-600), 0.15) 50%,\n rgba(var(--color-primary-400), 0.12) 100%),\n rgba(31, 41, 55, 0.8);\n border-bottom-color: rgba(55, 65, 81, 0.6);\n }\n\n /* 毛玻璃效果降级方案 */\n @supports not (backdrop-filter: blur(0)) {\n .site-header {\n background: linear-gradient(135deg,\n rgba(var(--color-primary-500), 0.08) 0%,\n rgba(var(--color-primary-600), 0.08) 50%,\n rgba(var(--color-primary-400), 0.06) 100%),\n rgb(255, 255, 255);\n }\n\n [data-theme=\"dark\"] .site-header {\n background: linear-gradient(135deg,\n rgba(var(--color-primary-500), 0.15) 0%,\n rgba(var(--color-primary-600), 0.15) 50%,\n rgba(var(--color-primary-400), 0.12) 100%),\n rgb(31, 41, 55);\n }\n }\n\n /* 顶部装饰线 - 增加高度和动画 */\n .site-header::before {\n content: '';\n position: absolute;\n top: 0;\n left: 0;\n right: 0;\n height: 4px;\n background: linear-gradient(90deg,\n rgb(var(--color-primary-500)) 0%,\n rgb(var(--color-primary-600)) 25%,\n rgb(var(--color-primary-400)) 50%,\n rgb(var(--color-primary-500)) 75%,\n rgb(var(--color-primary-600)) 100%);\n background-size: 200% 100%;\n animation: gradientShift 8s ease infinite;\n pointer-events: none; /* 装饰元素不应阻止点击 */\n }\n\n @keyframes gradientShift {\n 0%, 100% { background-position: 0% 0%; }\n 50% { background-position: 100% 0%; }\n }\n\n /* Header内容容器 - 增加垂直空间，统一容器宽度 */\n .header-content {\n @apply flex items-center justify-between px-3 md:px-6 py-6 md:py-8;\n /* 从max-w-7xl增加到max-w-screen-2xl，与主内容容器保持一致 */\n @apply max-w-screen-2xl mx-auto;\n @apply gap-4 md:gap-6;\n @apply relative;\n }\n\n /* 装饰性背景元素 */\n .header-content::before {\n content: '';\n position: absolute;\n right: 5%;\n top: 50%;\n transform: translateY(-50%);\n width: 200px;\n height: 200px;\n background: radial-gradient(circle, rgba(102, 126, 234, 0.08) 0%, transparent 70%);\n border-radius: 50%;\n pointer-events: none;\n animation: pulseGlow 4s ease-in-out infinite;\n }\n\n @keyframes pulseGlow {\n 0%, 100% {\n transform: translateY(-50%) scale(1);\n opacity: 0.5;\n }\n 50% {\n transform: translateY(-50%) scale(1.1);\n opacity: 0.8;\n }\n }\n\n .site-header hgroup {\n @apply text-left;\n /* 改为 flex-shrink，只占据内容宽度，不扩展占据整个空间 */\n @apply flex-shrink;\n @apply px-0 py-0;\n @apply bg-transparent;\n @apply min-w-0;\n /* 移除 z-10，不需要提升层级 */\n }\n\n .site-title {\n @apply text-4xl md:text-6xl lg:text-7xl font-bold;\n @apply mb-2;\n /* 移除 truncate，让标题自然换行而不是占据整行 */\n }\n\n .site-title a {\n @apply no-underline;\n /* 改为 inline-flex，只占据文字宽度 */\n @apply inline-flex items-center gap-3;\n @apply transition-all duration-300;\n @apply relative;\n /* 文字渐变效果 - 使用配色方案变量 */\n @apply text-primary-500; /* 降级颜色 */\n background: linear-gradient(135deg,\n rgb(var(--color-primary-500)) 0%,\n rgb(var(--color-primary-600)) 50%,\n rgb(var(--color-primary-400)) 100%);\n background-size: 200% auto;\n -webkit-background-clip: text;\n -webkit-text-fill-color: transparent;\n background-clip: text;\n animation: textShimmer 8s ease-in-out infinite;\n }\n\n /* 浏览器不支持background-clip: text时的降级样式 */\n @supports not (-webkit-background-clip: text) {\n .site-title a {\n @apply text-primary-500;\n background: none;\n }\n }\n\n @keyframes textShimmer {\n 0% { background-position: 0% 50%; }\n 100% { background-position: 200% 50%; }\n }\n\n /* 深色模式下的标题 */\n [data-theme=\"dark\"] .site-title a {\n @apply text-primary-400; /* 降级颜色 */\n background: linear-gradient(135deg,\n rgb(var(--color-primary-400)) 0%,\n rgb(var(--color-primary-300)) 50%,\n rgb(var(--color-primary-500)) 100%);\n background-size: 200% auto;\n -webkit-background-clip: text;\n -webkit-text-fill-color: transparent;\n background-clip: text;\n }\n\n /* 添加标题前的装饰图标 */\n .site-title a::before {\n content: '✦';\n font-size: 0.6em;\n opacity: 0;\n transform: translateX(-10px) rotate(0deg);\n transition: all 0.3s ease;\n @apply text-primary-500;\n }\n\n .site-title a:hover::before {\n opacity: 1;\n transform: translateX(0) rotate(360deg);\n }\n\n /* 添加标题hover下划线效果 */\n .site-title a::after {\n content: '';\n position: absolute;\n bottom: -4px;\n left: 50%;\n transform: translateX(-50%);\n width: 0;\n height: 3px;\n background: linear-gradient(90deg,\n rgb(var(--color-primary-500)),\n rgb(var(--color-primary-600)),\n rgb(var(--color-primary-400)));\n transition: width 0.4s cubic-bezier(0.4, 0, 0.2, 1);\n border-radius: 2px;\n }\n\n .site-title a:hover::after {\n /* 从中心向两边扩展，覆盖文字区域 */\n width: 100%;\n }\n\n .site-description {\n @apply text-gray-600 dark:text-gray-400 text-lg md:text-xl;\n @apply opacity-90;\n @apply font-light italic;\n @apply relative;\n /* 添加微妙的动画 */\n animation: fadeInUp 0.6s ease-out 0.2s both;\n }\n\n @keyframes fadeInUp {\n from {\n opacity: 0;\n transform: translateY(10px);\n }\n to {\n opacity: 0.9;\n transform: translateY(0);\n }\n }\n\n /* 快捷入口图标组 */\n .header-actions {\n @apply flex items-center gap-1.5;\n @apply relative;\n @apply flex-shrink-0;\n }\n\n .header-icon-btn {\n @apply flex items-center justify-center;\n @apply w-12 h-12 md:w-11 md:h-11 rounded-full; /* 移动端48px，符合触摸标准 */\n @apply text-gray-700 dark:text-gray-300;\n @apply bg-white dark:bg-gray-800;\n @apply hover:bg-gradient-to-br hover:from-primary-500 hover:to-primary-600;\n @apply hover:text-white;\n @apply transition-all duration-300;\n @apply shadow-sm hover:shadow-lg hover:scale-110;\n @apply border border-gray-200 dark:border-gray-700;\n @apply hover:border-transparent;\n @apply transform;\n }\n\n .header-icon-btn svg {\n @apply w-5 h-5 md:w-7 md:h-7;\n }\n\n /* 搜索框 - 下拉式（在搜索图标下方） */\n .header-search {\n @apply absolute right-0 z-50;\n @apply bg-white dark:bg-gray-800;\n @apply rounded-lg shadow-xl;\n @apply border border-gray-200 dark:border-gray-700;\n @apply mt-2;\n @apply w-[calc(100vw-2rem)] max-w-80;\n /* 定位在header-actions下方 */\n top: 100%;\n }\n\n .search-form {\n @apply flex items-center gap-2 p-3;\n }\n\n .search-input {\n @apply flex-1 px-4 py-2 rounded-lg;\n @apply border border-gray-300 dark:border-gray-600;\n @apply bg-gray-50 dark:bg-gray-900;\n @apply text-gray-900 dark:text-gray-100;\n @apply text-sm;\n @apply focus:outline-none focus:ring-2 focus:ring-primary-500 focus:border-primary-500;\n @apply placeholder-gray-400 dark:placeholder-gray-500;\n }\n\n .search-submit {\n @apply flex items-center justify-center;\n @apply w-12 h-12 rounded-lg;\n @apply bg-primary-600 text-white;\n @apply hover:bg-primary-700;\n @apply transition-colors duration-200;\n @apply flex-shrink-0;\n @apply border-0;\n @apply cursor-pointer;\n }\n\n .search-submit svg {\n @apply w-7 h-7;\n }\n\n /* 导航菜单 - 毛玻璃效果 */\n .main-navigation {\n @apply sticky top-0 z-50;\n @apply backdrop-blur-xl;\n @apply relative;\n background-color: rgba(var(--background) / 0.8);\n border-bottom: 1px solid rgb(var(--border) / 0.6);\n }\n\n /* 桌面端当前菜单项高亮 */\n .main-navigation .current-menu-item > a,\n .main-navigation .current_page_item > a {\n @apply bg-secondary text-foreground;\n @apply relative;\n }\n\n /* 移动端当前菜单项高亮已在 HTML 内联样式中处理 */\n\n /* 菜单切换按钮（仅移动端显示） */\n .menu-toggle {\n @apply md:hidden flex items-center justify-center;\n @apply w-full px-4 py-2.5 bg-white dark:bg-gray-800;\n @apply border-b border-gray-200 dark:border-gray-700;\n @apply text-gray-700 dark:text-gray-300;\n @apply hover:bg-gray-50 dark:hover:bg-gray-700;\n @apply transition-colors duration-200;\n }\n\n .menu-toggle .screen-reader-text {\n @apply sr-only;\n }\n\n /* 菜单容器 - 降低padding */\n .main-navigation ul {\n @apply flex flex-wrap gap-1.5 px-4 py-2;\n }\n\n /* 移动端：菜单垂直排列 */\n @media (max-width: 767px) {\n .main-navigation ul {\n @apply flex-col gap-0 p-0;\n @apply bg-white dark:bg-gray-800;\n @apply border-t border-gray-200 dark:border-gray-700;\n }\n\n .main-navigation ul.toggled-on {\n @apply block;\n }\n\n .main-navigation li {\n @apply border-b border-gray-200 dark:border-gray-700;\n }\n\n .main-navigation a {\n @apply block w-full px-4 py-3 rounded-none;\n }\n }\n\n .main-navigation li {\n @apply list-none;\n }\n\n /* 导航链接 - 增强样式和动画 */\n .main-navigation a {\n @apply px-3 py-1.5 rounded-lg text-gray-700 dark:text-gray-300;\n @apply hover:bg-gradient-to-r hover:from-primary-500 hover:to-primary-600 hover:text-white;\n @apply transition-all duration-300;\n @apply flex items-center gap-1.5;\n @apply font-medium;\n @apply text-base md:text-lg; /* 移动端16px，桌面端18px */\n @apply shadow-sm hover:shadow-md;\n @apply border border-transparent hover:border-primary-300;\n @apply transform hover:scale-105;\n @apply relative;\n }\n\n .main-navigation a.current-menu-item,\n .main-navigation a.current_page_item {\n @apply bg-gradient-to-r from-primary-500 to-primary-600 text-white;\n @apply shadow-md;\n }\n\n /* 导航图标 */\n .nav-icon {\n @apply w-4 h-4;\n @apply transition-transform duration-200;\n }\n\n .main-navigation a:hover .nav-icon {\n @apply scale-110;\n }\n\n /* 当前菜单项 */\n .main-navigation .current-menu-item a,\n .main-navigation .current_page_item a {\n @apply bg-primary-500 text-white;\n @apply shadow-md;\n }\n\n /* 子菜单样式 */\n .main-navigation .sub-menu {\n @apply absolute left-0 py-2 w-48;\n @apply bg-white shadow-lg rounded-md;\n @apply border border-gray-200;\n @apply hidden;\n z-index: 1000;\n /* 减少顶部间距，让鼠标更容易移过去 */\n margin-top: 0.25rem;\n /* 增加顶部的透明区域，防止鼠标移动时菜单消失 */\n padding-top: 0.75rem;\n }\n\n /* 在父菜单和子菜单之间添加不可见的桥接区域 */\n .main-navigation .sub-menu::before {\n content: '';\n position: absolute;\n top: -0.5rem;\n left: 0;\n right: 0;\n height: 0.5rem;\n background: transparent;\n }\n\n [data-theme=\"dark\"] .main-navigation .sub-menu {\n @apply bg-gray-800 border-gray-700;\n }\n\n .main-navigation .menu-item-has-children {\n @apply relative;\n }\n\n /* 增加hover延迟，让菜单不会立即消失 */\n .main-navigation .menu-item-has-children:hover > .sub-menu,\n .main-navigation .menu-item-has-children:focus-within > .sub-menu {\n @apply block;\n animation: fadeIn 0.15s ease-in;\n }\n\n @keyframes fadeIn {\n from {\n opacity: 0;\n transform: translateY(-8px);\n }\n to {\n opacity: 1;\n transform: translateY(0);\n }\n }\n\n .main-navigation .sub-menu li {\n @apply block w-full;\n }\n\n .main-navigation .sub-menu a {\n @apply block w-full px-4 py-2 rounded-none;\n @apply text-gray-700 hover:bg-primary-500 hover:text-white;\n }\n\n [data-theme=\"dark\"] .main-navigation .sub-menu a {\n @apply text-gray-300;\n }\n\n /* ========== 侧边抽屉导航 ========== */\n /* 遮罩层 */\n .drawer-overlay {\n @apply fixed inset-0 bg-black bg-opacity-50 z-40;\n @apply md:hidden;\n }\n\n /* 汉堡菜单按钮 */\n .hamburger-btn {\n @apply md:hidden flex items-center justify-center;\n @apply w-full px-4 py-2.5 bg-white dark:bg-gray-800;\n @apply border-b border-gray-200 dark:border-gray-700;\n @apply text-gray-700 dark:text-gray-300;\n @apply hover:bg-gray-50 dark:hover:bg-gray-700;\n @apply transition-colors duration-200;\n }\n\n /* 菜单容器 - 桌面端正常显示，移动端为侧边抽屉 */\n .menu-container {\n @apply md:block;\n }\n\n /* 移动端：侧边抽屉模式 */\n @media (max-width: 767px) {\n .menu-container {\n @apply fixed left-0 top-0 bottom-0 w-80 max-w-[85vw];\n @apply bg-white dark:bg-gray-800;\n @apply shadow-2xl z-50;\n @apply transform -translate-x-full;\n @apply transition-transform duration-300 ease-out;\n @apply overflow-y-auto;\n }\n\n .menu-container.drawer-open {\n @apply translate-x-0;\n }\n\n /* 抽屉头部 */\n .drawer-header {\n @apply flex items-center justify-between;\n @apply px-6 py-5 border-b border-gray-200 dark:border-gray-700;\n @apply bg-gradient-to-br from-primary-500 via-primary-600 to-primary-700;\n @apply relative overflow-hidden;\n }\n\n /* 抽屉头部装饰背景 */\n .drawer-header::before {\n content: '';\n position: absolute;\n top: -50%;\n right: -20%;\n width: 200px;\n height: 200px;\n background: radial-gradient(circle, rgba(255, 255, 255, 0.1) 0%, transparent 70%);\n border-radius: 50%;\n }\n\n .drawer-header-content {\n @apply flex items-center gap-3;\n @apply relative z-10;\n }\n\n .drawer-site-icon {\n @apply w-12 h-12 rounded-full;\n @apply bg-white bg-opacity-20;\n @apply flex items-center justify-center;\n @apply text-white;\n @apply backdrop-blur-sm;\n @apply shadow-lg;\n }\n\n .drawer-site-info {\n @apply flex flex-col;\n }\n\n .drawer-title {\n @apply text-lg font-bold text-white;\n @apply m-0 leading-tight;\n }\n\n .drawer-subtitle {\n @apply text-sm text-white text-opacity-90;\n @apply m-0 mt-0.5;\n @apply font-light;\n }\n\n .drawer-close-btn {\n @apply w-10 h-10 rounded-full;\n @apply flex items-center justify-center;\n @apply text-white hover:bg-white hover:bg-opacity-20;\n @apply transition-all duration-200;\n @apply relative z-10;\n @apply hover:rotate-90;\n }\n\n /* 抽屉内的菜单列表 */\n .menu-container ul.nav-menu {\n @apply flex-col gap-0 p-0;\n @apply bg-transparent;\n @apply border-0;\n }\n\n .menu-container li {\n @apply border-b border-gray-200 dark:border-gray-700;\n }\n\n .menu-container li:last-child {\n @apply border-b-0;\n }\n\n .menu-container a {\n @apply block w-full px-4 py-3 rounded-none;\n @apply text-gray-700 dark:text-gray-300;\n @apply hover:bg-primary-50 dark:hover:bg-gray-700;\n @apply border-0 shadow-none;\n @apply transform-none;\n }\n\n /* 移动端当前菜单项高亮样式 - 使用更明显的渐变背景 */\n .menu-container .current-menu-item > a,\n .menu-container .current_page_item > a {\n @apply bg-gradient-to-r from-primary-500 to-primary-600;\n @apply text-white;\n @apply border-l-4 border-primary-700;\n @apply font-semibold;\n }\n\n /* 移动端子菜单样式 - 显示为缩进列表 */\n .menu-container .sub-menu {\n /* 覆盖桌面端的绝对定位 */\n position: static !important;\n @apply block;\n @apply w-full;\n @apply bg-gray-50 dark:bg-gray-900;\n @apply border-l-2 border-primary-300 dark:border-primary-700;\n @apply ml-4;\n @apply mt-0 mb-0;\n @apply shadow-none;\n @apply rounded-none;\n @apply border-0 border-l-2;\n }\n\n .menu-container .sub-menu li {\n @apply border-b border-gray-100 dark:border-gray-800;\n }\n\n .menu-container .sub-menu a {\n @apply pl-6 py-2;\n @apply text-sm;\n @apply text-gray-600 dark:text-gray-400;\n }\n\n .menu-container .sub-menu a:hover {\n @apply bg-primary-100 dark:bg-gray-800;\n @apply text-primary-700 dark:text-primary-300;\n }\n\n /* 子菜单的当前项样式 */\n .menu-container .sub-menu .current-menu-item > a,\n .menu-container .sub-menu .current_page_item > a {\n @apply bg-primary-200 dark:bg-primary-900;\n @apply text-primary-800 dark:text-primary-200;\n @apply border-l-2 border-primary-600;\n @apply font-medium;\n }\n }\n\n /* 主内容区域 */\n .wrapper {\n @apply flex-1 max-w-7xl mx-auto w-full py-8;\n /* 移动端使用更小的padding,桌面端正常padding */\n @apply px-2 sm:px-4 md:px-6 lg:px-8;\n @apply flex flex-col lg:flex-row gap-8;\n }\n\n .site-content {\n @apply flex-1 min-w-0; /* 添加 min-w-0 防止flex子元素溢出 */\n }\n\n /* ========== 侧边栏 - 增强视觉区分 ========== */\n .widget-area {\n /* 使用Grid的4列自适应宽度 (8:4比例) */\n @apply w-full flex-shrink-0 space-y-6;\n }\n\n /* 桌面端侧边栏样式 */\n @media (min-width: 1024px) {\n .widget-area {\n /* 关键：让侧边栏高度跟随内容，不拉伸到整行 */\n align-self: start;\n /* 只设置左右和底部padding，顶部不要padding以消除高度差 */\n @apply px-4 pb-4 rounded-xl;\n /* 微妙的背景区分 */\n background: linear-gradient(to bottom,\n rgba(249, 250, 251, 0.5),\n rgba(243, 244, 246, 0.5));\n }\n\n [data-theme=\"dark\"] .widget-area {\n background: linear-gradient(to bottom,\n rgba(17, 24, 39, 0.5),\n rgba(31, 41, 55, 0.5));\n }\n }\n\n /* 页脚 */\n /* ========== Footer 样式 ========== */\n .site-footer {\n @apply relative;\n @apply bg-gradient-to-b from-gray-50 to-gray-100 dark:from-gray-900 dark:to-gray-950;\n @apply mt-16;\n /* 添加微妙的阴影 */\n box-shadow: 0 -4px 20px rgba(0, 0, 0, 0.03);\n }\n\n /* 装饰性顶部分隔线 */\n .footer-divider {\n @apply h-1 w-full;\n background: linear-gradient(90deg,\n transparent 0%,\n rgb(var(--color-primary-500)) 20%,\n rgb(var(--color-primary-600)) 50%,\n rgb(var(--color-primary-400)) 80%,\n transparent 100%);\n opacity: 0.6;\n }\n\n .footer-content {\n /* 从max-w-7xl增加到max-w-screen-2xl，与主内容容器保持一致 */\n @apply max-w-screen-2xl mx-auto px-4 md:px-6 py-8;\n }\n\n .footer-section {\n @apply py-4;\n }\n\n /* 第一行：版权和主要链接 */\n .footer-main {\n @apply flex flex-col md:flex-row items-center justify-between gap-6;\n @apply border-b border-gray-200 dark:border-gray-800;\n }\n\n .footer-copyright {\n @apply flex items-center gap-2;\n }\n\n .copyright-text {\n @apply flex items-center text-gray-600 dark:text-gray-400 text-sm;\n }\n\n .footer-link-brand {\n @apply font-semibold text-primary-600 dark:text-primary-400;\n @apply hover:text-primary-700 dark:hover:text-primary-300;\n @apply transition-colors duration-200;\n }\n\n .footer-links {\n @apply flex flex-wrap items-center justify-center gap-4;\n }\n\n .footer-link {\n @apply inline-flex items-center gap-1.5;\n @apply px-3 py-1.5 rounded-md;\n @apply text-sm text-gray-600 dark:text-gray-400;\n @apply hover:text-primary-600 dark:hover:text-primary-400;\n @apply hover:bg-white dark:hover:bg-gray-800;\n @apply transition-all duration-200;\n @apply border border-transparent hover:border-gray-200 dark:hover:border-gray-700;\n }\n\n .footer-link svg {\n @apply w-4 h-4;\n }\n\n /* 第二行：技术栈和性能 */\n .footer-meta {\n @apply flex flex-col md:flex-row items-center justify-between gap-4;\n @apply text-sm text-gray-500 dark:text-gray-400;\n }\n\n .footer-tech {\n @apply flex flex-wrap items-center justify-center gap-2;\n }\n\n .footer-performance {\n @apply flex items-center gap-2;\n @apply px-3 py-1.5 rounded-md;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n }\n\n /* 备案信息 */\n .footer-beian {\n @apply text-center py-4;\n }\n\n .footer-beian-link {\n @apply inline-block hover:opacity-80 transition-opacity;\n }\n\n .footer-beian-text {\n @apply text-gray-500 dark:text-gray-400;\n @apply text-sm leading-5;\n @apply m-0;\n }\n\n /* 响应式调整 */\n @media (max-width: 768px) {\n .footer-main {\n @apply text-center;\n }\n\n .footer-links {\n @apply flex-col gap-2;\n }\n\n .footer-meta {\n @apply text-center;\n }\n }\n\n /* ========== 文章相关 ========== */\n /* 文章条目 */\n .entry-header {\n @apply mb-6;\n }\n\n .entry-title {\n @apply text-3xl font-bold mb-4;\n }\n\n .entry-meta {\n @apply text-sm text-gray-600 dark:text-gray-400;\n @apply mb-4;\n }\n\n .entry-meta a {\n @apply text-primary-600 dark:text-primary-400 !important;\n @apply hover:text-primary-700 dark:hover:text-primary-300 !important;\n @apply transition-colors duration-200;\n }\n\n /* 文章摘要（列表页） — prose prose-sm 已提供基础 markdown 样式，此处做收口覆盖 */\n\n /* prose 默认 p/ul/ol margin 对卡片太大，压紧 */\n .article-excerpt p,\n .article-excerpt ul,\n .article-excerpt ol,\n .article-excerpt li,\n .article-excerpt blockquote {\n color: rgb(var(--muted-foreground));\n margin-top: 0.25rem;\n margin-bottom: 0.25rem;\n }\n\n .article-excerpt :first-child {\n margin-top: 0;\n }\n\n /* 摘要中标题压缩为正文大小，绝不能超过文章标题 */\n .article-excerpt h1,\n .article-excerpt h2,\n .article-excerpt h3,\n .article-excerpt h4,\n .article-excerpt h5,\n .article-excerpt h6 {\n font-size: 0.875rem;\n line-height: 1.4;\n font-weight: 600;\n color: rgb(var(--muted-foreground));\n margin-top: 0.5rem;\n margin-bottom: 0.25rem;\n }\n\n /* 摘要内链接不染色 */\n .article-excerpt a {\n color: inherit;\n text-decoration: none;\n }\n\n /* 摘要中图片正常显示，圆角+限高，避免超大图撑破卡片 */\n .article-excerpt img {\n display: block;\n max-width: 100%;\n max-height: 320px;\n width: auto;\n height: auto;\n object-fit: cover;\n border-radius: 0.5rem;\n margin-top: 0.5rem;\n margin-bottom: 0.5rem;\n }\n\n /* 代码块、表格、iframe、视频等复杂元素在摘要中隐藏 */\n .article-excerpt pre,\n .article-excerpt code,\n .article-excerpt table,\n .article-excerpt hr,\n .article-excerpt iframe,\n .article-excerpt video,\n .article-excerpt .codehilite {\n display: none;\n }\n\n /* 详情页文章体：h1 不能超过页面文章标题（text-2xl/text-3xl = 1.5rem/1.875rem）*/\n .article.prose h1 {\n font-size: 1.5rem; /* text-2xl，与移动端文章标题等高，小于桌面端文章标题 */\n line-height: 2rem;\n }\n\n .article.prose h2 {\n font-size: 1.25rem; /* text-xl */\n line-height: 1.75rem;\n }\n\n .article.prose h3 {\n font-size: 1.125rem; /* text-lg */\n line-height: 1.75rem;\n }\n\n /* 文章内容 */\n .entry-content {\n @apply prose prose-base dark:prose-invert max-w-none;\n @apply prose-headings:font-bold prose-headings:text-gray-900 dark:prose-headings:text-gray-100;\n @apply prose-p:text-gray-700 dark:prose-p:text-gray-300 prose-p:leading-relaxed;\n @apply prose-a:text-primary-500 hover:prose-a:text-primary-600;\n @apply prose-a:no-underline hover:prose-a:underline;\n @apply prose-strong:text-gray-900 dark:prose-strong:text-gray-100;\n @apply prose-ul:text-sm prose-ol:text-sm;\n @apply prose-li:text-sm;\n }\n\n /* 文章内容图片增强效果 */\n .entry-content img {\n @apply rounded-xl;\n @apply shadow-lg hover:shadow-2xl;\n @apply transition-all duration-300;\n @apply cursor-zoom-in;\n @apply border-4 border-white dark:border-gray-800;\n @apply ring-1 ring-gray-200 dark:ring-gray-700;\n @apply my-6;\n }\n\n .entry-content img:hover {\n @apply transform scale-105;\n @apply ring-2 ring-primary-400 dark:ring-primary-500;\n }\n\n /* Badge图片和小图片不需要特效 */\n .entry-content img[src*=\"badge.svg\"],\n .entry-content img[src*=\"shields.io\"],\n .entry-content img[src*=\"/badge/\"],\n .entry-content img[alt*=\"badge\" i] {\n @apply cursor-default;\n @apply border-0;\n @apply ring-0;\n @apply shadow-none;\n @apply my-2;\n }\n\n .entry-content img[src*=\"badge.svg\"]:hover,\n .entry-content img[src*=\"shields.io\"]:hover,\n .entry-content img[src*=\"/badge/\"]:hover,\n .entry-content img[alt*=\"badge\" i]:hover {\n @apply transform-none;\n @apply ring-0;\n @apply shadow-none;\n }\n\n /* 图片容器居中 - 仅当段落只包含图片时 */\n .entry-content p:has(img:only-child) {\n @apply text-center;\n }\n\n /* 图片本身显示为块级元素并居中 */\n .entry-content img {\n @apply mx-auto block;\n }\n\n /* 归档页面使用正常字体大小 - 覆盖prose样式 */\n .entry-content.archive-list,\n .entry-content.archive-list ul,\n .entry-content.archive-list ol,\n .entry-content.archive-list li,\n .entry-content.archive-list a {\n font-size: 1rem !important;\n line-height: 1.75rem !important;\n }\n\n .entry-content.archive-list .archive-year {\n @apply text-base font-semibold text-gray-900 dark:text-gray-100 mb-2 mt-4;\n font-size: 1rem !important;\n }\n\n .entry-content.archive-list .archive-month {\n @apply text-base text-gray-800 dark:text-gray-200 mb-2 ml-4;\n font-size: 1rem !important;\n }\n\n .entry-content.archive-list .archive-article {\n @apply ml-8 mb-1;\n }\n\n .entry-content.archive-list .archive-article a {\n @apply text-base text-gray-700 dark:text-gray-300 hover:text-primary-500;\n @apply hover:underline transition-colors duration-200;\n font-size: 1rem !important;\n }\n\n /* 减少目录和正文之间的间距 */\n .entry-content .break_line {\n @apply my-4;\n }\n\n /* 阅读时间预估（由插件注入） */\n .reading-time-estimate {\n @apply text-xs mb-4;\n color: rgb(var(--muted-foreground));\n }\n .reading-time-estimate em {\n font-style: normal;\n }\n\n /* 文章目录（覆盖全局 a { text-primary-500 } 规则） */\n .toc-nav a {\n @apply no-underline;\n color: rgb(var(--muted-foreground));\n transition: color 150ms;\n }\n .toc-nav a:hover {\n color: rgb(var(--primary));\n }\n\n .entry-content > b {\n @apply block mb-2;\n }\n\n /* 文章内容中的代码块覆盖 */\n .entry-content pre {\n @apply p-4 rounded-lg overflow-x-auto;\n background-color: #f9f9f9;\n border: 1px solid #e1e4e8;\n }\n\n [data-theme=\"dark\"] .entry-content pre,\n [data-theme=\"dark\"] .comment-content pre {\n background-color: #1e1e1e !important;\n color: #d4d4d4 !important;\n border-color: #30363d;\n }\n\n .entry-content pre code {\n @apply p-0 bg-transparent;\n font-size: 0.875rem;\n line-height: 1.7;\n color: #24292e;\n }\n\n [data-theme=\"dark\"] .entry-content pre code,\n [data-theme=\"dark\"] .entry-content code,\n [data-theme=\"dark\"] .comment-content code {\n color: #d4d4d4 !important;\n background-color: transparent !important;\n }\n\n /* 内联代码（不在pre中的） */\n .entry-content code:not(pre code) {\n @apply px-2 py-1 rounded;\n background-color: #f6f8fa;\n color: #24292e;\n font-size: 0.875em;\n border: 1px solid #e1e4e8;\n }\n\n [data-theme=\"dark\"] .entry-content code:not(pre code),\n [data-theme=\"dark\"] .comment-content code:not(pre code) {\n background-color: #2d2d2d !important;\n color: #d4d4d4 !important;\n border-color: #30363d;\n }\n\n /* 移除 Tailwind Typography 自动添加的反引号 */\n .entry-content code:not(pre code)::before,\n .entry-content code:not(pre code)::after,\n .comment-content code:not(pre code)::before,\n .comment-content code:not(pre code)::after {\n content: none !important;\n }\n\n /* 文章列表 */\n .article-list {\n @apply space-y-8;\n }\n\n .article-item {\n @apply card hover:shadow-xl transition-all duration-300;\n }\n\n /* 文章导航 */\n .nav-single {\n @apply mt-8 pt-6 clear-both;\n @apply border-t border-gray-200 dark:border-gray-700;\n @apply flex justify-between items-start flex-wrap gap-4;\n }\n\n .nav-single h3 {\n @apply sr-only;\n }\n\n .nav-single .nav-previous {\n @apply flex-shrink-0;\n }\n\n .nav-single .nav-next {\n @apply flex-shrink-0 ml-auto;\n }\n\n .nav-single a {\n @apply text-primary-600 dark:text-primary-400;\n @apply hover:text-primary-700 dark:hover:text-primary-300;\n @apply transition-colors duration-200;\n @apply inline-flex items-center space-x-2;\n @apply max-w-md;\n }\n\n .nav-single .meta-nav {\n @apply text-xl flex-shrink-0;\n }\n\n /* 归档页面 */\n /* ========== 归档页面现代化样式 ========== */\n .archive-header-modern {\n @apply mb-12;\n }\n\n .archive-hero {\n @apply text-center py-12;\n @apply bg-gradient-to-br from-primary-50 via-primary-100 to-primary-50;\n @apply dark:from-gray-800 dark:via-gray-900 dark:to-gray-800;\n @apply rounded-2xl shadow-lg;\n @apply border border-gray-200 dark:border-gray-700;\n @apply relative overflow-hidden;\n }\n\n /* 装饰性背景 */\n .archive-hero::before {\n content: '';\n position: absolute;\n top: -50%;\n right: -20%;\n width: 300px;\n height: 300px;\n background: radial-gradient(circle, rgba(102, 126, 234, 0.1) 0%, transparent 70%);\n border-radius: 50%;\n animation: float 6s ease-in-out infinite;\n }\n\n .archive-hero::after {\n content: '';\n position: absolute;\n bottom: -50%;\n left: -20%;\n width: 250px;\n height: 250px;\n background: radial-gradient(circle, rgba(240, 147, 251, 0.1) 0%, transparent 70%);\n border-radius: 50%;\n animation: float 8s ease-in-out infinite reverse;\n }\n\n @keyframes float {\n 0%, 100% {\n transform: translate(0, 0) scale(1);\n }\n 50% {\n transform: translate(20px, 20px) scale(1.1);\n }\n }\n\n .archive-icon {\n @apply inline-flex items-center justify-center;\n @apply w-20 h-20 rounded-full;\n @apply bg-gradient-to-br from-primary-500 to-primary-600;\n @apply text-white mb-4;\n @apply shadow-lg;\n @apply relative z-10;\n animation: iconPulse 3s ease-in-out infinite;\n }\n\n @keyframes iconPulse {\n 0%, 100% {\n transform: scale(1);\n box-shadow: 0 10px 25px rgba(102, 126, 234, 0.3);\n }\n 50% {\n transform: scale(1.05);\n box-shadow: 0 15px 35px rgba(102, 126, 234, 0.4);\n }\n }\n\n .archive-title-modern {\n @apply text-4xl md:text-5xl font-bold;\n @apply text-gray-900 dark:text-gray-100;\n @apply mb-2 relative z-10;\n }\n\n .archive-subtitle {\n @apply text-gray-600 dark:text-gray-400;\n @apply text-lg relative z-10;\n }\n\n /* 时间线样式 */\n .archive-timeline {\n @apply space-y-12;\n }\n\n .timeline-year-block {\n @apply relative;\n }\n\n .timeline-year-badge {\n @apply inline-flex items-center gap-3;\n @apply px-6 py-3 rounded-full;\n @apply bg-gradient-to-r from-primary-500 to-primary-600;\n @apply text-white font-bold;\n @apply shadow-lg mb-8;\n @apply sticky top-20 z-30;\n @apply backdrop-blur-sm;\n }\n\n .year-number {\n @apply text-2xl;\n }\n\n .year-count {\n @apply text-sm opacity-90;\n @apply px-2 py-0.5 rounded-full;\n @apply bg-white bg-opacity-20;\n }\n\n .timeline-month-block {\n @apply relative pl-8 mb-8;\n @apply before:content-[''] before:absolute before:left-0 before:top-0 before:bottom-0;\n @apply before:w-0.5 before:bg-gradient-to-b before:from-primary-300 before:to-primary-400;\n @apply dark:before:from-primary-700 dark:before:to-primary-600;\n }\n\n .timeline-month-header {\n @apply flex items-center gap-3 mb-4;\n @apply relative;\n }\n\n .timeline-dot {\n @apply absolute -left-8;\n @apply w-4 h-4 rounded-full;\n @apply bg-primary-500 dark:bg-primary-400;\n @apply border-4 border-white dark:border-gray-900;\n @apply shadow-md;\n animation: dotPulse 2s ease-in-out infinite;\n }\n\n @keyframes dotPulse {\n 0%, 100% {\n transform: scale(1);\n box-shadow: 0 0 0 0 rgba(102, 126, 234, 0.4);\n }\n 50% {\n transform: scale(1.1);\n box-shadow: 0 0 0 8px rgba(102, 126, 234, 0);\n }\n }\n\n .month-title {\n @apply text-xl font-semibold text-gray-800 dark:text-gray-200;\n }\n\n .month-count {\n @apply text-sm text-gray-500 dark:text-gray-400;\n @apply px-2 py-0.5 rounded-full;\n @apply bg-gray-100 dark:bg-gray-800;\n }\n\n .timeline-articles {\n @apply space-y-3;\n }\n\n .timeline-article-item {\n @apply transform transition-all duration-200;\n }\n\n .article-link {\n @apply flex items-center justify-between gap-4;\n @apply p-4 rounded-lg;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n @apply hover:border-primary-300 dark:hover:border-primary-600;\n @apply hover:shadow-md;\n @apply transition-all duration-200;\n }\n\n /* group class需要在HTML中添加，不能用@apply */\n\n .article-link:hover {\n @apply transform -translate-y-1;\n }\n\n .article-info {\n @apply flex-1 min-w-0;\n }\n\n .article-date {\n @apply inline-block px-2 py-0.5 rounded;\n @apply bg-primary-100 dark:bg-primary-900;\n @apply text-primary-600 dark:text-primary-300;\n @apply text-xs font-medium mb-2;\n }\n\n .article-title {\n @apply text-base font-medium text-gray-900 dark:text-gray-100;\n @apply group-hover:text-primary-600 dark:group-hover:text-primary-400;\n @apply transition-colors duration-200;\n @apply truncate;\n }\n\n .article-meta {\n @apply flex items-center gap-3 mt-2;\n @apply text-xs text-gray-500 dark:text-gray-400;\n }\n\n .article-category,\n .article-views {\n @apply inline-flex items-center gap-1;\n }\n\n .article-arrow {\n @apply w-5 h-5 text-gray-400;\n @apply group-hover:text-primary-500;\n @apply group-hover:translate-x-1;\n @apply transition-all duration-200;\n @apply flex-shrink-0;\n }\n\n /* 保留旧的归档样式（向后兼容） */\n .archive-header,\n .page-header {\n @apply mb-12 pb-6 border-b-2 border-primary-500;\n }\n\n .archive-title,\n .page-title {\n @apply text-2xl font-bold text-gray-900 dark:text-gray-100;\n }\n\n .archive-title span {\n @apply text-primary-500;\n }\n\n /* 评论链接 */\n .comments-link {\n @apply mt-6 text-sm text-gray-600 dark:text-gray-400;\n }\n\n .comments-link a {\n @apply hover:text-primary-500 dark:hover:text-primary-400;\n }\n\n /* 阅读更多链接 */\n .read-more {\n @apply mt-4;\n }\n\n .read-more a {\n @apply inline-flex items-center px-4 py-2;\n @apply bg-primary-500 text-white rounded-md;\n @apply hover:bg-primary-600 transition-colors duration-200;\n }\n\n /* ========== 评论系统 ========== */\n .comments-area {\n @apply mt-12 pt-8 border-t-2 border-gray-200 dark:border-gray-700;\n }\n\n .comment-tabs {\n @apply mb-6;\n }\n\n .commentlist {\n @apply space-y-6;\n }\n\n .comment-item, .comment {\n @apply list-none;\n }\n\n .comment-body {\n @apply p-6 bg-white dark:bg-gray-800 rounded-lg;\n @apply border border-gray-200 dark:border-gray-700;\n @apply shadow-sm hover:shadow-md transition-all duration-200;\n }\n\n .comment-author {\n @apply flex items-center space-x-3 mb-3;\n }\n\n .comment-author img {\n @apply w-12 h-12 rounded-full;\n @apply border-2 border-gray-200 dark:border-gray-700;\n }\n\n .comment-author .fn {\n @apply font-semibold text-gray-900 dark:text-gray-100;\n @apply not-italic;\n }\n\n .comment-meta {\n @apply text-sm text-gray-500 dark:text-gray-400;\n }\n\n .comment-content {\n @apply text-gray-700 dark:text-gray-300 mb-4;\n @apply prose dark:prose-invert max-w-none;\n }\n\n .reply a {\n @apply text-sm text-gray-600 dark:text-gray-400;\n @apply hover:text-primary-500 dark:hover:text-primary-400;\n @apply transition-colors duration-200;\n }\n\n /* 评论表单 */\n .comment-form {\n @apply space-y-4;\n }\n\n .comment-form label {\n @apply block text-sm font-medium text-gray-700 dark:text-gray-300 mb-2;\n }\n\n .comment-respond {\n @apply mt-8;\n }\n\n .comment-reply-title {\n @apply text-2xl font-bold mb-6 text-gray-900 dark:text-gray-100;\n }\n\n /* 嵌套评论 */\n .children {\n @apply mt-4 space-y-4;\n @apply border-l-2 border-gray-200 dark:border-gray-700 pl-4;\n }\n\n /* 移动端嵌套评论更细的边框 */\n @media (max-width: 768px) {\n .children {\n @apply border-l pl-2;\n }\n }\n\n /* 评论缩进 - PC端（桌面） */\n @media (min-width: 769px) {\n .comment-depth-0 { margin-left: 0; }\n .comment-depth-1 { margin-left: 1rem; }\n .comment-depth-2 { margin-left: 2rem; }\n .comment-depth-3 { margin-left: 3rem; }\n /* 深度4及以上固定在3rem */\n .comment-depth-4,\n .comment-depth-5,\n .comment-depth-6,\n .comment-depth-7,\n .comment-depth-8,\n .comment-depth-9,\n .comment-depth-10 {\n margin-left: 3rem;\n }\n }\n\n /* 评论缩进 - 移动端 */\n @media (max-width: 768px) {\n .comment-depth-0 { margin-left: 0; }\n .comment-depth-1 { margin-left: 0.5rem; }\n .comment-depth-2 { margin-left: 1rem; }\n /* 深度3及以上固定在1.5rem */\n .comment-depth-3,\n .comment-depth-4,\n .comment-depth-5,\n .comment-depth-6,\n .comment-depth-7,\n .comment-depth-8,\n .comment-depth-9,\n .comment-depth-10 {\n margin-left: 1.5rem;\n }\n }\n\n /* 深层评论使用更紧凑的样式 - PC端 */\n @media (min-width: 769px) {\n .comment-depth-3 .comment-body,\n .comment-depth-4 .comment-body,\n .comment-depth-5 .comment-body,\n .comment-depth-6 .comment-body,\n .comment-depth-7 .comment-body,\n .comment-depth-8 .comment-body,\n .comment-depth-9 .comment-body,\n .comment-depth-10 .comment-body {\n @apply p-3;\n }\n }\n\n /* 移动端深层评论更紧凑 */\n @media (max-width: 768px) {\n .comment-depth-2 .comment-body,\n .comment-depth-3 .comment-body,\n .comment-depth-4 .comment-body,\n .comment-depth-5 .comment-body,\n .comment-depth-6 .comment-body,\n .comment-depth-7 .comment-body,\n .comment-depth-8 .comment-body,\n .comment-depth-9 .comment-body,\n .comment-depth-10 .comment-body {\n @apply p-2;\n }\n\n /* 深层评论的头像也缩小 */\n .comment-depth-3 .comment-author img,\n .comment-depth-4 .comment-author img,\n .comment-depth-5 .comment-author img,\n .comment-depth-6 .comment-author img,\n .comment-depth-7 .comment-author img,\n .comment-depth-8 .comment-author img,\n .comment-depth-9 .comment-author img,\n .comment-depth-10 .comment-author img {\n @apply w-8 h-8;\n }\n }\n\n .widget {\n @apply card;\n }\n\n .widget-title {\n @apply text-xl font-bold mb-4;\n @apply border-b-2 border-primary-500 pb-2;\n }\n\n .widget ul {\n @apply space-y-2;\n }\n\n .widget li {\n @apply list-none;\n }\n\n .widget a {\n @apply hover:text-primary-500 dark:hover:text-primary-400;\n @apply transition-colors duration-200;\n }\n\n /* 特定widget的链接需要block布局 */\n .widget_recent_entries a,\n .widget_categories a,\n .widget_meta a {\n @apply block py-1;\n }\n\n /* ========== 侧边栏热门文章 ========== */\n .sidebar-hot-articles {\n @apply space-y-2;\n }\n\n .hot-article-item {\n @apply flex items-start gap-2.5 p-2.5 rounded-lg;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n @apply hover:border-primary-400 dark:hover:border-primary-500;\n @apply hover:shadow-md hover:-translate-y-0.5;\n @apply transition-all duration-200;\n }\n\n .hot-article-rank {\n @apply flex items-center justify-center;\n @apply w-7 h-7 rounded-full;\n @apply bg-gradient-to-br from-primary-500 to-primary-600;\n @apply text-white font-bold text-xs;\n @apply flex-shrink-0;\n @apply shadow-sm;\n }\n\n /* 前三名特殊样式 - 金银铜 */\n .rank-1 {\n @apply from-yellow-400 to-yellow-600;\n box-shadow: 0 2px 8px rgba(251, 191, 36, 0.4);\n animation: rankPulse 2s ease-in-out infinite;\n }\n\n .rank-2 {\n @apply from-gray-300 to-gray-400;\n box-shadow: 0 2px 8px rgba(156, 163, 175, 0.4);\n }\n\n .rank-3 {\n @apply from-orange-400 to-orange-600;\n box-shadow: 0 2px 8px rgba(251, 146, 60, 0.4);\n }\n\n @keyframes rankPulse {\n 0%, 100% {\n transform: scale(1);\n box-shadow: 0 2px 8px rgba(251, 191, 36, 0.4);\n }\n 50% {\n transform: scale(1.08);\n box-shadow: 0 4px 12px rgba(251, 191, 36, 0.6);\n }\n }\n\n .hot-article-content {\n @apply flex-1 min-w-0;\n }\n\n .hot-article-title {\n @apply block text-sm font-medium mb-1 leading-snug;\n @apply text-gray-900 dark:text-gray-100;\n @apply hover:text-primary-600 dark:hover:text-primary-400;\n @apply transition-colors duration-200;\n @apply line-clamp-2;\n }\n\n .hot-article-meta {\n @apply flex items-center gap-1;\n @apply text-xs text-gray-600 dark:text-gray-400;\n }\n\n .hot-article-views {\n @apply font-medium text-gray-700 dark:text-gray-300;\n }\n\n /* ========== 侧边栏分类列表 ========== */\n .sidebar-categories {\n @apply space-y-1.5;\n }\n\n .category-item {\n @apply list-none;\n }\n\n .category-link {\n @apply flex items-center gap-2 px-3 py-2 rounded-lg;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n @apply hover:border-primary-400 dark:hover:border-primary-500;\n @apply hover:shadow-md hover:-translate-y-0.5;\n @apply transition-all duration-200;\n @apply no-underline;\n }\n\n .category-icon {\n @apply flex-shrink-0;\n @apply text-primary-500 dark:text-primary-400;\n }\n\n .category-name {\n @apply flex-1 min-w-0;\n @apply text-sm font-medium;\n @apply text-gray-900 dark:text-gray-100;\n @apply truncate;\n }\n\n .category-count {\n @apply flex-shrink-0;\n @apply px-2 py-0.5 rounded-full;\n @apply bg-primary-100 dark:bg-primary-900/50;\n @apply text-primary-700 dark:text-primary-300;\n @apply text-xs font-semibold;\n }\n\n /* ========== 侧边栏最新评论 ========== */\n .sidebar-recent-comments {\n @apply space-y-2.5;\n }\n\n .recent-comment-item {\n @apply flex items-start gap-2 p-2.5 rounded-lg;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n @apply hover:border-primary-400 dark:hover:border-primary-500;\n @apply hover:shadow-md hover:-translate-y-0.5;\n @apply transition-all duration-200;\n }\n\n .comment-avatar {\n @apply flex-shrink-0;\n }\n\n .comment-avatar img {\n @apply ring-2 ring-gray-200 dark:ring-gray-700;\n }\n\n .comment-content {\n @apply flex-1 min-w-0;\n }\n\n .comment-text {\n @apply text-sm text-gray-900 dark:text-gray-100;\n @apply mb-2 leading-relaxed;\n @apply line-clamp-3;\n @apply font-normal;\n }\n\n .comment-meta {\n @apply flex items-center flex-wrap gap-1;\n @apply text-xs text-gray-500 dark:text-gray-400;\n }\n\n .comment-author-name {\n @apply font-medium text-gray-700 dark:text-gray-300;\n }\n\n .comment-separator {\n @apply text-gray-400 dark:text-gray-600;\n }\n\n .comment-time {\n @apply text-gray-500 dark:text-gray-400;\n }\n\n .comment-article-link {\n @apply text-primary-600 dark:text-primary-400;\n @apply hover:text-primary-700 dark:hover:text-primary-300;\n @apply transition-colors duration-200;\n @apply no-underline truncate;\n }\n\n /* ========== 侧边栏标签云多彩设计 ========== */\n .sidebar-tagcloud {\n @apply flex flex-wrap gap-1.5;\n }\n\n .sidebar-tag {\n @apply inline-flex items-center gap-1 px-2.5 py-1 rounded-md;\n @apply text-xs font-medium;\n @apply transition-all duration-200;\n @apply no-underline;\n @apply shadow-sm hover:shadow-md;\n @apply transform hover:scale-105 hover:-translate-y-0.5;\n }\n\n /* 根据标签顺序使用不同颜色 */\n .sidebar-tag:nth-child(8n+1) {\n @apply bg-blue-100 dark:bg-blue-900/40 text-blue-700 dark:text-blue-300;\n @apply hover:bg-blue-600 hover:text-white dark:hover:bg-blue-500;\n }\n\n .sidebar-tag:nth-child(8n+2) {\n @apply bg-green-100 dark:bg-green-900/40 text-green-700 dark:text-green-300;\n @apply hover:bg-green-600 hover:text-white dark:hover:bg-green-500;\n }\n\n .sidebar-tag:nth-child(8n+3) {\n @apply bg-purple-100 dark:bg-purple-900/40 text-purple-700 dark:text-purple-300;\n @apply hover:bg-purple-600 hover:text-white dark:hover:bg-purple-500;\n }\n\n .sidebar-tag:nth-child(8n+4) {\n @apply bg-pink-100 dark:bg-pink-900/40 text-pink-700 dark:text-pink-300;\n @apply hover:bg-pink-600 hover:text-white dark:hover:bg-pink-500;\n }\n\n .sidebar-tag:nth-child(8n+5) {\n @apply bg-orange-100 dark:bg-orange-900/40 text-orange-700 dark:text-orange-300;\n @apply hover:bg-orange-600 hover:text-white dark:hover:bg-orange-500;\n }\n\n .sidebar-tag:nth-child(8n+6) {\n @apply bg-teal-100 dark:bg-teal-900/40 text-teal-700 dark:text-teal-300;\n @apply hover:bg-teal-600 hover:text-white dark:hover:bg-teal-500;\n }\n\n .sidebar-tag:nth-child(8n+7) {\n @apply bg-indigo-100 dark:bg-indigo-900/40 text-indigo-700 dark:text-indigo-300;\n @apply hover:bg-indigo-600 hover:text-white dark:hover:bg-indigo-500;\n }\n\n .sidebar-tag:nth-child(8n+8) {\n @apply bg-red-100 dark:bg-red-900/40 text-red-700 dark:text-red-300;\n @apply hover:bg-red-600 hover:text-white dark:hover:bg-red-500;\n }\n\n /* 搜索表单 */\n .searchform {\n @apply flex items-center gap-2;\n }\n\n .searchform input[type=\"text\"] {\n @apply flex-1 input;\n }\n\n .searchform input[type=\"submit\"] {\n @apply btn btn-primary;\n }\n\n /* ========== 分页 ========== */\n .pagination {\n @apply flex justify-center items-center space-x-2 mt-8;\n }\n\n .pagination a,\n .pagination span {\n @apply px-4 py-2 rounded-md;\n @apply border border-gray-300 dark:border-gray-600;\n @apply transition-all duration-200;\n }\n\n .pagination a {\n @apply hover:bg-primary-500 hover:text-white hover:border-primary-500;\n }\n\n .pagination .current {\n @apply bg-primary-500 text-white border-primary-500;\n }\n\n /* ========== 面包屑导航 ========== */\n /* breadcrumb 现已使用 Tailwind 内联样式，此处仅保留注释 */\n\n /* ========== 标签云 ========== */\n .tagcloud {\n @apply flex flex-wrap gap-1.5;\n @apply leading-tight;\n @apply items-start;\n }\n\n .tagcloud a {\n @apply inline-block px-2.5 py-0.5 rounded-full;\n @apply bg-gray-100 dark:bg-gray-700;\n @apply text-gray-700 dark:text-gray-300;\n @apply text-sm;\n @apply hover:bg-primary-500 hover:text-white;\n @apply transition-all duration-200;\n @apply no-underline;\n @apply whitespace-nowrap;\n @apply shadow-sm hover:shadow-md;\n @apply border border-gray-200 dark:border-gray-600;\n @apply hover:border-transparent;\n @apply transform hover:scale-105;\n @apply leading-tight;\n }\n\n .tag-link {\n @apply inline-block px-2.5 py-0.5 rounded-full;\n @apply bg-gray-100 dark:bg-gray-700;\n @apply text-gray-700 dark:text-gray-300;\n @apply text-sm;\n @apply hover:bg-primary-500 hover:text-white;\n @apply transition-all duration-200;\n @apply whitespace-nowrap;\n @apply shadow-sm hover:shadow-md;\n @apply border border-gray-200 dark:border-gray-600;\n @apply leading-tight;\n }\n\n /* ========== 表单元素 ========== */\n input[type=\"text\"],\n input[type=\"email\"],\n input[type=\"password\"],\n input[type=\"search\"],\n textarea,\n select {\n @apply input;\n }\n\n button[type=\"submit\"],\n input[type=\"submit\"] {\n @apply btn btn-primary;\n }\n}\n\n/* ==================== 组件层 - 自定义组件 ==================== */\n@layer components {\n /* ========== 文章卡片 ========== */\n .article-card {\n @apply card mb-8;\n }\n\n .article-card:hover {\n @apply transform -translate-y-1;\n }\n\n /* ========== 侧边栏组件 ========== */\n .sidebar-widget {\n @apply widget;\n }\n\n /* ========== 搜索框 ========== */\n .search-form {\n @apply relative;\n }\n\n .search-form input {\n @apply w-full pr-10;\n }\n\n .search-form button {\n @apply absolute right-2 top-1/2 -translate-y-1/2;\n @apply text-gray-400 hover:text-primary-500;\n }\n\n /* ========== 通知消息 ========== */\n .notification {\n @apply fixed top-4 right-4 px-6 py-3 rounded-lg shadow-lg z-50;\n @apply animate-fade-in;\n }\n\n .notification-success {\n @apply bg-green-500 text-white;\n }\n\n .notification-error {\n @apply bg-red-500 text-white;\n }\n\n .notification-info {\n @apply bg-blue-500 text-white;\n }\n\n /* ========== 加载动画 ========== */\n .spinner {\n @apply animate-spin rounded-full;\n @apply border-2 border-gray-300 border-t-primary-500;\n }\n\n /* ========== OAuth登录按钮 ========== */\n .oauth-button {\n @apply inline-flex items-center space-x-2;\n @apply px-4 py-2 rounded-md;\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-300 dark:border-gray-600;\n @apply hover:bg-gray-50 dark:hover:bg-gray-700;\n @apply transition-all duration-200;\n }\n\n .oauth-button img {\n @apply w-5 h-5;\n }\n}\n\n/* ==================== 插件样式适配 ==================== */\n\n/* ========== Dark Mode 核心样式 ========== */\n/* CSS变量系统 - Solarized Dark风格 */\n:root {\n /* 亮色主题变量 */\n --dm-bg-primary: #ffffff;\n --dm-bg-secondary: #f4f4f4;\n --dm-bg-tertiary: #e6e6e6;\n\n --dm-text-primary: #444444;\n --dm-text-secondary: #757575;\n\n --dm-link-color: #21759b;\n --dm-link-hover: #0f3647;\n\n --dm-border-color: #cccccc;\n --dm-shadow: rgba(64, 64, 64, 0.1);\n\n /* 过渡时长 */\n --dm-transition: 300ms;\n}\n\n/* 暗色主题变量覆盖 */\nhtml[data-theme=\"dark\"] {\n --dm-bg-primary: #002b36;\n --dm-bg-secondary: #073642;\n --dm-bg-tertiary: #0e4450;\n\n --dm-text-primary: #93a1a1;\n --dm-text-secondary: #839496;\n\n --dm-link-color: #2aa198;\n --dm-link-hover: #3bc1b6;\n\n --dm-border-color: #073642;\n --dm-shadow: rgba(0, 0, 0, 0.3);\n}\n\n/* 深色模式切换按钮 */\n/* 深色模式切换按钮 - 确保始终可点击且清晰可见 */\n.dark-mode-toggle-fixed {\n /* 使用Tailwind配置的z-index值，让cssnano正确优化 */\n @apply fixed top-5 right-5 z-modal;\n pointer-events: auto !important; /* 强制可点击，不受 backdrop-blur 等影响 */\n isolation: isolate; /* 创建独立的层叠上下文 */\n will-change: transform; /* 提升到单独的合成层，避免被 backdrop-blur 影响 */\n transform: translateZ(0); /* 强制硬件加速，独立渲染层 */\n}\n\n.dark-mode-toggle-btn {\n @apply w-12 h-12 rounded-full;\n @apply bg-white dark:bg-gray-800;\n @apply border-2 border-gray-300 dark:border-gray-600;\n @apply flex items-center justify-center;\n @apply text-2xl cursor-pointer;\n @apply shadow-lg hover:shadow-xl;\n @apply transition-all duration-300;\n @apply hover:scale-110 hover:rotate-12;\n}\n\n.dark-mode-toggle-btn:active {\n @apply scale-95;\n}\n\n/* 图标切换 */\n.dark-mode-toggle-btn .icon-dark {\n display: none;\n}\n\nhtml[data-theme=\"dark\"] .dark-mode-toggle-btn .icon-light {\n display: none;\n}\n\nhtml[data-theme=\"dark\"] .dark-mode-toggle-btn .icon-dark {\n display: inline;\n}\n\n/* ========== Article Recommendation 插件适配 ========== */\n.article-recommendations {\n @apply my-8 p-6 card;\n}\n\n.recommendations-title {\n @apply text-xl font-bold mb-4;\n @apply border-b-2 border-primary-500 pb-2 inline-block;\n}\n\n.recommendations-grid {\n @apply grid gap-4 mt-4;\n @apply grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4;\n}\n\n.recommendation-card {\n @apply bg-white dark:bg-gray-800;\n @apply border border-gray-200 dark:border-gray-700;\n @apply rounded-lg overflow-hidden;\n @apply transition-all duration-200;\n @apply hover:border-primary-500 hover:shadow-md;\n}\n\n.recommendation-link {\n @apply block p-4 no-underline;\n}\n\n.recommendation-title {\n @apply text-base font-medium mb-2;\n @apply text-gray-900 dark:text-gray-100;\n @apply hover:text-primary-500 dark:hover:text-primary-400;\n @apply transition-colors duration-200;\n}\n\n.recommendation-meta {\n @apply flex justify-between items-center;\n @apply text-xs text-gray-500 dark:text-gray-400;\n}\n\n.recommendation-category {\n @apply px-2 py-1 rounded;\n @apply bg-gray-100 dark:bg-gray-700;\n @apply text-gray-600 dark:text-gray-300;\n}\n\n.recommendation-date {\n @apply text-gray-500 dark:text-gray-400;\n}\n\n/* 侧边栏推荐 */\n.widget_recommendations .recommendations-list {\n @apply space-y-3;\n}\n\n.recommendations-list .recommendation-item {\n @apply pb-3 border-b border-gray-200 dark:border-gray-700;\n}\n\n.recommendations-list .recommendation-item:last-child {\n @apply border-b-0;\n}\n\n.recommendations-list .recommendation-item a {\n @apply text-sm hover:text-primary-500 dark:hover:text-primary-400;\n}\n\n/* ========== Article Copyright 插件适配 ========== */\n.article-copyright {\n @apply my-8 p-6 rounded-lg;\n @apply bg-gradient-to-r from-gray-50 to-gray-100;\n @apply dark:from-gray-800 dark:to-gray-900;\n @apply border-l-4 border-primary-500;\n}\n\n.article-copyright-title {\n @apply text-lg font-bold mb-3 text-gray-900 dark:text-gray-100;\n @apply flex items-center space-x-2;\n}\n\n.article-copyright-content {\n @apply text-sm text-gray-700 dark:text-gray-300 space-y-2;\n}\n\n.article-copyright-content p {\n @apply mb-2;\n}\n\n.article-copyright-content a {\n @apply text-primary-600 dark:text-primary-400 hover:underline;\n}\n\n/* ========== Reading Time 插件适配 ========== */\n.reading-time {\n @apply inline-flex items-center space-x-1;\n @apply text-sm text-gray-600 dark:text-gray-400;\n}\n\n.reading-time-icon {\n @apply w-4 h-4;\n}\n\n/* ========== Image Lazy Loading 插件适配 ========== */\nimg[loading=\"lazy\"] {\n @apply transition-opacity duration-300;\n}\n\nimg[loading=\"lazy\"]:not([src]) {\n @apply opacity-0;\n}\n\nimg[loading=\"lazy\"][src] {\n @apply opacity-100;\n}\n\n/* 图片加载占位符 */\n.lazy-loading-placeholder {\n @apply bg-gray-200 dark:bg-gray-700 animate-pulse;\n}\n\n/* ========== View Count 插件适配 ========== */\n.view-count {\n @apply inline-flex items-center space-x-1;\n @apply text-sm text-gray-600 dark:text-gray-400;\n}\n\n.view-count-icon {\n @apply w-4 h-4;\n}\n\n/* ========== SEO Optimizer 插件适配 ========== */\n/* SEO插件通常不需要额外样式，主要修改meta标签 */\n\n/* ========== Cloudflare Cache 插件适配 ========== */\n/* Cloudflare缓存插件通常不需要前端样式 */\n\n/* ==================== 工具类层 - 自定义工具 ==================== */\n@layer utilities {\n /* 渐变背景 */\n .bg-gradient-primary {\n @apply bg-gradient-to-r from-primary-500 to-primary-600;\n }\n\n /* 文本渐变 */\n .text-gradient-primary {\n @apply bg-gradient-to-r from-primary-500 to-primary-600 bg-clip-text text-transparent;\n }\n\n /* 文本截断 */\n .line-clamp-2 {\n display: -webkit-box;\n -webkit-line-clamp: 2;\n -webkit-box-orient: vertical;\n overflow: hidden;\n }\n\n .line-clamp-3 {\n display: -webkit-box;\n -webkit-line-clamp: 3;\n -webkit-box-orient: vertical;\n overflow: hidden;\n }\n\n /* 隐藏滚动条但保持滚动 */\n .scrollbar-hide {\n -ms-overflow-style: none;\n scrollbar-width: none;\n }\n\n .scrollbar-hide::-webkit-scrollbar {\n display: none;\n }\n}\n\n/* ==================== NProgress 进度条 ==================== */\n#nprogress {\n pointer-events: none;\n}\n\n#nprogress .bar {\n @apply bg-primary-500;\n position: fixed;\n z-index: 1031;\n top: 0;\n left: 0;\n width: 100%;\n height: 2px;\n}\n\n#nprogress .peg {\n display: block;\n position: absolute;\n right: 0;\n width: 100px;\n height: 100%;\n box-shadow: 0 0 10px rgba(33, 117, 155, 0.6), 0 0 5px rgba(33, 117, 155, 0.6);\n opacity: 1;\n transform: rotate(3deg) translate(0px, -4px);\n}\n\n/* ==================== 回到顶部按钮 ==================== */\n#rocket {\n @apply fixed bottom-8 right-8 w-12 h-12;\n @apply bg-primary-500 hover:bg-primary-600;\n @apply text-white rounded-full;\n @apply flex items-center justify-center;\n @apply shadow-lg hover:shadow-xl;\n @apply cursor-pointer;\n z-index: 1000;\n}\n\n#rocket.move {\n animation: rocketMove 0.8s ease-out;\n}\n\n@keyframes rocketMove {\n 0% {\n transform: translateY(0);\n }\n 50% {\n transform: translateY(-100px);\n }\n 100% {\n transform: translateY(-200vh);\n opacity: 0;\n }\n}\n\n/* Reaction 模态框和通知动画 */\n@keyframes fadeIn {\n from {\n opacity: 0;\n }\n to {\n opacity: 1;\n }\n}\n\n@keyframes fadeOut {\n from {\n opacity: 1;\n }\n to {\n opacity: 0;\n }\n}\n\n@keyframes scaleIn {\n from {\n opacity: 0;\n transform: scale(0.95);\n }\n to {\n opacity: 1;\n transform: scale(1);\n }\n}\n\n@keyframes slideInRight {\n from {\n opacity: 0;\n transform: translateX(100px);\n }\n to {\n opacity: 1;\n transform: translateX(0);\n }\n}\n\n.animate-fade-in {\n animation: fadeIn 0.2s ease-out;\n}\n\n.animate-fade-out {\n animation: fadeOut 0.2s ease-out;\n}\n\n.animate-scale-in {\n animation: scaleIn 0.2s ease-out;\n}\n\n.animate-slide-in-right {\n animation: slideInRight 0.3s ease-out;\n}\n\n/* ==================== Pygments 代码高亮兼容 ==================== */\n.codehilite {\n @apply rounded-lg overflow-x-auto mb-4;\n background-color: #f9f9f9;\n border: 1px solid #e1e4e8;\n /* 移动端优化 */\n max-width: 100%;\n -webkit-overflow-scrolling: touch;\n}\n\n/* 深色模式 - Pygments代码高亮 */\n[data-theme=\"dark\"] .codehilite {\n background-color: #1e1e1e !important;\n border-color: #30363d;\n}\n\n.codehilite pre {\n @apply m-0;\n background-color: transparent;\n /* 移动端字号优化 */\n @apply text-sm md:text-base;\n /* 确保内容不会溢出 */\n white-space: pre;\n overflow-x: auto;\n}\n\n[data-theme=\"dark\"] .codehilite pre {\n color: #d4d4d4 !important;\n border: none !important;\n background: transparent !important;\n}\n\n[data-theme=\"dark\"] .codehilite code {\n color: #d4d4d4 !important;\n background-color: transparent !important;\n /* 移动端字号 */\n @apply text-sm md:text-base;\n}\n\n.codehilite code {\n /* 移动端字号 */\n @apply text-sm md:text-base;\n display: block;\n}\n\n/* 深色模式 - Pygments Token 颜色覆盖（VS Code Dark+ 风格） */\n[data-theme=\"dark\"] .codehilite .hll { background-color: #49483e !important; }\n[data-theme=\"dark\"] .codehilite .c { color: #6a9955 !important; } /* Comment */\n[data-theme=\"dark\"] .codehilite .err { color: #f48771 !important; } /* Error */\n[data-theme=\"dark\"] .codehilite .k { color: #c586c0 !important; } /* Keyword */\n[data-theme=\"dark\"] .codehilite .l { color: #ce9178 !important; } /* Literal */\n[data-theme=\"dark\"] .codehilite .n { color: #9cdcfe !important; } /* Name */\n[data-theme=\"dark\"] .codehilite .o { color: #d4d4d4 !important; } /* Operator */\n[data-theme=\"dark\"] .codehilite .p { color: #d4d4d4 !important; } /* Punctuation */\n[data-theme=\"dark\"] .codehilite .ch { color: #6a9955 !important; } /* Comment.Hashbang */\n[data-theme=\"dark\"] .codehilite .cm { color: #6a9955 !important; } /* Comment.Multiline */\n[data-theme=\"dark\"] .codehilite .cp { color: #c586c0 !important; } /* Comment.Preproc */\n[data-theme=\"dark\"] .codehilite .cpf { color: #6a9955 !important; } /* Comment.PreprocFile */\n[data-theme=\"dark\"] .codehilite .c1 { color: #6a9955 !important; } /* Comment.Single */\n[data-theme=\"dark\"] .codehilite .cs { color: #6a9955 !important; } /* Comment.Special */\n[data-theme=\"dark\"] .codehilite .gd { color: #f48771 !important; } /* Generic.Deleted */\n[data-theme=\"dark\"] .codehilite .ge { font-style: italic !important; } /* Generic.Emph */\n[data-theme=\"dark\"] .codehilite .gr { color: #f48771 !important; } /* Generic.Error */\n[data-theme=\"dark\"] .codehilite .gh { color: #4ec9b0 !important; font-weight: bold !important; } /* Generic.Heading */\n[data-theme=\"dark\"] .codehilite .gi { color: #b5cea8 !important; } /* Generic.Inserted */\n[data-theme=\"dark\"] .codehilite .go { color: #808080 !important; } /* Generic.Output */\n[data-theme=\"dark\"] .codehilite .gp { color: #808080 !important; font-weight: bold !important; } /* Generic.Prompt */\n[data-theme=\"dark\"] .codehilite .gs { font-weight: bold !important; } /* Generic.Strong */\n[data-theme=\"dark\"] .codehilite .gu { color: #4ec9b0 !important; font-weight: bold !important; } /* Generic.Subheading */\n[data-theme=\"dark\"] .codehilite .gt { color: #f48771 !important; } /* Generic.Traceback */\n[data-theme=\"dark\"] .codehilite .kc { color: #569cd6 !important; } /* Keyword.Constant */\n[data-theme=\"dark\"] .codehilite .kd { color: #569cd6 !important; } /* Keyword.Declaration */\n[data-theme=\"dark\"] .codehilite .kn { color: #c586c0 !important; } /* Keyword.Namespace */\n[data-theme=\"dark\"] .codehilite .kp { color: #569cd6 !important; } /* Keyword.Pseudo */\n[data-theme=\"dark\"] .codehilite .kr { color: #569cd6 !important; } /* Keyword.Reserved */\n[data-theme=\"dark\"] .codehilite .kt { color: #4ec9b0 !important; } /* Keyword.Type */\n[data-theme=\"dark\"] .codehilite .ld { color: #ce9178 !important; } /* Literal.Date */\n[data-theme=\"dark\"] .codehilite .m { color: #b5cea8 !important; } /* Literal.Number */\n[data-theme=\"dark\"] .codehilite .s { color: #ce9178 !important; } /* Literal.String */\n[data-theme=\"dark\"] .codehilite .na { color: #9cdcfe !important; } /* Name.Attribute */\n[data-theme=\"dark\"] .codehilite .nb { color: #dcdcaa !important; } /* Name.Builtin */\n[data-theme=\"dark\"] .codehilite .nc { color: #4ec9b0 !important; } /* Name.Class */\n[data-theme=\"dark\"] .codehilite .no { color: #4ec9b0 !important; } /* Name.Constant */\n[data-theme=\"dark\"] .codehilite .nd { color: #dcdcaa !important; } /* Name.Decorator */\n[data-theme=\"dark\"] .codehilite .ni { color: #4ec9b0 !important; } /* Name.Entity */\n[data-theme=\"dark\"] .codehilite .ne { color: #4ec9b0 !important; } /* Name.Exception */\n[data-theme=\"dark\"] .codehilite .nf { color: #dcdcaa !important; } /* Name.Function */\n[data-theme=\"dark\"] .codehilite .nl { color: #9cdcfe !important; } /* Name.Label */\n[data-theme=\"dark\"] .codehilite .nn { color: #4ec9b0 !important; } /* Name.Namespace */\n[data-theme=\"dark\"] .codehilite .nx { color: #9cdcfe !important; } /* Name.Other */\n[data-theme=\"dark\"] .codehilite .py { color: #9cdcfe !important; } /* Name.Property */\n[data-theme=\"dark\"] .codehilite .nt { color: #569cd6 !important; } /* Name.Tag */\n[data-theme=\"dark\"] .codehilite .nv { color: #9cdcfe !important; } /* Name.Variable */\n[data-theme=\"dark\"] .codehilite .ow { color: #569cd6 !important; } /* Operator.Word */\n[data-theme=\"dark\"] .codehilite .w { color: #d4d4d4 !important; } /* Text.Whitespace */\n[data-theme=\"dark\"] .codehilite .mb { color: #b5cea8 !important; } /* Literal.Number.Bin */\n[data-theme=\"dark\"] .codehilite .mf { color: #b5cea8 !important; } /* Literal.Number.Float */\n[data-theme=\"dark\"] .codehilite .mh { color: #b5cea8 !important; } /* Literal.Number.Hex */\n[data-theme=\"dark\"] .codehilite .mi { color: #b5cea8 !important; } /* Literal.Number.Integer */\n[data-theme=\"dark\"] .codehilite .mo { color: #b5cea8 !important; } /* Literal.Number.Oct */\n[data-theme=\"dark\"] .codehilite .sa { color: #ce9178 !important; } /* Literal.String.Affix */\n[data-theme=\"dark\"] .codehilite .sb { color: #ce9178 !important; } /* Literal.String.Backtick */\n[data-theme=\"dark\"] .codehilite .sc { color: #ce9178 !important; } /* Literal.String.Char */\n[data-theme=\"dark\"] .codehilite .dl { color: #ce9178 !important; } /* Literal.String.Delimiter */\n[data-theme=\"dark\"] .codehilite .sd { color: #6a9955 !important; } /* Literal.String.Doc */\n[data-theme=\"dark\"] .codehilite .s2 { color: #ce9178 !important; } /* Literal.String.Double */\n[data-theme=\"dark\"] .codehilite .se { color: #d7ba7d !important; } /* Literal.String.Escape */\n[data-theme=\"dark\"] .codehilite .sh { color: #ce9178 !important; } /* Literal.String.Heredoc */\n[data-theme=\"dark\"] .codehilite .si { color: #d7ba7d !important; } /* Literal.String.Interpol */\n[data-theme=\"dark\"] .codehilite .sx { color: #ce9178 !important; } /* Literal.String.Other */\n[data-theme=\"dark\"] .codehilite .sr { color: #d16969 !important; } /* Literal.String.Regex */\n[data-theme=\"dark\"] .codehilite .s1 { color: #ce9178 !important; } /* Literal.String.Single */\n[data-theme=\"dark\"] .codehilite .ss { color: #ce9178 !important; } /* Literal.String.Symbol */\n[data-theme=\"dark\"] .codehilite .bp { color: #dcdcaa !important; } /* Name.Builtin.Pseudo */\n[data-theme=\"dark\"] .codehilite .fm { color: #dcdcaa !important; } /* Name.Function.Magic */\n[data-theme=\"dark\"] .codehilite .vc { color: #9cdcfe !important; } /* Name.Variable.Class */\n[data-theme=\"dark\"] .codehilite .vg { color: #9cdcfe !important; } /* Name.Variable.Global */\n[data-theme=\"dark\"] .codehilite .vi { color: #9cdcfe !important; } /* Name.Variable.Instance */\n[data-theme=\"dark\"] .codehilite .vm { color: #9cdcfe !important; } /* Name.Variable.Magic */\n[data-theme=\"dark\"] .codehilite .il { color: #b5cea8 !important; } /* Literal.Number.Integer.Long */\n\n/* ==================== 响应式优化 ==================== */\n@media (max-width: 768px) {\n /* 移动端优化 */\n .site-header {\n @apply px-2;\n }\n\n .wrapper {\n @apply px-2;\n }\n\n .comment-body {\n @apply p-4;\n }\n\n .children {\n @apply ml-4;\n }\n}\n\n/* ==================== 打印样式 ==================== */\n@media print {\n .site-header,\n .main-navigation,\n .widget-area,\n .site-footer,\n #rocket,\n .dark-mode-toggle-fixed,\n .comment-respond {\n @apply hidden;\n }\n\n .wrapper {\n @apply block;\n }\n\n .site-content {\n @apply w-full;\n }\n}\n\n/* ==================== Alpine.js 支持 ==================== */\n/* x-cloak: 隐藏未初始化的Alpine组件 */\n[x-cloak] {\n display: none !important;\n}\n\n/* ==================== 辅助功能 ==================== */\n/* 跳过链接（屏幕阅读器） */\n.skip-link {\n @apply sr-only focus:not-sr-only;\n @apply fixed top-2 left-2 z-50;\n @apply bg-primary-500 text-white px-4 py-2 rounded;\n}\n\n/* 焦点可见性 */\n:focus-visible {\n @apply outline-2 outline-offset-2 outline-primary-500;\n}\n\n/* ==================== 兼容性 ==================== */\n/* 平滑过渡所有颜色变化 */\n* {\n transition: background-color 0.3s ease, border-color 0.3s ease, color 0.3s ease;\n}\n\n/* 禁用某些元素的过渡 */\nbutton,\ninput,\ntextarea,\nselect {\n transition: none;\n}\n\nbutton:hover,\ninput:focus,\ntextarea:focus,\nselect:focus {\n transition: all 0.2s ease;\n}\n"
},
{
"path": "frontend/src/utils/nprogress.js",
"content": "/**\n * 简化版 NProgress 进度条\n * 保留原有功能\n */\n\nconst NProgress = {\n settings: {\n minimum: 0.08,\n easing: 'ease',\n speed: 200,\n trickle: true,\n trickleSpeed: 200,\n showSpinner: true,\n },\n\n status: null,\n\n configure(options) {\n Object.assign(this.settings, options);\n return this;\n },\n\n set(n) {\n const started = this.isStarted();\n n = this.clamp(n, this.settings.minimum, 1);\n this.status = n === 1 ? null : n;\n\n const progress = this.render(!started);\n const bar = progress.querySelector('.bar');\n const speed = this.settings.speed;\n const ease = this.settings.easing;\n\n progress.offsetWidth; // Repaint\n\n this.queue((next) => {\n bar.style.transition = `all ${speed}ms ${ease}`;\n bar.style.width = n * 100 + '%';\n\n if (n === 1) {\n progress.style.transition = `all ${speed}ms ${ease}`;\n progress.style.opacity = '0';\n setTimeout(() => {\n this.remove();\n next();\n }, speed);\n } else {\n setTimeout(next, speed);\n }\n });\n\n return this;\n },\n\n isStarted() {\n return typeof this.status === 'number';\n },\n\n start() {\n if (!this.status) this.set(0);\n\n const work = () => {\n setTimeout(() => {\n if (!this.status) return;\n this.trickle();\n work();\n }, this.settings.trickleSpeed);\n };\n\n if (this.settings.trickle) work();\n\n return this;\n },\n\n done(force) {\n if (!force && !this.status) return this;\n return this.inc(0.3 + 0.5 * Math.random()).set(1);\n },\n\n inc(amount) {\n let n = this.status;\n\n if (!n) {\n return this.start();\n }\n\n if (typeof amount !== 'number') {\n amount = (1 - n) * this.clamp(Math.random() * n, 0.1, 0.95);\n }\n\n n = this.clamp(n + amount, 0, 0.994);\n return this.set(n);\n },\n\n trickle() {\n return this.inc(Math.random() * 0.02);\n },\n\n render(fromStart) {\n if (this.isRendered()) return document.getElementById('nprogress');\n\n const progress = document.createElement('div');\n progress.id = 'nprogress';\n progress.innerHTML = '';\n\n const bar = progress.querySelector('.bar');\n const perc = fromStart ? 0 : (this.status || 0) * 100;\n\n bar.style.transition = 'none';\n bar.style.width = perc + '%';\n\n if (!this.settings.showSpinner) {\n const spinner = progress.querySelector('.spinner');\n spinner && spinner.remove();\n }\n\n document.body.appendChild(progress);\n return progress;\n },\n\n remove() {\n const progress = document.getElementById('nprogress');\n progress && progress.remove();\n },\n\n isRendered() {\n return !!document.getElementById('nprogress');\n },\n\n clamp(n, min, max) {\n if (n < min) return min;\n if (n > max) return max;\n return n;\n },\n\n toBarPerc(n) {\n return (-1 + n) * 100;\n },\n\n queue: (function () {\n const pending = [];\n\n function next() {\n const fn = pending.shift();\n if (fn) fn(next);\n }\n\n return function (fn) {\n pending.push(fn);\n if (pending.length === 1) next();\n };\n })(),\n};\n\nexport default NProgress;\n"
},
{
"path": "frontend/tailwind.config.js",
"content": "/** @type {import('tailwindcss').Config} */\nexport default {\n // 扫描这些文件以提取使用的CSS类\n content: [\n \"./src/**/*.{js,jsx,ts,tsx}\",\n \"../templates/**/*.html\",\n \"../blog/templates/**/*.html\",\n \"../accounts/templates/**/*.html\",\n \"../comments/templates/**/*.html\",\n \"../oauth/templates/**/*.html\",\n ],\n\n // 深色模式配置 - 使用 data-theme 属性，与 dark_mode 插件配合\n darkMode: ['selector', '[data-theme=\"dark\"]'],\n\n theme: {\n extend: {\n // 自定义颜色，使用CSS变量支持动态主题\n colors: {\n // 主题色系统\n primary: {\n 50: 'rgb(var(--color-primary-50) / )',\n 100: 'rgb(var(--color-primary-100) / )',\n 200: 'rgb(var(--color-primary-200) / )',\n 300: 'rgb(var(--color-primary-300) / )',\n 400: 'rgb(var(--color-primary-400) / )',\n 500: 'rgb(var(--color-primary-500) / )',\n 600: 'rgb(var(--color-primary-600) / )',\n 700: 'rgb(var(--color-primary-700) / )',\n 800: 'rgb(var(--color-primary-800) / )',\n 900: 'rgb(var(--color-primary-900) / )',\n },\n // 语义化颜色（对标 Next.js）\n border: 'rgb(var(--border) / )',\n input: 'rgb(var(--input) / )',\n ring: 'rgb(var(--ring) / )',\n background: 'rgb(var(--background) / )',\n foreground: 'rgb(var(--foreground) / )',\n card: {\n DEFAULT: 'rgb(var(--card) / )',\n foreground: 'rgb(var(--card-foreground) / )',\n },\n muted: {\n DEFAULT: 'rgb(var(--muted) / )',\n foreground: 'rgb(var(--muted-foreground) / )',\n },\n secondary: {\n DEFAULT: 'rgb(var(--secondary) / )',\n foreground: 'rgb(var(--secondary-foreground) / )',\n },\n accent: {\n DEFAULT: 'rgb(var(--accent) / )',\n foreground: 'rgb(var(--accent-foreground) / )',\n },\n destructive: {\n DEFAULT: 'rgb(var(--destructive) / )',\n foreground: 'rgb(var(--destructive-foreground) / )',\n },\n },\n\n // Z-index 层级定义\n zIndex: {\n 'modal': '9999', // 深色模式按钮等固定元素\n },\n\n // 字体家族\n fontFamily: {\n sans: ['Open Sans', 'Helvetica Neue', 'Helvetica', 'Arial', 'sans-serif'],\n mono: ['Consolas', 'Monaco', 'Courier New', 'monospace'],\n },\n\n // 容器最大宽度，与现有布局一致\n maxWidth: {\n 'site': '1040px',\n },\n\n // 动画\n animation: {\n 'fade-in': 'fadeIn 0.3s ease-in-out',\n 'slide-up': 'slideUp 0.3s ease-out',\n 'slide-down': 'slideDown 0.3s ease-out',\n },\n\n keyframes: {\n fadeIn: {\n '0%': { opacity: '0' },\n '100%': { opacity: '1' },\n },\n slideUp: {\n '0%': { transform: 'translateY(10px)', opacity: '0' },\n '100%': { transform: 'translateY(0)', opacity: '1' },\n },\n slideDown: {\n '0%': { transform: 'translateY(-10px)', opacity: '0' },\n '100%': { transform: 'translateY(0)', opacity: '1' },\n },\n },\n },\n },\n\n plugins: [\n require('@tailwindcss/typography'),\n ],\n};\n"
},
{
"path": "frontend/vite.config.js",
"content": "import { defineConfig } from 'vite';\nimport path from 'path';\n\nexport default defineConfig({\n // 构建配置\n build: {\n // 输出目录 - 直接输出到Django的static目录\n outDir: '../blog/static/blog/dist',\n // 清空输出目录\n emptyOutDir: true,\n // 生成manifest文件，方便Django引用\n manifest: true,\n // 压缩配置 - 最高级别\n minify: 'terser',\n terserOptions: {\n compress: {\n // 移除 console 和 debugger\n drop_console: true,\n drop_debugger: true,\n // 移除未使用的代码\n pure_funcs: ['console.log', 'console.info', 'console.debug', 'console.warn'],\n // 移除死代码\n dead_code: true,\n // 使用更激进的优化\n passes: 3,\n // 移除未使用的函数参数\n keep_fargs: false,\n // 移除未使用的函数名\n keep_fnames: false,\n // 移除未使用的类名\n keep_classnames: false,\n // 内联函数\n inline: 3,\n // 移除不可达代码\n conditionals: true,\n // 优化布尔表达式\n booleans: true,\n // 优化循环\n loops: true,\n // 合并变量声明\n join_vars: true,\n // 移除未使用的变量\n unused: true,\n // 折叠常量\n evaluate: true,\n // 优化 if 语句\n if_return: true,\n // 移除空语句\n sequences: true,\n // 压缩属性访问\n properties: true,\n },\n mangle: {\n // 混淆变量名\n toplevel: true,\n // 混淆属性名（谨慎使用）\n properties: false,\n // 保留类名（避免 Alpine.js 等框架问题）\n keep_classnames: false,\n keep_fnames: false,\n // Safari 10 兼容\n safari10: true,\n },\n format: {\n // 移除注释\n comments: false,\n // 使用 ASCII 输出\n ascii_only: true,\n // 紧凑输出\n beautify: false,\n // 压缩到极致\n ecma: 2020,\n },\n },\n // 启用 CSS 压缩\n cssMinify: true,\n // 代码分割阈值（字节）\n chunkSizeWarningLimit: 500,\n // 报告压缩后的大小\n reportCompressedSize: true,\n // Rollup 优化配置（合并后）\n rollupOptions: {\n input: {\n main: path.resolve(__dirname, 'src/main.js'),\n },\n output: {\n // 资源文件命名\n entryFileNames: 'js/[name]-[hash].js',\n chunkFileNames: 'js/[name]-[hash].js',\n assetFileNames: (assetInfo) => {\n // CSS文件放在css目录\n if (assetInfo.name.endsWith('.css')) {\n return 'css/[name]-[hash][extname]';\n }\n // 其他资源放在assets目录\n return 'assets/[name]-[hash][extname]';\n },\n // 手动代码分割\n manualChunks: (id) => {\n // 将 node_modules 中的包分离\n if (id.includes('node_modules')) {\n if (id.includes('alpinejs')) return 'alpine';\n if (id.includes('htmx')) return 'htmx';\n return 'vendor';\n }\n },\n // 最小化输出\n compact: true,\n // 不生成 sourcemap\n sourcemap: false,\n },\n },\n },\n\n // 开发服务器配置\n server: {\n port: 5173,\n host: true,\n // CORS配置，允许Django访问\n cors: true,\n // HMR配置\n hmr: {\n overlay: true,\n },\n },\n\n // 路径解析\n resolve: {\n alias: {\n '@': path.resolve(__dirname, 'src'),\n '@components': path.resolve(__dirname, 'src/components'),\n '@styles': path.resolve(__dirname, 'src/styles'),\n },\n },\n\n // CSS配置\n css: {\n postcss: './postcss.config.js',\n },\n});\n"
},
{
"path": "locale/en/LC_MESSAGES/django.po",
"content": "# SOME DESCRIPTIVE TITLE.\n# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER\n# This file is distributed under the same license as the PACKAGE package.\n# FIRST AUTHOR , YEAR.\n#\n#, fuzzy\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: PACKAGE VERSION\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2023-09-13 16:02+0800\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: LANGUAGE \\n\"\n\"Language: \\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=2; plural=(n != 1);\\n\"\n\n#: .\\accounts\\admin.py:12\nmsgid \"password\"\nmsgstr \"password\"\n\n#: .\\accounts\\admin.py:13\nmsgid \"Enter password again\"\nmsgstr \"Enter password again\"\n\n#: .\\accounts\\admin.py:24 .\\accounts\\forms.py:89\nmsgid \"passwords do not match\"\nmsgstr \"passwords do not match\"\n\n#: .\\accounts\\forms.py:36\nmsgid \"email already exists\"\nmsgstr \"email already exists\"\n\n#: .\\accounts\\forms.py:46 .\\accounts\\forms.py:50\nmsgid \"New password\"\nmsgstr \"New password\"\n\n#: .\\accounts\\forms.py:60\nmsgid \"Confirm password\"\nmsgstr \"Confirm password\"\n\n#: .\\accounts\\forms.py:70 .\\accounts\\forms.py:116\nmsgid \"Email\"\nmsgstr \"Email\"\n\n#: .\\accounts\\forms.py:76 .\\accounts\\forms.py:80\nmsgid \"Code\"\nmsgstr \"Code\"\n\n#: .\\accounts\\forms.py:100 .\\accounts\\tests.py:194\nmsgid \"email does not exist\"\nmsgstr \"email does not exist\"\n\n#: .\\accounts\\models.py:12 .\\oauth\\models.py:17\nmsgid \"nick name\"\nmsgstr \"nick name\"\n\n#: .\\accounts\\models.py:13 .\\blog\\models.py:29 .\\blog\\models.py:266\n#: .\\blog\\models.py:284 .\\comments\\models.py:13 .\\oauth\\models.py:23\n#: .\\oauth\\models.py:53\nmsgid \"creation time\"\nmsgstr \"creation time\"\n\n#: .\\accounts\\models.py:14 .\\comments\\models.py:14 .\\oauth\\models.py:24\n#: .\\oauth\\models.py:54\nmsgid \"last modify time\"\nmsgstr \"last modify time\"\n\n#: .\\accounts\\models.py:15\nmsgid \"create source\"\nmsgstr \"create source\"\n\n#: .\\accounts\\models.py:33 .\\djangoblog\\logentryadmin.py:81\nmsgid \"user\"\nmsgstr \"user\"\n\n#: .\\accounts\\tests.py:216 .\\accounts\\utils.py:39\nmsgid \"Verification code error\"\nmsgstr \"Verification code error\"\n\n#: .\\accounts\\utils.py:13\nmsgid \"Verify Email\"\nmsgstr \"Verify Email\"\n\n#: .\\accounts\\utils.py:21\n#, python-format\nmsgid \"\"\n\"You are resetting the password, the verification code is：%(code)s, valid \"\n\"within 5 minutes, please keep it properly\"\nmsgstr \"\"\n\"You are resetting the password, the verification code is：%(code)s, valid \"\n\"within 5 minutes, please keep it properly\"\n\n#: .\\blog\\admin.py:13 .\\blog\\models.py:92 .\\comments\\models.py:17\n#: .\\oauth\\models.py:12\nmsgid \"author\"\nmsgstr \"author\"\n\n#: .\\blog\\admin.py:53\nmsgid \"Publish selected articles\"\nmsgstr \"Publish selected articles\"\n\n#: .\\blog\\admin.py:54\nmsgid \"Draft selected articles\"\nmsgstr \"Draft selected articles\"\n\n#: .\\blog\\admin.py:55\nmsgid \"Close article comments\"\nmsgstr \"Close article comments\"\n\n#: .\\blog\\admin.py:56\nmsgid \"Open article comments\"\nmsgstr \"Open article comments\"\n\n#: .\\blog\\admin.py:89 .\\blog\\models.py:101 .\\blog\\models.py:183\n#: .\\templates\\blog\\tags\\sidebar.html:40\nmsgid \"category\"\nmsgstr \"category\"\n\n#: .\\blog\\models.py:20 .\\blog\\models.py:179 .\\templates\\share_layout\\nav.html:8\nmsgid \"index\"\nmsgstr \"index\"\n\n#: .\\blog\\models.py:21\nmsgid \"list\"\nmsgstr \"list\"\n\n#: .\\blog\\models.py:22\nmsgid \"post\"\nmsgstr \"post\"\n\n#: .\\blog\\models.py:23\nmsgid \"all\"\nmsgstr \"all\"\n\n#: .\\blog\\models.py:24\nmsgid \"slide\"\nmsgstr \"slide\"\n\n#: .\\blog\\models.py:30 .\\blog\\models.py:267 .\\blog\\models.py:285\nmsgid \"modify time\"\nmsgstr \"modify time\"\n\n#: .\\blog\\models.py:63\nmsgid \"Draft\"\nmsgstr \"Draft\"\n\n#: .\\blog\\models.py:64\nmsgid \"Published\"\nmsgstr \"Published\"\n\n#: .\\blog\\models.py:67\nmsgid \"Open\"\nmsgstr \"Open\"\n\n#: .\\blog\\models.py:68\nmsgid \"Close\"\nmsgstr \"Close\"\n\n#: .\\blog\\models.py:71 .\\comments\\admin.py:47\nmsgid \"Article\"\nmsgstr \"Article\"\n\n#: .\\blog\\models.py:72\nmsgid \"Page\"\nmsgstr \"Page\"\n\n#: .\\blog\\models.py:74 .\\blog\\models.py:280\nmsgid \"title\"\nmsgstr \"title\"\n\n#: .\\blog\\models.py:75\nmsgid \"body\"\nmsgstr \"body\"\n\n#: .\\blog\\models.py:77\nmsgid \"publish time\"\nmsgstr \"publish time\"\n\n#: .\\blog\\models.py:79\nmsgid \"status\"\nmsgstr \"status\"\n\n#: .\\blog\\models.py:84\nmsgid \"comment status\"\nmsgstr \"comment status\"\n\n#: .\\blog\\models.py:88 .\\oauth\\models.py:43\nmsgid \"type\"\nmsgstr \"type\"\n\n#: .\\blog\\models.py:89\nmsgid \"views\"\nmsgstr \"views\"\n\n#: .\\blog\\models.py:97 .\\blog\\models.py:258 .\\blog\\models.py:282\nmsgid \"order\"\nmsgstr \"order\"\n\n#: .\\blog\\models.py:98\nmsgid \"show toc\"\nmsgstr \"show toc\"\n\n#: .\\blog\\models.py:105 .\\blog\\models.py:249\nmsgid \"tag\"\nmsgstr \"tag\"\n\n#: .\\blog\\models.py:115 .\\comments\\models.py:21\nmsgid \"article\"\nmsgstr \"article\"\n\n#: .\\blog\\models.py:171\nmsgid \"category name\"\nmsgstr \"category name\"\n\n#: .\\blog\\models.py:174\nmsgid \"parent category\"\nmsgstr \"parent category\"\n\n#: .\\blog\\models.py:234\nmsgid \"tag name\"\nmsgstr \"tag name\"\n\n#: .\\blog\\models.py:256\nmsgid \"link name\"\nmsgstr \"link name\"\n\n#: .\\blog\\models.py:257 .\\blog\\models.py:271\nmsgid \"link\"\nmsgstr \"link\"\n\n#: .\\blog\\models.py:260\nmsgid \"is show\"\nmsgstr \"is show\"\n\n#: .\\blog\\models.py:262\nmsgid \"show type\"\nmsgstr \"show type\"\n\n#: .\\blog\\models.py:281\nmsgid \"content\"\nmsgstr \"content\"\n\n#: .\\blog\\models.py:283 .\\oauth\\models.py:52\nmsgid \"is enable\"\nmsgstr \"is enable\"\n\n#: .\\blog\\models.py:289\nmsgid \"sidebar\"\nmsgstr \"sidebar\"\n\n#: .\\blog\\models.py:299\nmsgid \"site name\"\nmsgstr \"site name\"\n\n#: .\\blog\\models.py:305\nmsgid \"site description\"\nmsgstr \"site description\"\n\n#: .\\blog\\models.py:311\nmsgid \"site seo description\"\nmsgstr \"site seo description\"\n\n#: .\\blog\\models.py:313\nmsgid \"site keywords\"\nmsgstr \"site keywords\"\n\n#: .\\blog\\models.py:318\nmsgid \"article sub length\"\nmsgstr \"article sub length\"\n\n#: .\\blog\\models.py:319\nmsgid \"sidebar article count\"\nmsgstr \"sidebar article count\"\n\n#: .\\blog\\models.py:320\nmsgid \"sidebar comment count\"\nmsgstr \"sidebar comment count\"\n\n#: .\\blog\\models.py:321\nmsgid \"article comment count\"\nmsgstr \"article comment count\"\n\n#: .\\blog\\models.py:322\nmsgid \"show adsense\"\nmsgstr \"show adsense\"\n\n#: .\\blog\\models.py:324\nmsgid \"adsense code\"\nmsgstr \"adsense code\"\n\n#: .\\blog\\models.py:325\nmsgid \"open site comment\"\nmsgstr \"open site comment\"\n\n#: .\\blog\\models.py:352\nmsgid \"Website configuration\"\nmsgstr \"Website configuration\"\n\n#: .\\blog\\models.py:360\nmsgid \"There can only be one configuration\"\nmsgstr \"There can only be one configuration\"\n\n#: .\\blog\\views.py:348\nmsgid \"\"\n\"Sorry, the page you requested is not found, please click the home page to \"\n\"see other?\"\nmsgstr \"\"\n\"Sorry, the page you requested is not found, please click the home page to \"\n\"see other?\"\n\n#: .\\blog\\views.py:356\nmsgid \"Sorry, the server is busy, please click the home page to see other?\"\nmsgstr \"Sorry, the server is busy, please click the home page to see other?\"\n\n#: .\\blog\\views.py:369\nmsgid \"Sorry, you do not have permission to access this page?\"\nmsgstr \"Sorry, you do not have permission to access this page?\"\n\n#: .\\comments\\admin.py:15\nmsgid \"Disable comments\"\nmsgstr \"Disable comments\"\n\n#: .\\comments\\admin.py:16\nmsgid \"Enable comments\"\nmsgstr \"Enable comments\"\n\n#: .\\comments\\admin.py:46\nmsgid \"User\"\nmsgstr \"User\"\n\n#: .\\comments\\models.py:25\nmsgid \"parent comment\"\nmsgstr \"parent comment\"\n\n#: .\\comments\\models.py:29\nmsgid \"enable\"\nmsgstr \"enable\"\n\n#: .\\comments\\models.py:34 .\\templates\\blog\\tags\\article_info.html:30\nmsgid \"comment\"\nmsgstr \"comment\"\n\n#: .\\comments\\utils.py:13\nmsgid \"Thanks for your comment\"\nmsgstr \"Thanks for your comment\"\n\n#: .\\comments\\utils.py:15\n#, python-format\nmsgid \"\"\n\"Thank you very much for your comments on this site
\\n\"\n\" You can visit %(article_title)s \\n\"\n\" to review your comments,\\n\"\n\" Thank you again!\\n\"\n\" Thank you very much for your comments on this site
\\n\"\n\" You can visit %(article_title)s \\n\"\n\" to review your comments,\\n\"\n\" Thank you again!\\n\"\n\" \"\n\"%(article_title)s \"\n\"%(article_title)s Congratulations, you have successfully bound your email address. You \"\n\"can use\\n\"\n\" %(oauthuser_type)s to directly log in to this website without a \"\n\"password.
\\n\"\n\" You are welcome to continue to follow this site, the address is\\n\"\n\" %(site)s \\n\"\n\" Thank you again!\\n\"\n\" Congratulations, you have successfully bound your email address. You \"\n\"can use\\n\"\n\" %(oauthuser_type)s to directly log in to this website without a \"\n\"password.
\\n\"\n\" You are welcome to continue to follow this site, the address is\\n\"\n\" %(site)s \\n\"\n\" Thank you again!\\n\"\n\" Please click the link below to bind your email
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\" Thank you again!\\n\"\n\" Please click the link below to bind your email
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\" Thank you again!\\n\"\n\" , YEAR.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: PACKAGE VERSION\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2023-09-13 16:02+0800\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: LANGUAGE \\n\"\n\"Language: \\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\n#: .\\accounts\\admin.py:12\nmsgid \"password\"\nmsgstr \"密码\"\n\n#: .\\accounts\\admin.py:13\nmsgid \"Enter password again\"\nmsgstr \"再次输入密码\"\n\n#: .\\accounts\\admin.py:24 .\\accounts\\forms.py:89\nmsgid \"passwords do not match\"\nmsgstr \"密码不匹配\"\n\n#: .\\accounts\\forms.py:36\nmsgid \"email already exists\"\nmsgstr \"邮箱已存在\"\n\n#: .\\accounts\\forms.py:46 .\\accounts\\forms.py:50\nmsgid \"New password\"\nmsgstr \"新密码\"\n\n#: .\\accounts\\forms.py:60\nmsgid \"Confirm password\"\nmsgstr \"确认密码\"\n\n#: .\\accounts\\forms.py:70 .\\accounts\\forms.py:116\nmsgid \"Email\"\nmsgstr \"邮箱\"\n\n#: .\\accounts\\forms.py:76 .\\accounts\\forms.py:80\nmsgid \"Code\"\nmsgstr \"验证码\"\n\n#: .\\accounts\\forms.py:100 .\\accounts\\tests.py:194\nmsgid \"email does not exist\"\nmsgstr \"邮箱不存在\"\n\n#: .\\accounts\\models.py:12 .\\oauth\\models.py:17\nmsgid \"nick name\"\nmsgstr \"昵称\"\n\n#: .\\accounts\\models.py:13 .\\blog\\models.py:29 .\\blog\\models.py:266\n#: .\\blog\\models.py:284 .\\comments\\models.py:13 .\\oauth\\models.py:23\n#: .\\oauth\\models.py:53\nmsgid \"creation time\"\nmsgstr \"创建时间\"\n\n#: .\\accounts\\models.py:14 .\\comments\\models.py:14 .\\oauth\\models.py:24\n#: .\\oauth\\models.py:54\nmsgid \"last modify time\"\nmsgstr \"最后修改时间\"\n\n#: .\\accounts\\models.py:15\nmsgid \"create source\"\nmsgstr \"来源\"\n\n#: .\\accounts\\models.py:33 .\\djangoblog\\logentryadmin.py:81\nmsgid \"user\"\nmsgstr \"用户\"\n\n#: .\\accounts\\tests.py:216 .\\accounts\\utils.py:39\nmsgid \"Verification code error\"\nmsgstr \"验证码错误\"\n\n#: .\\accounts\\utils.py:13\nmsgid \"Verify Email\"\nmsgstr \"验证邮箱\"\n\n#: .\\accounts\\utils.py:21\n#, python-format\nmsgid \"\"\n\"You are resetting the password, the verification code is：%(code)s, valid \"\n\"within 5 minutes, please keep it properly\"\nmsgstr \"您正在重置密码，验证码为：%(code)s，5分钟内有效 请妥善保管.\"\n\n#: .\\blog\\admin.py:13 .\\blog\\models.py:92 .\\comments\\models.py:17\n#: .\\oauth\\models.py:12\nmsgid \"author\"\nmsgstr \"作者\"\n\n#: .\\blog\\admin.py:53\nmsgid \"Publish selected articles\"\nmsgstr \"发布选中的文章\"\n\n#: .\\blog\\admin.py:54\nmsgid \"Draft selected articles\"\nmsgstr \"选中文章设为草稿\"\n\n#: .\\blog\\admin.py:55\nmsgid \"Close article comments\"\nmsgstr \"关闭文章评论\"\n\n#: .\\blog\\admin.py:56\nmsgid \"Open article comments\"\nmsgstr \"打开文章评论\"\n\n#: .\\blog\\admin.py:89 .\\blog\\models.py:101 .\\blog\\models.py:183\n#: .\\templates\\blog\\tags\\sidebar.html:40\nmsgid \"category\"\nmsgstr \"分类目录\"\n\n#: .\\blog\\models.py:20 .\\blog\\models.py:179 .\\templates\\share_layout\\nav.html:8\nmsgid \"index\"\nmsgstr \"首页\"\n\n#: .\\blog\\models.py:21\nmsgid \"list\"\nmsgstr \"列表\"\n\n#: .\\blog\\models.py:22\nmsgid \"post\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:23\nmsgid \"all\"\nmsgstr \"所有\"\n\n#: .\\blog\\models.py:24\nmsgid \"slide\"\nmsgstr \"侧边栏\"\n\n#: .\\blog\\models.py:30 .\\blog\\models.py:267 .\\blog\\models.py:285\nmsgid \"modify time\"\nmsgstr \"修改时间\"\n\n#: .\\blog\\models.py:63\nmsgid \"Draft\"\nmsgstr \"草稿\"\n\n#: .\\blog\\models.py:64\nmsgid \"Published\"\nmsgstr \"发布\"\n\n#: .\\blog\\models.py:67\nmsgid \"Open\"\nmsgstr \"打开\"\n\n#: .\\blog\\models.py:68\nmsgid \"Close\"\nmsgstr \"关闭\"\n\n#: .\\blog\\models.py:71 .\\comments\\admin.py:47\nmsgid \"Article\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:72\nmsgid \"Page\"\nmsgstr \"页面\"\n\n#: .\\blog\\models.py:74 .\\blog\\models.py:280\nmsgid \"title\"\nmsgstr \"标题\"\n\n#: .\\blog\\models.py:75\nmsgid \"body\"\nmsgstr \"内容\"\n\n#: .\\blog\\models.py:77\nmsgid \"publish time\"\nmsgstr \"发布时间\"\n\n#: .\\blog\\models.py:79\nmsgid \"status\"\nmsgstr \"状态\"\n\n#: .\\blog\\models.py:84\nmsgid \"comment status\"\nmsgstr \"评论状态\"\n\n#: .\\blog\\models.py:88 .\\oauth\\models.py:43\nmsgid \"type\"\nmsgstr \"类型\"\n\n#: .\\blog\\models.py:89\nmsgid \"views\"\nmsgstr \"阅读量\"\n\n#: .\\blog\\models.py:97 .\\blog\\models.py:258 .\\blog\\models.py:282\nmsgid \"order\"\nmsgstr \"排序\"\n\n#: .\\blog\\models.py:98\nmsgid \"show toc\"\nmsgstr \"显示目录\"\n\n#: .\\blog\\models.py:105 .\\blog\\models.py:249\nmsgid \"tag\"\nmsgstr \"标签\"\n\n#: .\\blog\\models.py:115 .\\comments\\models.py:21\nmsgid \"article\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:171\nmsgid \"category name\"\nmsgstr \"分类名\"\n\n#: .\\blog\\models.py:174\nmsgid \"parent category\"\nmsgstr \"上级分类\"\n\n#: .\\blog\\models.py:234\nmsgid \"tag name\"\nmsgstr \"标签名\"\n\n#: .\\blog\\models.py:256\nmsgid \"link name\"\nmsgstr \"链接名\"\n\n#: .\\blog\\models.py:257 .\\blog\\models.py:271\nmsgid \"link\"\nmsgstr \"链接\"\n\n#: .\\blog\\models.py:260\nmsgid \"is show\"\nmsgstr \"是否显示\"\n\n#: .\\blog\\models.py:262\nmsgid \"show type\"\nmsgstr \"显示类型\"\n\n#: .\\blog\\models.py:281\nmsgid \"content\"\nmsgstr \"内容\"\n\n#: .\\blog\\models.py:283 .\\oauth\\models.py:52\nmsgid \"is enable\"\nmsgstr \"是否启用\"\n\n#: .\\blog\\models.py:289\nmsgid \"sidebar\"\nmsgstr \"侧边栏\"\n\n#: .\\blog\\models.py:299\nmsgid \"site name\"\nmsgstr \"站点名称\"\n\n#: .\\blog\\models.py:305\nmsgid \"site description\"\nmsgstr \"站点描述\"\n\n#: .\\blog\\models.py:311\nmsgid \"site seo description\"\nmsgstr \"站点SEO描述\"\n\n#: .\\blog\\models.py:313\nmsgid \"site keywords\"\nmsgstr \"关键字\"\n\n#: .\\blog\\models.py:318\nmsgid \"article sub length\"\nmsgstr \"文章摘要长度\"\n\n#: .\\blog\\models.py:319\nmsgid \"sidebar article count\"\nmsgstr \"侧边栏文章数目\"\n\n#: .\\blog\\models.py:320\nmsgid \"sidebar comment count\"\nmsgstr \"侧边栏评论数目\"\n\n#: .\\blog\\models.py:321\nmsgid \"article comment count\"\nmsgstr \"文章页面默认显示评论数目\"\n\n#: .\\blog\\models.py:322\nmsgid \"show adsense\"\nmsgstr \"是否显示广告\"\n\n#: .\\blog\\models.py:324\nmsgid \"adsense code\"\nmsgstr \"广告内容\"\n\n#: .\\blog\\models.py:325\nmsgid \"open site comment\"\nmsgstr \"公共头部\"\n\n#: .\\blog\\models.py:352\nmsgid \"Website configuration\"\nmsgstr \"网站配置\"\n\n#: .\\blog\\models.py:360\nmsgid \"There can only be one configuration\"\nmsgstr \"只能有一个配置\"\n\n#: .\\blog\\views.py:348\nmsgid \"\"\n\"Sorry, the page you requested is not found, please click the home page to \"\n\"see other?\"\nmsgstr \"抱歉，你所访问的页面找不到，请点击首页看看别的？\"\n\n#: .\\blog\\views.py:356\nmsgid \"Sorry, the server is busy, please click the home page to see other?\"\nmsgstr \"抱歉，服务出错了，请点击首页看看别的？\"\n\n#: .\\blog\\views.py:369\nmsgid \"Sorry, you do not have permission to access this page?\"\nmsgstr \"抱歉，你没用权限访问此页面。\"\n\n#: .\\comments\\admin.py:15\nmsgid \"Disable comments\"\nmsgstr \"禁用评论\"\n\n#: .\\comments\\admin.py:16\nmsgid \"Enable comments\"\nmsgstr \"启用评论\"\n\n#: .\\comments\\admin.py:46\nmsgid \"User\"\nmsgstr \"用户\"\n\n#: .\\comments\\models.py:25\nmsgid \"parent comment\"\nmsgstr \"上级评论\"\n\n#: .\\comments\\models.py:29\nmsgid \"enable\"\nmsgstr \"启用\"\n\n#: .\\comments\\models.py:34 .\\templates\\blog\\tags\\article_info.html:30\nmsgid \"comment\"\nmsgstr \"评论\"\n\n#: .\\comments\\utils.py:13\nmsgid \"Thanks for your comment\"\nmsgstr \"感谢你的评论\"\n\n#: .\\comments\\utils.py:15\n#, python-format\nmsgid \"\"\n\"Thank you very much for your comments on this site
\\n\"\n\" You can visit %(article_title)s \\n\"\n\" to review your comments,\\n\"\n\" Thank you again!\\n\"\n\" 非常感谢您对此网站的评论
\\n\"\n\" 您可以访问%(article_title)s \\n\"\n\"查看您的评论，\\n\"\n\"再次感谢您！\\n\"\n\" \"\n\"%(article_title)s %(article_title)s Congratulations, you have successfully bound your email address. You \"\n\"can use\\n\"\n\" %(oauthuser_type)s to directly log in to this website without a \"\n\"password.
\\n\"\n\" You are welcome to continue to follow this site, the address is\\n\"\n\" %(site)s \\n\"\n\" Thank you again!\\n\"\n\" 恭喜你已经绑定成功 你可以使用\\n\"\n\" %(oauthuser_type)s 来免密登录本站
\\n\"\n\" 欢迎继续关注本站, 地址是\\n\"\n\" %(site)s \\n\"\n\" 再次感谢你\\n\"\n\" Please click the link below to bind your email
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\" Thank you again!\\n\"\n\" 请点击下面的链接绑定您的邮箱
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\"再次感谢您！\\n\"\n\" , YEAR.\n#\nmsgid \"\"\nmsgstr \"\"\n\"Project-Id-Version: PACKAGE VERSION\\n\"\n\"Report-Msgid-Bugs-To: \\n\"\n\"POT-Creation-Date: 2023-09-13 16:02+0800\\n\"\n\"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n\"\n\"Last-Translator: FULL NAME \\n\"\n\"Language-Team: LANGUAGE \\n\"\n\"Language: \\n\"\n\"MIME-Version: 1.0\\n\"\n\"Content-Type: text/plain; charset=UTF-8\\n\"\n\"Content-Transfer-Encoding: 8bit\\n\"\n\"Plural-Forms: nplurals=1; plural=0;\\n\"\n\n#: .\\accounts\\admin.py:12\nmsgid \"password\"\nmsgstr \"密碼\"\n\n#: .\\accounts\\admin.py:13\nmsgid \"Enter password again\"\nmsgstr \"再次輸入密碼\"\n\n#: .\\accounts\\admin.py:24 .\\accounts\\forms.py:89\nmsgid \"passwords do not match\"\nmsgstr \"密碼不匹配\"\n\n#: .\\accounts\\forms.py:36\nmsgid \"email already exists\"\nmsgstr \"郵箱已存在\"\n\n#: .\\accounts\\forms.py:46 .\\accounts\\forms.py:50\nmsgid \"New password\"\nmsgstr \"新密碼\"\n\n#: .\\accounts\\forms.py:60\nmsgid \"Confirm password\"\nmsgstr \"確認密碼\"\n\n#: .\\accounts\\forms.py:70 .\\accounts\\forms.py:116\nmsgid \"Email\"\nmsgstr \"郵箱\"\n\n#: .\\accounts\\forms.py:76 .\\accounts\\forms.py:80\nmsgid \"Code\"\nmsgstr \"驗證碼\"\n\n#: .\\accounts\\forms.py:100 .\\accounts\\tests.py:194\nmsgid \"email does not exist\"\nmsgstr \"郵箱不存在\"\n\n#: .\\accounts\\models.py:12 .\\oauth\\models.py:17\nmsgid \"nick name\"\nmsgstr \"昵稱\"\n\n#: .\\accounts\\models.py:13 .\\blog\\models.py:29 .\\blog\\models.py:266\n#: .\\blog\\models.py:284 .\\comments\\models.py:13 .\\oauth\\models.py:23\n#: .\\oauth\\models.py:53\nmsgid \"creation time\"\nmsgstr \"創建時間\"\n\n#: .\\accounts\\models.py:14 .\\comments\\models.py:14 .\\oauth\\models.py:24\n#: .\\oauth\\models.py:54\nmsgid \"last modify time\"\nmsgstr \"最後修改時間\"\n\n#: .\\accounts\\models.py:15\nmsgid \"create source\"\nmsgstr \"來源\"\n\n#: .\\accounts\\models.py:33 .\\djangoblog\\logentryadmin.py:81\nmsgid \"user\"\nmsgstr \"用戶\"\n\n#: .\\accounts\\tests.py:216 .\\accounts\\utils.py:39\nmsgid \"Verification code error\"\nmsgstr \"驗證碼錯誤\"\n\n#: .\\accounts\\utils.py:13\nmsgid \"Verify Email\"\nmsgstr \"驗證郵箱\"\n\n#: .\\accounts\\utils.py:21\n#, python-format\nmsgid \"\"\n\"You are resetting the password, the verification code is：%(code)s, valid \"\n\"within 5 minutes, please keep it properly\"\nmsgstr \"您正在重置密碼，驗證碼為：%(code)s，5分鐘內有效 請妥善保管.\"\n\n#: .\\blog\\admin.py:13 .\\blog\\models.py:92 .\\comments\\models.py:17\n#: .\\oauth\\models.py:12\nmsgid \"author\"\nmsgstr \"作者\"\n\n#: .\\blog\\admin.py:53\nmsgid \"Publish selected articles\"\nmsgstr \"發布選中的文章\"\n\n#: .\\blog\\admin.py:54\nmsgid \"Draft selected articles\"\nmsgstr \"選中文章設為草稿\"\n\n#: .\\blog\\admin.py:55\nmsgid \"Close article comments\"\nmsgstr \"關閉文章評論\"\n\n#: .\\blog\\admin.py:56\nmsgid \"Open article comments\"\nmsgstr \"打開文章評論\"\n\n#: .\\blog\\admin.py:89 .\\blog\\models.py:101 .\\blog\\models.py:183\n#: .\\templates\\blog\\tags\\sidebar.html:40\nmsgid \"category\"\nmsgstr \"分類目錄\"\n\n#: .\\blog\\models.py:20 .\\blog\\models.py:179 .\\templates\\share_layout\\nav.html:8\nmsgid \"index\"\nmsgstr \"首頁\"\n\n#: .\\blog\\models.py:21\nmsgid \"list\"\nmsgstr \"列表\"\n\n#: .\\blog\\models.py:22\nmsgid \"post\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:23\nmsgid \"all\"\nmsgstr \"所有\"\n\n#: .\\blog\\models.py:24\nmsgid \"slide\"\nmsgstr \"側邊欄\"\n\n#: .\\blog\\models.py:30 .\\blog\\models.py:267 .\\blog\\models.py:285\nmsgid \"modify time\"\nmsgstr \"修改時間\"\n\n#: .\\blog\\models.py:63\nmsgid \"Draft\"\nmsgstr \"草稿\"\n\n#: .\\blog\\models.py:64\nmsgid \"Published\"\nmsgstr \"發布\"\n\n#: .\\blog\\models.py:67\nmsgid \"Open\"\nmsgstr \"打開\"\n\n#: .\\blog\\models.py:68\nmsgid \"Close\"\nmsgstr \"關閉\"\n\n#: .\\blog\\models.py:71 .\\comments\\admin.py:47\nmsgid \"Article\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:72\nmsgid \"Page\"\nmsgstr \"頁面\"\n\n#: .\\blog\\models.py:74 .\\blog\\models.py:280\nmsgid \"title\"\nmsgstr \"標題\"\n\n#: .\\blog\\models.py:75\nmsgid \"body\"\nmsgstr \"內容\"\n\n#: .\\blog\\models.py:77\nmsgid \"publish time\"\nmsgstr \"發布時間\"\n\n#: .\\blog\\models.py:79\nmsgid \"status\"\nmsgstr \"狀態\"\n\n#: .\\blog\\models.py:84\nmsgid \"comment status\"\nmsgstr \"評論狀態\"\n\n#: .\\blog\\models.py:88 .\\oauth\\models.py:43\nmsgid \"type\"\nmsgstr \"類型\"\n\n#: .\\blog\\models.py:89\nmsgid \"views\"\nmsgstr \"閱讀量\"\n\n#: .\\blog\\models.py:97 .\\blog\\models.py:258 .\\blog\\models.py:282\nmsgid \"order\"\nmsgstr \"排序\"\n\n#: .\\blog\\models.py:98\nmsgid \"show toc\"\nmsgstr \"顯示目錄\"\n\n#: .\\blog\\models.py:105 .\\blog\\models.py:249\nmsgid \"tag\"\nmsgstr \"標簽\"\n\n#: .\\blog\\models.py:115 .\\comments\\models.py:21\nmsgid \"article\"\nmsgstr \"文章\"\n\n#: .\\blog\\models.py:171\nmsgid \"category name\"\nmsgstr \"分類名\"\n\n#: .\\blog\\models.py:174\nmsgid \"parent category\"\nmsgstr \"上級分類\"\n\n#: .\\blog\\models.py:234\nmsgid \"tag name\"\nmsgstr \"標簽名\"\n\n#: .\\blog\\models.py:256\nmsgid \"link name\"\nmsgstr \"鏈接名\"\n\n#: .\\blog\\models.py:257 .\\blog\\models.py:271\nmsgid \"link\"\nmsgstr \"鏈接\"\n\n#: .\\blog\\models.py:260\nmsgid \"is show\"\nmsgstr \"是否顯示\"\n\n#: .\\blog\\models.py:262\nmsgid \"show type\"\nmsgstr \"顯示類型\"\n\n#: .\\blog\\models.py:281\nmsgid \"content\"\nmsgstr \"內容\"\n\n#: .\\blog\\models.py:283 .\\oauth\\models.py:52\nmsgid \"is enable\"\nmsgstr \"是否啟用\"\n\n#: .\\blog\\models.py:289\nmsgid \"sidebar\"\nmsgstr \"側邊欄\"\n\n#: .\\blog\\models.py:299\nmsgid \"site name\"\nmsgstr \"站點名稱\"\n\n#: .\\blog\\models.py:305\nmsgid \"site description\"\nmsgstr \"站點描述\"\n\n#: .\\blog\\models.py:311\nmsgid \"site seo description\"\nmsgstr \"站點SEO描述\"\n\n#: .\\blog\\models.py:313\nmsgid \"site keywords\"\nmsgstr \"關鍵字\"\n\n#: .\\blog\\models.py:318\nmsgid \"article sub length\"\nmsgstr \"文章摘要長度\"\n\n#: .\\blog\\models.py:319\nmsgid \"sidebar article count\"\nmsgstr \"側邊欄文章數目\"\n\n#: .\\blog\\models.py:320\nmsgid \"sidebar comment count\"\nmsgstr \"側邊欄評論數目\"\n\n#: .\\blog\\models.py:321\nmsgid \"article comment count\"\nmsgstr \"文章頁面默認顯示評論數目\"\n\n#: .\\blog\\models.py:322\nmsgid \"show adsense\"\nmsgstr \"是否顯示廣告\"\n\n#: .\\blog\\models.py:324\nmsgid \"adsense code\"\nmsgstr \"廣告內容\"\n\n#: .\\blog\\models.py:325\nmsgid \"open site comment\"\nmsgstr \"公共頭部\"\n\n#: .\\blog\\models.py:352\nmsgid \"Website configuration\"\nmsgstr \"網站配置\"\n\n#: .\\blog\\models.py:360\nmsgid \"There can only be one configuration\"\nmsgstr \"只能有一個配置\"\n\n#: .\\blog\\views.py:348\nmsgid \"\"\n\"Sorry, the page you requested is not found, please click the home page to \"\n\"see other?\"\nmsgstr \"抱歉，你所訪問的頁面找不到，請點擊首頁看看別的？\"\n\n#: .\\blog\\views.py:356\nmsgid \"Sorry, the server is busy, please click the home page to see other?\"\nmsgstr \"抱歉，服務出錯了，請點擊首頁看看別的？\"\n\n#: .\\blog\\views.py:369\nmsgid \"Sorry, you do not have permission to access this page?\"\nmsgstr \"抱歉，你沒用權限訪問此頁面。\"\n\n#: .\\comments\\admin.py:15\nmsgid \"Disable comments\"\nmsgstr \"禁用評論\"\n\n#: .\\comments\\admin.py:16\nmsgid \"Enable comments\"\nmsgstr \"啟用評論\"\n\n#: .\\comments\\admin.py:46\nmsgid \"User\"\nmsgstr \"用戶\"\n\n#: .\\comments\\models.py:25\nmsgid \"parent comment\"\nmsgstr \"上級評論\"\n\n#: .\\comments\\models.py:29\nmsgid \"enable\"\nmsgstr \"啟用\"\n\n#: .\\comments\\models.py:34 .\\templates\\blog\\tags\\article_info.html:30\nmsgid \"comment\"\nmsgstr \"評論\"\n\n#: .\\comments\\utils.py:13\nmsgid \"Thanks for your comment\"\nmsgstr \"感謝你的評論\"\n\n#: .\\comments\\utils.py:15\n#, python-format\nmsgid \"\"\n\"Thank you very much for your comments on this site
\\n\"\n\" You can visit %(article_title)s \\n\"\n\" to review your comments,\\n\"\n\" Thank you again!\\n\"\n\" 非常感謝您對此網站的評論
\\n\"\n\" 您可以訪問%(article_title)s \\n\"\n\"查看您的評論，\\n\"\n\"再次感謝您！\\n\"\n\" \"\n\"%(article_title)s %(article_title)s Congratulations, you have successfully bound your email address. You \"\n\"can use\\n\"\n\" %(oauthuser_type)s to directly log in to this website without a \"\n\"password.
\\n\"\n\" You are welcome to continue to follow this site, the address is\\n\"\n\" %(site)s \\n\"\n\" Thank you again!\\n\"\n\" 恭喜你已經綁定成功 你可以使用\\n\"\n\" %(oauthuser_type)s 來免密登錄本站
\\n\"\n\" 歡迎繼續關註本站, 地址是\\n\"\n\" %(site)s \\n\"\n\" 再次感謝你\\n\"\n\" Please click the link below to bind your email
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\" Thank you again!\\n\"\n\" 請點擊下面的鏈接綁定您的郵箱
\\n\"\n\"\\n\"\n\" %(url)s \\n\"\n\"\\n\"\n\"再次感謝您！\\n\"\n\" %s ' %\n (link, obj.author.nickname if obj.author.nickname else obj.author.email))\n\n def show_user_image(self, obj):\n img = obj.picture\n return format_html(\n u'.html',\n views.RequireEmailView.as_view(),\n name='require_email'),\n path(\n r'oauth/emailconfirm//.html',\n views.emailconfirm,\n name='email_confirm'),\n path(\n r'oauth/bindsuccess/.html',\n views.bindsuccess,\n name='bindsuccess'),\n path(\n r'oauth/oauthlogin',\n views.oauthlogin,\n name='oauthlogin')]\n"
},
{
"path": "oauth/views.py",
"content": "import logging\n# Create your views here.\nfrom urllib.parse import urlparse\n\nfrom django.conf import settings\nfrom django.contrib.auth import get_user_model\nfrom django.contrib.auth import login\nfrom django.core.exceptions import ObjectDoesNotExist\nfrom django.db import transaction\nfrom django.http import HttpResponseForbidden\nfrom django.http import HttpResponseRedirect\nfrom django.shortcuts import get_object_or_404\nfrom django.shortcuts import render\nfrom django.urls import reverse\nfrom django.utils import timezone\nfrom django.utils.translation import gettext_lazy as _\nfrom django.views.generic import FormView\nfrom django.utils.http import url_has_allowed_host_and_scheme\n\nfrom djangoblog.blog_signals import oauth_user_login_signal\nfrom djangoblog.utils import get_current_site\nfrom djangoblog.utils import send_email, get_sha256\nfrom oauth.forms import RequireEmailForm\nfrom .models import OAuthUser\nfrom .oauthmanager import get_manager_by_type, OAuthAccessTokenException\n\nlogger = logging.getLogger(__name__)\n\n\ndef get_redirecturl(request):\n nexturl = request.GET.get('next_url', None)\n if not nexturl or nexturl == '/login/' or nexturl == '/login':\n return '/'\n\n # Only allow relative URLs or URLs pointing to the current host\n site_domain = get_current_site().domain\n if url_has_allowed_host_and_scheme(\n url=nexturl,\n allowed_hosts={site_domain},\n require_https=request.is_secure()\n ):\n return nexturl\n\n logger.info('非法url:' + str(nexturl))\n return '/'\n\n\ndef oauthlogin(request):\n type = request.GET.get('type', None)\n if not type:\n return HttpResponseRedirect('/')\n manager = get_manager_by_type(type)\n if not manager:\n return HttpResponseRedirect('/')\n nexturl = get_redirecturl(request)\n authorizeurl = manager.get_authorization_url(nexturl)\n return HttpResponseRedirect(authorizeurl)\n\n\ndef authorize(request):\n type = request.GET.get('type', None)\n if not type:\n return HttpResponseRedirect('/')\n manager = get_manager_by_type(type)\n if not manager:\n return HttpResponseRedirect('/')\n code = request.GET.get('code', None)\n try:\n rsp = manager.get_access_token_by_code(code)\n except OAuthAccessTokenException as e:\n logger.warning(\"OAuthAccessTokenException:\" + str(e))\n return HttpResponseRedirect('/')\n except Exception as e:\n logger.error(e)\n rsp = None\n nexturl = get_redirecturl(request)\n if not rsp:\n return HttpResponseRedirect(manager.get_authorization_url(nexturl))\n user = manager.get_oauth_userinfo()\n if user:\n if not user.nickname or not user.nickname.strip():\n user.nickname = \"djangoblog\" + timezone.now().strftime('%y%m%d%I%M%S')\n try:\n temp = OAuthUser.objects.get(type=type, openid=user.openid)\n temp.picture = user.picture\n temp.metadata = user.metadata\n temp.nickname = user.nickname\n user = temp\n except ObjectDoesNotExist:\n pass\n # facebook的token过长\n if type == 'facebook':\n user.token = ''\n if user.email:\n with transaction.atomic():\n author = None\n try:\n author = get_user_model().objects.get(id=user.author_id)\n except ObjectDoesNotExist:\n pass\n if not author:\n result = get_user_model().objects.get_or_create(email=user.email)\n author = result[0]\n if result[1]:\n try:\n get_user_model().objects.get(username=user.nickname)\n except ObjectDoesNotExist:\n author.username = user.nickname\n else:\n author.username = \"djangoblog\" + timezone.now().strftime('%y%m%d%I%M%S')\n author.source = 'authorize'\n author.save()\n\n user.author = author\n user.save()\n\n oauth_user_login_signal.send(\n sender=authorize.__class__, id=user.id)\n login(request, author)\n # 设置session过期时间为2周（默认）\n request.session.set_expiry(settings.SESSION_COOKIE_AGE)\n # 设置登录标记 cookie\n response = HttpResponseRedirect(nexturl)\n response.set_cookie(\n 'logged_user',\n 'true',\n max_age=settings.SESSION_COOKIE_AGE,\n httponly=False, # 允许 JavaScript 访问\n samesite='Lax'\n )\n return response\n else:\n user.save()\n url = reverse('oauth:require_email', kwargs={\n 'oauthid': user.id\n })\n\n return HttpResponseRedirect(url)\n else:\n return HttpResponseRedirect(nexturl)\n\n\ndef emailconfirm(request, id, sign):\n if not sign:\n return HttpResponseForbidden()\n if not get_sha256(settings.SECRET_KEY +\n str(id) +\n settings.SECRET_KEY).upper() == sign.upper():\n return HttpResponseForbidden()\n oauthuser = get_object_or_404(OAuthUser, pk=id)\n with transaction.atomic():\n if oauthuser.author:\n author = get_user_model().objects.get(pk=oauthuser.author_id)\n else:\n result = get_user_model().objects.get_or_create(email=oauthuser.email)\n author = result[0]\n if result[1]:\n author.source = 'emailconfirm'\n author.username = oauthuser.nickname.strip() if oauthuser.nickname.strip(\n ) else \"djangoblog\" + timezone.now().strftime('%y%m%d%I%M%S')\n author.save()\n oauthuser.author = author\n oauthuser.save()\n oauth_user_login_signal.send(\n sender=emailconfirm.__class__,\n id=oauthuser.id)\n login(request, author)\n # 设置session过期时间为2周（默认）\n request.session.set_expiry(settings.SESSION_COOKIE_AGE)\n\n site = 'http://' + get_current_site().domain\n content = _('''\n Congratulations, you have successfully bound your email address. You can use\n %(oauthuser_type)s to directly log in to this website without a password.
\n You are welcome to continue to follow this site, the address is\n %(site)s \n Thank you again!\n Please click the link below to bind your email
\n\n %(url)s \n\n Thank you again!\n 本文由 {article.author.username} 原创，转载请注明出处。
\"\n return content + copyright_info\n\n\n# 3. 实例化插件。\n# 这会自动调用 BasePlugin.__init__，然后 BasePlugin.__init__ 会调用我们上面定义的 register_hooks 方法。\nplugin = ArticleCopyrightPlugin()\n"
},
{
"path": "plugins/article_recommendation/__init__.py",
"content": "# 文章推荐插件\n"
},
{
"path": "plugins/article_recommendation/plugin.py",
"content": "import logging\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\nfrom djangoblog.plugin_manage import hooks\nfrom djangoblog.plugin_manage.hook_constants import ARTICLE_DETAIL_LOAD\nfrom blog.models import Article\n\nlogger = logging.getLogger(__name__)\n\n\nclass ArticleRecommendationPlugin(BasePlugin):\n PLUGIN_NAME = '文章推荐'\n PLUGIN_DESCRIPTION = '智能文章推荐系统，支持多位置展示'\n PLUGIN_VERSION = '1.0.0'\n PLUGIN_AUTHOR = 'liangliangyy'\n \n # 支持的位置\n SUPPORTED_POSITIONS = ['article_bottom']\n \n # 各位置优先级\n POSITION_PRIORITIES = {\n 'article_bottom': 80, # 文章底部优先级\n }\n \n # 插件配置\n CONFIG = {\n 'article_bottom_count': 8, # 文章底部推荐数量\n 'sidebar_count': 5, # 侧边栏推荐数量\n 'enable_category_fallback': True, # 启用分类回退\n 'enable_popular_fallback': True, # 启用热门文章回退\n }\n \n def register_hooks(self):\n \"\"\"注册钩子\"\"\"\n hooks.register(ARTICLE_DETAIL_LOAD, self.on_article_detail_load)\n \n def on_article_detail_load(self, article, context, request, *args, **kwargs):\n \"\"\"文章详情页加载时的处理\"\"\"\n # 可以在这里预加载推荐数据到context中\n recommendations = self.get_recommendations(article)\n context['article_recommendations'] = recommendations\n \n def should_display(self, position, context, **kwargs):\n \"\"\"条件显示逻辑\"\"\"\n # 只在文章详情页底部显示\n if position == 'article_bottom':\n article = kwargs.get('article') or context.get('article')\n # 检查是否有文章对象，以及是否不是索引页面\n is_index = context.get('isindex', False) if hasattr(context, 'get') else False\n return article is not None and not is_index\n \n return False\n \n def render_article_bottom_widget(self, context, **kwargs):\n \"\"\"渲染文章底部推荐\"\"\"\n article = kwargs.get('article') or context.get('article')\n if not article:\n return None\n \n # 使用配置的数量，也可以通过kwargs覆盖\n count = kwargs.get('count', self.CONFIG['article_bottom_count'])\n recommendations = self.get_recommendations(article, count=count)\n if not recommendations:\n return None\n \n # 将RequestContext转换为普通字典\n context_dict = {}\n if hasattr(context, 'flatten'):\n context_dict = context.flatten()\n elif hasattr(context, 'dicts'):\n # 合并所有上下文字典\n for d in context.dicts:\n context_dict.update(d)\n \n template_context = {\n 'recommendations': recommendations,\n 'article': article,\n 'title': '相关推荐',\n **context_dict\n }\n \n return self.render_template('bottom_widget.html', template_context)\n \n def render_sidebar_widget(self, context, **kwargs):\n \"\"\"渲染侧边栏推荐\"\"\"\n article = context.get('article')\n \n # 使用配置的数量，也可以通过kwargs覆盖\n count = kwargs.get('count', self.CONFIG['sidebar_count'])\n \n if article:\n # 文章页面，显示相关文章\n recommendations = self.get_recommendations(article, count=count)\n title = '相关文章'\n else:\n # 其他页面，显示热门文章\n recommendations = self.get_popular_articles(count=count)\n title = '热门推荐'\n \n if not recommendations:\n return None\n \n # 将RequestContext转换为普通字典\n context_dict = {}\n if hasattr(context, 'flatten'):\n context_dict = context.flatten()\n elif hasattr(context, 'dicts'):\n # 合并所有上下文字典\n for d in context.dicts:\n context_dict.update(d)\n \n template_context = {\n 'recommendations': recommendations,\n 'title': title,\n **context_dict\n }\n \n return self.render_template('sidebar_widget.html', template_context)\n \n def get_css_files(self):\n \"\"\"返回CSS文件\"\"\"\n return ['css/recommendation.css']\n \n def get_js_files(self):\n \"\"\"返回JS文件\"\"\"\n return ['js/recommendation.js']\n \n def get_recommendations(self, article, count=5):\n \"\"\"获取推荐文章\"\"\"\n if not article:\n return []\n \n recommendations = []\n \n # 1. 基于标签的推荐\n if article.tags.exists():\n tag_ids = list(article.tags.values_list('id', flat=True))\n tag_based = list(Article.objects.filter(\n status='p',\n tags__id__in=tag_ids\n ).exclude(\n id=article.id\n ).exclude(\n title__isnull=True\n ).exclude(\n title__exact=''\n ).distinct().order_by('-views')[:count])\n recommendations.extend(tag_based)\n \n # 2. 如果数量不够，基于分类推荐\n if len(recommendations) < count and self.CONFIG['enable_category_fallback']:\n needed = count - len(recommendations)\n existing_ids = [r.id for r in recommendations] + [article.id]\n \n category_based = list(Article.objects.filter(\n status='p',\n category=article.category\n ).exclude(\n id__in=existing_ids\n ).exclude(\n title__isnull=True\n ).exclude(\n title__exact=''\n ).order_by('-views')[:needed])\n recommendations.extend(category_based)\n \n # 3. 如果还是不够，推荐热门文章\n if len(recommendations) < count and self.CONFIG['enable_popular_fallback']:\n needed = count - len(recommendations)\n existing_ids = [r.id for r in recommendations] + [article.id]\n \n popular_articles = list(Article.objects.filter(\n status='p'\n ).exclude(\n id__in=existing_ids\n ).exclude(\n title__isnull=True\n ).exclude(\n title__exact=''\n ).order_by('-views')[:needed])\n recommendations.extend(popular_articles)\n \n # 过滤掉无效的推荐\n valid_recommendations = []\n for rec in recommendations:\n if rec.title and len(rec.title.strip()) > 0:\n valid_recommendations.append(rec)\n else:\n logger.warning(f\"过滤掉空标题文章: ID={rec.id}, 标题='{rec.title}'\")\n \n # 调试：记录推荐结果\n logger.info(f\"原始推荐数量: {len(recommendations)}, 有效推荐数量: {len(valid_recommendations)}\")\n for i, rec in enumerate(valid_recommendations):\n logger.info(f\"推荐 {i+1}: ID={rec.id}, 标题='{rec.title}', 长度={len(rec.title)}\")\n \n return valid_recommendations[:count]\n \n def get_popular_articles(self, count=3):\n \"\"\"获取热门文章\"\"\"\n return list(Article.objects.filter(\n status='p'\n ).order_by('-views')[:count])\n\n\n# 实例化插件\nplugin = ArticleRecommendationPlugin()\n"
},
{
"path": "plugins/article_recommendation/static/article_recommendation/css/recommendation.css",
"content": "/* 文章推荐插件样式 - 与网站风格保持一致 */\n\n/* 文章底部推荐样式 */\n.article-recommendations {\n margin: 30px 0;\n padding: 20px;\n background: #fff;\n border: 1px solid #e1e1e1;\n border-radius: 3px;\n box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);\n}\n\n.recommendations-title {\n margin: 0 0 15px 0;\n font-size: 18px;\n color: #444;\n font-weight: bold;\n padding-bottom: 8px;\n border-bottom: 2px solid #21759b;\n display: inline-block;\n}\n\n.recommendations-icon {\n margin-right: 5px;\n font-size: 16px;\n}\n\n.recommendations-grid {\n display: grid;\n gap: 15px;\n grid-template-columns: 1fr;\n margin-top: 15px;\n}\n\n.recommendation-card {\n background: #fff;\n border: 1px solid #e1e1e1;\n border-radius: 3px;\n transition: all 0.2s ease;\n overflow: hidden;\n}\n\n.recommendation-card:hover {\n border-color: #21759b;\n box-shadow: 0 2px 5px rgba(33, 117, 155, 0.1);\n}\n\n.recommendation-link {\n display: block;\n padding: 15px;\n text-decoration: none;\n color: inherit;\n}\n\n.recommendation-title {\n margin: 0 0 8px 0;\n font-size: 15px;\n font-weight: normal;\n color: #444;\n line-height: 1.4;\n transition: color 0.2s ease;\n}\n\n.recommendation-card:hover .recommendation-title {\n color: #21759b;\n}\n\n.recommendation-meta {\n display: flex;\n justify-content: space-between;\n align-items: center;\n font-size: 12px;\n color: #757575;\n}\n\n.recommendation-category {\n background: #ebebeb;\n color: #5e5e5e;\n padding: 2px 6px;\n border-radius: 2px;\n font-size: 11px;\n font-weight: normal;\n}\n\n.recommendation-date {\n font-weight: normal;\n color: #757575;\n}\n\n/* 深色模式支持 */\n[data-theme=\"dark\"] .article-recommendations {\n background: #1a1a1a;\n border-color: #333;\n box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);\n}\n\n[data-theme=\"dark\"] .recommendations-title {\n color: #e0e0e0;\n border-bottom-color: #3a8fb7;\n}\n\n[data-theme=\"dark\"] .recommendation-card {\n background: #2a2a2a;\n border-color: #3a3a3a;\n}\n\n[data-theme=\"dark\"] .recommendation-card:hover {\n border-color: #3a8fb7;\n box-shadow: 0 2px 5px rgba(58, 143, 183, 0.2);\n}\n\n[data-theme=\"dark\"] .recommendation-title {\n color: #d0d0d0;\n}\n\n[data-theme=\"dark\"] .recommendation-card:hover .recommendation-title {\n color: #3a8fb7;\n}\n\n[data-theme=\"dark\"] .recommendation-meta {\n color: #999;\n}\n\n[data-theme=\"dark\"] .recommendation-category {\n background: #3a3a3a;\n color: #b0b0b0;\n}\n\n[data-theme=\"dark\"] .recommendation-date {\n color: #999;\n}\n\n/* 侧边栏推荐样式 */\n.widget_recommendations {\n margin-bottom: 20px;\n}\n\n.widget_recommendations .widget-title {\n font-size: 16px;\n font-weight: bold;\n margin-bottom: 15px;\n color: #333;\n border-bottom: 2px solid #007cba;\n padding-bottom: 5px;\n}\n\n.recommendations-list {\n list-style: none;\n padding: 0;\n margin: 0;\n}\n\n.recommendations-list .recommendation-item {\n padding: 8px 0;\n border-bottom: 1px solid #eee;\n background: none;\n border: none;\n border-radius: 0;\n}\n\n.recommendations-list .recommendation-item:last-child {\n border-bottom: none;\n}\n\n.recommendations-list .recommendation-item a {\n color: #333;\n text-decoration: none;\n font-size: 14px;\n line-height: 1.4;\n display: block;\n margin-bottom: 4px;\n transition: color 0.3s ease;\n}\n\n.recommendations-list .recommendation-item a:hover {\n color: #007cba;\n}\n\n.recommendations-list .recommendation-meta {\n font-size: 11px;\n color: #999;\n margin: 0;\n}\n\n.recommendations-list .recommendation-meta span {\n margin-right: 10px;\n}\n\n/* 响应式设计 - 分栏显示 */\n@media (min-width: 768px) {\n .recommendations-grid {\n grid-template-columns: repeat(2, 1fr);\n gap: 15px;\n }\n}\n\n@media (min-width: 1024px) {\n .recommendations-grid {\n grid-template-columns: repeat(3, 1fr);\n gap: 15px;\n }\n}\n\n@media (min-width: 1200px) {\n .recommendations-grid {\n grid-template-columns: repeat(4, 1fr);\n gap: 15px;\n }\n}\n"
},
{
"path": "plugins/article_recommendation/static/article_recommendation/js/recommendation.js",
"content": "/**\n * 文章推荐插件JavaScript\n */\n\n(function() {\n 'use strict';\n \n // 等待DOM加载完成\n document.addEventListener('DOMContentLoaded', function() {\n initRecommendations();\n });\n \n function initRecommendations() {\n // 添加点击统计\n trackRecommendationClicks();\n \n // 懒加载优化（如果需要）\n lazyLoadRecommendations();\n }\n \n function trackRecommendationClicks() {\n const recommendationLinks = document.querySelectorAll('.recommendation-item a');\n \n recommendationLinks.forEach(function(link) {\n link.addEventListener('click', function(e) {\n // 可以在这里添加点击统计逻辑\n const articleTitle = this.textContent.trim();\n const articleUrl = this.href;\n \n // 发送统计数据到后端（可选）\n if (typeof gtag !== 'undefined') {\n gtag('event', 'click', {\n 'event_category': 'recommendation',\n 'event_label': articleTitle,\n 'value': 1\n });\n }\n \n console.log('Recommendation clicked:', articleTitle, articleUrl);\n });\n });\n }\n \n function lazyLoadRecommendations() {\n // 如果推荐内容很多，可以实现懒加载\n const recommendationContainer = document.querySelector('.article-recommendations');\n \n if (!recommendationContainer) {\n return;\n }\n \n // 检查是否在视窗中\n const observer = new IntersectionObserver(function(entries) {\n entries.forEach(function(entry) {\n if (entry.isIntersecting) {\n entry.target.classList.add('loaded');\n observer.unobserve(entry.target);\n }\n });\n }, {\n threshold: 0.1\n });\n \n const recommendationItems = document.querySelectorAll('.recommendation-item');\n recommendationItems.forEach(function(item) {\n observer.observe(item);\n });\n }\n \n // 添加一些动画效果\n function addAnimations() {\n const recommendationItems = document.querySelectorAll('.recommendation-item');\n \n recommendationItems.forEach(function(item, index) {\n item.style.opacity = '0';\n item.style.transform = 'translateY(20px)';\n item.style.transition = 'opacity 0.5s ease, transform 0.5s ease';\n \n setTimeout(function() {\n item.style.opacity = '1';\n item.style.transform = 'translateY(0)';\n }, index * 100);\n });\n }\n \n // 如果需要，可以在这里添加更多功能\n window.ArticleRecommendation = {\n init: initRecommendations,\n track: trackRecommendationClicks,\n animate: addAnimations\n };\n \n})();\n"
},
{
"path": "plugins/cloudflare_cache/__init__.py",
"content": "\"\"\"\nCloudflare Cache Plugin for DjangoBlog\n\nAutomatically purges Cloudflare cache when content changes.\n\"\"\"\n\n__version__ = '1.0.0'\n"
},
{
"path": "plugins/cloudflare_cache/api.py",
"content": "\"\"\"\nCloudflare API 封装\n\n提供与Cloudflare API交互的功能，用于清除缓存。\n\"\"\"\n\nimport logging\nimport requests\nfrom typing import List, Dict, Optional\n\nlogger = logging.getLogger(__name__)\n\n\nclass CloudflareAPI:\n \"\"\"Cloudflare API 客户端\"\"\"\n\n API_BASE = \"https://api.cloudflare.com/client/v4\"\n\n def __init__(self, zone_id: str, api_token: str):\n \"\"\"\n 初始化Cloudflare API客户端\n\n Args:\n zone_id: Cloudflare Zone ID\n api_token: Cloudflare API Token (需要 Zone.Cache Purge 权限)\n \"\"\"\n self.zone_id = zone_id\n self.api_token = api_token\n self.headers = {\n 'Authorization': f'Bearer {api_token}',\n 'Content-Type': 'application/json'\n }\n\n def purge_urls(self, urls: List[str]) -> Dict:\n \"\"\"\n 按URL清除缓存（精确清除）\n\n Args:\n urls: 要清除的URL列表（最多30个）\n\n Returns:\n API响应结果字典，包含 'success' 字段\n\n Note:\n - 单次请求最多清除30个URL\n - URL必须包含完整的协议和域名\n - 示例: https://example.com/article/123.html\n \"\"\"\n if not urls:\n logger.warning(\"[CF API] No URLs to purge\")\n return {'success': True, 'result': {'id': 'no-op'}}\n\n # Cloudflare限制单次最多30个URL\n if len(urls) > 30:\n logger.warning(f\"[CF API] URLs count ({len(urls)}) exceeds limit (30), will be truncated\")\n urls = urls[:30]\n\n endpoint = f\"{self.API_BASE}/zones/{self.zone_id}/purge_cache\"\n data = {'files': urls}\n\n try:\n logger.info(f\"[CF API] Purging {len(urls)} URLs from cache\")\n logger.debug(f\"[CF API] URLs: {urls}\")\n\n response = requests.post(\n endpoint,\n json=data,\n headers=self.headers,\n timeout=10\n )\n\n result = response.json()\n\n if result.get('success'):\n logger.info(f\"[CF API] Successfully purged {len(urls)} URLs\")\n logger.debug(f\"[CF API] Response: {result}\")\n else:\n errors = result.get('errors', [])\n logger.error(f\"[CF API] Failed to purge cache: {errors}\")\n\n return result\n\n except requests.Timeout:\n logger.error(\"[CF API] Request timeout (10s)\")\n return {'success': False, 'errors': [{'message': 'Request timeout'}]}\n\n except requests.RequestException as e:\n logger.error(f\"[CF API] Request failed: {e}\", exc_info=True)\n return {'success': False, 'errors': [{'message': str(e)}]}\n\n except Exception as e:\n logger.error(f\"[CF API] Unexpected error: {e}\", exc_info=True)\n return {'success': False, 'errors': [{'message': f'Unexpected error: {e}'}]}\n\n def purge_all(self) -> Dict:\n \"\"\"\n 清除所有缓存（慎用！）\n\n Returns:\n API响应结果字典\n\n Warning:\n 此操作会清除Zone下的所有缓存，影响范围大，请谨慎使用！\n \"\"\"\n endpoint = f\"{self.API_BASE}/zones/{self.zone_id}/purge_cache\"\n data = {'purge_everything': True}\n\n try:\n logger.warning(\"[CF API] Purging ALL cache - this affects the entire zone!\")\n\n response = requests.post(\n endpoint,\n json=data,\n headers=self.headers,\n timeout=10\n )\n\n result = response.json()\n\n if result.get('success'):\n logger.info(\"[CF API] Successfully purged all cache\")\n else:\n errors = result.get('errors', [])\n logger.error(f\"[CF API] Failed to purge all cache: {errors}\")\n\n return result\n\n except requests.RequestException as e:\n logger.error(f\"[CF API] Request failed: {e}\", exc_info=True)\n return {'success': False, 'errors': [{'message': str(e)}]}\n\n def purge_by_tags(self, tags: List[str]) -> Dict:\n \"\"\"\n 按缓存标签清除（需要企业版）\n\n Args:\n tags: 缓存标签列表\n\n Returns:\n API响应结果字典\n\n Note:\n 此功能仅在Cloudflare企业版中可用\n \"\"\"\n endpoint = f\"{self.API_BASE}/zones/{self.zone_id}/purge_cache\"\n data = {'tags': tags}\n\n try:\n logger.info(f\"[CF API] Purging cache by tags: {tags}\")\n\n response = requests.post(\n endpoint,\n json=data,\n headers=self.headers,\n timeout=10\n )\n\n result = response.json()\n\n if result.get('success'):\n logger.info(f\"[CF API] Successfully purged cache by tags\")\n else:\n errors = result.get('errors', [])\n logger.error(f\"[CF API] Failed to purge by tags: {errors}\")\n\n return result\n\n except requests.RequestException as e:\n logger.error(f\"[CF API] Request failed: {e}\", exc_info=True)\n return {'success': False, 'errors': [{'message': str(e)}]}\n\n def validate_credentials(self) -> bool:\n \"\"\"\n 验证API凭证是否有效\n\n Returns:\n True 如果凭证有效，False 否则\n \"\"\"\n endpoint = f\"{self.API_BASE}/zones/{self.zone_id}\"\n\n try:\n response = requests.get(\n endpoint,\n headers=self.headers,\n timeout=5\n )\n\n result = response.json()\n\n if result.get('success'):\n logger.info(\"[CF API] Credentials validated successfully\")\n return True\n else:\n logger.error(f\"[CF API] Invalid credentials: {result.get('errors')}\")\n return False\n\n except Exception as e:\n logger.error(f\"[CF API] Failed to validate credentials: {e}\")\n return False\n"
},
{
"path": "plugins/cloudflare_cache/handlers.py",
"content": "\"\"\"\nDjango信号处理器\n\n监听模型变更事件，触发Cloudflare缓存清除。\n\"\"\"\n\nimport logging\nfrom typing import List\nfrom django.contrib.admin.models import LogEntry\n\nlogger = logging.getLogger(__name__)\n\n\nclass CloudflareCacheHandler:\n \"\"\"Cloudflare缓存处理器\"\"\"\n\n def __init__(self, config: dict):\n \"\"\"\n 初始化处理器\n\n Args:\n config: 插件配置字典\n \"\"\"\n self.config = config\n\n # 初始化Cloudflare API客户端\n from .api import CloudflareAPI\n self.cf_api = CloudflareAPI(\n zone_id=config['zone_id'],\n api_token=config['api_token']\n )\n\n logger.info(\"[CF Handler] Initialized with config\")\n\n def on_model_save(self, sender, instance, created, update_fields, **kwargs):\n \"\"\"\n Django post_save 信号处理器\n\n Args:\n sender: 发送信号的模型类\n instance: 保存的模型实例\n created: 是否为新建\n update_fields: 更新的字段集合\n **kwargs: 其他参数\n \"\"\"\n # 忽略日志条目\n if isinstance(instance, LogEntry):\n return\n\n # 🚨 关键：忽略仅更新views字段的情况\n # 浏览量更新非常频繁，不应该清除缓存\n is_update_views = update_fields == {'views'}\n if is_update_views:\n logger.debug(f\"[CF Handler] Skipping cache purge for views update: {instance}\")\n return\n\n # 导入模型类（延迟导入避免循环依赖）\n from blog.models import Article\n from comments.models import Comment\n\n # 收集需要清除的URL\n urls_to_purge = []\n\n if isinstance(instance, Article):\n if self.config['purge_on_article_save']:\n urls_to_purge = self._collect_article_urls(instance, created)\n logger.info(f\"[CF Handler] Article {'created' if created else 'updated'}: {instance.title}\")\n\n elif isinstance(instance, Comment):\n if self.config['purge_on_comment_save'] and instance.is_enable:\n urls_to_purge = self._collect_comment_urls(instance, created)\n logger.info(f\"[CF Handler] Comment {'created' if created else 'updated'} on article: {instance.article.title}\")\n\n # 执行缓存清除\n if urls_to_purge:\n self._purge_cache_batch(urls_to_purge)\n\n def _collect_article_urls(self, article, is_new: bool) -> List[str]:\n \"\"\"\n 收集文章相关的URL\n\n Args:\n article: 文章实例\n is_new: 是否为新建文章\n\n Returns:\n 需要清除的URL列表\n \"\"\"\n from djangoblog.utils import get_current_site\n\n try:\n site = get_current_site()\n base_url = f\"https://{site.domain}\"\n\n urls = []\n\n # 1. 文章详情页（必须清除）\n article_url = base_url + article.get_absolute_url()\n urls.append(article_url)\n logger.debug(f\"[CF Handler] Added article detail: {article_url}\")\n\n # 2. 首页（如果配置启用）\n if self.config['purge_home_on_article']:\n home_url = base_url + '/'\n urls.append(home_url)\n logger.debug(f\"[CF Handler] Added homepage: {home_url}\")\n\n # 3. 相关页面（如果配置启用）\n if self.config['purge_related_pages']:\n # 分类页\n try:\n category_url = base_url + article.category.get_absolute_url()\n urls.append(category_url)\n logger.debug(f\"[CF Handler] Added category: {category_url}\")\n except Exception as e:\n logger.warning(f\"[CF Handler] Failed to get category URL: {e}\")\n\n # 标签页\n try:\n for tag in article.tags.all():\n tag_url = base_url + tag.get_absolute_url()\n urls.append(tag_url)\n logger.debug(f\"[CF Handler] Added tag: {tag_url}\")\n except Exception as e:\n logger.warning(f\"[CF Handler] Failed to get tag URLs: {e}\")\n\n # RSS Feeds\n urls.append(base_url + '/rss/')\n urls.append(base_url + '/feed/')\n logger.debug(f\"[CF Handler] Added RSS feeds\")\n\n # 去重\n urls = list(dict.fromkeys(urls))\n\n logger.info(f\"[CF Handler] Collected {len(urls)} URLs for article: {article.title}\")\n return urls\n\n except Exception as e:\n logger.error(f\"[CF Handler] Error collecting article URLs: {e}\", exc_info=True)\n return []\n\n def _collect_comment_urls(self, comment, is_new: bool) -> List[str]:\n \"\"\"\n 收集评论相关的URL\n\n Args:\n comment: 评论实例\n is_new: 是否为新评论\n\n Returns:\n 需要清除的URL列表\n \"\"\"\n from djangoblog.utils import get_current_site\n\n try:\n site = get_current_site()\n base_url = f\"https://{site.domain}\"\n\n urls = []\n\n # 评论所在的文章页\n if comment.article:\n article_url = base_url + comment.article.get_absolute_url()\n urls.append(article_url)\n logger.debug(f\"[CF Handler] Added article for comment: {article_url}\")\n\n # 如果配置启用，也清除首页（显示最新评论的情况）\n if self.config.get('purge_home_on_comment', False):\n urls.append(base_url + '/')\n\n logger.info(f\"[CF Handler] Collected {len(urls)} URLs for comment\")\n return urls\n\n except Exception as e:\n logger.error(f\"[CF Handler] Error collecting comment URLs: {e}\", exc_info=True)\n return []\n\n def _purge_cache_batch(self, urls: List[str]):\n \"\"\"\n 批量清除缓存\n\n Args:\n urls: 要清除的URL列表\n\n Note:\n - Cloudflare单次请求最多30个URL\n - 自动分批处理\n \"\"\"\n if not urls:\n return\n\n max_urls = self.config['max_urls_per_request']\n\n try:\n # 分批处理\n for i in range(0, len(urls), max_urls):\n batch = urls[i:i + max_urls]\n\n logger.info(f\"[CF Handler] Purging batch {i//max_urls + 1}: {len(batch)} URLs\")\n\n result = self.cf_api.purge_urls(batch)\n\n if result.get('success'):\n logger.info(f\"[CF Handler] ✓ Successfully purged {len(batch)} URLs\")\n else:\n errors = result.get('errors', [])\n error_messages = [err.get('message', str(err)) for err in errors]\n logger.error(f\"[CF Handler] ✗ Failed to purge batch: {error_messages}\")\n\n except Exception as e:\n # 缓存清除失败不应影响主流程\n logger.error(f\"[CF Handler] Exception during cache purge: {e}\", exc_info=True)\n logger.warning(\"[CF Handler] Cache purge failed, but main operation completed successfully\")\n\n def purge_all(self):\n \"\"\"\n 手动清除所有缓存\n\n Warning:\n 此方法会清除整个Zone的所有缓存，请谨慎使用\n \"\"\"\n logger.warning(\"[CF Handler] Manual purge all triggered\")\n\n try:\n result = self.cf_api.purge_all()\n\n if result.get('success'):\n logger.info(\"[CF Handler] ✓ Successfully purged all cache\")\n return True\n else:\n errors = result.get('errors', [])\n logger.error(f\"[CF Handler] ✗ Failed to purge all: {errors}\")\n return False\n\n except Exception as e:\n logger.error(f\"[CF Handler] Exception during purge all: {e}\", exc_info=True)\n return False\n"
},
{
"path": "plugins/cloudflare_cache/plugin.py",
"content": "\"\"\"\nCloudflare 缓存管理插件\n\n自动清除Cloudflare CDN缓存，确保内容更新后用户能看到最新内容。\n\n功能特性：\n- 文章发布/修改时自动清除相关页面缓存\n- 评论发布时清除文章页面缓存\n- 智能过滤浏览量更新，避免频繁清除缓存\n- 支持批量清除，自动处理Cloudflare的30个URL限制\n- 完整的错误处理，缓存清除失败不影响主流程\n- 灵活的配置选项，可按需启用/禁用功能\n\n作者: DjangoBlog\n版本: 1.0.0\n\"\"\"\n\nimport os\nimport logging\nfrom django.conf import settings\nfrom django.db.models.signals import post_save\n\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\n\nlogger = logging.getLogger(__name__)\n\n\nclass CloudflareCachePlugin(BasePlugin):\n \"\"\"Cloudflare 缓存管理插件\"\"\"\n\n # ==================== 插件元数据 ====================\n PLUGIN_NAME = 'Cloudflare 缓存管理'\n PLUGIN_DESCRIPTION = '自动清除Cloudflare缓存，在文章、评论更新时保持内容同步'\n PLUGIN_VERSION = '1.0.0'\n PLUGIN_AUTHOR = 'DjangoBlog'\n\n # ==================== 位置配置 ====================\n # 此插件不需要在页面上显示任何内容，只在后台工作\n SUPPORTED_POSITIONS = []\n\n # ==================== 插件配置 ====================\n CONFIG = {\n # === 基础配置 ===\n 'enabled': True, # 插件总开关\n\n # Cloudflare 凭证（从环境变量或Django settings读取）\n 'zone_id': os.environ.get('CLOUDFLARE_ZONE_ID', ''),\n 'api_token': os.environ.get('CLOUDFLARE_API_TOKEN', ''),\n\n # === 清除策略 ===\n 'purge_on_startup': os.environ.get('CLOUDFLARE_PURGE_ON_STARTUP', 'false').lower() in ('true', '1', 'yes'), # 应用启动时清除全站缓存\n 'purge_on_article_save': True, # 文章保存时清除缓存\n 'purge_on_comment_save': True, # 评论保存时清除缓存\n\n # === 清除范围 ===\n 'purge_home_on_article': True, # 文章更新时是否清除首页\n 'purge_related_pages': True, # 是否清除分类页、标签页、RSS等相关页面\n 'purge_home_on_comment': True, # 评论更新时是否清除首页（如果首页显示最新评论则开启）\n\n # === API 配置 ===\n 'max_urls_per_request': 30, # 单次请求最多清除的URL数（Cloudflare限制）\n 'request_timeout': 10, # API请求超时时间（秒）\n\n }\n\n def init_plugin(self):\n \"\"\"插件初始化\"\"\"\n logger.info(f\"Initializing {self.PLUGIN_NAME} v{self.PLUGIN_VERSION}\")\n\n # 从Django settings读取配置（如果存在）\n if hasattr(settings, 'CLOUDFLARE_CONFIG'):\n cf_config = settings.CLOUDFLARE_CONFIG\n self.CONFIG['zone_id'] = cf_config.get('zone_id', self.CONFIG['zone_id'])\n self.CONFIG['api_token'] = cf_config.get('api_token', self.CONFIG['api_token'])\n logger.info(\"[CF Plugin] Loaded config from Django settings\")\n\n # 验证配置\n if not self._validate_config():\n self.CONFIG['enabled'] = False\n logger.warning(\"[CF Plugin] Plugin disabled due to invalid configuration\")\n return\n\n logger.info(\"[CF Plugin] Configuration validated successfully\")\n\n # 测试API连接（可选）\n if self.CONFIG.get('test_on_init', False):\n self._test_api_connection()\n\n # 启动时清除全站缓存（可选）\n if self.CONFIG.get('purge_on_startup', False):\n self._purge_on_startup()\n\n def _validate_config(self) -> bool:\n \"\"\"\n 验证配置是否有效\n\n Returns:\n True 如果配置有效，False 否则\n \"\"\"\n zone_id = self.CONFIG.get('zone_id', '').strip()\n api_token = self.CONFIG.get('api_token', '').strip()\n\n if not zone_id:\n logger.error(\"[CF Plugin] CLOUDFLARE_ZONE_ID not configured\")\n logger.info(\"[CF Plugin] Please set environment variable: CLOUDFLARE_ZONE_ID\")\n return False\n\n if not api_token:\n logger.error(\"[CF Plugin] CLOUDFLARE_API_TOKEN not configured\")\n logger.info(\"[CF Plugin] Please set environment variable: CLOUDFLARE_API_TOKEN\")\n return False\n\n # 基本格式验证\n if len(zone_id) != 32:\n logger.warning(f\"[CF Plugin] Zone ID format may be invalid (length: {len(zone_id)})\")\n\n if len(api_token) < 20:\n logger.warning(f\"[CF Plugin] API Token format may be invalid (length: {len(api_token)})\")\n\n return True\n\n def _test_api_connection(self):\n \"\"\"测试Cloudflare API连接\"\"\"\n try:\n from .api import CloudflareAPI\n\n cf_api = CloudflareAPI(\n zone_id=self.CONFIG['zone_id'],\n api_token=self.CONFIG['api_token']\n )\n\n if cf_api.validate_credentials():\n logger.info(\"[CF Plugin] ✓ API connection test successful\")\n else:\n logger.error(\"[CF Plugin] ✗ API connection test failed\")\n logger.warning(\"[CF Plugin] Plugin will continue, but cache purging may not work\")\n\n except Exception as e:\n logger.error(f\"[CF Plugin] Error testing API connection: {e}\")\n\n def _purge_on_startup(self):\n \"\"\"\n 应用启动时清除全站缓存\n\n 使用后台线程异步执行，不阻塞启动过程\n \"\"\"\n import threading\n\n def _do_purge():\n \"\"\"实际执行清除的函数\"\"\"\n try:\n import time\n # 延迟几秒，确保应用完全启动\n time.sleep(3)\n\n logger.info(\"[CF Plugin] 🚀 Starting startup cache purge...\")\n\n from .api import CloudflareAPI\n cf_api = CloudflareAPI(\n zone_id=self.CONFIG['zone_id'],\n api_token=self.CONFIG['api_token']\n )\n\n result = cf_api.purge_all()\n\n if result.get('success'):\n logger.info(\"[CF Plugin] ✓ Successfully purged all cache on startup\")\n logger.info(\"[CF Plugin] 🎉 All Cloudflare cache cleared! Fresh start guaranteed.\")\n else:\n errors = result.get('errors', [])\n logger.error(f\"[CF Plugin] ✗ Failed to purge cache on startup: {errors}\")\n\n except Exception as e:\n logger.error(f\"[CF Plugin] Exception during startup cache purge: {e}\", exc_info=True)\n\n # 在后台线程中执行，不阻塞应用启动\n thread = threading.Thread(target=_do_purge, daemon=True, name=\"CloudflareCachePurgeOnStartup\")\n thread.start()\n logger.info(\"[CF Plugin] Scheduled startup cache purge (will execute in background)\")\n\n def register_hooks(self):\n \"\"\"注册Django信号钩子\"\"\"\n if not self.CONFIG['enabled']:\n logger.info(\"[CF Plugin] Plugin is disabled, skipping hook registration\")\n return\n\n try:\n # 导入模型类\n from blog.models import Article\n from comments.models import Comment\n from .handlers import CloudflareCacheHandler\n\n # 初始化处理器\n self.handler = CloudflareCacheHandler(self.CONFIG)\n\n # 注册Article模型的post_save信号\n if self.CONFIG['purge_on_article_save']:\n post_save.connect(\n self.handler.on_model_save,\n sender=Article,\n dispatch_uid='cloudflare_cache_article_save'\n )\n logger.info(\"[CF Plugin] Registered hook: Article.post_save\")\n\n # 注册Comment模型的post_save信号\n if self.CONFIG['purge_on_comment_save']:\n post_save.connect(\n self.handler.on_model_save,\n sender=Comment,\n dispatch_uid='cloudflare_cache_comment_save'\n )\n logger.info(\"[CF Plugin] Registered hook: Comment.post_save\")\n\n logger.info(\"[CF Plugin] All hooks registered successfully\")\n\n except ImportError as e:\n logger.error(f\"[CF Plugin] Failed to import dependencies: {e}\")\n self.CONFIG['enabled'] = False\n\n except Exception as e:\n logger.error(f\"[CF Plugin] Error registering hooks: {e}\", exc_info=True)\n self.CONFIG['enabled'] = False\n\n # ==================== 管理命令接口 ====================\n\n def purge_all_cache(self):\n \"\"\"\n 手动清除所有缓存\n\n Returns:\n bool: 是否成功\n\n Warning:\n 此操作会清除整个Zone的所有缓存！\n \"\"\"\n if not self.CONFIG['enabled']:\n logger.error(\"[CF Plugin] Plugin is not enabled\")\n return False\n\n if hasattr(self, 'handler'):\n return self.handler.purge_all()\n else:\n logger.error(\"[CF Plugin] Handler not initialized\")\n return False\n\n def get_plugin_status(self) -> dict:\n \"\"\"\n 获取插件状态\n\n Returns:\n 包含插件状态信息的字典\n \"\"\"\n return {\n 'name': self.PLUGIN_NAME,\n 'version': self.PLUGIN_VERSION,\n 'enabled': self.CONFIG['enabled'],\n 'zone_id_configured': bool(self.CONFIG.get('zone_id')),\n 'api_token_configured': bool(self.CONFIG.get('api_token')),\n 'purge_on_article': self.CONFIG['purge_on_article_save'],\n 'purge_on_comment': self.CONFIG['purge_on_comment_save'],\n }\n\n\n# ==================== 插件实例（必需）====================\nplugin = CloudflareCachePlugin()\n"
},
{
"path": "plugins/external_links/__init__.py",
"content": "# This file makes this a Python package\n"
},
{
"path": "plugins/external_links/plugin.py",
"content": "import re\nfrom urllib.parse import urlparse\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\nfrom djangoblog.plugin_manage import hooks\nfrom djangoblog.plugin_manage.hook_constants import ARTICLE_CONTENT_HOOK_NAME\n\n\nclass ExternalLinksPlugin(BasePlugin):\n PLUGIN_NAME = '外部链接处理器'\n PLUGIN_DESCRIPTION = '自动为文章中的外部链接添加 target=\"_blank\" 和 rel=\"noopener noreferrer\" 属性。'\n PLUGIN_VERSION = '0.1.0'\n PLUGIN_AUTHOR = 'liangliangyy'\n\n def register_hooks(self):\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, self.process_external_links)\n\n def process_external_links(self, content, *args, **kwargs):\n from djangoblog.utils import get_current_site\n site_domain = get_current_site().domain\n\n # 正则表达式查找所有 标签\n link_pattern = re.compile(r'(]*?\\s+)?href=\")([^\"]*)(\".*?/a>)', re.IGNORECASE)\n\n def replacer(match):\n # match.group(1) 是 ... \n href = match.group(2)\n\n # 如果链接已经有 target 属性，则不处理\n if 'target=' in match.group(0).lower():\n return match.group(0)\n\n # 解析链接\n parsed_url = urlparse(href)\n\n # 如果链接是外部的 (有域名且域名不等于当前网站域名)\n if parsed_url.netloc and parsed_url.netloc != site_domain:\n # 添加 target 和 rel 属性\n return f'{match.group(1)}{href}\" target=\"_blank\" rel=\"noopener noreferrer\"{match.group(3)}'\n\n # 否则返回原样\n return match.group(0)\n\n return link_pattern.sub(replacer, content)\n\n\nplugin = ExternalLinksPlugin()\n"
},
{
"path": "plugins/image_lazy_loading/__init__.py",
"content": "# Image Lazy Loading Plugin\n"
},
{
"path": "plugins/image_lazy_loading/plugin.py",
"content": "import re\nimport hashlib\nfrom urllib.parse import urlparse\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\nfrom djangoblog.plugin_manage import hooks\nfrom djangoblog.plugin_manage.hook_constants import ARTICLE_CONTENT_HOOK_NAME\n\n\nclass ImageOptimizationPlugin(BasePlugin):\n PLUGIN_NAME = '图片性能优化插件'\n PLUGIN_DESCRIPTION = '自动为文章中的图片添加懒加载、异步解码等性能优化属性，显著提升页面加载速度。'\n PLUGIN_VERSION = '1.0.0'\n PLUGIN_AUTHOR = 'liangliangyy'\n\n def __init__(self):\n # 插件配置\n self.config = {\n 'enable_lazy_loading': True, # 启用懒加载\n 'enable_async_decoding': True, # 启用异步解码\n 'add_loading_placeholder': True, # 添加加载占位符\n 'optimize_external_images': True, # 优化外部图片\n 'add_responsive_attributes': True, # 添加响应式属性\n 'skip_first_image': True, # 跳过第一张图片（LCP优化）\n }\n super().__init__()\n\n def register_hooks(self):\n hooks.register(ARTICLE_CONTENT_HOOK_NAME, self.optimize_images)\n\n def optimize_images(self, content, *args, **kwargs):\n \"\"\"\n 优化文章中的图片标签\n \"\"\"\n if not content:\n return content\n\n # 正则表达式匹配 img 标签\n img_pattern = re.compile(\n r']*?)(?:\\s*/)?>',\n re.IGNORECASE | re.DOTALL\n )\n\n image_count = 0\n \n def replace_img_tag(match):\n nonlocal image_count\n image_count += 1\n \n # 获取原始属性\n original_attrs = match.group(1)\n \n # 解析现有属性\n attrs = self._parse_img_attributes(original_attrs)\n \n # 应用优化\n optimized_attrs = self._apply_optimizations(attrs, image_count)\n \n # 重构 img 标签\n return self._build_img_tag(optimized_attrs)\n\n # 替换所有 img 标签\n optimized_content = img_pattern.sub(replace_img_tag, content)\n \n return optimized_content\n\n def _parse_img_attributes(self, attr_string):\n \"\"\"\n 解析 img 标签的属性\n \"\"\"\n attrs = {}\n \n # 正则表达式匹配属性\n attr_pattern = re.compile(r'(\\w+)=([\"\\'])(.*?)\\2')\n \n for match in attr_pattern.finditer(attr_string):\n attr_name = match.group(1).lower()\n attr_value = match.group(3)\n attrs[attr_name] = attr_value\n \n return attrs\n\n def _apply_optimizations(self, attrs, image_index):\n \"\"\"\n 应用各种图片优化\n \"\"\"\n # 1. 懒加载优化（跳过第一张图片以优化LCP）\n if self.config['enable_lazy_loading']:\n if not (self.config['skip_first_image'] and image_index == 1):\n if 'loading' not in attrs:\n attrs['loading'] = 'lazy'\n\n # 2. 异步解码\n if self.config['enable_async_decoding']:\n if 'decoding' not in attrs:\n attrs['decoding'] = 'async'\n\n # 3. 添加样式优化\n current_style = attrs.get('style', '')\n \n # 确保图片不会超出容器\n if 'max-width' not in current_style:\n if current_style and not current_style.endswith(';'):\n current_style += ';'\n current_style += 'max-width:100%;height:auto;'\n attrs['style'] = current_style\n\n # 4. 添加 alt 属性（SEO和可访问性）\n if 'alt' not in attrs:\n # 尝试从图片URL生成有意义的alt文本\n src = attrs.get('src', '')\n if src:\n # 从文件名生成alt文本\n filename = src.split('/')[-1].split('.')[0]\n # 移除常见的无意义字符\n clean_name = re.sub(r'[0-9a-f]{8,}', '', filename) # 移除长hash\n clean_name = re.sub(r'[_-]+', ' ', clean_name).strip()\n attrs['alt'] = clean_name if clean_name else '文章图片'\n else:\n attrs['alt'] = '文章图片'\n\n # 5. 外部图片优化\n if self.config['optimize_external_images'] and 'src' in attrs:\n src = attrs['src']\n parsed_url = urlparse(src)\n \n # 如果是外部图片，添加 referrerpolicy\n if parsed_url.netloc and parsed_url.netloc != self._get_current_domain():\n attrs['referrerpolicy'] = 'no-referrer-when-downgrade'\n # 为外部图片添加crossorigin属性以支持性能监控\n if 'crossorigin' not in attrs:\n attrs['crossorigin'] = 'anonymous'\n\n # 6. 响应式图片属性（如果配置启用）\n if self.config['add_responsive_attributes']:\n # 添加 sizes 属性（如果没有的话）\n if 'sizes' not in attrs and 'srcset' not in attrs:\n attrs['sizes'] = '(max-width: 768px) 100vw, (max-width: 1024px) 50vw, 33vw'\n\n # 7. 添加图片唯一标识符用于性能追踪\n if 'data-img-id' not in attrs and 'src' in attrs:\n img_hash = hashlib.md5(attrs['src'].encode()).hexdigest()[:8]\n attrs['data-img-id'] = f'img-{img_hash}'\n\n # 8. 为第一张图片添加高优先级提示（LCP优化）\n if image_index == 1 and self.config['skip_first_image']:\n attrs['fetchpriority'] = 'high'\n # 移除懒加载以确保快速加载\n if 'loading' in attrs:\n del attrs['loading']\n\n return attrs\n\n def _build_img_tag(self, attrs):\n \"\"\"\n 重新构建 img 标签\n \"\"\"\n attr_strings = []\n \n # 确保 src 属性在最前面\n if 'src' in attrs:\n attr_strings.append(f'src=\"{attrs[\"src\"]}\"')\n \n # 添加其他属性\n for key, value in attrs.items():\n if key != 'src': # src 已经添加过了\n attr_strings.append(f'{key}=\"{value}\"')\n \n return f'预计阅读时间：{reading_minutes} 分钟
'\n \n return reading_time_html + content\n\n\nplugin = ReadingTimePlugin() "
},
{
"path": "plugins/seo_optimizer/__init__.py",
"content": "# This file makes this a Python package\n"
},
{
"path": "plugins/seo_optimizer/plugin.py",
"content": "import json\nfrom django.utils.html import strip_tags\nfrom django.template.defaultfilters import truncatewords\nfrom djangoblog.plugin_manage.base_plugin import BasePlugin\nfrom djangoblog.plugin_manage import hooks\nfrom blog.models import Article, Category, Tag\nfrom djangoblog.utils import get_blog_setting\n\n\nclass SeoOptimizerPlugin(BasePlugin):\n PLUGIN_NAME = 'SEO 优化器'\n PLUGIN_DESCRIPTION = '为文章、页面等提供高级 SEO 优化，动态生成增强的 Open Graph 标签和 JSON-LD 结构化数据。基础 SEO（title、description、keywords）由视图层提供。'\n PLUGIN_VERSION = '0.3.0'\n PLUGIN_AUTHOR = 'liuangliangyy'\n\n def register_hooks(self):\n hooks.register('head_meta', self.dispatch_seo_generation)\n\n def _get_article_seo_data(self, context, request, blog_setting):\n article = context.get('article')\n if not isinstance(article, Article):\n return None\n\n from django.utils.html import escape\n from django.utils.text import Truncator\n from djangoblog.utils import CommonMarkdown\n \n # 处理description：markdown -> HTML -> 纯文本，彻底去除格式\n html_content = CommonMarkdown.get_markdown(article.body)\n description = strip_tags(html_content)\n description = ' '.join(description.split())\n description = Truncator(description).chars(150, truncate='...')\n description_escaped = escape(description)\n \n # 增强的 Open Graph 标签\n # 使用article.get_full_url确保与canonical一致\n article_url = article.get_full_url()\n meta_tags = f'''\n \n
\n
\n\n
\n
\n
\n
\n {% trans 'Reset Password' %}\n \n
\n {% trans 'Enter your email to reset password' %}\n
\n
\n\n
\n
\n\n
\n
\n
\n {# Header #}\n
\n\n {# Form Card #}\n
\n
\n\n {# Footer links #}\n
\n
\n
\n {# Header #}\n
\n\n {# Form Card #}\n
\n
{{ title }} \n{% endblock %}\n{% block content %}\n \n
\n
\n
\n\n
{{ content }} \n\n
\n
\n
\n
{% trans 'article archive' %} | {{ SITE_NAME }} \n\n \n
\n
\n {# Page Header #}\n \n
{% trans 'article archive' %} \n
\n 共 {{ article_list|length }} 篇文章\n
\n
\n {% regroup article_list by pub_time.year as year_post_group %}\n\n {% for year in year_post_group %}\n
\n {# Year Header #}\n
\n {{ year.grouper }}\n \n\n {% regroup year.list by pub_time.month as month_post_group %}\n\n {% for month in month_post_group %}\n
\n {# Month Header #}\n
\n {{ month.grouper }} 月\n \n\n {# Articles in this month #}\n
\n {% for article in month.list %}\n
\n {# Timeline dot #}\n
\n
\n
\n {{ article.title }}\n \n
\n {{ article.pub_time|date:\"m-d\" }} \n {% if article.category %}\n · \n {{ article.category.name }} \n {% endif %}\n
\n
\n
\n {% endfor %}\n
\n
\n {% endfor %}\n
\n {% endfor %}\n
\n\n {# Sidebar #}\n
\n
\n {% load_sidebar user 'i' %}\n
\n
\n
\n
{{ seo_title|default:SITE_NAME }} \n \n
\n {# Main Content #}\n
\n {# Article #}\n \n \n {# Breadcrumb #}\n {% if article.type == 'a' %}\n {% cache 36000 breadcrumb_v3 article.pk %}\n {% load_breadcrumb article %}\n {% endcache %}\n {% endif %}\n\n {# Title #}\n
\n {{ article.title }}\n \n\n {# Meta #}\n
\n
\n {{ article.category.name }}\n \n
\n \n \n {{ article.pub_time|date:\"Y-m-d\" }}\n \n
\n \n \n {{ article.views }}\n \n {% if article.comment_status == \"o\" and open_site_comment %}\n
\n \n \n {{ article.comment_set.count }}\n \n {% endif %}\n
\n\n
\n\n {# Content #}\n
\n {% if article.show_toc %}\n {% get_markdown_toc article.body as toc %}\n
\n \n \n \n {% trans 'toc' %}\n \n \n {{ toc|safe }}\n \n \n {% endif %}\n
\n {% render_article_content article False %}\n
\n
\n\n {# Tags #}\n
\n\n {# Prev/Next Navigation #}\n {% if article.type == 'a' and next_article or prev_article %}\n
\n {% endif %}\n
\n\n {# Article bottom plugins #}\n {% render_plugin_widgets 'article_bottom' article=article %}\n\n {# Comments Section #}\n {% if article.comment_status == \"o\" and OPEN_SITE_COMMENT %}\n {% include 'comments/tags/comment_list_modern.html' %}\n\n {% if user.is_authenticated %}\n {% include 'comments/tags/post_comment_modern.html' %}\n {% else %}\n \n
\n {% trans 'login' %} \n 后发表评论\n
\n {% load oauth_tags %}\n
\n {% load_oauth_applications request %}\n
\n
\n\n {# Sidebar - Desktop #}\n
\n
\n {% load_sidebar user \"p\" %}\n
\n
\n
\n\n {# Mobile Sidebar #}\n
\n
\n \n 发现更多 \n \n \n \n \n {% load_sidebar user \"p\" %}\n
\n \n
\n
{{ SITE_NAME }} \n \n {# Main Grid #}\n
\n {# Main Content #}\n
\n {# Title Section #}\n \n {% if page_type == \"分类目录归档\" %}\n
分类
\n
{{ tag_name }} \n {% elif page_type == \"分类标签归档\" %}\n
标签
\n
{{ tag_name }} \n {% elif page_type == \"作者文章归档\" %}\n
作者
\n
{{ tag_name }} \n {% else %}\n
{% trans 'recent articles' %} \n {% endif %}\n
\n {% for article in article_list %}\n {% load_article_detail article True user %}\n {% endfor %}\n
\n\n {# Pagination #}\n {% if is_paginated %}\n {% load_pagination_info page_obj page_type tag_name %}\n {% endif %}\n \n\n {# Sidebar - Desktop: fixed right column #}\n
\n
\n {% load_sidebar user \"p\" %}\n
\n
\n
\n\n {# Mobile Sidebar - shown below content on small screens #}\n
\n
\n \n 发现更多 \n \n \n \n \n {% load_sidebar user \"p\" %}\n
\n \n
\n
404 NotFound \n {% elif statuscode == '403' %}\n Permission Denied \n {% elif statuscode == '500' %}\n 500 Error \n {% else %}\n {{ SITE_NAME }} | {{ SITE_DESCRIPTION }} \n {% endif %}\n \n
\n
\n \n
\n {# Error code #}\n {% if statuscode %}\n
\n {{ statuscode }}\n
\n {% endif %}\n\n {# Error message #}\n
\n {{ message }}\n \n\n {# Action buttons - unified style #}\n
\n
\n
\n\n {# Sidebar #}\n
\n
\n {% load_sidebar user 'i' %}\n
\n
\n
\n
友情链接 | {{ SITE_NAME }} \n\n \n
\n
\n {# Page Header #}\n \n
{% trans 'links' %} \n
\n 共 {{ object_list|length }} 个链接\n
\n
\n\n {# Sidebar #}\n
\n
\n {% load_sidebar user 'i' %}\n
\n
\n
\n
\n\n {# Top: Category & Date #}\n \n\n {# Title #}\n \n\n {# Excerpt (List page only) #}\n {% if isindex %}\n \n {% render_article_content article True %}\n
\n {% endif %}\n\n {# Bottom: Tags & Stats #}\n \n {# Tags #}\n
\n\n {# Stats #}\n
\n
\n \n \n {{ article.views }}\n \n {% if article.comment_status == \"o\" and open_site_comment %}\n
\n \n \n {{ article.comment_set.count }}\n \n {% endif %}\n
\n
\n"
},
{
"path": "templates/blog/tags/article_info_highlight.html",
"content": "{% load blog_tags %}\n{% load cache %}\n{% load i18n %}\n\n\n \n\n \n {% if isindex %}\n {# 列表页显示搜索摘要 #}\n {% if highlighted.body %}\n
\n {% for snippet in highlighted.body %}\n
...{{ snippet|safe }}...
\n {% endfor %}\n
\n {% else %}\n {% render_article_content article True %}\n {% endif %}\n
\n Read more \n
\n {% else %}\n {# 详情页显示完整内容（不高亮，因为高亮只在搜索结果列表有意义） #}\n {% if article.show_toc %}\n {% get_markdown_toc article.body as toc %}\n
{% trans 'toc' %}: \n {{ toc|safe }}\n
\n {% endif %}\n
\n {% render_article_content article False %}\n
\n {% endif %}\n
\n\n\n{% if not isindex %}\n {% render_plugin_widgets 'article_bottom' article=article %}\n{% endif %}\n"
},
{
"path": "templates/blog/tags/article_meta_info.html",
"content": "{% load i18n %}\n{% load blog_tags %}\n\n\n\n\n"
},
{
"path": "templates/blog/tags/article_pagination.html",
"content": "{% if page_obj.paginator.num_pages > 1 %}\n\n {# Previous #}\n {% if page_obj.has_previous and previous_url %}\n \n \n \n \n {% else %}\n \n \n \n \n {% endif %}\n\n {# Page numbers #}\n {% for item in page_range %}\n {% if item.type == 'ellipsis' %}\n ... \n {% elif item.is_current %}\n \n {{ item.number }}\n \n {% else %}\n \n {{ item.number }}\n \n {% endif %}\n {% endfor %}\n\n {# Next #}\n {% if page_obj.has_next and next_url %}\n \n \n \n \n {% else %}\n \n \n \n \n {% endif %}\n \n{% endif %}\n"
},
{
"path": "templates/blog/tags/article_tag_list.html",
"content": "{% load i18n %}\n{% if article_tags_list %}\n \n{% endif %}\n"
},
{
"path": "templates/blog/tags/breadcrumb.html",
"content": "\n\n \n {% for name,url in names %}\n \n \n {{ name }} \n \n \n \n \n \n \n {% endfor %}\n \n {{ title }} \n \n \n \n"
},
{
"path": "templates/blog/tags/sidebar.html",
"content": "{% load blog_tags %}\n{% load i18n %}\n\n\n"
},
{
"path": "templates/comments/tags/comment_item.html",
"content": "{% load blog_tags %}\n"
},
{
"path": "templates/comments/tags/comment_item_modern.html",
"content": "{% load blog_tags %}\n\n\n"
},
{
"path": "templates/comments/tags/comment_item_tree.html",
"content": "{% load blog_tags %}\n\n{% query article_comments parent_comment=comment_item as cc_comments %}\n{% for cc in cc_comments %}\n {% with comment_item=cc template_name=\"comments/tags/comment_item_tree.html\" %}\n {% if depth >= 1 %}\n {% include template_name %}\n {% else %}\n {% with depth=depth|add:1 %}\n {% include template_name %}\n {% endwith %}\n {% endif %}\n {% endwith %}\n{% endfor %}"
},
{
"path": "templates/comments/tags/comment_list.html",
"content": "\n \n\n "
},
{
"path": "templates/comments/tags/comment_list_modern.html",
"content": "{% load blog_tags %}\n{% load comments_tags %}\n{% load cache %}\n\n\n\n"
},
{
"path": "templates/comments/tags/post_comment.html",
"content": "\n\n\n"
},
{
"path": "templates/comments/tags/post_comment_modern.html",
"content": "\n\n\n\n\n"
},
{
"path": "templates/oauth/bindsuccess.html",
"content": "{% extends 'share_layout/base.html' %}\n{% block header %}\n {{ title }} \n{% endblock %}\n{% block content %}\n \n
\n
\n
\n\n
{{ content }} \n\n
\n
\n
\n
\n
\n
\n\n
\n
\n {% if picture %}\n
\n {% else %}\n
\n {% endif %}\n
绑定您的邮箱账号 \n
请输入您的邮箱以完成绑定
\n
\n\n
\n
\n\n
\n
\n
记录日期 \n\n\n\n\n {% for date in results %}\n \n {{ date }} \n \n {% endfor %}\n \n\n"
},
{
"path": "templates/owntracks/show_maps.html",
"content": "\n\n 运动轨迹 \n\n\n\n
\n\n\n\n\n\n\n\n"
},
{
"path": "templates/plugins/article_recommendation/__init__.py",
"content": "# 插件模板目录\n"
},
{
"path": "templates/plugins/article_recommendation/bottom_widget.html",
"content": "{% load i18n %}\n\n
\n 📖 {{ title }}\n \n
\n {% for article in recommendations %}\n {% if article.title and article.title|length > 0 %}\n
\n {% endif %}\n {% endfor %}\n
\n
搜索：{{ query }} | {{ SITE_NAME }} \n 搜索 | {{ SITE_NAME }} \n \n
\n
\n {% if query %}\n {# Search header #}\n \n {% if suggestion %}\n
\n 已显示 \"{{ suggestion }}\" 的搜索结果。\n 仍然搜索：{{ query }} \n \n {% else %}\n
\n 搜索：{{ query }} \n \n {% endif %}\n
\n {% for result in page.object_list %}\n {% load_article_detail result.object True user query %}\n {% endfor %}\n
\n\n {% if page.has_previous or page.has_next %}\n \n {% if page.has_previous %}\n \n \n \n 上一页 \n \n {% else %}\n
\n {% endif %}\n\n {% if page.has_next %}\n \n 下一页 \n \n \n \n {% else %}\n
\n {% endif %}\n \n {% endif %}\n {% else %}\n {# No results #}\n \n
\n \n
\n 关键字：{{ query }} 没有找到结果\n \n
要不换个词再试试？
\n
\n\n {# Sidebar #}\n
\n
\n {% load_sidebar request.user 'i' %}\n
\n
\n
\n
\n {% load i18n %}\n {% include 'share_layout/nav.html' %}\n
\n\n {% block content %}\n {% endblock %}\n\n\n {% block sidebar %}\n {% endblock %}\n\n\n
\n {% include 'share_layout/footer.html' %}\n
\n \n \n \n \n\n\n\n \n
\n
\n\n \n
\n
\n
\n\n \n
\n\n \n
\n \n \n \n
\n
\n
{{ SITE_NAME }} | {% block page_title %}Account{% endblock %} \n \n \n \n \n\n\n"
},
{
"path": "templates/share_layout/footer.html",
"content": "{% load i18n %}\n{% load blog_tags %}\n\n"
},
{
"path": "templates/share_layout/nav.html",
"content": "{% load blog_tags %}\n{% load i18n %}\n\n\n\n\n"
},
{
"path": "templates/share_layout/nav_node.html",
"content": "\n\n\n"
},
{
"path": "templates/share_layout/nav_node_mobile.html",
"content": "{% load blog_tags %}\n{% query nav_category_list parent_category=node as child_categorys %}\n\n\n \n\n {% if child_categorys %}\n \n {% endif %}\n \n"
}
]
![\"Django](\"https://github.com/liangliangyy/DjangoBlog/actions/workflows/django.yml/badge.svg\"){kind=icon}
\n ![\"Frontend](\"https://github.com/liangliangyy/DjangoBlog/actions/workflows/frontend.yml/badge.svg\"){kind=icon}
\n ![\"CodeQL\"](\"https://github.com/liangliangyy/DjangoBlog/actions/workflows/codeql-analysis.yml/badge.svg\"){kind=icon}
\n \n ![](\"https://codecov.io/gh/liangliangyy/DjangoBlog/branch/master/graph/badge.svg?token=vmnMtzuFqN\"/){kind=icon}
![\"license\"](\"https://img.shields.io/github/license/liangliangyy/djangoblog.svg\")
\n![\"支付宝赞助\"](\"/docs/imgs/alipay.jpg\")
\n ![\"微信赞助\"](\"/docs/imgs/wechat.jpg\")
\n![\"JetBrains](\"/docs/imgs/pycharm_logo.png\"){kind=logo}
\n \n![\"codecov\"](\"https://codecov.io/gh/liangliangyy/DjangoBlog/branch/master/graph/badge.svg\"){kind=icon}
\n
\n {# {% query article_comments parent_comment=None as parent_comments %}#}\n {% for comment_item in p_comments %}\n\n {% with 0 as depth %}\n {% include \"comments/tags/comment_item_tree.html\" %}\n {% endwith %}\n {% endfor %}\n\n
\n\n