用Python搭建一个校园维基网站(一)

时间:2022-04-25
本文章向大家介绍用Python搭建一个校园维基网站(一),主要内容包括简述、效果图、Wagtail初体验、基本概念、基础应用、原理机制和需要注意的事项等,并结合实例形式分析了其使用技巧,希望通过本文能帮助到大家理解应用这部分内容。

專 欄

treelakePython中文社区专栏作者

项目Github地址:

https://github.com/zr777/school-wiki

简述

  • 我们的目标是做一个校园维基站点,提供校园生活百科的内容服务。
  • 主要需求为
    1. 百科的搜索
    2. 百科的标签分类
    3. 人人皆可参与编辑
    4. 界面简洁大方直观
  • 其实有一个很好的技术选型,那就是开源的wikihow 英文中文,它的UI简洁不失美观,单维基页面的展示很清晰,而且是基于某种markdown语言的人人可修改。不过,它是基于mediaWiki,熟悉PHP的同学可以去尝试。
  • 对于Python而言,虽然没有现成的工具,但借助强大的Python开源社区,我们也可以很快地搭建起一个轻量级的校园百科网站。
  • Wagtail是一个基于Django的优秀CMS(内容管理系统)。有强大的Django社区做后盾,开发资源相当丰富。利用它我们可以轻松地搭建属于自己的内容发布网站。
  • Wagtail的后台管理界面漂亮而且强大,有良好的权限管理系统,页面、图片和文档的管理功能以及富文本编辑功能。在文本内容搜索上可以集成elasticsearch,非常方便。
  • 学习一个开源框架最好的方式就是去读它的官方文档 - wagtail。它的官方文档已经比较完善了,对新手友好,推荐阅读。
  • 由于单人开发而且业务逻辑比较简单明确,没有考虑前后端分离,而是利用django模板功能,在SEO方面有一定的优势。
  • 为了方便,前端样式选择了轻量的purecss框架,有现成的一些页面样式可以使用,而且比较符合个人审美。
  • 此外,由于之前的内容发布使用WordPress博客系统,需要导入原来的原生HTML内容,维基页面要兼容原生html,所以目前游客的权限较低,修改后需要提交审核。markdown编辑功能暂时没有加上,不过有开源的插件,使用很方便。

效果图

移动端首页

PC端首页

标签页

搜索结果页面

PC端单维基页面

移动端单维基页面

帮助修改页面

帮助修改的富文本编辑与其他功能

Wagtail初体验

1、pip install wagtail安装库。

2、命令行输入wagtail start mysite开始我们的项目。

3、cd mysite进入项目目录。

4、python manage.py migrate数据库迁移 。

5、python manage.py createsuperuser创建管理员。

6、python manage.py runserver开始运行,就可以在http://127.0.0.1:8000看到你的第一个wagtail网页了。