Gollum 是一个简单、轻量级的静态文档站点生成器,非常适合用于创建个人博客、文档站点等。它基于 GitHub 的仓库来存储内容,使得文档的版本控制和协作变得非常方便。以下是 Gollum 在 CentOS 上的简单部署指南。
环境准备
在开始部署 Gollum 之前,请确保你的 CentOS 系统满足以下要求:
- CentOS 7 或更高版本
- Node.js 环境(推荐版本为 14.x)
- Git
安装 Node.js
由于 Gollum 需要 Node.js 环境,我们首先需要安装 Node.js。以下是在 CentOS 上安装 Node.js 的步骤:
- 安装 NodeSource 的仓库:
sudo rpm --import https://www.nodesource.com/setup_14.x.el7.gpg
- 安装 Node.js 和 npm:
sudo yum install -y nodejs
- 验证 Node.js 和 npm 是否安装成功:
node -v
npm -v
安装 Gollum
- 安装 Gollum 的 npm 包:
npm install -g gollum
- 验证 Gollum 是否安装成功:
gollum -v
创建 Gollum 站点
- 创建一个新的 Gollum 站点:
gollum new my-gollum-site
这将在当前目录下创建一个名为 my-gollum-site 的文件夹,其中包含 Gollum 站点的所有文件。
- 进入站点目录:
cd my-gollum-site
- 启动 Gollum 站点:
gollum serve
此时,Gollum 站点将在默认的 4000 端口上启动。你可以通过浏览器访问 http://localhost:4000 来查看站点。
配置 Gollum 站点
Gollum 站点的配置文件位于站点目录下的 _config.yml 文件中。你可以根据需要修改以下配置项:
title:站点标题author:作者信息baseurl:站点的基础 URLmarkdown:Markdown 解析器highlighter:代码高亮工具
例如,修改 _config.yml 文件来设置站点标题:
title: My Gollum Site
部署 Gollum 站点
- 将 Gollum 站点推送到 GitHub 仓库:
git init
git remote add origin <your-github-repository-url>
git add .
git commit -m "Initial commit"
git push -u origin master
- 在 GitHub 仓库中创建一个名为
gh-pages的分支,用于托管静态站点文件:
git checkout -b gh-pages
- 将 Gollum 站点文件推送到
gh-pages分支:
git add .
git commit -m "Update site"
git push origin gh-pages
现在,你可以通过访问 http://<your-github-username>.github.io/<your-github-repository-name> 来查看你的 Gollum 站点。
总结
通过以上步骤,你可以在 CentOS 上成功部署 Gollum 站点。Gollum 的轻量级和易用性使其成为创建个人博客和文档站点的理想选择。希望这份指南能帮助你快速上手 Gollum。
