Photorama 项目常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00101/article/details/143790558

Photorama 项目常见问题解决方案

photorama "PHOTORAMA" template for Jekyll 项目地址: https://gitcode.com/gh_mirrors/ph/photorama

项目基础介绍

Photorama 是一个基于 Jekyll 的模板项目，专为摄影博主和艺术家设计。它使用 Clean Blog 作为基础，旨在为 GitHub Pages 提供一个美观且功能丰富的项目页面。Photorama 主要使用 HTML、CSS 和 JavaScript 进行开发，适合那些希望在 GitHub Pages 上展示个人作品的用户。

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

1. 配置文件 `_config.yml` 的正确设置

问题描述：
新手在使用 Photorama 时，可能会遇到页面加载失败或样式丢失的问题。这通常是由于 _config.yml 文件中的 URL 和 BASEURL 设置不正确导致的。

解决步骤：

打开 _config.yml 文件：
在项目根目录下找到 _config.yml 文件并打开。
修改 URL 和 BASEURL：
将 url 设置为 https://yourusername.github.io，将 baseurl 设置为 /repositoryname。例如：
```
url: "https://yourusername.github.io"
baseurl: "/repositoryname"
```

更新内部导航链接：
确保内部导航链接指向正确的路径。例如：

nav:
  GALLERY: "https://yourusername.github.io/repositoryname/gallery/"
  JOURNAL: "https://yourusername.github.io/repositoryname/journal/"
  ABOUT: "https://yourusername.github.io/repositoryname/about/"

保存并重新部署：
保存文件后，重新部署项目以确保更改生效。

2. 自定义域名与 HTTPS 的兼容性问题

问题描述：
Photorama 项目在版本 2.0 之后强制使用 HTTPS，但自定义域名可能无法直接支持 HTTPS。

解决步骤：

创建 CNAME 文件：
在项目根目录下创建一个名为 CNAME 的文件，并在其中添加你的域名，例如：
```
www.yourdomain.com
```
配置域名解析：
登录你的域名注册商，添加一个 CNAME 记录，将你的域名指向 GitHub Pages：
```
type: CNAME
host: www.yourdomain.com
answer: yourusername.github.io/repositoryname
TTL: 300
```
等待 DNS 生效：
通常需要几分钟到几小时的时间，等待 DNS 记录生效。
检查 HTTPS 支持：
访问 https://www.yourdomain.com，确保页面正常加载且没有安全警告。

3. 图片和资源加载问题

问题描述：
新手在使用 Photorama 时，可能会遇到图片或其他资源无法加载的问题。这通常是由于路径设置不正确导致的。

解决步骤：

检查资源路径：
确保所有图片和资源的路径都相对于 baseurl 设置。例如，如果 baseurl 设置为 /repositoryname，则图片路径应为 /repositoryname/img/yourimage.jpg。
使用相对路径：
在引用图片和资源时，尽量使用相对路径，避免绝对路径导致的加载问题。例如：
```
<img src="{{ site.baseurl }}/img/yourimage.jpg" alt="Your Image">
```
检查文件名和扩展名：
确保文件名和扩展名正确无误，避免因大小写或拼写错误导致的加载失败。