Next.jsAstroHugoReact博客启动器

hugo-theme-paper-starter — Next.js 博客模板

作者 ouraihub-hugo-themes

基于 Hugo Paper 主题的快速启动模板，预配置 Hugo Modules 与 GitHub Actions，面向使用 Hugo 搭建极简响应式博客的场景。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-12查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

通过 Hugo Modules 引用预编译的 Hugo Paper 主题，无需构建主题源码

02

内置 GitHub Actions 工作流，可自动部署到 GitHub Pages

03

支持英文与中文双语内容，按语言目录分别创建文章

04

主题侧提供明暗模式、搜索与 Giscus 评论等博客常用能力

05

附带入门、配置、部署等文档，说明安装与发布步骤

模板详细介绍

这是一个面向 Hugo 的博客启动模板，用于快速搭建以 Hugo Paper 主题为基础的站点。模板本身不包含主题源码，而是通过 Hugo Modules 引用预编译版本的 Hugo Paper 主题，因此使用时不需自行编译主题资源。仓库提供 GitHub Actions 工作流，可将站点自动部署到 GitHub Pages，并附带安装、配置、部署等文档。

内容组织上支持多语言（英文/中文），文章按语言分目录创建，front matter 使用 title、date、draft、description、categories、tags 等字段。主题侧提供明暗模式、搜索、Giscus 评论等能力，模板已把这些能力接入到默认配置中。

使用前需要准备 Hugo Extended、Git、Go、Node.js 与 pnpm 等环境，按文档执行 hugo mod get -u、pnpm install、pnpm dev 即可在本地启动。模板的 MIT 许可仅覆盖代码本身，演示图片、字体、图标等第三方素材以及域名、托管等外部服务需另行核对许可与费用。

Next.jsAstroHugo博客启动器

适合你的项目吗？

适用场景

  • 用 Hugo 搭建个人极简风格博客并发布到 GitHub Pages
  • 需要中英文双语内容站点的写作与发布
  • 希望直接使用预编译主题、不自行编译主题资源的博客项目
  • 以 GitHub 仓库为协作与部署入口的静态博客维护

适合人群

  • 熟悉或愿意使用 Hugo 与 Hugo Modules 的开发者
  • 需要多语言博客内容结构的个人作者
  • 倾向用 GitHub Actions 自动部署静态站点的团队或个人

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    需准备 Hugo Extended v0.120.0+、Git 2.0+、Go 1.20+、Node.js v18.0+ 与 pnpm v8.0+

  2. 2

    克隆仓库后执行 hugo mod get -u 初始化 Hugo Modules，再执行 pnpm install 安装搜索相关依赖

  3. 3

    本地开发使用 pnpm dev，默认访问 http://localhost:1313

  4. 4

    更新主题可执行 hugo mod get -u 与 hugo mod tidy

  5. 5

    MIT 许可仅覆盖代码，演示图片、字体、图标及托管等外部服务需另行确认许可与费用

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
  • 使用该模板需预先安装 Hugo Extended v0.120.0+、Git 2.0+、Go 1.20+、Node.js v18.0+ 与 pnpm v8.0+；其中 Node.js 用于 Pagefind 搜索功能，缺少这些外部工具链将无法按文档完成安装与本地运行。
  • 评论功能依赖 Giscus 这一外部服务，需在 GitHub 上启用并配置对应仓库与讨论区后才能使用，属于模板之外的外部依赖。
  • 自动部署能力依赖 GitHub Actions 与 GitHub Pages 服务，需使用 GitHub 账号与仓库，属于外部平台依赖而非模板自带能力。
  • 文档列出的 Vercel、Netlify、Cloudflare Pages 部署方式均依赖第三方托管平台，可能涉及账号注册与平台自身的费用或配额限制，需自行核对。
  • 本模板通过 Hugo Modules 引用预编译的发行版主题仓库，主题源码位于另一个开发仓库；使用与修改主题需分别查看对应仓库的许可与说明。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

- Hugo Extended v0.120.0+ - Git 2.0+ - Go 1.20+ - Node.js v18.0+ (for Pagefind search) - pnpm v8.0+

README 原文

- 💬 Giscus comments integration

README 原文

This starter includes GitHub Actions for automatic deployment to GitHub Pages.

README 原文

