Homepage-Creators 的安装和配置教程

Homepage-Creators 的安装和配置教程

项目基础介绍

Homepage-Creators 是一款适用于 Zola 的个人主页主题，风格接近 Apple，美观大气。该主题使用简单，只需修改 config.toml 文件即可动态调整内容。无需修改 HTML 内容，极大降低用户的心智负担。

主要编程语言

Homepage-Creators 主要使用 TOML（Tom's Obvious, Minimal Language）作为配置文件格式，这是一种易于阅读和编辑的配置文件格式。

使用的关键技术和框架

• Zola: 一个静态网站生成器，用于构建个人主页。
• AVIF/WebP: 用于图片格式转换，大幅降低图片尺寸。
• GitHub Actions: 用于自动构建和部署网站。

安装和配置准备工作

• GitHub 账号: 用于托管和部署个人主页。
• Zola 命令行工具: 用于本地预览和管理网站。
• 文本编辑器: 用于编辑配置文件和内容。

安装步骤

1. Fork 仓库

   • 访问 Homepage-Creators 仓库，点击 Fork 按钮创建自己的副本。

2. 启用 GitHub Actions

   • 在自己的仓库中，进入 Actions 页面，找到 Build GH Pages 工作流，点击启用。

3. 配置 GitHub Pages

   • 在仓库的 Settings 页面，找到 GitHub Pages 部分，选择 gh-pages 分支作为源，保存设置。

4. 自定义主页内容

   • 根据需求修改 config.toml 文件，配置板块、文字内容和引用的图片。
   • 将使用到的图片素材存放在 static/img 文件夹。

5. 本地预览

   • 运行 zola serve 命令，在浏览器打开提示的预览地址，查看主页效果。

6. 提交更改

   • 将修改后的代码提交到自己的仓库。

7. 部署完成

   • 提交更改后，GitHub Actions 将自动构建并部署到 gh-pages 分支。
   • 部署完成后，可以通过 https://<your-username>.github.io/<repository-name> 访问个人主页。

注意事项

• 确保仓库中包含 .github/workflows/deploy.yml 文件。
• 可以参考官方文档和定制主页章节，进一步定制个人主页。