专栏首页ii【玩转腾讯云】快速搭建私有文档编辑系统 支持Markdown
原创

【玩转腾讯云】快速搭建私有文档编辑系统 支持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.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:

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

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

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

yarn build
nohup 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语句,自己根据需要编写。

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

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

相关文章

  • ubuntu 18.04安装sublime text教程

    AI之禅
  • Ubuntu配置开发环境

    如果不习惯Vim,强烈建议VSCodehttps://code.visualstudio.com/

    py3study
  • Python|斐波那契数列

    斐波那契数列(Fibonacci sequence),又称黄金分割数列、因数学家列昂纳多·斐波那契(Leonardoda Fibonacci)以兔子繁殖为例子而...

    算法与编程之美
  • OOW 2015 精彩预告

    2015年旧金山Oracle OpenWorld大会,一年一度再次来临,虽然距离开幕还有几天,但是我们已经能够从大会日程上,饱览OOW的精华和重点内容。以下我将...

    数据和云
  • Toolbar去除标题与返回键间的间距

    标题和左侧的返回键间距过大,之前在做CloudReader的时候就遇到了,一直没有解决,由于自身强迫症,心里始终和这个过不去,就研究了很久终于解决了。

    Jingbin
  • 深度学习笔记总结(2) 改善深层神经网络:超参数调试、 正则化以及优化

    如果我们的模型太简单并且参数很少,那么它可能具有高偏差和低方差。另一方面,如果我们的模型具有大量参数,那么它将具有高方差和低偏差。因此,我们需要找到正确/良好的...

    致Great
  • 代码解读 | VINS_Mono中的鱼眼相机模型

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 ...

    用户1150922
  • mysql执行计划看是否最优

    介绍   本篇主要通过汇总网上的大牛的知识,简单介绍一下如何使用mysql的执行计划,并根据执行计划判断如何优化和是否索引最优。   执行计划可显示估计查询语...

    用户1217611
  • 关系型数据库大佬—Oracle

    大家好,我是Oracle。Oracle,西方人认为有“神谕、预言”之意,中国人则译作“甲骨文”,是当今世界最强大的数据库软件。所有这一切要从IBM的一篇论文谈起...

    DataScience
  • 用 Cricket 在 Java 环境里构建极简的内容管理服务器

    原文地址:https://dzone.com/articles/minimalistic-cms-microservice-for-java

    Techeek

扫码关注云+社区

领取腾讯云代金券