GitHub Pages 画廊项目常见问题解决方案

GitHub Pages 画廊项目常见问题解决方案

github-pages-gallery A zero dollar solution to host your photo/video gallery online using Github pages and GitHub Actions. No coding necessary. 项目地址: https://gitcode.com/gh_mirrors/gi/github-pages-gallery

项目基础介绍

GitHub Pages 画廊项目是一个利用 GitHub Pages 和 GitHub Actions 来免费托管照片和视频画廊的解决方案。该项目的主要目的是为摄影师或任何希望在线展示其作品的人提供一个零成本的托管平台。项目的主要编程语言是 JavaScript，因为它依赖于 Thumbsup 这个基于 Node.js 的静态网站生成器。

新手使用注意事项及解决方案

1. 配置文件 config.json 的正确设置

问题描述：
新手在使用项目时，可能会遇到由于 config.json 文件配置错误导致画廊无法正确生成的问题。

解决步骤：

1. 检查输入和输出路径：
   确保 config.json 文件中的 input 和 output 路径设置正确。例如：

   {
     "input": "/gallery",
     "output": "/build_output"
   }
   

2. 设置画廊标题和版权信息：
   在 config.json 中设置画廊的标题和版权信息，例如：

   {
     "title": "我的画廊",
     "footer": "版权所有 © 2023"
   }
   

3. 选择合适的主题：
   根据个人喜好选择画廊的主题，例如 cards 主题：

   {
     "theme": "cards"
   }
   

2. GitHub Actions 工作流配置问题

问题描述：
新手可能会遇到 GitHub Actions 工作流配置不正确，导致画廊无法自动生成和部署的问题。

解决步骤：

1. 检查 .github/workflows 目录：
   确保 .github/workflows 目录下有正确的工作流文件，例如 deploy.yml。

2. 设置 GitHub Pages 源：
   在 GitHub 仓库的 Settings 页面中，选择 Pages 选项，确保 Source 设置为 GitHub Actions。

3. 触发工作流：
   提交更改后，GitHub Actions 会自动触发工作流，生成并部署画廊。如果工作流未触发，可以手动运行工作流。

3. 图片和视频文件的正确上传

问题描述：
新手可能会遇到上传的图片或视频文件格式不支持，导致画廊无法正确显示的问题。

解决步骤：

1. 检查文件格式：
   确保上传的图片和视频文件格式是 Thumbsup 支持的格式，例如常见的 JPEG、PNG、MP4 等。

2. 文件命名规范：
   确保文件命名规范，避免使用特殊字符或空格，建议使用字母、数字和下划线。

3. 文件路径正确：
   确保文件上传到 config.json 中指定的 input 路径下，例如 /gallery 目录。

通过以上步骤，新手可以更好地理解和使用 GitHub Pages 画廊项目，避免常见问题，顺利部署自己的画廊。

github-pages-gallery A zero dollar solution to host your photo/video gallery online using Github pages and GitHub Actions. No coding necessary. 项目地址: https://gitcode.com/gh_mirrors/gi/github-pages-gallery