机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

Hugo 个人简介

📷 原文此处有图片，请前往 GitHub 仓库查看完整内容。
Hugo 个人简介： 一款高性能、以移动端为优先的 Hugo 主题，适用于个人作品集和博客。

• 示例网站: https://hugo-profile.netlify.app
• 维基页面: https://github.com/gurusabarish/hugo-profile/wiki
• 完整文档（在此仓库中有版本管理）：wiki/Home.md

功能特点：

• 完全响应式
• 极简设计
• SEO 友好
• 国际化 (i18n) 支持
• 浅色/深色/自动主题颜色配置
• 分类和标签支持
• 分析支持 (Google Analytics)
• 评论支持 (Disqus)
• 联系表单集成（FormSpree）
• 基于 Bootstrap 和 Font Awesome 构建

要求

• Hugo 版本 0.87.0 或更高
  要检查已安装的版本，请运行：

  hugo version

  如果未安装 Hugo，请遵循官方安装指南进行安装。

快速开始

1. 创建一个新的 Hugo 站点：

   hugo new site my-site --format="yaml"

   这使用 hugo.yaml 配置文件，而不是默认的 TOML 格式。

2. 添加一个主题。

   选项A：在你的主题文件夹中克隆这个仓库。
   这允许你进行大量自定义更改。

   cd my-site/themes
   git clone https://github.com/gurusabarish/hugo-profile.git

   选项 B：作为 Git 子模块添加。
   这使您能够从原始仓库获得自动或结构化的更新。

   cd my-site
   git init
   git submodule add https://github.com/gurusabarish/hugo-profile.git themes/hugo-profile

3. 将示例配置文件复制到您的网站根目录：

   cp -f themes/hugo-profile/exampleSite/hugo.yaml ./hugo.yaml

4. 启动 Hugo 开发服务器：

   hugo server

5. 推荐：复制示例内容和资源。

   当你首次运行 hugo server 时，网站可能看起来不完整——图片可能缺失，博客或画廊部分可能不会出现。

   这是因为它们的内容目前位于 themes/hugo-profile/exampleSite/，而 Hugo 期望它们位于根级目录的 static/（用于图片）和 content/（用于页面）目录中。

   要完整查看示例网站，请运行：

   rsync -av themes/hugo-profile/exampleSite/static/ ./static/
   rsync -av themes/hugo-profile/exampleSite/content/ ./content/

   您可以自定义或替换此内容以匹配您自己的网站。

内容管理

您现在可以开始自定义您的网站。

要更改网站标题或主页内容，请编辑根目录中的 hugo.yaml 文件。该文件还控制显示或隐藏网站部分（例如，关于、教育）的设置。

要创建一个新页面，例如，在博客部分，请运行：

hugo new content content/blogs/my-post.md

这将在 content/blogs/ 文件夹中创建一个新文件，带有包含日期等元数据的前置内容。

以下是一些供您参考的有用资源：

• Hugo 快速入门指南 – 关于如何创建网站、添加内容并发布网站。

• Hugo 内容组织 – 长颈鹿学院

• Wiki 页面 – 针对该主题的特定提示。

国际化 (i18n)

此主题开箱即支持多种语言。Hugo Profile 包含对英语、西班牙语和法语的内置翻译，并且您可以轻松添加自己的语言。

设置多语言

要启用多语言支持，请将以下内容添加到您的 hugo.yaml ：

defaultContentLanguage: "en"
defaultContentLanguageInSubdir: false

languages:
  en:
    languageName: "English"
    weight: 1
  es:
    languageName: "Español"
    weight: 2
  fr:
    languageName: "Français"
    weight: 3

工作原理

1. 翻译文件：该主题在 i18n/ 目录中包含翻译文件：

   • en.toml - 英文翻译
   • es.toml - 西班牙语翻译
   • fr.toml - 法语翻译

2. 语言切换器：当您启用多语言时，导航栏会自动出现一个语言切换下拉菜单，允许访问者在语言之间切换。

3. 向后兼容性：所有现有网站无需任何更改即可继续使用。如果未提供多语言设置，主题会自动回退到英语或您配置的语言。

添加新语言

要添加对新语言（例如德语）的支持：

1. 在您的网站根目录或主题中创建一个新的翻译文件 i18n/de.toml:

   [nav_about]
   other = "Über uns"
   
   [nav_experience]
   other = "Erfahrung"
   
   # Add all other translations...

2. 将语言添加到您的 hugo.yaml ：

   languages:
    de:
      languageName: "Deutsch"
      weight: 4

3. （可选）在 content/de/ 目录中创建特定语言的内容。

自定义翻译

您可以通过将其添加到您网站的 params.terms 部分中的 hugo.yaml 来覆盖任何翻译：

params:
  terms:
    read: "Custom Read Text"
    pageNotFound: "Custom 404 Message"

有关 Hugo 多语言功能的更多信息，请参阅 Hugo 多语言文档。

部署

如果您不需要广泛的自定义，最简单的部署方式是：

1. 点击 使用此模板 按钮来创建您自己的仓库。
2. 将仓库连接到 Netlify。

每当您在 exampleSite 文件夹内对文件进行更改时，Netlify 会自动检测并部署您的更改。

如果您已经按照上面快速开始部分的步骤操作，您仍然可以将您的网站部署到 Netlify，但您需要一些额外配置。

有关更多信息，请参阅在 Netlify 托管指南。

对于手动部署，运行 hugo 以在 public/ 文件夹中生成最终的、可部署的静态网站，您可以将其上传到任何托管平台。

建议在每次构建之前删除 public/ 文件夹，以确保其中只包含最新的输出：

rm -rf public/ && hugo

故障排除

ERROR error calling resources.GetRemote: Get "https://publish.twitter.com/oembed?dnt=false&url=https%3A%2F%2Ftwitter.com%2FGoHugoIO%2Fstatus%2F1315233626070503424": net/http: TLS handshake timeout
Built in 10266 ms
Error: error building site: logged 1 error(s)

TLS 握手超时错误可能由于网络问题发生。如果此错误持续存在，您可以删除 "content/blogs/rich-content.md" 文件中的短代码示例 {{< tweet user="GoHugoIO" id="1315233626070503424" >}}。

问题

如果您有问题，请 打开问题 以寻求帮助，并帮助后来的人。您提供的信息越多，效果越好！

贡献

欢迎贡献、提交问题和功能请求！对于重大更改，请先打开一个问题讨论您想要更改的内容。

许可证

根据 MIT 许可授权

🤝 支持

如果你喜欢这个项目，请给一个⭐️或者给我买一杯~ coffee ~茶！