入门指南
入门指南
从模板快速开始
imfing/hextra-starter-template
您可以通过使用上述模板仓库快速入门。
我们提供了一个 GitHub Actions 工作流，可以帮助自动构建并将您的站点部署到 GitHub Pages，并免费托管。 更多选项，请查看 部署站点。
作为新项目开始
有两种主要方式将 Hextra 主题添加到您的 Hugo 项目中：
-
Hugo 模块（推荐）：最简单且推荐的方法。Hugo 模块允许您直接从在线源拉取主题。主题会自动下载并由 Hugo 管理。
-
Git 子模块：或者，将 Hextra 添加为 Git 子模块。主题由 Git 下载并存储在您项目的
themes文件夹中。
将 Hextra 设置为 Hugo 模块
先决条件
在开始之前，您需要安装以下软件：
步骤
初始化一个新的 Hugo 站点
hugo new site my-site --format=yaml通过模块配置 Hextra 主题
# 初始化 Hugo 模块
cd my-site
hugo mod init github.com/username/my-site
# 添加 Hextra 主题
hugo mod get github.com/imfing/hextra配置 hugo.yaml 以使用 Hextra 主题，添加以下内容：
module:
imports:
- path: github.com/imfing/hextra创建您的内容页面
为主页和文档页面创建新的内容页面：
hugo new content/_index.md
hugo new content/docs/_index.md本地预览站点
hugo server --buildDrafts --disableFastRender恭喜，您的新站点预览可在 http://localhost:1313/ 查看。
如何更新主题？
将 Hextra 设置为 Git 子模块
先决条件
在开始之前，您需要安装以下软件：
步骤
初始化一个新的 Hugo 站点
hugo new site my-site --format=yaml将 Hextra 主题添加为 Git 子模块
git submodule add https://github.com/imfing/hextra.git themes/hextra配置 hugo.yaml 以使用 Hextra 主题，添加以下内容：
theme: hextra创建您的内容页面
为主页和文档页面创建新的内容页面：
hugo new content/_index.md
hugo new content/docs/_index.md本地预览站点
hugo server --buildDrafts --disableFastRender您的新站点预览可在 http://localhost:1313/ 查看。
当使用 CI/CD 部署 Hugo 网站时，确保在运行 hugo 命令之前执行以下命令至关重要。
git submodule update --init如果不运行此命令，主题文件夹将不会被 Hextra 主题文件填充，导致构建失败。
如何更新主题？
要更新仓库中所有子模块到最新提交，请运行以下命令：
git submodule update --remote要将 Hextra 更新到最新提交，请运行以下命令：
git submodule update --remote themes/hextra有关更多详细信息，请参阅 Git 子模块。
下一步
探索以下部分以开始添加更多内容：