使用Github.io创建自己的博客
文章目录
1.最终效果
2.操作步骤
2.1 前置操作
- Fork repo, https://github.com/academicpages/academicpages.github.io
- 进入fork的项目中,点击Setting,把名字改成你的github名字.github.io (yourname.github.io),
- 下载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的链接
- 在
_config.yml
中,author
字段里,和上面一样,写上名称和对应的url链接地址 - 在
_includes/author-profile.html
中,照着下面的复制,然后修改,其中关于class字段的值,可以去网站https://fontawesome.com/search搜索
- 建议看这个:https://www.w3schools.com/icons/icons_reference.asp,似乎这个网页只支持部分font awesome(font awesome 5)
- 然后填入对应的值即可,例如:
参考:
- 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/
3. 项目设置为私密(要付费升级账号才行❌)
3.1 取消/解绑fork的依赖关系
如果是直接fork了原项目,那么这个项目是无法修改可见性为私密的。因此,可以使用github的虚拟助手:
- 点击链接:https://support.github.com/contact?tags=rr-forks&subject=Detach Fork&flow=detach_fork
- 选择Detach/Extract
- 然后按照提示,输入要解除fork关系的repo url或者yourname/repo等
- 然后去自己github绑定的邮箱里,可以看到一个工单号
- 点击,就可以看到这个工单的详情了,如果解绑操作完成,邮件也会有额外的通知的,等着就好了,我等了大概4个小时工单处理好的显示
3.2 设置私密
- 收到解绑后的通知,就可以去setting中把项目设置为不可见了。
- BUT,如果想设置成不可见,那么github pages就要升级到专业版。。。
- so,算了,还是保持公开吧
参考:
其他参考(非academicpages的视线):