Cover Image for 使用 Next.js 和 GitHub Pages 创建博客:初学者开发者的步骤
[Blog][Next.js][初学者]
2024年1月23日

使用 Next.js 和 GitHub Pages 创建博客:初学者开发者的步骤

您好!今天,我将分享我使用 Next.js 创建博客并将其托管在 GitHub Pages 上的经验。本分步指南专为希望以最小努力创建博客的开发初学者设计。让我们开始吧!

快速开始:

如果您想节省时间,可以使用我的 GitHub 存储库并跳过"安装 Next.js 和准备好的模板"和"上传到 GitHub"部分。通过访问 https://github.com/progosling/blog-example/fork 并点击"创建分叉"来分叉我的博客。

分叉页面

安装 Next.js 和准备好的模板:

让我们从安装 Vercel 提供的博客的准备模板开始。使用以下命令:

npx create-next-app --example blog-starter blog-starter-app
# 或者
yarn create next-app --example blog-starter blog-starter-app
# 或者
pnpm create next-app --example blog-starter blog-starter-app

现在您拥有了所有博客代码。

发布文章:

所有文章都存储在 /_posts 文件夹中,格式为 Markdown。只需将新的 Markdown 文件添加到 /_posts 文件夹中,新文章就会出现在您的博客上。 在文章文件的开头,请务必添加这段代码,但根据您的文章编辑其内容。

---
title: "文章 1"
excerpt: "描述"
coverImage: "/images/image.png"
date: "2024-01-23T09:00:00.322Z"
ogImage:
  url: "/images/image.png"
---

其中 title 是文章的 标题。excerpt 是描述。coverImage 是文章的头图。 date 是文章的发布日期。ogImage 是页面元标记的图像。

博客图片:

博客图片应放置在 public/assets 文件夹中。在您的文章中,您可以通过指定它们的路径来使用这些图片,而无需指定 public,以下是如何为图片 /images/image.jpg 指定路径的示例。

上传到 GitHub:

在 GitHub 上创建一个新存储库,并在终端中执行以下命令以将您的代码上传到 GitHub:

git init
git add .
git commit -m "Initial commit"
git remote add origin [link to your repository]
git push -u origin master

现在您的代码已在 GitHub 上可用。

GitHub Pages 和 GitHub Actions:

GitHub Pages 和 GitHub Actions: 转到您的 GitHub 存储库的设置并启用 GitHub Pages。在源中,选择 GitHub Actions。

Github pages

选择 Next.js 工作流并点击配置。

Next.js workflow

保存文件并等待 GitHub Actions 执行首次部署。现在,每次您对项目进行更改时,您的博客都会自动更新。恭喜,您的博客已准备好使用!它将位于 your-username.github.io/blog-example

您可以在 此页面此存储库 中查看博客示例。

继续阅读

加入我们的社区