Go to file
2020-06-28 21:11:05 +08:00
app_admin 修复电子邮箱配置相关问题 2020-06-17 20:58:03 +08:00
app_api 0.5.3版本,更新记录详见changes.md 2020-06-13 20:41:17 +08:00
app_doc v0.5.4 详见更新日志 2020-06-21 21:44:10 +08:00
BrowserMark Chrome扩展添加鼠标选择控制选项 2020-06-28 20:14:46 +08:00
captrue 修改文档页面新增删除文档功能,优化首页样式 2020-05-08 20:36:16 +08:00
config 添加Chromium启动参数配置项 2020-05-21 13:32:11 +08:00
media 修复获取下级文档的bug 2019-07-28 10:02:19 +08:00
MrDoc v0.5.4 详见更新日志 2020-06-21 21:44:10 +08:00
static 优化文档样式 2020-06-28 20:32:42 +08:00
template 优化后台管理界面样式 2020-06-28 21:11:05 +08:00
.gitignore 新增注册邀请码功能,并优化部分样式 2020-02-22 14:22:44 +08:00
CHANGES.md 更新自述文件 2020-06-28 20:48:46 +08:00
LICENSE v0.5.4 详见更新日志 2020-06-21 21:44:10 +08:00
manage.py 第一次提交 2019-07-21 22:08:04 +08:00
README_ENG.md 更新自述文件 2020-06-28 20:48:46 +08:00
README.md 更新自述文件 2020-06-28 20:48:46 +08:00
requirements.txt 更新依赖库Django版本 2020-06-07 08:10:02 +08:00

MrDoc觅道文档 - 记录文档,汇聚思想 - English

mrdoc python mrdoc

Mrdoc首页

介绍

MrDoc 是基于Python开发的在线文档系统适合作为个人和小型团队的文档、知识和笔记管理工具。致力于成为全平台Web端、桌面端、移动端的私有化在线文档部署方案。

目前涵盖:

开源地址

码云: https://gitee.com/zmister/MrDoc

GitHub: https://github.com/zmister2016/MrDoc

示例站点: http://mrdoc.zmister.com 可注册、可创建文集、文档,账号不定期清除,仅作测试用途,请勿编写重要文档。

说明文档:

MrDoc安装手册MrDoc文档效果MrDoc使用手册

特性:

  • 站点管理与用户管理

    • 支持用户注册、登录、管理、管理员等基础用户功能;
    • 支持站点配置注册邀请码、广告代码、统计代码、邮箱找回密码、全站关闭注册、全站强制登录等管理功能;
    • 支持个人中心管理文集、文档、文档模板、图片、附件支持个人中心导出文集MD文件压缩包
    • 支持配置文集权限提供公开、私密、指定用户可见、访问码可见4种权限模式
  • 文档系统

    • 基于文集进行文档撰写和阅读,拥有文集文档文档模板图片附件5大模块
    • 使用基于EditormdMarkdown编辑器优化和扩展,以Markdown语法进行文档写作,并支持图片管理和上传、表格粘贴、思维导图绘制、流程图绘制、序列图绘制:
    • 两栏式文档阅读页面、三级目录层级显示文档阅读字体缩放字体类型切换页面社交分享移动端阅读优化、文集导出PDF、EPUB文件
    • 支持基于账户的**API接口**,可以借助账户token通过API获取文集、上传图片和创建文档;
    • 支持文集协作功能,一个文集可以拥有一个创建者和多个协作者,可灵活选择协作权限;
    • 支持文档历史版本功能,可以查看和对比历史版本与现有版本的差异,恢复某个历史版本为当前版本;

完整更新记录详见:CHANGES.md

在开发过程中参考和借鉴了GitBook、ShowDoc、Wordbook等应用和网站的功能与样式并使用了众多开源组件、插件。

应用核心依赖环境

MrDoc基于Python语言的Django Web框架配合前端的LayUIJQuery等库进行开发。

MrDocPython 3.6 + Django 2.2上进行开发并且在Django 2.1、2.2和Python3.5、3.6、3.7上测试运行良好在其他环境下运行MrDoc不排除有未知的异常。

简明安装教程

1、安装依赖库

pip install -r requirements.txt

2、配置数据库信息

默认情况下MrDoc使用Django的SQLite数据库如果你使用Sqlite数据库则无需另外配置数据库。

如果有配置其他数据库的需求请首先按照Django官方的数据库支持说明安装特定数据库的Python绑定库

然后在/MrDoc/config目录下打开conig.ini文件根据自己的数据库信息进行修改

# engine指定数据库类型接受sqlite、mysql、oracle、postgresql
engine = sqlite
# name表示数据库的名称
# name = db_name
# user表示数据库用户名
# user = db_user
# password表示数据库用户密码
# password = db_pwd
# host表示数据库主机地址
# host = db_host
# port表示数据库端口
# port = db_port

3、初始化数据库

在安装完所需的第三方库并配置好数据库信息之后,我们需要对数据库进行初始化。

在项目路径下打开命令行界面,运行如下命令生成数据库迁移:

python manage.py makemigrations 

运行如下命令执行数据库迁移:

python manage.py migrate

执行完毕之后,数据库就初始化完成了。

4、创建管理员账户

在初始化完数据库之后需要创建一个管理员账户来管理整个MrDoc在项目路径下打开命令行终端运行如下命令

python manage.py createsuperuser

按照提示输入用户名、电子邮箱地址和密码即可。

5、测试运行

在完成上述步骤之后即可运行使用MrDoc。

在测试环境中可以使用Django自带的服务器运行MrDoc其命令为

python manage.py runserver

问题提交和反馈

1、提交issue

在如下页面提交问题:

2、加入MrDoc交流群

加入MrDoc交流QQ群:

  • 群1付费 735507293
  • 群2免费 849206042,入群密码:mrdoc

3、联系作者

微信WeChattaoist_ling

公众号:zmister2016

博客:https://zmister.com

赞赏项目

开源不易需要鼓励如果MrDoc觅道文档对你有所帮助请给予一个Star

欢迎给予开发者赞赏,助力项目更好发展。

Paypal:https://paypal.me/zmister