Three Minutes to Get Started: Docsify + Serverless Framework for Rapid Personal Blog Creation
2023-10-15 10:28:48
用 Docsify 和 Serverless Framework 创建一个免费的个人博客
创建美观、现代的博客
作为一名摄影爱好者，我翻译了许多国外艺术文章来提升我的审美和英语水平。最近，我考虑建立一个个人博客来存放这些内容。但搭建一个网站对我来说太麻烦了，所以一直搁置。
就在这时，我发现了 Docsify，一个神奇的文档网站生成工具。它与 GitBook 和 Hexo 不同，它不通过将 Markdown 文件转换为 HTML 来生成静态网站。相反，它直接从 Git 仓库加载 Markdown 文件，并动态地在浏览器中渲染它们。这种方法有以下优点：
- 无需在本地构建网站，节省了大量时间和精力。
- Markdown 文件更改后自动更新，使网站保持最新状态变得轻而易举。
- 易于部署到任何支持静态文件的 Web 托管平台，例如 GitHub Pages、Netlify 和 Amazon S3。
安装 Docsify
要使用 Docsify，只需通过 npm 全局安装它：
npm install docsify-cli -g
然后，为你的博客创建一个新目录并初始化一个 Git 仓库：
mkdir my-blog
cd my-blog
git init
创建 Docsify 项目
在项目的根目录中创建一个名为 docsify.config.js 的新文件。此文件将包含你的 Docsify 项目的配置。这是一个示例配置：
module.exports = {
name: 'My Blog',
repo: 'https://github.com/username/my-blog', // Your GitHub repository
loadSidebar: true, // Whether to load the sidebar
homepage: 'README.md', // The homepage of your blog
};
部署到 Serverless Framework
要将你的博客部署到 Serverless Framework，你需要创建一个新的 Serverless 项目。你可以通过运行以下命令来执行此操作：
serverless create --template aws-nodejs
这将在当前目录中创建一个新的 Serverless 项目。
接下来，你需要将以下代码添加到你的 serverless.yml 文件中：
functions:
blog:
handler: handler.main
events:
- http:
path: /
method: get
cors: true
此代码定义了一个名为 blog 的新函数，它将由对根路径 (/) 的 HTTP GET 请求触发。
最后，你需要将以下代码添加到你的 handler.js 文件中：
const path = require('path');
const express = require('express');
app.use(express.static(path.join(__dirname, '../my-blog')));
exports.main = app;
此代码设置了一个 Express.js 服务器，它从 my-blog 目录提供静态文件。
现在，你可以通过运行以下命令将你的博客部署到 Serverless Framework：
serverless deploy
这将把你的博客部署到 AWS Lambda 并创建一个新的端点，你可以用它来访问你的博客。
结论
Docsify 和 Serverless Framework 是强大的工具，可以快速轻松地创建一个个人博客。通过遵循本指南中的步骤，你可以在几分钟内启动并运行你的博客。
常见问题解答
-
Docsify 和 GitBook 或 Hexo 有什么不同？
- 与 GitBook 和 Hexo 相比，Docsify 不生成静态网站，而是直接加载 Markdown 文件并动态渲染它们。
-
我可以在哪里部署我的博客？
- 你可以将你的博客部署到任何支持静态文件的 Web 托管平台，例如 GitHub Pages、Netlify 和 Amazon S3。
-
我的博客会自动更新吗？
- 是的，只要你对 Markdown 文件进行更改，你的博客就会自动更新。
-
我可以自定义我的博客的外观吗？
- 是的，你可以通过修改
docsify.config.js文件和创建自定义 CSS 文件来自定义博客的外观。
- 是的，你可以通过修改
-
我的博客有安全问题吗？
- 你博客的安全性取决于你选择的托管平台。选择一个提供安全功能的平台，例如 SSL 和访问控制。
