Next.js 部署到 GitHub Pages 教程

随笔3个月前发布 厚道传家
47 0 0

Next.js 部署到 GitHub Pages 教程

nextjs-github-pages🚀 Deploy a Next.js app to Github Pages via Github Actions.项目地址:https://gitcode.com/gh_mirrors/ne/nextjs-github-pages

项目介绍

nextjs-github-pages 是一个开源项目,旨在通过 GitHub Actions 将 Next.js 应用部署到 GitHub Pages。该项目支持 Next.js 的 App Router,并提供了详细的配置指南和最佳实践。

项目快速启动

克隆项目

首先,克隆项目到本地:

  1. git clone https://github.com/gregrickaby/nextjs-github-pages.git

  2. cd nextjs-github-pages

安装依赖

安装项目依赖:

npm install

配置 Next.js

编辑 next.config.js 文件,添加以下配置:

  1. /** @type {import('next').NextConfig} */

  2. const nextConfig = {

  3. output: "export",

  4. basePath: "/nextjs-github-pages",

  5. images: {

  6. unoptimized: true,

  7. },

  8. };

  9. module.exports = nextConfig;

添加 .nojekyll 文件

public 目录下添加 .nojekyll 文件,以禁用 GitHub Pages 的 Jekyll 构建:

touch public/.nojekyll

部署到 GitHub Pages

  1. 创建 GitHub Actions 配置文件 deploy.yml
  1. name: Deploy to GitHub Pages

  2. on:

  3. push:

  4. branches:

  5. - main

  6. jobs:

  7. deploy:

  8. runs-on: ubuntu-latest

  9. steps:

  10. - uses: actions/checkout@v2

  11. - uses: actions/setup-node@v2

  12. with:

  13. node-version: '14'

  14. - run: npm install

  15. - run: npm run build

  16. - run: npm run export

  17. - name: Deploy

  18. uses: peaceiris/actions-gh-pages@v3

  19. with:

  20. github_token: ${{ secrets.GITHUB_TOKEN }}

  21. publish_dir: ./out

  1. 提交代码并推送到 GitHub:
  1. git add .

  2. git commit -m "Initial commit"

  3. git push origin main

应用案例和最佳实践

应用案例

  • 静态网站:使用 Next.js 构建的静态网站可以轻松部署到 GitHub Pages,适用于个人博客、文档站点等。
  • 开源项目文档:许多开源项目使用 Next.js 构建文档站点,并通过 GitHub Pages 进行部署。

最佳实践

  • 优化图片:虽然 GitHub Pages 不支持 Next.js 的图片优化功能,但可以通过其他工具(如 ImageOptim)预先优化图片。
  • 使用 GitHub Actions:利用 GitHub Actions 自动化部署流程,确保每次提交都能自动部署到 GitHub Pages。

典型生态项目

  • Next.js:一个用于构建服务器渲染的 React 应用程序的框架。
  • GitHub Actions:GitHub 提供的自动化工作流工具,用于构建、测试和部署代码。
  • GitHub Pages:GitHub 提供的静态网站托管服务,适用于托管静态网页和项目文档。

通过以上步骤和最佳实践,您可以轻松地将 Next.js 应用部署到 GitHub Pages,并享受自动化部署带来的便利。

nextjs-github-pages🚀 Deploy a Next.js app to Github Pages via Github Actions.项目地址:https://gitcode.com/gh_mirrors/ne/nextjs-github-pages

© 版权声明

相关文章

暂无评论

您必须登录才能参与评论!
立即登录
暂无评论...