博客系统 活跃维护

hugo-website

pmichaillat/hugo-website

用于学术网站的极简 Hugo 模板

373
Stars 标星
166
Forks 分支
4
Watchers 关注
0
Open Issues
HTML
主要语言
MIT
开源协议
5.3 MB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:pmichaillat/hugo-website
git clone https://github.com/pmichaillat/hugo-website.git
git clone git@github.com:pmichaillat/hugo-website.git
README.md main

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

学术网站的极简 Hugo 模板

该仓库包含一个 Hugo 模板,用于创建个人学术网站。该模板使用 PaperMod 主题,但在多方面进行了修改,使其更加极简且更适合学术网站。该网站托管在 GitHub Pages 上。

文档

该模板在 https://pascalmichaillat.org/b/ 有文档记录

插图

由该模板生成的网站可以在 https://pascalmichaillat.org/hugo-website/ 查看

安装

在你的本地机器上

  • 安装 Hugo。在 Mac 上,可以使用 Homebrew 来安装:在终端中运行 brew install hugo。如果你已经安装了 Hugo,但版本过旧,请运行 brew upgrade hugo。
  • 由于网站托管在 GitHub Pages 上,安装 GitHub Desktop 会很方便。可以通过 GitHub Desktop 从本地机器更新网站,而无需直接访问 GitHub。
  • 将模板仓库克隆到本地机器。可以分两步完成:
    • 点击“Use this template”,然后在仓库顶部点击“Create a new repository”。
    • 一旦在你的 GitHub 账户上创建了新仓库,打开 GitHub Desktop,点击“File”,然后选择“Clone repository”。在“GitHub.com”标签下找到新创建的仓库并克隆它。
  • 将 baseURL 参数更新到 config.yml 中,使用你计划使用的网站 URL。默认 URL 为 https://username.github.io。

在你的 GitHub 账户上

  • 第一次将仓库推送到 GitHub 时,你需要允许 GitHub Actions 和 GitHub Pages,以便网站可以构建并部署到 GitHub Pages。
  • 第一步是 请求 GitHub 使用 GitHub Action 发布网站。GitHub 提供了一个现成的 action 用于发布 Hugo 网站,称为 Deploy Hugo site to Pages。必须在你 GitHub 仓库的 Pages 设置 中启用此 action。你可以在 .github/workflows/hugo.yml 文件中查看由该 action 触发的工作流程。
  • 一旦启用 GitHub Actions,每当仓库更新时,GitHub 会立即构建并发布网站。
  • 如果你想更新部署操作(例如它过时导致无法部署网站),可以在 GitHub 上找到 最新的 action。你可以将此文件直接放入 .github/workflows 文件夹中以替换旧的 hugo.yml 文件——但请确保将 push: branches 设置为 ["main"]。

使用

本地开发

导航到网站目录(cd)并在终端中运行:

hugo server

该命令在您的计算机上构建网站,并通过 http://localhost:1313 提供访问,同时在您编辑时自动重新构建。您可以修改仓库的内容,并完全在您的计算机上开发网站。

在线部署

一旦您的网站准备公开,请提交您的内容和模板更改,并将其推送到 GitHub 上的网站仓库。使用 GitHub Desktop 进行此 Git 操作会很方便。

每次推送时,GitHub Actions 工作流 会调用 Hugo 生成网站,并将输出部署到 GitHub Pages。在工作流期间,Hugo 会处理您的内容、模板和其他项目文件,并生成一个静态网站。

性能

该网站在移动设备和桌面设备上的表现良好。以下是来自 PageSpeed Insights 的移动性能概览:

以下是桌面性能概览:

软件

  • 该网站使用 Hugo v0.147.2 通过 GitHub Actions 构建。
  • 该网站在 macOS Sequoia 上本地使用 Hugo v0.147.2 开发。
  • 该网站在以下浏览器上进行了测试:
    • macOS Sequoia 上的 Safari 18.4
    • iOS 18 上的移动 Safari
  • 其他 Hugo 版本、操作系统和网页浏览器可能需要进行轻微调整。请报告任何问题以帮助改善兼容性。

许可

该代码库根据 MIT 许可 进行许可。

实际应用

相关资源

  • latex-cv - 这个 LaTeX 模板可以生成极简风格的学术简历,您可以将其发布到您的网站上。
  • latex-presentation - 这个 LaTeX 模板可以生成极简风格的研究演示文稿,您可以将其发布到您的网站上。
  • latex-paper - 这个 LaTeX 模板可以生成极简风格的研究论文,您可以将其发布到您的网站上。
  • latex-book - 这个 LaTeX 模板可以生成极简风格的讲义和研究专著,您也可以将其发布到您的网站上。
本站来源与版权声明
  • 本文标题:hugo-website - 用于学术网站的极简 Hugo 模板
  • 本文链接:https://www.cn121.com/blog/pmichaillat-hugo-website.html
  • 原项目:pmichaillat/hugo-website 版权归原作者 pmichaillat 及贡献者所有
  • 收录信息:本站于 2026-10-12 收录本项目,本页所列协议与仓库指标均为收录当时的状态;该日期之后原项目的版本更新与协议变更,本页不作同步。
  • 开源协议:收录时本项目采用 MIT(查看 LICENSE 原文),本站译文为其衍生内容;使用、修改、分发请以该仓库 LICENSE 原文为准。
  • 站点出处:本文首发于 OneTwoOne,收录自 GitHub 开源项目 pmichaillat/hugo-website。
  • 翻译说明:本页正文为人工智能生成内容——由机器翻译对原项目 README 初译、经程序校验排版,可能存在错漏,请以原项目文档为准。
  • 引用声明:商业转载、第三方聚合或 AI 检索训练引用时,请务必保留以上来源出处、本文永久链接,以及原项目的版权声明与许可信息。
  • 下架通道:若原项目此后变更或收紧了许可协议、或作者/权利人认为本站的收录方式(译文、排版适配、简介翻译等)超出其授权范围,请通过 xyd3302001@163.com 发送下架通知,并附上项目地址与本页链接。本站核实后将第一时间删除本页内容,或改为不复制原文的目录性收录;署名更正等其他要求可一并提出。