学术主页个人信息填写指南

学术主页个人信息填写指南

项目简介

这是一个基于 Jekyll 的学术主页模板 (Academic Pages),专为学者、研究人员和学术工作者设计。它可以免费托管在 GitHub Pages 上,自动将 Markdown 文件转换为精美的网页。


快速开始步骤

1. 本地运行网站(推荐先在本地预览)

使用 Docker(最简单):

cd /Users/zqs/Desktop/ZhaoQisheng123.github.io
chmod -R 777 .
docker compose up

然后在浏览器访问:http://localhost:4000

或者使用 Jekyll(需要安装 Ruby):

# 安装依赖
brew install ruby node
gem install bundler
bundle install

# 启动服务
bundle exec jekyll serve -l -H localhost

2. 部署到 GitHub Pages

  1. 确保仓库名为:ZhaoQisheng123.github.io
  2. 在 GitHub 仓库设置中启用 GitHub Pages
  3. 推送代码后,网站会自动部署到:https://ZhaoQisheng123.github.io

📝 需要填写的个人信息清单

✅ 第一步:基础配置文件 _config.yml

这是最重要的配置文件,位于项目根目录。

1. 网站基本信息(第 10-19 行)

locale: "zh-CN"  # 或 "en-US"
site_theme: "default"  # 主题选项: "default" 或 "air"
title: "您的名字 / 网站标题"
name: &name "您的名字"
description: &description "您的名字的学术作品集"
url: https://ZhaoQisheng123.github.io
baseurl: ""
repository: "ZhaoQisheng123/ZhaoQisheng123.github.io"

填写内容:

  • 您的中文或英文姓名
  • 网站标题(通常是您的名字)
  • 网站描述(简短介绍)
  • GitHub 用户名和仓库名

2. 个人简介信息(第 24-33 行)

author:
  avatar: "profile.png"  # 头像文件名,放在 /images/ 目录
  name: "侧边栏显示的名字"
  pronouns: "他/Him"  # 可选
  bio: "侧边栏的简短个人简介"
  location: "城市, 国家"
  employer: "所在机构/大学"
  uri: ""  # 个人网站(如果有其他主页)
  email: "your.email@example.com"

填写内容:

  • 准备一张个人照片,命名为 profile.png,放到 /images/ 目录
  • 侧边栏显示的名字
  • 简短的个人简介(1-2 句话)
  • 所在城市和国家
  • 工作单位/就读学校
  • 联系邮箱

3. 学术网站链接(第 35-45 行)

  # 学术网站
  academia: ""  # Academia.edu 主页链接
  arxiv: ""  # arXiv 作者主页
  googlescholar: "https://scholar.google.com/citations?user=您的ID"
  inspire-hep: ""
  impactstory: ""
  orcid: "https://orcid.org/您的ORCID"
  semantic: ""
  pubmed: ""
  researchgate: ""  # ResearchGate 主页
  scopus: ""

填写内容:

  • Google Scholar 个人主页链接(如有)
  • ORCID 链接(如有)
  • ResearchGate、arXiv 等其他学术网站链接

4. 代码仓库和开发平台(第 47-53 行)

  # 代码仓库
  bitbucket: ""
  codepen: ""
  dribbble: ""
  github: "您的GitHub用户名"
  kaggle: ""
  stackoverflow: ""

填写内容:

  • GitHub 用户名
  • 其他技术平台账号(如需要)

5. 社交媒体账号(第 55-80 行)

  # 社交媒体
  artstation: ""
  bluesky: ""
  facebook: ""
  flickr: ""
  foursquare: ""
  goodreads: ""
  google_plus: ""
  keybase: ""
  instagram: ""
  lastfm: ""
  linkedin: "您的LinkedIn用户名"
  mastodon: ""
  medium: ""
  pinterest: ""
  soundcloud: ""
  steam: ""
  telegram: ""
  tumblr: ""
  twitter: ""  # X/Twitter 用户名
  vine: ""
  weibo: "您的微博用户名"
  wikipedia: ""
  xing: ""
  youtube: ""
  zhihu: "您的知乎用户名"

