shuosc / fly

上海大学溯源手册（SHUFly）

上海大学溯源手册(SHUFly)

意见反馈

• 【腾讯文档】上海大学溯源手册意见征集📝
• Github Issues

---

SHUFly 交流群

---

如何使用

在线网站

访问 https://shuosc.github.io/fly/

点击右上角分类或标签以快速查看

本地部署

git clone https://github.com/shuosc/fly.git --depth=1
cd fly
# 确保已安装 Hugo
hugo serve

---

如何贡献

支持使用本名或昵称投稿，主题不限，内容亦不限，任何有关上大的内容都可以投稿

升学指南 ｜ 学习资料 ｜ 社团成长 等等等等全都欢迎！😉

为方便不熟悉计算机操作者，提供以下两种方式：

1️⃣ GitHub 提交

• Fork 本项目
• 添加并编辑 Markdown 文件
  • hugo new posts/文件名.md 或直接复制 content/posts/ 目录下现有文件并修改
  • 注意文件名规范
  • 在开头添加 category/tag，方便快速检索不同专业，保研/考研/出国/工作等去向，以及 CN/US/CA/UK/SG 等上岸地区
  • 若有条件可在本地部署预览网页效果
• 发起 Pull Request

2️⃣ 邮箱投递

将写好的Word或Markdown文件发送电子邮件至 [email protected]

邮件主题请注明「投稿/修改-姓名-专业-去向」并附上微信号等联系方式

---

贡献者

fly's Issues

Some pictures

规范项目文件及目录结构

此前一直使用 Github 作为图床，直到 2023-05-09，官方出于安全和隐私考虑做出了访问限制。

此前的解决方案是创建 content/posts/images 目录，并将相关图片放置其中。但关于 Hugo 的内容组织，正确的实践是创建一个文件夹，把每篇文章的相关内容放在一起，包括文本和其他资源文件，其中文本文件命名为 index.md，具体参考官方文档。

To Do List

• 删除 .DS_store，并添加到 .gitignore 中
• 将 content/posts/images 目录下文件整理至相关文章目录下，static 目录下的部分文件也需要重新整理
• 将 #60 中图片整理至相关文章目录下（可选，工作量较大）

为评论区增加评论的邮件提醒

在评论区被评论了没有邮件通知，只能管理员定时查看口头通知，效率非常低下

开启邮件通知可以完善评论区的功能

因为域名过期，评论区无法访问

如题

使用更朴素且信息集中的主题代替 Hugo FixIt

最初由于维护成本采用了偏技术风的主题 https://github.com/hugo-fixit/FixIt

现考虑换用 https://jialanxin.github.io/njuphy-/ 中采用的主题 https://github.com/flysnow-org/maupassant-hugo

优点是更加朴素且右侧同页能显示分类、标签等

缺点是缺少夜间模式和其他更符合现代人的特性。

目前我们还是想采用Blog形式记录文章，所以可能还在寻找更多更适合的主题，如有其他更好的主题也欢迎PR :D

欢迎大家支持！

Pic

评论区内容不挂梯子无法获取

不挂梯子访问评论区会无法获取评论内容，怀疑是因为vercel.app域名被屏蔽导致的

可能的解决方法：搞一个国内可以访问的域名

优化国内网络环境访问

由于众所周知的原因，Github Pages 的国内访问体验一直都不太好
考虑使用 CDN 加速或者其他方法优化国内网络环境访问 Github Pages 的效果

开启评论功能

基于 Waline.js 开启了评论功能：
目前的功能包括：

• 支持基本的 markdown 语法。
• 评论必须填写邮箱。此外，个人昵称、个人网站的 url 也是可选项。
• 评论的字数限制为 1000 字。
• 提供基础的 emoji 表情。
• 提供代码高亮与 tex 渲染（不过 tex 无法在预览中显示）。

Mitacs

Add support for RSS readers

I just want to read it on my RSS reader. 🙂

开启文章搜索功能

https://github.com/hugo-fixit/FixIt/ 主题在右上角有搜索栏，但目前尚不可用

解决方案：仿照 https://github.com/hugo-fixit/FixIt/blob/master/config.toml#L105-L126 在 config.toml 中启用搜索引擎

增加类似于校友地图的页面

可以考虑以下模板
**海洋大学：https://github.com/Copypeng/AlumniMap
南科大：https://github.com/SUSTech-Application/SUSTech-Alumni-Map
海南大学：https://github.com/Hainanu-Application/Hainanu-Alumni-Map

增加对 Pull Request 的自动检查

使用 GitHub Actions 能方便地对新创建的 Pull Request 进行自动检查，只需自动测试用 Hugo 部署不出错即可，如有必要可以对接 vercel 实现部署预览