Django开发个人博客网站——15、通过markdown实现博客内容的展示

到现在我们已经可以实现很多功能了&＃xff0c;包括登陆后台写博客&＃xff0c;前端博客的展示、归档、标签云等等。但是直到现在我们的博客是没有样式的&＃xff0c;所有的文字顺序排列&＃xff0c;很不美观。如何才能实现博客的排版呢&＃xff1f;还好有很多文字编辑器&＃xff0c;我们可以使用最简单也是应用很广泛的&＃xff0c;markdown语法。

什么是markdown语法&＃xff0c;我们的CSDN、简书、博客园等都是用的markdown语法。它规则很简单&＃xff0c;可以参考如下资料&＃xff1a;

• Markdown——入门指南
• Markdown 语法说明 (简体中文版)

1、安装markdown

进入虚拟环境&＃xff1a;

pip install markdown

2、渲染 Markdown

将 Markdown 格式的文本渲染成 HTML 文本非常简单&＃xff0c;只需调用这个库的 markdown 方法即可。我们书写的博客文章内容存在 Blog的 content属性里&＃xff0c;回到我们的详情页视图函数&＃xff0c;对Blog 的 content的值做一下渲染&＃xff0c;把 Markdown 文本转为 HTML 文本再传递给模板&＃xff1a;

view.py

import markdown# 将博客内容用markdown显示出来
blog.content &＃61; markdown.markdown(blog.content)


这样我们在模板中展示 {{ blog.content }} 的时候&＃xff0c;就不再是原始的 Markdown 文本了&＃xff0c;而是渲染过后的 HTML 文本。

blog-detail.html

{{ blog.content|safe }}

Django 出于安全方面的考虑&＃xff0c;任何的 HTML 代码在 Django 的模板中都会被转义&＃xff08;即显示原始的 HTML 代码&＃xff0c;而不是经浏览器渲染后的格式&＃xff09;。为了解除转义&＃xff0c;只需在模板标签使用 safe 过滤器即可&＃xff0c;告诉 Django&＃xff0c;这段文本是安全的&＃xff0c;你什么也不用做。

这样&＃xff0c;再次刷新页面&＃xff0c;就可以看到带有样式的博客页面了。

3、给主页添加上样式

我们这里只是给博客详情页面加上了markdown样式&＃xff0c;但是我们博客的主页还有博客内容的展示。因此&＃xff0c;也需要给博客主页的index.html添加上样式&＃xff1a;

view.py

class IndexView(View):def get(self, request):all_blog &＃61; Blog.objects.all().order_by(&＃39;-id&＃39;)for blog in all_blog:blog.content &＃61; markdown.markdown(blog.content)....

因为得到的是个queryset&＃xff0c;因此需要用for循环对每个对象进行markdown样式的渲染。

最后要说明的是&＃xff0c;对于我们不经常用markdwon语法的人&＃xff0c;直接在后台书写markdown毕竟还是不太习惯的&＃xff0c;并且没有实时预览。还有一点就是图片的插入我们暂时是实现不了的&＃xff0c;因为这个功能需要将图片上传到云盘中&＃xff0c;获得图片链接后再插入到博客内。为了简单操作&＃xff0c;建议大家可以下载一个markdown编辑器&＃xff0c;写好后直接粘过去就行了。让然&＃xff0c;也可以像我一样&＃xff0c;直接在csdn博客上书写&＃xff0c;完事粘过去就可以了。

——————————————————————————————————————————

项目的完整代码&＃xff1a;django_blog
觉得有用的欢迎给个star。