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

开源 0

文章目录

  • 1.最终效果
  • 2.操作步骤
    • 2.1 前置操作
    • 2.2 按照自己需求修改内容
      • 2.2.1 基本修改
      • 2.2.2 额外添加知乎等社交网站链接
    • 2.3 首页修改
    • 2.4 查看发布状态
    • 2.5 奇怪的错误(头像显示错误)
    • 2.6 本地调试
    • 2.7 后续修改
  • 3. 项目设置为私密（要付费升级账号才行❌）
    • 3.1 取消/解绑fork的依赖关系
    • 3.2 设置私密

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）

也许您对下面的内容还感兴趣：