2023-4-23 在Github上搭建个人网站
Published:
我使用模板搭建个人网站的过程,以及解决一些小问题的方法。
写在前面
Tools and Basics
- Uses the template of the https://github.com/academicpages/academicpages.github.io repository
- 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的建议):
- 在Notion中编写文档,如本文档,再export为markdown & csv文件,选取md文件上传。
- 直接在编辑器中编写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