无服务器部署个人知识库,小白使用Docsify+Markdown+‌Vercel快速上线

304 阅读6分钟

无服务器部署个人知识库

Docsify

docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 .html 文件,所有转换工作都是在运行时。如果你想要开始使用它,只需要创建一个 index.html 就可以开始编写文档并直接部署在 GitHub Pages

特性

  • 无需构建,写完文档直接发布
  • 容易使用并且轻量 (压缩后 ~21kB)
  • 智能的全文搜索
  • 提供多套主题
  • 丰富的 API
  • 支持 Emoji
  • 兼容 IE11
  • 支持服务端渲染 SSR (示例)

快速启动

通过使用静态 Web 服务器或 GitHub Pages,利用这个现成的 Docsify 模板 可快速开始。查看 快速入门教程

访问页面

请在此添加图片描述

Markdown

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

## 前言

### 第一趴

### 第二趴

#### 第二趴第一节

### 无需列表

- 苹果
- 香蕉
- 巧克力

### 有序列表

1. 猫猫
2. 狗狗
3. 小绵羊

请在此添加图片描述

Vercel

Vercel是一个现代化的静态网站部署和托管平台,提供简单、快速的部署方式,适用于静态网站、单页应用程序(SPA)、服务器渲染应用程序(SSR)和函数式后端服务‌。Vercel的主要特点和功能包括:

  1. 零配置部署‌:用户可以轻松地将项目部署到全球分布的CDN,无需繁琐的配置‌。
  2. 自动缩放‌:根据流量变化自动调整资源,确保应用程序始终具有良好的性能‌。
  3. 预渲染和服务器渲染支持‌:支持静态网站的预渲染,提供更快的页面加载速度,同时支持Next.js等服务器渲染框架‌。
  4. 灰度部署和A/B测试‌:允许用户将新功能部署到一小部分用户进行测试,评估性能和用户体验‌。
  5. 域名管理和SSL‌:提供域名管理工具和免费的SSL证书,确保应用程序的安全性和可靠性‌。
  6. 集成GitHub、GitLab和Bitbucket‌:与常见的代码托管平台集成,通过Git进行部署,方便团队协作‌。

Vercel由Vercel Inc.开发,成立于2015年,总部位于加利福尼亚。Vercel的创始人Guillermo RauchWeb开发领域的知名人物,团队还包括许多其他技术大牛,如React官方脚手架项目create-react-app的核心成员Joe HaddadSvelte框架的作者Rich Harris‌。

Vercel不仅是一个部署工具,还致力于优化前端团队的整个开发和部署体验,支持Jamstack架构,这种架构将前端与后端分离,有助于改善开发人员体验和网站性能‌。

请在此添加图片描述

GitHub部署

通过github登录后 点击 add New...

请在此添加图片描述

选择对应github项目

请在此添加图片描述

修改项目名称、点击deploy,等待生成

请在此添加图片描述

请在此添加图片描述

点击访问我的部署案例

好啦到这里 关联github项目部署就完成了 是不是很快,缺点就是国内打开很慢(可能需要梯子)。

本地部署

要在本地部署 Vercel 应用,您可以使用 Vercel CLI 来设置本地开发环境。以下是步骤和示例代码:

  1. 安装 Vercel CLI:
npm install -g vercel
  1. 克隆您的 Vercel 项目仓库(如果您有远程仓库):
git clone https://github.com/username/repo.git
cd repo
  1. 安装项目依赖:
npm install
  1. 在项目根目录下启动 Vercel 的开发服务器:
vercel dev
  1. 如果一切顺利,你将看到类似的输出,表明本地服务器已经运行并且可以通过指定的 URL 访问:
Ready! Available at the URL(s):
  - http://localhost:3000

在浏览器中打开提供的 URL 地址,你应该看到你的 Vercel 应用运行在本地。

注意:确保你的 Vercel 项目配置文件 vercel.json 和 now.json 正确无误,并且所有必要的环境变量都已经配置好。

Vercel部署相关文章参考

未完待续,持续更新中...

感谢关注点赞评论~