学术主页个人信息填写指南
学术主页个人信息填写指南
项目简介
这是一个基于 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
- 确保仓库名为:
ZhaoQisheng123.github.io - 在 GitHub 仓库设置中启用 GitHub Pages
- 推送代码后,网站会自动部署到:
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 up 或 bundle 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/
🚀 准备发布
- 本地测试:确保在本地运行正常
- 提交代码:
git add . git commit -m "更新个人信息" git push origin master - 检查部署:访问
https://ZhaoQisheng123.github.io查看效果 - 持续更新:定期添加新论文、演讲、博客等内容
📚 更多资源
祝您的学术主页搭建顺利!🎓
