创建新站点：从预设的站点开始

3 分钟阅读

Create a new site: start with a prepopulated site - 创建新站点：从预设的站点开始

通过使用 Docsy 示例站点的克隆作为起点来创建新的 Hugo 站点。

创建新 Docsy 站点的最简单方法是使用 Docsy 示例站点的源代码作为起点。这种方法为您的站点提供了一个骨架结构，包括顶层和文档章节以及您可以根据需要修改的模板。示例站点会自动作为 Hugo 模块引入 Docsy 主题，因此很容易保持最新状态。

如果您更喜欢从头开始创建站点，请按照"从头开始创建站点（Start a site from scratch）“的说明进行操作。

在 Unix Shell 或 Windows 命令行中运行以下命令：

1
2
3
git clone https://github.com/google/docsy-example.git my-new-site
cd  my-new-site
hugo server

现在，您可以在浏览器中预览 http://localhost:1313 中的新站点。

示例站点为您构建文档站点提供了一个很好的起点，并且预先配置为自动引入 Docsy 主题作为 Hugo 模块。有两种不同的方法可以获取示例站点的本地克隆：

如果您想使用除GitHub之外的远程存储库（例如GitLab、BitBucket、AWS CodeCommit、Gitea），或者根本不需要远程存储库，只需直接使用git clone创建一个本地工作副本，将您选择的本地存储库名称（此处为my-new-site）作为最后一个参数即可：

1
git clone https://github.com/google/docsy-example.git my-new-site

由于Docsy示例站点存储库是模板存储库，因此创建自己的远程GitHub克隆Docsy示例站点存储库非常容易：

进入Docsy示例站点存储库，点击Use this template。
选择新存储库的名称（例如my-new-site），并在Repository name字段中输入它。您还可以添加一个可选的Description。
单击Create repository from template以创建新存储库。恭喜，您刚刚创建了远程Github克隆，现在它是您自己站点的起点！
使用git clone创建您新创建的GitHub存储库的本地副本，并将其作为最后一个参数给出您的存储库的Web URL。
1
git clone https://github.com/me-at-github/my-new-site.git

注意
根据您的环境，您可能需要微调config.toml中的模块顶级设置，例如添加代理以在下载远程模块时使用。您可以在Hugo模块文档中找到这些配置设置的详细信息。

现在，您可以对副本站点进行本地编辑并使用Hugo在本地进行测试。

要在本地构建和预览站点，请切换到克隆项目的根目录并使用Hugo的server命令：

1
2
cd my-new-site
hugo server

在浏览器中预览站点：http://localhost:1313。由于Hugo的实时预览功能，您可以立即看到对本地存储库源文件进行更改的影响。您可以在任何时候使用Ctrl + c停止Hugo服务器。请参阅MacOS上的已知问题。

最后修改 May 22, 2023: 第一次提交 (d4e19f0)