填写内容:

  • LinkedIn 个人主页
  • 微博、知乎等中文社交平台账号
  • Twitter/X 账号(如有)
  • 其他社交媒体账号

✅ 第二步:主页内容 _pages/about.md

这是网站的首页,访客第一眼看到的内容。

位置: _pages/about.md

---
permalink: /
title: "关于我"
author_profile: true
redirect_from: 
  - /about/
  - /about.html
---

# 在这里写您的个人简介

## 研究方向
描述您的研究领域和兴趣...

## 教育背景
- 博士,XXX大学,XXX专业(20XX-20XX)
- 硕士,XXX大学,XXX专业(20XX-20XX)
- 学士,XXX大学,XXX专业(20XX-20XX)

## 研究兴趣
- 研究方向1
- 研究方向2
- 研究方向3

## 最新动态
- [日期] 最新消息...

填写内容:

  • 详细的个人介绍
  • 教育背景
  • 研究方向和兴趣
  • 最新动态和新闻

✅ 第三步:发表论文 _publications/ 目录

为每篇论文创建一个 .md 文件。

文件命名格式: YYYY-MM-DD-论文标题.md

模板:

---
title: "论文标题"
collection: publications
category: conferences  # 或 manuscripts(期刊), books(书籍)
permalink: /publication/YYYY-MM-DD-论文标题
excerpt: '论文简短摘要(1-2句话)'
date: 2024-01-01
venue: '会议或期刊名称'
paperurl: 'http://链接到论文PDF'
citation: '作者. (年份). "论文标题." <i>期刊/会议名</i>. 卷(期).'
---

在这里可以写更详细的论文介绍、研究背景、主要贡献等。

填写内容:

  • 为每篇论文创建一个 Markdown 文件
  • 上传 PDF 到 /files/ 目录
  • 填写论文标题、发表时间、期刊/会议名称、引用格式

✅ 第四步:学术报告 _talks/ 目录

为每次演讲或报告创建一个 .md 文件。

模板:

---
title: "报告标题"
collection: talks
type: "Talk"  # 或 "Tutorial", "Invited Talk" 等
permalink: /talks/YYYY-MM-DD-报告标题
venue: "会议或机构名称"
date: 2024-01-01
location: "城市, 国家"
---

在这里描述报告内容、听众反馈等。

可以添加报告幻灯片链接:[下载幻灯片](/files/slides.pdf)

填写内容:

  • 报告标题和时间
  • 报告地点和机构
  • 上传幻灯片到 /files/ 目录(如有)

✅ 第五步:教学经验 _teaching/ 目录

为每门课程创建一个 .md 文件。

模板:

---
title: "课程名称"
collection: teaching
type: "Undergraduate course"  # 或 "Graduate course", "Workshop" 等
permalink: /teaching/YYYY-学期-课程名
venue: "大学名称, 学院"
date: 2024-01-01
location: "城市, 国家"
---

## 课程描述
这是一门关于...的课程

## 教学内容
- 主题1
- 主题2
- 主题3

## 课程资料
- [讲义](/files/lecture-notes.pdf)
- [作业](/files/homework.pdf)

填写内容:

  • 教授过的课程名称和时间
  • 课程描述和教学内容
  • 课程资料(如需公开)

✅ 第六步:博客文章 _posts/ 目录

写一些学术博客、研究笔记或技术分享。

文件命名格式: YYYY-MM-DD-标题.md

模板:

---
title: '博客标题'
date: 2024-01-01
permalink: /posts/2024/01/博客标题/
tags:
  - 标签1
  - 标签2
  - 标签3
---

博客正文内容...

## 小标题
内容...

填写内容:

  • 撰写博客文章(可选)
  • 添加相关标签

✅ 第七步:项目作品集 _portfolio/ 目录

