diff --git a/src/DjangoBlog-master/blog/admin.py b/src/DjangoBlog-master/blog/admin.py
index 46c3420..917bcf5 100644
--- a/src/DjangoBlog-master/blog/admin.py
+++ b/src/DjangoBlog-master/blog/admin.py
@@ -17,18 +17,22 @@ class ArticleForm(forms.ModelForm):
fields = '__all__'
+#xjh：管理员动作函数 - 发布选中的文章
def makr_article_publish(modeladmin, request, queryset):
queryset.update(status='p')
+#xjh：管理员动作函数 - 将选中的文章设为草稿
def draft_article(modeladmin, request, queryset):
queryset.update(status='d')
+#xjh：管理员动作函数 - 关闭文章评论
def close_article_commentstatus(modeladmin, request, queryset):
queryset.update(comment_status='c')
+#xjh：管理员动作函数 - 打开文章评论
def open_article_commentstatus(modeladmin, request, queryset):
queryset.update(comment_status='o')
@@ -40,6 +44,7 @@ open_article_commentstatus.short_description = _('Open article comments')
class ArticlelAdmin(admin.ModelAdmin):
+ """xjh：文章模型的后台管理配置"""
list_per_page = 20
search_fields = ('body', 'title')
form = ArticleForm
@@ -65,6 +70,7 @@ class ArticlelAdmin(admin.ModelAdmin):
open_article_commentstatus]
def link_to_category(self, obj):
+ """xjh：在文章列表显示分类链接"""
info = (obj.category._meta.app_label, obj.category._meta.model_name)
link = reverse('admin:%s_%s_change' % info, args=(obj.category.id,))
return format_html(u'%s' % (link, obj.category.name))
@@ -72,15 +78,18 @@ class ArticlelAdmin(admin.ModelAdmin):
link_to_category.short_description = _('category')
def get_form(self, request, obj=None, **kwargs):
+ """xjh：限制作者字段只能选择超级用户"""
form = super(ArticlelAdmin, self).get_form(request, obj, **kwargs)
form.base_fields['author'].queryset = get_user_model(
).objects.filter(is_superuser=True)
return form
def save_model(self, request, obj, form, change):
+ """xjh：保存文章模型"""
super(ArticlelAdmin, self).save_model(request, obj, form, change)
def get_view_on_site_url(self, obj=None):
+ """xjh：获取文章在前台的URL"""
if obj:
url = obj.get_full_url()
return url
@@ -91,22 +100,27 @@ class ArticlelAdmin(admin.ModelAdmin):
class TagAdmin(admin.ModelAdmin):
+ """xjh：标签模型的后台管理配置"""
exclude = ('slug', 'last_mod_time', 'creation_time')
class CategoryAdmin(admin.ModelAdmin):
+ """xjh：分类模型的后台管理配置"""
list_display = ('name', 'parent_category', 'index')
exclude = ('slug', 'last_mod_time', 'creation_time')
class LinksAdmin(admin.ModelAdmin):
+ """xjh：友情链接模型的后台管理配置"""
exclude = ('last_mod_time', 'creation_time')
class SideBarAdmin(admin.ModelAdmin):
+ """xjh：侧边栏模型的后台管理配置"""
list_display = ('name', 'content', 'is_enable', 'sequence')
exclude = ('last_mod_time', 'creation_time')
class BlogSettingsAdmin(admin.ModelAdmin):
- pass
+ """xjh：博客设置模型的后台管理配置"""
+ pass
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/apps.py b/src/DjangoBlog-master/blog/apps.py
index 7930587..733788d 100644
--- a/src/DjangoBlog-master/blog/apps.py
+++ b/src/DjangoBlog-master/blog/apps.py
@@ -2,4 +2,5 @@ from django.apps import AppConfig
class BlogConfig(AppConfig):
- name = 'blog'
+ """xjh：博客应用的配置类"""
+ name = 'blog'
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/context_processors.py b/src/DjangoBlog-master/blog/context_processors.py
index 73e3088..7729c4e 100644
--- a/src/DjangoBlog-master/blog/context_processors.py
+++ b/src/DjangoBlog-master/blog/context_processors.py
@@ -9,6 +9,7 @@ logger = logging.getLogger(__name__)
def seo_processor(requests):
+ """xjh：SEO上下文处理器，为模板提供SEO相关变量"""
key = 'seo_processor'
value = cache.get(key)
if value:
@@ -16,6 +17,7 @@ def seo_processor(requests):
else:
logger.info('set processor cache.')
setting = get_blog_setting()
+ #xjh：构建包含SEO和网站配置的上下文字典
value = {
'SITE_NAME': setting.site_name,
'SHOW_GOOGLE_ADSENSE': setting.show_google_adsense,
@@ -39,5 +41,6 @@ def seo_processor(requests):
"GLOBAL_FOOTER": setting.global_footer,
"COMMENT_NEED_REVIEW": setting.comment_need_review,
}
+ #xjh：缓存上下文数据10小时
cache.set(key, value, 60 * 60 * 10)
- return value
+ return value
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/documents.py b/src/DjangoBlog-master/blog/documents.py
index 0f1db7b..adac98b 100644
--- a/src/DjangoBlog-master/blog/documents.py
+++ b/src/DjangoBlog-master/blog/documents.py
@@ -7,9 +7,11 @@ from elasticsearch_dsl.connections import connections
from blog.models import Article
+#xjh：检查是否启用了Elasticsearch
ELASTICSEARCH_ENABLED = hasattr(settings, 'ELASTICSEARCH_DSL')
if ELASTICSEARCH_ENABLED:
+ #xjh：创建Elasticsearch连接
connections.create_connection(
hosts=[settings.ELASTICSEARCH_DSL['default']['hosts']])
from elasticsearch import Elasticsearch
@@ -21,6 +23,7 @@ if ELASTICSEARCH_ENABLED:
try:
c.get_pipeline('geoip')
except elasticsearch.exceptions.NotFoundError:
+ #xjh：创建geoip处理管道，用于IP地址地理位置解析
c.put_pipeline('geoip', body='''{
"description" : "Add geoip info",
"processors" : [
@@ -34,6 +37,7 @@ if ELASTICSEARCH_ENABLED:
class GeoIp(InnerDoc):
+ """xjh：IP地理位置信息文档结构"""
continent_name = Keyword()
country_iso_code = Keyword()
country_name = Keyword()
@@ -41,21 +45,25 @@ class GeoIp(InnerDoc):
class UserAgentBrowser(InnerDoc):
+ """xjh：用户代理浏览器信息文档结构"""
Family = Keyword()
Version = Keyword()
class UserAgentOS(UserAgentBrowser):
+ """xjh：用户代理操作系统信息文档结构"""
pass
class UserAgentDevice(InnerDoc):
+ """xjh：用户代理设备信息文档结构"""
Family = Keyword()
Brand = Keyword()
Model = Keyword()
class UserAgent(InnerDoc):
+ """xjh：完整的用户代理信息文档结构"""
browser = Object(UserAgentBrowser, required=False)
os = Object(UserAgentOS, required=False)
device = Object(UserAgentDevice, required=False)
@@ -64,6 +72,7 @@ class UserAgent(InnerDoc):
class ElapsedTimeDocument(Document):
+ """xjh：页面加载耗时记录文档"""
url = Keyword()
time_taken = Long()
log_datetime = Date()
@@ -83,8 +92,10 @@ class ElapsedTimeDocument(Document):
class ElaspedTimeDocumentManager:
+ """xjh：耗时文档管理器"""
@staticmethod
def build_index():
+ """xjh：构建性能索引"""
from elasticsearch import Elasticsearch
client = Elasticsearch(settings.ELASTICSEARCH_DSL['default']['hosts'])
res = client.indices.exists(index="performance")
@@ -93,12 +104,14 @@ class ElaspedTimeDocumentManager:
@staticmethod
def delete_index():
+ """xjh：删除性能索引"""
from elasticsearch import Elasticsearch
es = Elasticsearch(settings.ELASTICSEARCH_DSL['default']['hosts'])
es.indices.delete(index='performance', ignore=[400, 404])
@staticmethod
def create(url, time_taken, log_datetime, useragent, ip):
+ """xjh：创建耗时记录"""
ElaspedTimeDocumentManager.build_index()
ua = UserAgent()
ua.browser = UserAgentBrowser()
@@ -116,6 +129,7 @@ class ElaspedTimeDocumentManager:
ua.string = useragent.ua_string
ua.is_bot = useragent.is_bot
+ #xjh：使用当前时间戳作为文档ID
doc = ElapsedTimeDocument(
meta={
'id': int(
@@ -127,10 +141,11 @@ class ElaspedTimeDocumentManager:
time_taken=time_taken,
log_datetime=log_datetime,
useragent=ua, ip=ip)
- doc.save(pipeline="geoip")
+ doc.save(pipeline="geoip") #xjh：保存文档并通过geoip管道处理
class ArticleDocument(Document):
+ """xjh：文章搜索文档结构"""
body = Text(analyzer='ik_max_word', search_analyzer='ik_smart')
title = Text(analyzer='ik_max_word', search_analyzer='ik_smart')
author = Object(properties={
@@ -165,19 +180,23 @@ class ArticleDocument(Document):
class ArticleDocumentManager():
+ """xjh：文章文档管理器"""
def __init__(self):
self.create_index()
def create_index(self):
+ """xjh：创建文章索引"""
ArticleDocument.init()
def delete_index(self):
+ """xjh：删除文章索引"""
from elasticsearch import Elasticsearch
es = Elasticsearch(settings.ELASTICSEARCH_DSL['default']['hosts'])
es.indices.delete(index='blog', ignore=[400, 404])
def convert_to_doc(self, articles):
+ """xjh：将文章对象转换为搜索文档"""
return [
ArticleDocument(
meta={
@@ -202,6 +221,7 @@ class ArticleDocumentManager():
article_order=article.article_order) for article in articles]
def rebuild(self, articles=None):
+ """xjh：重建文章索引"""
ArticleDocument.init()
articles = articles if articles else Article.objects.all()
docs = self.convert_to_doc(articles)
@@ -209,5 +229,6 @@ class ArticleDocumentManager():
doc.save()
def update_docs(self, docs):
+ """xjh：更新文档"""
for doc in docs:
- doc.save()
+ doc.save()
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/forms.py b/src/DjangoBlog-master/blog/forms.py
index 715be76..32c319f 100644
--- a/src/DjangoBlog-master/blog/forms.py
+++ b/src/DjangoBlog-master/blog/forms.py
@@ -7,13 +7,15 @@ logger = logging.getLogger(__name__)
class BlogSearchForm(SearchForm):
+ """xjh：博客搜索表单"""
querydata = forms.CharField(required=True)
def search(self):
+ """xjh：执行搜索"""
datas = super(BlogSearchForm, self).search()
if not self.is_valid():
return self.no_query_found()
if self.cleaned_data['querydata']:
logger.info(self.cleaned_data['querydata'])
- return datas
+ return datas
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/middleware.py b/src/DjangoBlog-master/blog/middleware.py
index 94dd70c..67aaa2d 100644
--- a/src/DjangoBlog-master/blog/middleware.py
+++ b/src/DjangoBlog-master/blog/middleware.py
@@ -10,14 +10,16 @@ logger = logging.getLogger(__name__)
class OnlineMiddleware(object):
+ """xjh：在线中间件，用于记录页面加载时间和用户访问信息"""
def __init__(self, get_response=None):
self.get_response = get_response
super().__init__()
def __call__(self, request):
- ''' page render time '''
+ ''' xjh：页面渲染时间统计 '''
start_time = time.time()
response = self.get_response(request)
+ #xjh：获取用户IP和User-Agent信息
http_user_agent = request.META.get('HTTP_USER_AGENT', '')
ip, _ = get_client_ip(request)
user_agent = parse(http_user_agent)
@@ -25,6 +27,7 @@ class OnlineMiddleware(object):
try:
cast_time = time.time() - start_time
if ELASTICSEARCH_ENABLED:
+ #xjh：记录页面加载耗时到Elasticsearch
time_taken = round((cast_time) * 1000, 2)
url = request.path
from django.utils import timezone
@@ -34,9 +37,10 @@ class OnlineMiddleware(object):
log_datetime=timezone.now(),
useragent=user_agent,
ip=ip)
+ #xjh：在页面内容中替换加载时间占位符
response.content = response.content.replace(
b'', str.encode(str(cast_time)[:5]))
except Exception as e:
logger.error("Error OnlineMiddleware: %s" % e)
- return response
+ return response
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/models.py b/src/DjangoBlog-master/blog/models.py
index 083788b..99840fa 100644
--- a/src/DjangoBlog-master/blog/models.py
+++ b/src/DjangoBlog-master/blog/models.py
@@ -18,6 +18,7 @@ logger = logging.getLogger(__name__)
class LinkShowType(models.TextChoices):
+ """xjh：链接显示类型选择"""
I = ('i', _('index'))
L = ('l', _('list'))
P = ('p', _('post'))
@@ -26,17 +27,20 @@ class LinkShowType(models.TextChoices):
class BaseModel(models.Model):
+ """xjh：基础模型类，包含公共字段"""
id = models.AutoField(primary_key=True)
creation_time = models.DateTimeField(_('creation time'), default=now)
last_modify_time = models.DateTimeField(_('modify time'), default=now)
def save(self, *args, **kwargs):
+ #xjh：特殊处理文章浏览量更新
is_update_views = isinstance(
self,
Article) and 'update_fields' in kwargs and kwargs['update_fields'] == ['views']
if is_update_views:
Article.objects.filter(pk=self.pk).update(views=self.views)
else:
+ #xjh：自动生成slug字段
if 'slug' in self.__dict__:
slug = getattr(
self, 'title') if 'title' in self.__dict__ else getattr(
@@ -45,6 +49,7 @@ class BaseModel(models.Model):
super().save(*args, **kwargs)
def get_full_url(self):
+ """xjh：获取完整URL"""
site = get_current_site().domain
url = "https://{site}{path}".format(site=site,
path=self.get_absolute_url())
@@ -55,11 +60,12 @@ class BaseModel(models.Model):
@abstractmethod
def get_absolute_url(self):
+ """xjh：抽象方法，获取绝对URL"""
pass
class Article(BaseModel):
- """文章"""
+ """xjh：文章模型"""
STATUS_CHOICES = (
('d', _('Draft')),
('p', _('Published')),
@@ -118,6 +124,7 @@ class Article(BaseModel):
get_latest_by = 'id'
def get_absolute_url(self):
+ """xjh：获取文章绝对URL"""
return reverse('blog:detailbyid', kwargs={
'article_id': self.id,
'year': self.creation_time.year,
@@ -127,6 +134,7 @@ class Article(BaseModel):
@cache_decorator(60 * 60 * 10)
def get_category_tree(self):
+ """xjh：获取分类树"""
tree = self.category.get_category_tree()
names = list(map(lambda c: (c.name, c.get_absolute_url()), tree))
@@ -136,10 +144,12 @@ class Article(BaseModel):
super().save(*args, **kwargs)
def viewed(self):
+ """xjh：增加文章浏览量"""
self.views += 1
self.save(update_fields=['views'])
def comment_list(self):
+ """xjh：获取文章评论列表"""
cache_key = 'article_comments_{id}'.format(id=self.id)
value = cache.get(cache_key)
if value:
@@ -152,23 +162,24 @@ class Article(BaseModel):
return comments
def get_admin_url(self):
+ """xjh：获取文章管理后台URL"""
info = (self._meta.app_label, self._meta.model_name)
return reverse('admin:%s_%s_change' % info, args=(self.pk,))
@cache_decorator(expiration=60 * 100)
def next_article(self):
- # 下一篇
+ """xjh：获取下一篇文章"""
return Article.objects.filter(
id__gt=self.id, status='p').order_by('id').first()
@cache_decorator(expiration=60 * 100)
def prev_article(self):
- # 前一篇
+ """xjh：获取上一篇文章"""
return Article.objects.filter(id__lt=self.id, status='p').first()
def get_first_image_url(self):
"""
- Get the first image url from article.body.
+ xjh：从文章内容中提取第一张图片URL
:return:
"""
match = re.search(r'!\[.*?\]\((.+?)\)', self.body)
@@ -178,7 +189,7 @@ class Article(BaseModel):
class Category(BaseModel):
- """文章分类"""
+ """xjh：文章分类模型"""
name = models.CharField(_('category name'), max_length=30, unique=True)
parent_category = models.ForeignKey(
'self',
@@ -205,7 +216,7 @@ class Category(BaseModel):
@cache_decorator(60 * 60 * 10)
def get_category_tree(self):
"""
- 递归获得分类目录的父级
+ xjh：递归获得分类目录的父级
:return:
"""
categorys = []
@@ -221,7 +232,7 @@ class Category(BaseModel):
@cache_decorator(60 * 60 * 10)
def get_sub_categorys(self):
"""
- 获得当前分类目录所有子集
+ xjh：获得当前分类目录所有子集
:return:
"""
categorys = []
@@ -241,7 +252,7 @@ class Category(BaseModel):
class Tag(BaseModel):
- """文章标签"""
+ """xjh：文章标签模型"""
name = models.CharField(_('tag name'), max_length=30, unique=True)
slug = models.SlugField(default='no-slug', max_length=60, blank=True)
@@ -253,6 +264,7 @@ class Tag(BaseModel):
@cache_decorator(60 * 60 * 10)
def get_article_count(self):
+ """xjh：获取标签下的文章数量"""
return Article.objects.filter(tags__name=self.name).distinct().count()
class Meta:
@@ -262,7 +274,7 @@ class Tag(BaseModel):
class Links(models.Model):
- """友情链接"""
+ """xjh：友情链接模型"""
name = models.CharField(_('link name'), max_length=30, unique=True)
link = models.URLField(_('link'))
@@ -287,7 +299,7 @@ class Links(models.Model):
class SideBar(models.Model):
- """侧边栏,可以展示一些html内容"""
+ """xjh：侧边栏模型，可以展示一些html内容"""
name = models.CharField(_('title'), max_length=100)
content = models.TextField(_('content'))
sequence = models.IntegerField(_('order'), unique=True)
@@ -305,7 +317,7 @@ class SideBar(models.Model):
class BlogSettings(models.Model):
- """blog的配置"""
+ """xjh：博客设置模型"""
site_name = models.CharField(
_('site name'),
max_length=200,
@@ -367,10 +379,12 @@ class BlogSettings(models.Model):
return self.site_name
def clean(self):
+ """xjh：验证只能有一个博客配置实例"""
if BlogSettings.objects.exclude(id=self.id).count():
raise ValidationError(_('There can only be one configuration'))
def save(self, *args, **kwargs):
+ """xjh：保存时清除缓存"""
super().save(*args, **kwargs)
from djangoblog.utils import cache
- cache.clear()
+ cache.clear()
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/search_indexes.py b/src/DjangoBlog-master/blog/search_indexes.py
index 7f1dfac..a062214 100644
--- a/src/DjangoBlog-master/blog/search_indexes.py
+++ b/src/DjangoBlog-master/blog/search_indexes.py
@@ -4,10 +4,13 @@ from blog.models import Article
class ArticleIndex(indexes.SearchIndex, indexes.Indexable):
+ """xjh：文章搜索索引配置"""
text = indexes.CharField(document=True, use_template=True)
def get_model(self):
+ """xjh：指定搜索模型"""
return Article
def index_queryset(self, using=None):
- return self.get_model().objects.filter(status='p')
+ """xjh：指定索引查询集，只索引已发布的文章"""
+ return self.get_model().objects.filter(status='p')
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/tests.py b/src/DjangoBlog-master/blog/tests.py
index ee13505..64396d5 100644
--- a/src/DjangoBlog-master/blog/tests.py
+++ b/src/DjangoBlog-master/blog/tests.py
@@ -20,11 +20,13 @@ from oauth.models import OAuthUser, OAuthConfig
# Create your tests here.
class ArticleTest(TestCase):
+ """xjh：文章相关测试用例"""
def setUp(self):
self.client = Client()
self.factory = RequestFactory()
def test_validate_article(self):
+ """xjh：测试文章相关功能"""
site = get_current_site().domain
user = BlogUser.objects.get_or_create(
email="liangliangyy@gmail.com",
@@ -149,6 +151,7 @@ class ArticleTest(TestCase):
self.client.get('/admin/admin/logentry/1/change/')
def check_pagination(self, p, type, value):
+ """xjh：检查分页功能"""
for page in range(1, p.num_pages + 1):
s = load_pagination_info(p.page(page), type, value)
self.assertIsNotNone(s)
@@ -160,6 +163,7 @@ class ArticleTest(TestCase):
self.assertEqual(response.status_code, 200)
def test_image(self):
+ """xjh：测试图片上传和处理功能"""
import requests
rsp = requests.get(
'https://www.python.org/static/img/python-logo.png')
@@ -183,10 +187,12 @@ class ArticleTest(TestCase):
'https://www.python.org/static/img/python-logo.png')
def test_errorpage(self):
+ """xjh：测试错误页面"""
rsp = self.client.get('/eee')
self.assertEqual(rsp.status_code, 404)
def test_commands(self):
+ """xjh：测试管理命令"""
user = BlogUser.objects.get_or_create(
email="liangliangyy@gmail.com",
username="liangliangyy")[0]
@@ -229,4 +235,4 @@ class ArticleTest(TestCase):
call_command("create_testdata")
call_command("clear_cache")
call_command("sync_user_avatar")
- call_command("build_search_words")
+ call_command("build_search_words")
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/urls.py b/src/DjangoBlog-master/blog/urls.py
index adf2703..caf40e3 100644
--- a/src/DjangoBlog-master/blog/urls.py
+++ b/src/DjangoBlog-master/blog/urls.py
@@ -5,58 +5,71 @@ from . import views
app_name = "blog"
urlpatterns = [
+ #xjh：首页
path(
r'',
views.IndexView.as_view(),
name='index'),
+ #xjh：首页分页
path(
r'page//',
views.IndexView.as_view(),
name='index_page'),
+ #xjh：文章详情页
path(
r'article////.html',
views.ArticleDetailView.as_view(),
name='detailbyid'),
+ #xjh：分类目录页
path(
r'category/.html',
views.CategoryDetailView.as_view(),
name='category_detail'),
+ #xjh：分类目录分页
path(
r'category//.html',
views.CategoryDetailView.as_view(),
name='category_detail_page'),
+ #xjh：作者文章页
path(
r'author/.html',
views.AuthorDetailView.as_view(),
name='author_detail'),
+ #xjh：作者文章分页
path(
r'author//.html',
views.AuthorDetailView.as_view(),
name='author_detail_page'),
+ #xjh：标签文章页
path(
r'tag/.html',
views.TagDetailView.as_view(),
name='tag_detail'),
+ #xjh：标签文章分页
path(
r'tag//.html',
views.TagDetailView.as_view(),
name='tag_detail_page'),
+ #xjh：文章归档页（缓存1小时）
path(
'archives.html',
cache_page(
60 * 60)(
views.ArchivesView.as_view()),
name='archives'),
+ #xjh：友情链接页
path(
'links.html',
views.LinkListView.as_view(),
name='links'),
+ #xjh：文件上传接口
path(
r'upload',
views.fileupload,
name='upload'),
+ #xjh：清理缓存接口
path(
r'clean',
views.clean_cache_view,
name='clean'),
-]
+]
\ No newline at end of file
diff --git a/src/DjangoBlog-master/blog/views.py b/src/DjangoBlog-master/blog/views.py
index d5dc7ec..f95d2f1 100644
--- a/src/DjangoBlog-master/blog/views.py
+++ b/src/DjangoBlog-master/blog/views.py
@@ -25,6 +25,7 @@ logger = logging.getLogger(__name__)
class ArticleListView(ListView):
+ """xjh：文章列表视图基类"""
# template_name属性用于指定使用哪个模板进行渲染
template_name = 'blog/article_index.html'
@@ -61,7 +62,7 @@ class ArticleListView(ListView):
def get_queryset_from_cache(self, cache_key):
'''
- 缓存页面数据
+ xjh：缓存页面数据
:param cache_key: 缓存key
:return:
'''
@@ -77,7 +78,7 @@ class ArticleListView(ListView):
def get_queryset(self):
'''
- 重写默认，从缓存获取数据
+ xjh：重写默认，从缓存获取数据
:return:
'''
key = self.get_queryset_cache_key()
@@ -91,7 +92,7 @@ class ArticleListView(ListView):
class IndexView(ArticleListView):
'''
- 首页
+ xjh：首页视图
'''
# 友情链接类型
link_type = LinkShowType.I
@@ -107,7 +108,7 @@ class IndexView(ArticleListView):
class ArticleDetailView(DetailView):
'''
- 文章详情页面
+ xjh：文章详情页面视图
'''
template_name = 'blog/article_detail.html'
model = Article
@@ -163,7 +164,7 @@ class ArticleDetailView(DetailView):
class CategoryDetailView(ArticleListView):
'''
- 分类目录列表
+ xjh：分类目录列表视图
'''
page_type = "分类目录归档"
@@ -202,7 +203,7 @@ class CategoryDetailView(ArticleListView):
class AuthorDetailView(ArticleListView):
'''
- 作者详情页
+ xjh：作者详情页视图
'''
page_type = '作者文章归档'
@@ -228,7 +229,7 @@ class AuthorDetailView(ArticleListView):
class TagDetailView(ArticleListView):
'''
- 标签列表页面
+ xjh：标签列表页面视图
'''
page_type = '分类标签归档'
@@ -260,7 +261,7 @@ class TagDetailView(ArticleListView):
class ArchivesView(ArticleListView):
'''
- 文章归档页面
+ xjh：文章归档页面视图
'''
page_type = '文章归档'
paginate_by = None
@@ -276,6 +277,7 @@ class ArchivesView(ArticleListView):
class LinkListView(ListView):
+ """xjh：友情链接列表视图"""
model = Links
template_name = 'blog/links_list.html'
@@ -284,6 +286,7 @@ class LinkListView(ListView):
class EsSearchView(SearchView):
+ """xjh：Elasticsearch搜索视图"""
def get_context(self):
paginator, page = self.build_page()
context = {
@@ -303,7 +306,7 @@ class EsSearchView(SearchView):
@csrf_exempt
def fileupload(request):
"""
- 该方法需自己写调用端来上传图片，该方法仅提供图床功能
+ xjh：文件上传接口，该方法需自己写调用端来上传图片，该方法仅提供图床功能
:param request:
:return:
"""
@@ -344,6 +347,7 @@ def page_not_found_view(
request,
exception,
template_name='blog/error_page.html'):
+ """xjh：404页面处理视图"""
if exception:
logger.error(exception)
url = request.get_full_path()
@@ -355,6 +359,7 @@ def page_not_found_view(
def server_error_view(request, template_name='blog/error_page.html'):
+ """xjh：500页面处理视图"""
return render(request,
template_name,
{'message': _('Sorry, the server is busy, please click the home page to see other?'),
@@ -366,6 +371,7 @@ def permission_denied_view(
request,
exception,
template_name='blog/error_page.html'):
+ """xjh：403页面处理视图"""
if exception:
logger.error(exception)
return render(
@@ -375,5 +381,6 @@ def permission_denied_view(
def clean_cache_view(request):
+ """xjh：清理缓存视图"""
cache.clear()
- return HttpResponse('ok')
+ return HttpResponse('ok')
\ No newline at end of file