【玩转腾讯云】快速搭建私有文档编辑系统 支持Markdown

TopDocs 是一个开源的基于graphql、nuxtjs、mongodb、keystonejs的实时在线文档编辑系统,可用作各种在线文档编辑和展示,支持markdown语法。

其拥有动态实时编辑系统,移动优先,服务端渲染,针对SEO优化。适合小到大型项目的在线文档官网。

正巧我最近做博客,对文档工具有一些需求,所以搭建了这款开源的文档系统。

机器配置:1C-1G-1M

Ubuntu 18.04 实际操作:

1. 安装NodeJS

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -sudo apt-get install -y nodejs

2.安装Mongodb

echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.listsudo apt-get updatesudo apt-get install -y mongodb-orgsudo systemctl start mongodmongouse admindb.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "root", db: "admin" } ] } )use topdocsdb.createUser( { user: "topdocs", pwd: "topdocs", roles: [ { role: "readWrite", db: "topdocs" } ] } )exitvim /etc/mongod.conf<!-- append lines -->security:  authorization: enabled<!-- 退出编辑 -->sudo systemctl restart mongod

3.安装topdocs:

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.listsudo apt-get update && sudo apt-get install yarngit clone https://gitee.com/quazero/topdocscd topdocsyarn       

4.反代绑定一个域名并且SSL之后,比如我绑定一个域名:docs.moejj.com,编辑index.js

const config = {  endpoint: 'http://127.0.0.1:3000/admin/api',}find endpointedit itendpoint: 'https://docs.moejj.com/admin/api'

5.编译之后,开启应用:

yarn buildnohup yarn start &exit

使用教程

开启之后,后台地址/admin ,密码为adminadmin,自己进后台修改。 设置中index中是首页的展示内容,需要注意的是:

-logo-/logo.png-logo--title-跨世代文档编辑系统-title--subtitle-实时动态markdown文档编辑系统,基于graqhql、mongodb、keystonejs、nuxtjs开发的移动优先的服务端渲染文档系统。-subtitle--button-查看文档$https://gitee.com/quazero/topdocs-button-===header===header下面就是完全的markdown语法的编写区域,编辑完成之后,首页可查看变化。

-logo-之间的是LOGO图片,可链接也可路径。

-title-之间的是首页展示大标题。

-subtitle-之间的是首页展示的项目介绍。

-button-是首页展示按钮需要的内容。其中<按钮名>$<链接>,链接可链接也可路径,按需更改。

===header===下面的就是正常的markdown语句,自己根据需要编写。

注明:本文为星速云原创版权所有,禁止转载,一经发现将追究版权责任!

发表评论

登录后才能评论
问答社区 QQ客服
微信客服
微信客服
分享本页
返回顶部