python测试开发django-56.模板渲染markdown语法+代码高亮
前言
上一篇已经实现在xadmin后台编辑markdown语法的文档，编辑完成之后发布博客，在前端html能把markdown语法显示出来。
主要思路是先从数据库把markdown的代码读出来，导入markdown模块，把markdown的语法转换成html语法，再嵌入到模板里面。
markdown
先使用pip按照markdown模块，用于转换markdown为html
pip install markdown
在后台页面编辑的markdown内容，markdown里面插入代码一般有两种方式：一种是把代码全部选中，然后缩进（四个空格）
第二种是代码部分用三个```包起来,后面可以跟着对应语言python，如下（这里不太好展示，前面的\要去掉）
# django 框架介绍
Django 项目是一个Python定制框架，它源自一个在线新闻 Web 站点，于 2005 年以开源的形式被释放出来。Django 框架的核心组件有：
- 用于创建模型的对象关系映射
- 为最终用户设计的完美管理界面
- 一流的 URL 设计
- 设计者友好的模板语言
- 缓存系统。
# 图片展示
图片显示
# 代码展示
\```python # 前面的\去掉
from django.db import models
from mdeditor.fields import MDTextField # 必须导入
class Blog(models.Model):
'''博客管理'''
title = models.CharField(max_length=30)
content = MDTextField() # 注意为MDTextField()
def __str__(self):
return self.__doc__ + "title->" + self.title
class Meta:
verbose_name = "博客发布"
verbose_name_plural = verbose_name
\``` # 前面的\去掉
views试图
在views.py中导入markdown，这里extensions里面三个参数用法,
- markdown.extensions.extra 本身包含很多扩展
- markdown.extensions.codehilite 是语法高亮，后面插入代码会用到
- markdown.extensions.toc 是自动生成目录
from .models import Blog
import markdown
def detail(request, id):
'''博客详情展示, 根据id读取'''
blog = Blog.objects.filter(id=int(id)).first()
blog.content = markdown.markdown(blog.content,
extensions=[
'markdown.extensions.extra',
'markdown.extensions.codehilite',
'markdown.extensions.toc',
],
safe_mode=True,
enable_attributes=False)
context = {
"blogmd": blog
}
return render(request, 'blogmd.html', context)
templates模板
接下来把markdown的内容插入到以下模板的{{ blogmd.content | safe}} 位置，这里需加个safe参数，
Django 出于安全方面的考虑，任何的 HTML 代码在 Django 的模板中都会被转义（即显示原始的 HTML 代码，而不是经浏览器渲染后的格式）。
为了解除转义，只需在模板标签使用 safe 过滤器即可，告诉 Django，这段文本是安全的，你什么也不用做
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="../static/hello/css/code.css" type="text/css">
<title>{{blogmd.title}}</title>
</head>
<body>
<div style="margin: 5% 20%;">
<h1>{{blogmd.title}}</h1>
<br>
<div class="author">
<span class="publish-time">2019.04.22 18:28 发布</span>
<span class="wordage"> 作者： 上海-悠悠</span>
<span class="views-count"> 阅读 9999</span>
</div>
<hr>
{{ blogmd.content | safe}}
</div>
</body>
文件名保存为blogmd.html
urls.py设置
urls.py设置访问地址
from django.conf.urls import url
from hello import views
urlpatterns = [
url(r'^blog/(.+).html$', views.detail),
]
访问地址:http://localhost:8000/blog/2.html页面效果如下
代码高亮展示
这里代码部分，默认是不会有背景的，也不会也高亮，如下图
代码高亮展示需要安装Pygments模块
pip install Pygments
接着在你的app的static目录新建一个css目录：hello/static/hello/css
打开cmd, cd到hello/static/hello/css目录，执行以下指令，会在当前目录生成一个code.css文件
pygmentize -S default -f html -a .codehilite > code.css
在模板里面引入这个css文件就可以了，在head里面加一个link
<link rel="stylesheet" href="../static/hello/css/code.css" type="text/css">
刷新页面后，就能显示高亮的代码了
