元数据

飞跃手册使用 Markdown 文件开头的 YAML frontmatter 来为经验分享贴子添加元数据。其大致格式如下：

---
type: grad
author: 黄冠超
year: 19
degree: master
university: nd
department: sme
date: 2023-02-19
---

# 标题

...

必须字段

NOTE

目前 title 从第一级标题中自动提取，因此并非所需字段，但日后可能移动到 frontmatter 中。

• author：作者的姓名。
• date：帖子合并的时间，遵守 YYYY-MM-DD 格式。
• department：作者所属的院系，详见 department。
• type：帖子的类型，可选值如下：
  • grad: 个人申请总结。
  • abroad: 海外交流项目，包括暑研、暑校等。
  • job: 求职就业经验分享。
  • recruit: 招生信息。
  • experience: 其他专项经验分享，如英语学习、备考、其他的学习经验等。

NOTE

在内容根目录下，且没有 type 字段的，被视作特殊页面，如 /join、/updates 等。

按类型必须字段

除所有帖子都必须包含的字段外，不同类型的帖子有特定的字段要求。可通过点击链接跳转到文档的对应位置查看。

• grad - 申请经验
  • department
  • degree
  • region
  • program
  • university
  • year
• abroad - 海外交流
  • department
  • region
  • university
• job - 就业经验
  • department
  • employer
  • year
• recruit - 招生信息
  • region
  • university
• experience - 其他专项经验分享
  • department

所有可用字段

这里展示其余所有可用的字段及选项。根据分享类型，需要填入不同的字段组合。

degree

录取的学位，可选值为 master 和 doctor。

department

申请人在南科大所属的院系对应的代码，由院系域名决定。例如深港微电子学院的域名为 sme.sustech.edu.cn 则其代码为 sme，这与通行的缩写和课程代号前缀可能有所不同。可选值如下：

bio: 生命科学学院
bme: 生物医学工程系
business: 商学院
chem: 化学系
cse: 计算机科学与工程系
eee: 电子与电气工程系
ese: 环境学院
ess: 地球与空间科学系
mae: 力学与航空航天工程系
math: 数学系
mee: 机械与能源工程系
med: 医学院
mse: 材料科学与工程系
ocean: 海洋科学与工程系
phy: 物理系
sdim: 系统设计与智能制造学院
sme: 深港微电子学院
stat-ds: 统计与数据科学系

employer

就业经验所涉及的雇主名称。

program

申请的项目/专业，不包括学位。例如，项目全称为 PhD in Computer Science and Engineering，则项目为 Computer Science and Engineering。

region

经验分享适用的 ISO 3166 标准地区代码。可以是单个地区或多个地区。

region: us # 单个地区
region: [us, ca] # 多个地区

university

学校代码，以学校域名为准。例如 University of Notre Dame 的域名为 nd.edu，则代码为 nd。如果学校还未在其他经验分享未出现过，则需要先在 src/metadata.yaml 中添加对应的值。

year

投稿者的年级，格式为 YY。