python测试开发django-56.模板渲染markdown语法+代码高亮

时间:2021-03-26 15:05:56

前言

上一篇已经实现在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 设计
- 设计者友好的模板语言
- 缓存系统。 # 图片展示 图片显示 ![](/media/editor/1_20190422134140555628.png) # 代码展示 \```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">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;作者: 上海-悠悠</span>
<span class="views-count">&nbsp;&nbsp;&nbsp;&nbsp;阅读 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页面效果如下

python测试开发django-56.模板渲染markdown语法+代码高亮

代码高亮展示

这里代码部分,默认是不会有背景的,也不会也高亮,如下图

python测试开发django-56.模板渲染markdown语法+代码高亮

代码高亮展示需要安装Pygments模块

pip install Pygments

接着在你的app的static目录新建一个css目录:hello/static/hello/css

python测试开发django-56.模板渲染markdown语法+代码高亮

打开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">

刷新页面后,就能显示高亮的代码了

python测试开发django-56.模板渲染markdown语法+代码高亮