使用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个人描述等的修改,这里就不赘述了

参考:

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. 然后填入对应的值即可,例如:
    在这里插入图片描述

参考:

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 后续修改

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

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,算了,还是保持公开吧

参考:


其他参考(非academicpages的视线):