前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >【玩转腾讯云】快速搭建私有文档编辑系统 支持Markdown

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

原创
作者头像
用户7148954
修改2020-04-07 17:43:08
2.1K0
修改2020-04-07 17:43:08
举报
文章被收录于专栏:ii

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

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

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

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

Ubuntu 18.04 实际操作:

1. 安装NodeJS

代码语言:javascript
复制
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

2.安装Mongodb

代码语言:javascript
复制
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.list
sudo apt-get update
sudo apt-get install -y mongodb-org
sudo systemctl start mongod
mongo
use admin
db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "root", db: "admin" } ] } )
use topdocs
db.createUser( { user: "topdocs", pwd: "topdocs", roles: [ { role: "readWrite", db: "topdocs" } ] } )
exit
vim /etc/mongod.conf
<!-- append lines -->
security:
  authorization: enabled
<!-- 退出编辑 -->
sudo systemctl restart mongod

3.安装topdocs:

代码语言:javascript
复制
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.list
sudo apt-get update && sudo apt-get install yarn
git clone https://gitee.com/quazero/topdocs
cd topdocs
yarn       

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

代码语言:javascript
复制
const config = {
  endpoint: 'http://127.0.0.1:3000/admin/api',
}
find endpoint
edit it
endpoint: 'https://docs.moejj.com/admin/api'

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

代码语言:javascript
复制
yarn build
nohup yarn start &
exit

使用教程

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

代码语言:javascript
复制
-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语句,自己根据需要编写。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
作者已关闭评论
0 条评论
热度
最新
推荐阅读
目录
  • 正巧我最近做博客,对文档工具有一些需求,所以搭建了这款开源的文档系统。
  • Ubuntu 18.04 实际操作:
    • 1. 安装NodeJS
      • 3.安装topdocs:
        • 4.反代绑定一个域名并且SSL之后,比如我绑定一个域名:docs.moejj.com,编辑index.js
          • 5.编译之后,开启应用:
            • 使用教程
            相关产品与服务
            云服务器
            云服务器(Cloud Virtual Machine,CVM)提供安全可靠的弹性计算服务。 您可以实时扩展或缩减计算资源,适应变化的业务需求,并只需按实际使用的资源计费。使用 CVM 可以极大降低您的软硬件采购成本,简化 IT 运维工作。
            领券
            问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档