2023-4-23 在Github上搭建个人网站

Published:

我使用模板搭建个人网站的过程,以及解决一些小问题的方法。

写在前面

Tools and Basics

  1. Uses the template of the https://github.com/academicpages/academicpages.github.io repository
  2. Fork it, change the meta data and upload my own content

Customization procedures

1. 修改 _config.yml 根文件

  • 更改关键信息:网站名、姓名、url (github.io后缀的网址)、repository (你自己的repository)等
  • 注意:url一定要填写准确,否则在站内其他页面的相对路径会出错。

2. 修改_data/文件夹下的author.yml, navigation.yml 两个文件

  • author.yml: 姓名等基本信息
  • navigation.yml: 主页指向的其他页面—相对路径。默认包括publications, talks, teaching, portfolio, blog posts, CV和guide 七个界面。可以增删。增加的话需要在根目录增加相应的文件夹和内容。

3. 修改_pages/文件夹下各个界面的html/md导航内容

  • 内容格式可以是html,也可以是md。

4. 上传各个界面文件夹下的具体内容,比如CV, talks, publications等,根据内容编写md/html文件。

  • 目前可操作的方法有(根据ChatGPT的建议):
    1. 在Notion中编写文档,如本文档,再export为markdown & csv文件,选取md文件上传。
    2. 直接在编辑器中编写md文档。有需要上传图片的地方,写好引用位置,再把图片单独上传到images/或者相应的文件夹中。

2023-10-12 解决blog内容无法显示的问题

其实4月23日已经写下第一篇blog,但是网站上一直无法显示(blog栏目下为空白)。效率优先,我就先把blog部分隐藏,网站上线。

今天突然想更新一些阅读感想,就继续来看这个问题。根结似乎出在 _data/ui_text.yml 中,默认显示语言中并未配置中文。试一试找解决方案。

结果发现原因并不是中英文的显示问题,而是网站的blogs栏目根文件引导问题。因为这个网站的模板是fork来的,所以本身对blogs引导的位置是_pages文件夹下的year_archive.html 并且设置blog栏目的默认链接是网址/year_archive (吐槽一下,作者是怎么想到这个鬼才命名的)。而我把栏目名称改成blogs之后,内容文件自然找不到归属的地方了,从网页上也就打不开应有的文章了。

解决办法是:把_data/文件夹下navigation.yml文件中的 blogs 位置引导为 url: /blogs,这样一来,网页上导航指示的位置就和后台编写的内容指示的位置一致。后台内容找到了前台显示的路径,问题解决。

2023-10-26 相同办法解决 talks 内容显示问题

最近有新的公众演讲,想要把 talks 这一栏目建立起来,保存一个记录的位置。按照上次的方法,把 talks 部分的导航不一致问题解决。内容正常显示。

Leave a Comment