前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >三分钟入坑指北 🔜 Docsify + Serverless Framework 快速创建个人博客系统

三分钟入坑指北 🔜 Docsify + Serverless Framework 快速创建个人博客系统

原创
作者头像
Aceyclee
修改2020-02-05 11:22:26
修改2020-02-05 11:22:26
1.4K0
举报
文章被收录于专栏:Tencent Serverless 官方专栏

之前由于学摄影的关系,为了提高自己的审美,顺便锻炼下自己的英文能力,翻译了不少国外艺术类的 文章。最近一直想搭一个个人博客来存放这些内容,又懒得折腾建站,遂一直搁置。

直到偶然发现了 docsifyServerless Framework,建站一下子变得特别容易 —— 用 docsify 创建博客系统,然后用 Serverless Framework 部署服务,三分钟就搞定了!

简单介绍一下:

  • docsify:一个神奇的文档网站生成工具,不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件,所有转换工作都是在运行时进行。而且如果只是需要快速搭建一个小型的文档网站,或者不想因为生成的一堆 .html 文件「污染」 commit 记录,只需要创建一个 index.html 就可以开始写文档;
  • Serverless Framework:在 GitHub 上有三万颗星,业界非常受欢迎的无服务器应用框架,开发者无需关心底层资源即可部署完整可用的 Serverless 应用架构。

接下来我们分三步进行:安装与初始化 → 配置 yml 文件 → 部署

▎安装与初始化

首先确保系统包含以下环境:

  • Node.js (Node.js 版本需不低于 8.6,建议使用 10.0 及以上版本)
  • Git

1. 安装 Serverless Framework

代码语言:txt
复制
$ npm install -g serverless

2. 安装 docsify

代码语言:txt
复制
$ npm i docsify-cli -g

3. 初始化项目

代码语言:txt
复制
$ docsify init docsify

初始化成功后,可以看到 ./docsify 目录下创建的几个文件

  • index.html 入口文件
  • README.md 会做为主页内容渲染

直接编辑 docsify/README.md 就能更新网站内容,当然也可以写多个页面,这是后话。

4. 本地预览

运行以下命令,并通过浏览器访问 http://localhost:3000 即可方便地预览效果,而且提供 LiveReload 功能,可以实时预览。

代码语言:txt
复制
$ docsify serve docsify

▎配置 yml 文件

在项目目录下,创建 serverless.yml 文件:

代码语言:txt
复制
$ touch serverless.yml

将以下内容写入上述的 yml 文件里:

代码语言:txt
复制
# serverless.yml

mydocsify:
  component: "@serverless/tencent-website"
  inputs:
    code:
      src: ./docsify # Upload static files generated by docsify
      index: index.html
      error: index.html
    region: ap-guangzhou
    bucketName: my-bucket

配置完成后,文件目录如下:

代码语言:txt
复制
.
├── docsify
|   ├── index.html
|   └── README.md
└── serverless.yml

▎部署

通过 sls 命令进行部署,这里还可以添加 --debug 参数来查看部署过程中的信息,

代码语言:txt
复制
$ sls --debug

如果你的账号未 登陆注册 腾讯云,可以直接通过微信扫描命令行中的二维码,从而进行授权登陆和注册。这也是我觉得特别方便的一个地方!

部署过程中,terminal 显示信息示意:

部署过程
部署过程

访问命令行输出的 url,即可查看使用 Serverless Framework 部署的 docsify 文档网站啦~

最终效果
最终效果

▎小结

以上示例基于腾讯云的无服务器框架 Serverless Framework 实现,代码详情可参考完整的 模板仓库 👈

虽然这只是一个非常简单的 demo,但是不难看出,Serverless Framework 在快速部署方面的强大能力。比如集成了微信扫描二维码,就直接让我们避开了繁琐的云服务的账号注册、配置的环节。而你需要做的,只是根据 docsify 自身的能力,进行网站的定制而已。通过这两个工具的结合使用,即使编程小白也能快速搭建起自己的个人博客!✌️

传送门:GitHub: github.com/serverless 官网:serverless.com

欢迎访问:Serverless 中文网,您可以在 最佳实践 里体验更多关于 Serverless 应用的开发!😝

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

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

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

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

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • ▎安装与初始化
  • ▎配置 yml 文件
  • ▎部署
  • ▎小结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档