展示您的研究项目或软件作品。

模板:

---
title: "项目名称"
excerpt: "项目简短描述<br/><img src='/images/项目截图.png'>"
collection: portfolio
---

## 项目介绍
详细描述项目背景、目标、技术栈等。

## 主要功能
- 功能1
- 功能2

## 链接
- [GitHub 仓库](https://github.com/...)
- [项目网站](https://...)
- [演示视频](https://...)

填写内容:

  • 研究项目或软件作品
  • 项目截图放到 /images/ 目录
  • 项目链接和演示

✅ 第八步:简历页面 _pages/cv.md

编辑个人简历页面。

位置: _pages/cv.md

您可以使用 Markdown 格式编写,或者使用 JSON 格式(_data/cv.json)。

填写内容:

  • 完整的学术简历
  • 教育背景、工作经历
  • 发表论文列表
  • 获奖和荣誉
  • 技能和专长

✅ 第九步:导航菜单 _data/navigation.yml

自定义顶部导航栏显示的链接。

位置: _data/navigation.yml

main:
  - title: "Publications"  # 显示的文字
    url: /publications/    # 链接地址
  
  - title: "Talks"
    url: /talks/
  
  - title: "Teaching"
    url: /teaching/
  
  - title: "Portfolio"
    url: /portfolio/
  
  - title: "Blog Posts"
    url: /year-archive/
  
  - title: "CV"
    url: /cv/

填写内容:

  • 根据需要增删导航项
  • 如果某个栏目不需要,可以删除或注释掉

📂 文件上传清单

图片文件(放在 /images/ 目录)

  • profile.png - 个人头像(建议尺寸:500x500px)
  • 其他项目截图、插图等

PDF 文件(放在 /files/ 目录)

  • 论文 PDF 文件
  • 幻灯片 PDF 文件
  • 简历 PDF 文件
  • 其他相关文件

🎨 自定义样式和主题

更改网站主题

_config.yml 中修改:

site_theme: "default"  # 或 "air"

更改网站语言

locale: "zh-CN"  # 中文简体
# locale: "en-US"  # 英语

🔧 常见问题

1. 如何预览网站?

运行 docker compose upbundle exec jekyll serve,然后访问 http://localhost:4000

2. 修改后网站没有更新?

  • 本地开发:重启 Jekyll 服务
  • GitHub Pages:等待 1-2 分钟让 GitHub 自动构建

3. 如何添加数学公式?

在 Markdown 中使用:

  • 行内公式:$E=mc^2$
  • 独立公式:$$E=mc^2$$

4. 如何批量生成论文/演讲页面?

使用 /markdown_generator/ 目录下的 Python 脚本或 Jupyter Notebook,从 TSV/CSV 文件批量生成。


📋 填写检查清单

完成后打钩:

配置文件:

  • _config.yml - 基础信息已填写
  • _data/navigation.yml - 导航菜单已调整

个人信息:

  • 头像图片已上传
  • 主页介绍已撰写 (_pages/about.md)
  • 简历已更新 (_pages/cv.md)

学术内容:

  • 论文列表已添加 (_publications/)
  • 演讲记录已添加 (_talks/)
  • 教学经验已添加 (_teaching/)

可选内容:

  • 项目作品集已添加 (_portfolio/)
  • 博客文章已撰写 (_posts/)

链接和资源:

  • 社交媒体链接已填写
  • PDF 文件已上传到 /files/
  • 图片文件已上传到 /images/

🚀 准备发布

  1. 本地测试:确保在本地运行正常
  2. 提交代码
    git add .
    git commit -m "更新个人信息"
    git push origin master
    
  3. 检查部署:访问 https://ZhaoQisheng123.github.io 查看效果
  4. 持续更新:定期添加新论文、演讲、博客等内容

📚 更多资源


祝您的学术主页搭建顺利!🎓

如有问题,可以查看项目的 Issues讨论区