python实现一个简单的项目建议书范文_开源一个Python文档写作系统：MrDoc

一、为什么写MrDoc

从2016年底到今天，州的先生在博客上写了一百来篇文章，其中有不少的都是连载类型的系列教程。在积累了一定数量的文章之后，就打算将其整理为一个文集，方便读者朋友的连贯性阅读和学习。但是博客使用的WordPress在进行文集管理方面并不是很好，于是就在市面上找各种文档文集系统。在这个过程中，接触到了如下几个优秀的文档写作系统：

Gitbook

一个基于Node.js的文档写作工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，其提供本地化地部署，也支持在gitbook上注册账号进行文档写作。

ShowDoc

一个国内团队开发的基于PHP的文档写作系统，可以快速使用Markdown编写文档，更加适用于技术团队的文档写作。目前我在项目中既是使用其作为数据采集数据库的字段说明文档系统。同时也是提供了本地部署的开源版本和线上的使用版本。

WordBook

一个基于WordPress的文档写作主题，文档页面类似于gitbook。据说是免费的，但是下载主题需要加QQ群。

WeDocs

一个WordPress的插件和主题，目前州的先生博客的在线教程栏目既是使用这个插件编写的，离自己的需求还是差了那么一点。

每个系统都有各自的特点，功能也很丰富，但是在面对自己的需求的使用，也都有一些不如意的地方。兜兜转转还是觉得自己动手写一个比较好。仔细参考和借鉴了一下各个文档系统，发现基本功能的实现并不复杂，那就开干吧。

二、MrDoc都有哪些功能

MrDoc借鉴了上述部分应用的功能和样式，拥有以下特点：

基于Django自带的用户模型，实现简单高效的用户管理，支持用户注册、用户登录、管理员等控制等功能；

基于Editormd的Markdown编辑器，支持Markdown语法的文档写作，支持图片粘贴上传；

提供文档模板功能，支持文档模板的创建、修改；

仿GitBook文档阅读页面，支持文档阅读页面的字体缩放，字体类型修改；

支持三级目录层级显示；

部分页面截图如下所示：

首页：

文档阅读页：

文档阅读页面切换字体、隐藏侧边栏：

文档编写页面：

选择文档模板：

三、如何下载MrDoc

目前，MrDoc已经将代码托管到开源中国旗下的代码托管平台——Gitee上，项目地址为：https://gitee.com/zmister/MrDoc

如需要的小伙伴可以前往下载。

四、如何使用MrDoc

有关于MrDoc的使用和二次开发，州的先生已经在编写《MrDoc说明文档》，网址为：http://mrdoc.zmister.com

此网站亦是基于MrDoc搭建的MrDoc演示站点。

五、反馈建议和Bug

如果你在使用过程中有好的建议或遇到了Bug，欢迎给州的先生反馈。

1、提交issue

2、加入MrDoc 交流QQ群

加入MrDoc交流QQ群，群号为735507293，入群密码：mrdoc

分享到：

python实现一个简单的项目建议书范文_开源一个Python文档写作系统：MrDoc相关推荐

python实现一个简单的项目建议书范文_建议收藏，22个Python迷你项目(附源码)
Python部落在使用Python的过程中,我最喜欢的就是Python的各种第三方库,能够完成很多操作. 下面就给大家介绍22个通过Python构建的项目,以此来学习Python编程. 大家也可根据项 ...
python实现一个简单的项目建议书范文_建议收藏，18个Python迷你项目(附源码)
在使用Python的过程中,我最喜欢的就是Python的各种第三方库,能够完成很多操作. 下面就给大家介绍22个通过Python构建的项目,以此来学习Python编程. 大家也可根据项目的目的及提示, ...
【软件项目管理】项目建议书是项目立项阶段开发的文档
项目建议书不是项目计划阶段开发的文档,而是项目立项阶段开发的文档. 在项目选择过程中,关键是对项目的定义有明确的描述,包括明确项目的目标.时间表.项目使用的资源和经费,而且得到执行该项目的项目经理和项 ...
python如何寻找两个相似的文件_如何计算两个文档的相似度（二）
上一节我们介绍了一些背景知识以及gensim , 相信很多同学已经尝试过了.这一节将从gensim最基本的安装讲起,然后举一个非常简单的例子用以说明如何使用gensim,下一节再介绍其在课程图谱上的应 ...
python api文档管理工具_开源的api文档管理系统
在项目中,需要协同开发,所以会写许多API文档给其他同事,以前都是写一个简单的TXT文本或Word文档,口口相传,这种方式比较老土了,所以,需要有个api管理系统专门来管理这些api,从网上找了许多比 ...
Java项目—健身房管理系统（附源码+文档）
今天给大家分享一个Java实战项目-健身房管理系统(附源码+数据库+文档) 需要资料源码的小伙伴可以点击下方链接和小编一起学习~ 需要源码直接私信小编哟~https://www.bilibili.co ...
《maven实战》笔记（2）----一个简单maven项目的搭建，测试和打包
参照<maven实战>在本地创建对应的基本项目helloworld,在本地完成后项目结构如下: 可以看到maven项目的骨架: src/main/java(javaz主代码) src/te ...
c c 语言编程项目实例,实例分享cmake编译一个简单c++项目(demo)
实例分享cmake编译一个简单c++项目(demo) 发布时间:2020-09-19 21:08:04 来源:脚本之家阅读:63 作者:mdxy-dxy 下面通过一个小例子来说明cmake编译一个c ...
使用spring boot实现一个简单的项目——⽤户管理功能
Spring Boot之用户管理功能趁着这几天有时间跟大家分享一个使用spring boot实现的一个简单的项目,也开启了我第一次在CSDN上面写博客,相信这是个新的篇章.好了,废话不多说,直接上真 ...
实现一个简单的trim函数，用于去除一个字符串，头部和尾部的空白字符
// 实现一个简单的trim函数,用于去除一个字符串,头部和尾部的空白字符 // 假定空白字符只有半角空格.Tab // 练习通过循环,以及字符串的一些基本方法,分别扫描字符串str头部和尾部是否有连 ...

python实现一个简单的项目建议书范文_开源一个Python文档写作系统：MrDoc

python实现一个简单的项目建议书范文_开源一个Python文档写作系统：MrDoc相关推荐

最新文章

热门文章