前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >告别繁琐.html文件,使用Docsify快速搭建文档网站

告别繁琐.html文件,使用Docsify快速搭建文档网站

作者头像
腾讯云开发TCB
发布2020-06-03 15:07:54
8680
发布2020-06-03 15:07:54
举报
文章被收录于专栏:云开发云开发

Docsify是一个漂亮的动态生成文档的工具。如果只是需要快速的搭建一个小型的文档网站,或者不想因为生成的一堆 .html 文件“污染” commit 记录,只需要创建一个 index.html 就可以开始写文档而且直接部署在云开发静态托管上。

云开发(CloudBase)是一款云端一体化的产品方案 ,采用 serverless 架构,免环境搭建等运维事务 ,支持一云多端,助力快速构建小程序、Web应用、移动应用。

云开发静态网站托管支持通过云开发SDK调用服务端资源如:云函数、云存储、云数据库等,从而将静态网站扩展为全栈网站

无论是腾讯云·云开发用户,还是小程序·云开发用户,只要开通按量付费,即可享有云开发静态网站托管服务

Let's Go

接下来我们分三步进行:搭建环境→创建项目→部署

搭建环境

1.安装Node.js 和 npm

通过 node -v 命令查看本机是否安装,如果没有安装,参考node.js安装指南 根据电脑系统环境进行安装

2.安装cloudbase/cli

npm install -g @cloudbase/cli

3.安装docsify-cli

npm i docsify-cli -g

4.测试安装是否成功

cloudbase -v

docsify -v

如果看到输出版本号,说明已经安装成功。

创建项目

1.初始化这个项目

docsify init docs

初始化完成后,你可以修改 /docs/README.md 文件内容,然后在本地运行

2.运行本地服务器

docsify serve docs

运行成功后,打开浏览器,访问 localhost:3000

部署

创建云开发环境

访问腾讯云云开发控制台,新建【按量计费云开发环境】,记住云开发环境ID,我们需要用到云开发网站托管服务,目前只有按量计费的环境才支持静态托管。

进入网站托管控制页,开通静态网站托管服务:

当你看到这样的界面时,就说明已经开通好了。

登入

tcb login

这个时候会提醒你需要在网页中授权,在弹出的页面确认授权:

确认授权后,你会看到控制台输出相应的命令,

执行命令上传文件,记得将这里的 EnvID 替换为你自己的环境的环境 ID:

稍等片刻,文件就上传好了。

查看静态网站域名和状态:

这个时候你会看到静态网站域名,打开浏览器访问就可以了,

这个时候你可以访问云开发控制台,查看上传的文件:

点击设置,就可以看到刚才控制台输出的默认域名,当然你也可以添加自己的域名。

小结

部署过程中用到的环境ID envId,可以在云开发控制台查看,docsify的基本使用可以到其官网查看。

如果在操作过程中遇到问题,可以评论留下你的问题哦~

One More Thing

云开发CloudBase全新升级,支持小程序开发、Web和APP多端应用开发!更有[9.9元云开发静态网站托管包年赞助计划]!还等什么?快来体验吧!

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2020-04-17,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 腾讯云开发CloudBase 微信公众号,前往查看

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

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • Let's Go
    • 创建云开发环境
      • 登入
      • One More Thing
      相关产品与服务
      静态网站托管
      静态网站托管(Website Hosting,WH)是由云开发提供的便捷、稳定、高拓展性的托管服务,您无需自建服务器,即可一键部署网站应用,将静态网站发布到全网节点,轻松为您的业务增添稳定、高并发、快速访问等能力。此外,您还可以结合云开发的云函数、数据库等能力,将静态网站扩展为带有后台服务端的全栈网站,让您可极速提供网站应用。
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档