- [Vercel](docs/DEPLOYMENT.md#vercel) - [Netlify](docs/DEPLOYMENT.md#netlify) - [Cloudflare Pages](docs/DEPLOYMENT.md#cloudflare-pages)

README 原文

- [Development Repository](https://github.com/ouraihub-hugo-themes/hugo-theme-paper) - Source code - [Distribution Repository](https://github.com/ouraihub-hugo-themes/hugo-theme-paper-dist) - Pre-compiled (used by this starter)

README 原文
https://github.com/ouraihub-hugo-themes/hugo-theme-paper-starter/blob/master/LICENSEhttps://github.com/ouraihub-hugo-themes/hugo-theme-paper-starter/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 85 / 100
技术栈
Next.js · Astro · Hugo · React
网站类型
博客 · 启动器
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-05-27
截图检查日期
2026-10-12

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: codex-user-requested-batch-review-20261015 · 2026-10-15

查看当时使用的来源资料

SHA-256: 084cae3799409e43f703b2599451bcbc7e4f869f9709e042fd0b34a06f9426fb

2026-10-12T03:55:44.833Z

来源文件 / 仓库
# Hugo Paper Starter

English | [简体中文](README.zh.md)

A quick start template for [Hugo Paper](https://github.com/ouraihub-hugo-themes/hugo-theme-paper) theme - a minimal, responsive blog theme inspired by AstroPaper.

**Features:**
- ✅ Pre-configured with Hugo Modules
- ✅ Uses pre-compiled theme (no build tools needed)
- ✅ GitHub Actions deployment included
- ✅ Multilingual support (English/Chinese)
- ✅ Ready to use out of the box

## 📖 Documentation

- **[Getting Started](docs/GETTING_STARTED.md)** - Installation and first steps
- **[Configuration](docs/CONFIGURATION.md)** - Detailed configuration guide
- **[Deployment](docs/DEPLOYMENT.md)** - Deploy to GitHub Pages
- **[Quick Setup](docs/SETUP_DEPLOYMENT.md)** - One-minute deployment guide
- **[Changelog](CHANGELOG.md)** - Version history

**Theme Repositories:**
- [Development Repository](https://github.com/ouraihub-hugo-themes/hugo-theme-paper) - Source code
- [Distribution Repository](https://github.com/ouraihub-hugo-themes/hugo-theme-paper-dist) - Pre-compiled (used by this starter)

## 🚀 Quick Start

### Prerequisites

- Hugo Extended v0.120.0+
- Git 2.0+
- Go 1.20+
- Node.js v18.0+ (for Pagefind search)
- pnpm v8.0+

### Installation

1. **Use this template** (click the green button above)
2. **Clone your repository**
   ```bash
   git clone https://github.com/yourusername/your-repo.git
   cd your-repo
   ```
3. **Initialize Hugo Modules**
   ```bash
   hugo mod get -u
   ```
4. **Install dependencies** (for search)
   ```bash
   pnpm install
   ```
5. **Start development server**
   ```bash
   pnpm dev
   ```
6. **Visit** http://localhost:1313

See [Getting Started Guide](docs/GETTING_STARTED.md) for detailed instructions.

## ✨ Features

- 🎨 Minimal and responsive design
- 🌓 Dark/Light mode support
- 🔍 Built-in search functionality
- 🌐 Multilingual (English/Chinese)
- ⚡️ Fast performance
- ♿️ WCAG 2.1 AA accessibility
- 🎯 SEO optimized
- 💬 Giscus comments integration

## 📝 Creating Content

### Create a new post

```bash
# English post
hugo new content/en/post/my-first-post.md

# Chinese post
hugo new content/zh/post/my-first-post.md
```

### Edit the post

```yaml
---
title: "My First Post"
date: 2024-01-15T10:00:00+08:00
draft: false
description: "Post description"
categories: ["Technology"]
tags: ["Hugo", "Blog"]
---

Your content here...
```

See [Getting Started Guide](docs/GETTING_STARTED.md) for more details.

## 🚢 Deployment

This starter includes GitHub Actions for automatic deployment to GitHub Pages.

**Other platforms:**
- [Vercel](docs/DEPLOYMENT.md#vercel)
- [Netlify](docs/DEPLOYMENT.md#netlify)
- [Cloudflare Pages](docs/DEPLOYMENT.md#cloudflare-pages)

See [Deployment Guide](docs/DEPLOYMENT.md) for detailed instructions.

## 🔄 Updating Theme

```bash
hugo mod get -u
hugo mod tidy
```

## 🤝 Contributing

Issues and Pull Requests are welcome!

## 📄 License

MIT License - see [LICENSE](LICENSE) for details.

## 🔗 Links

- [Hugo Paper Theme](https://github.com/ouraihub-hugo-themes/hugo-theme-paper)
- [Hugo Documentation](https://gohugo.io/documentation/)

---

**Powered by [Hugo Paper](https://github.com/ouraihub-hugo-themes/hugo-theme-paper)** 🚀
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

ai-website-cloner-template

ai-website-cloner-template

Clone any website with one command using AI coding agents

Next.js · 启动器

Next.js SaaS Starter

Next.js SaaS Starter

Next.js SaaS Starter 是 Next.js 官方维护的 SaaS 起点模板，定位介于学习资源和可直接部署的脚手架之间。

Next.js · SaaS

Next.js Commerce

Next.js Commerce

Next.js Commerce 是 Vercel 团队维护的电商启动模板，基于 Next.js App Router 构建，采用服务端渲染、React Server Components、Server Actions …

Next.js · 电商

Next-js-Boilerplate

Next-js-Boilerplate

Next-js-Boilerplate 是一个面向 Next.js 16、Tailwind CSS 4 和 TypeScript 的启动器，核心定位是开发者体验优先。

Next.js · 启动器

tailwind-nextjs-starter-blog

tailwind-nextjs-starter-blog

tailwind-nextjs-starter-blog 是一个面向个人技术博客的 Next.js 与 Tailwind CSS 启动模板，其 v2 版本基于 App Router 与 React Server Comp…

Next.js · 博客

next-forge

next-forge

Production-grade Turborepo template for Next.js apps.

Next.js · 启动器