这里是天津师范大学,iOS Club 官网的工程仓库页面。本项目使用 hugo-academic 作为项目模版进行了自定义 DIY。
本仓库已将 CI 从 Travis 迁移至 Actions ,当 master
分支更新后,可以自动部署,无需手动编译!
语言支持:官网需要支持 中文 和 英文 两种语言。两种语言的内容,分别依靠 content/en
和 content/zh
中的 markdown 文件来区分。不同种语言的页面结构和内容不一定要对应,本模版甚至提供不同语言页面完全不同的可行性,但是在内容更新时,建议尽最大可能保证对应。
内容划分:官网内容分为 成员(Members)、历史(History)、成果(Accomplishments)、活动(Activities) 和 文章(Posts)。接下来将简单介绍不同的内容在本仓库中的对应位置,具体的写作细节,将在下一章介绍。
- 成员(Member):对应
content/x/authors/NAME
中的文件,每一位成员,应当分别创建自己的 中英双语 档案 - 历史(History):对应
content/x/home/history.md
文件,每一个历史节点,对应 markdown 文件中的一个[[experience]]
,博客系统将自动将其按填写时间排序 - 成果(Accomplishment):对应
content/x/accomplishment
中的文件,每个成员请独立维护 中英双语 档案 - 活动(Activities):对应
content/x/project
中的文件夹,一个活动对应一个文件夹。 - 文章(Post):对应
content/x/post
中的文件。
所有内容可以只支持中文,但是要复制一份中文文档放在英文目录下,以确保中英文内容完全一致
所有的开发工作均是基于 Git 和 GitHub 的,所以请学习好相关基础知识
首先安装 hugo
获取代码
git clone https://github.com/TJNU-iOS-Club/BlogSrc-Of-TJNU-iOS-Club.git
cd BlogSrc-Of-TJNU-iOS-Club
启动开发服务器
./view.sh
用浏览器打开 http://localhost:1313 可以看到实时更新的页面
官网内容更新将通过对本仓库 Pull Request 来进行,详细的 Pull Request 方案,请查看 CONTRIBUTING.md