使用Github.io创建自己的博客

文章目录

1.最终效果

2.操作步骤

2.1 前置操作

1. Fork repo, https://github.com/academicpages/academicpages.github.io
2. 进入fork的项目中，点击Setting，把名字改成你的github名字.github.io (yourname.github.io),
3. 下载fork后的项目到本地，vscode打开准备开始编辑修改

2.2 按照自己需求修改内容

2.2.1 基本修改

把

_config.yml

中的内容全部复制到

_config.dev.yml

中，后者当做备份，然后对前者进行修改。

主要就是name，baseurl和description个人描述等的修改，这里就不赘述了

参考：

• Building an Academic Website
• https://academicpages.github.io/markdown/
• https://github.com/linfangjian01/linfangjian01.github.io
• https://bryanyzhu.github.io/

2.2.2 额外添加知乎等社交网站链接

比如，要添加知乎和csdn的链接

1. 在_config.yml中，author字段里，和上面一样，写上名称和对应的url链接地址
2. 在_includes/author-profile.html中，照着下面的复制，然后修改，其中关于class字段的值，可以去网站https://fontawesome.com/search搜索
3. 建议看这个：https://www.w3schools.com/icons/icons_reference.asp，似乎这个网页只支持部分font awesome（font awesome 5）
4. 然后填入对应的值即可，例如：

参考：

• Way to add blogger icon and link easily? #784
• https://fontawesome.com/search，可以在这个网站找想要的icon的类名称

2.3 首页修改

• 左侧的①，其实就是_config.yml文件的Site Author部分，其中关于个人头像，默认给的展位图是720720的png图像，因此自己的图像也尽量是720720的，可以在PPT里裁剪一下，然后用微信发送压缩一下
• 上面的②，其实体现在_data/navigation.yml中，不想要的可以删除或者注释掉，对应的其实是各个子文件夹，例如：Publications对应的就是_publications文件夹，里面可以存放以md文件或者是html文件形成的内容
• 上面的③，对应_pages/about.md文件，可以直接用markdown的一级标题二级标题的井号语法。

2.4 查看发布状态

根据https://docs.github.com/zh/pages/quickstart可知，一般5~10分钟就发布好了，但是实际上，查看

Actions

就可以看到对应的构建和发布状态，基本上都是1分钟左右

2.5 奇怪的错误(头像显示错误)

头像无法显示，链接多了一个空格

搜索定位问题到文件

_includes/author-profile.html

导致这个空格出现的原因是，在添加知乎和csdn的链接后，在VScode中进行了保存，保存时默认对html文件进行了格式化，自动添加了这个空格。

根据如何解决vscode中保存后html自动格式化的问题可知，直接去首选项修改格式即可。

2.6 本地调试

这部分内容我没有试过，来自：https://jayrobwilliams.com/posts/2020/06/academic-website/

如果想在本地调试，那么需要安装

Jekyll

，最简单的安装方法就是使用

Bundler

进行安装，Bundler是一个Ruby的包管理器，

Jekyll

是用Ruby写的

• 如果是Windows，那么需要RubyInstaller
• 如果是macOS，就可以直接用homebrew来安装了brew install ruby
• 如果是linux，直接用包管理器安装Ruby，然后执行gem install bundler
• 安装好bundler之后，就可以切换到项目目录下，执行bundle install 这句话会读取 Gemfile文件并执行一些安装
• 接下来就可以在本地启动一个jekyll服务，bundle exec jekyll serve 然后去访问127.0.0.1:4000或者localhost:4000就可以看到网页了

2.7 后续修改

基本了解文件结构之后，想要再改什么，就直接参考下面这两个成品改就可以了

• https://academicpages.github.io/publications/
• https://bryanyzhu.github.io/
• https://yonsci.github.io/yon_academic//
• https://junqing-zhang.github.io/ - https://github.com/academicpages/academicpages.github.io/compare/master...junqing-zhang:junqing-zhang.github.io:master- 直接看改动了哪些其实更直接

3. 项目设置为私密（要付费升级账号才行❌）

3.1 取消/解绑fork的依赖关系

如果是直接fork了原项目，那么这个项目是无法修改可见性为私密的。因此，可以使用github的虚拟助手：

1. 点击链接：https://support.github.com/contact?tags=rr-forks&subject=Detach Fork&flow=detach_fork
2. 选择Detach/Extract
3. 然后按照提示，输入要解除fork关系的repo url或者yourname/repo等
4. 然后去自己github绑定的邮箱里，可以看到一个工单号
5. 点击，就可以看到这个工单的详情了，如果解绑操作完成，邮件也会有额外的通知的，等着就好了，我等了大概4个小时工单处理好的显示

3.2 设置私密

• 收到解绑后的通知，就可以去setting中把项目设置为不可见了。
• BUT，如果想设置成不可见，那么github pages就要升级到专业版。。。
• so，算了，还是保持公开吧

参考：

• Delete fork dependency of a GitHub repository

其他参考（非academicpages的视线）：

• https://idratherbewriting.com/documentation-theme-jekyll/mydoc_publishing_github_pages.html
• https://www.natalyakosenko.com/2017-12-23-how-to-switch-jekyll-theme-on-github-pages-site
• https://github.com/poloclub/ganlab/tree/master
• 利用github.io快速拥有自己的第一个免费个人主页
• 如何在 GitHub 上搭建个人网站（github.io）