Django1.9开发博客(11)- 富文本与代码高亮

时间:2021-11-19 20:50:04

TinyMCE是一个轻量级的基于浏览器的所见即所得编辑器,支持目前流行的各种浏览器,由JavaScript写成。 功能配置灵活简单(两行代码就可以将编辑器嵌入网页中),支持AJAX。另一特点是加载速度非常快。

django里引用TinyMCE富文本编辑器,其实很简单,前提是你知道django的静态文件配置。 其实这个我已经在前面文章提到过,可以回去再看看。

TinyMCE的官方网站是:http://www.tinymce.com/

下载地址:http://download.moxiecode.com/tinymce/tinymce_4.1.9.zip

TinyMCE的最新版本是4.1.9,下面是官网截屏:

Django1.9开发博客(11)- 富文本与代码高亮

下载下来后,我们把它解压到工程的static/目录下面,如下图所示:

Django1.9开发博客(11)- 富文本与代码高亮

安装原理

安装的原理很简单,只需要在使用编辑器的页面里引用tinymce.min.js文件并初始化就可以了。 tinymce.min.js文件在tinymce项目里, tinymce.min.js会根据初始配置里的信息找到需要用编辑器的html节点。

例如在post_edit.html页面使用编辑器,只需要在模板文件写下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{% load staticfiles %}
{% block header %}
<link rel="stylesheet" href="{% static 'tinymce/plugins/upload/plugin.css' %}">
<script type="text/javascript" src="{% static 'tinymce/tinymce.min.js' %}"></script>
<script type="text/javascript">
tinymce.init({
selector: "textarea",
//width: 800,
height: 300,
forced_root_block: false,
plugins: [
"advlist autolink lists link image charmap print preview anchor sh4tinymce upload",
"searchreplace visualblocks code fullscreen",
"insertdatetime table contextmenu paste"
],
toolbar: "insertfile undo redo | styleselect | bold italic | alignleft aligncenter" +
" alignright alignjustify | bullist numlist outdent indent | preview link image sh4tinymce"
});
</script>
{% endblock %}

这段代码的含义是 初始化 tinyMCE编辑器,selector指需要将编辑器显示在html那个标签节点, 这里选了textareas。则表示会变成编辑器所在的位置。

另外,我还自定义一下编辑器的高度、插件、菜单项目等。具体详细配置请参考官方文档,写的都比较清楚。

给TinyMCE增加一个addmore插件

需求很简单,就是每次我写文章的时候需要插入某个<!--more-->标签, 这样可以在列表页面先只显示文章的一部分,然后碰到这个more标签就显示一个”点击阅读更多”的链接。

第一步,在tinymce/plugins文件下新增一个addmore文件夹,然后在里面新建一个plugin.min.js文件, 内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
tinymce.PluginManager.add("addmore", function (a) {
a.addCommand("InsertMoreRule", function () {
a.execCommand("mceInsertContent", !1, "[!--more--]")
}), a.addButton("addmore", {
icon: "addmore",
tooltip: "Insert More",
cmd: "InsertMoreRule"
}), a.addMenuItem("addmore", {
icon: "addmore",
text: "Insert More",
cmd: "InsertMoreRule",
context: "insert"
})
});

在post_edit.html中修改tinymce.init方法,plugins项目后面添加一个addmore:

...
plugins: [
"advlist autolink lists link image charmap print preview anchor sh4tinymce upload",
"searchreplace visualblocks code fullscreen",
"insertdatetime table contextmenu paste addmore"
],
...

再看看效果,没问题了。

SyntaxHighlighter代码高亮

程序员写博客当然少不了代码高亮,这个功能页很容易实现。有一款插件叫SyntaxHighlighter值的推荐。

项目主页:http://alexgorbatchev.com/SyntaxHighlighter/

下载地址:http://alexgorbatchev.com/SyntaxHighlighter/download/download.php?sh_current

下载下来后直接解压到static/目录下面,这个跟tinymce是一样的原理。

使用方法

只需要修改django页面的基础模板就行了,非常简单。

打开mysite/templates/mysite/base.html页面,引入syntaxhighlighter:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{% load staticfiles %}
{% load i18n %}
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/>
<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
<!-- Optional theme -->
<link rel="stylesheet" href="{% static 'css/bootstrap-theme.min.css' %}">
<!-- Blog CSS-->
<link rel="stylesheet" href="{% static 'css/blog.css' %}">
<link type="text/css" rel="stylesheet" href="{% static 'syntaxhighlighter/styles/shCoreDefault.css' %}"/>
<script type="text/javascript" src="{% static 'syntaxhighlighter/scripts/shCore.js' %}"></script>
<script type="text/javascript">SyntaxHighlighter.all();</script>
<!-- Latest compiled and minified JavaScript -->
<script src="{% static 'js/jquery-1.11.1.min.js' %}"></script>
<script src="{% static 'js/base.js' %}"></script>
<script src="{% static 'js/bootstrap.min.js' %}"></script>
{% block header %}
{% endblock %}
<title>{% trans 'Simple Blog'%}</title>
</head>
<body class="customize-support">
中间省略...
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushJScript.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushBash.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushPhp.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushJava.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushSql.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushXml.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushPython.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushCss.js' %}"></script>
<script class="javascript" src="{% static 'syntaxhighlighter/scripts/shBrushCpp.js' %}"></script>
</body>
</html>

由于我们之前已经安装过了TinyMCE,这个跟它结合起来就非常好用了,因为TinyMCE自带有选择代码语言功能。

下面是我创建文章时,插入了一段python代码的示例:

Django1.9开发博客(11)- 富文本与代码高亮

这个是保存后的效果:

Django1.9开发博客(11)- 富文本与代码高亮

最后一件事

别忘了部署到Heroku上面和别人分享你的成果。

OK,到此为止,前台的各种功能已经差不多了,你能一直坚持学到这里很不错了,为你自己鼓掌吧。

后面还有一个重头戏,就是django的后台管理,我选择了更美观更好用的xamdin,敬请期待…