Jekyll利用编写好的Markdown生成HTML文件。GitHub自带Jekyll,所以项目文件可以直接托管给GitHub,无需自己再建站部署。
整个项目clone到自己新建的GitHub库中,库名改成[GitHub名].github.io,_config.yml文件中的url也改成[GitHub名].github.io
-
基本信息修改:编辑配置文件_config.yml
-
静态文件(pdf文件等): /files/
-
主页图片(可以在_config.yml中修改): images/profile.png
-
顶部导航栏配置:_data/navigation.yml
-
关键* 编辑导航栏每一项对应的单页:_pages/
-
每一个单页对应一个markdown文件或html文件。
-
无论是markdown文件还是html文件,都要编写文件最开头的YAML front matter信息。以Publications栏的publications2.md为例:
-
在_pages文件夹创建的markdown文件,其名称通常与navigation.yml文件中相应栏目的url一致,方便查找修改,比如此处的publications2.md就与Publications栏的url一致。
-
permalink:
指定页面的永久链接,此处设为/publications2/
,与navigation.yml文件中Publications栏的url一致- 如果设定为/,表示将当前文件映射至网站首页,本项目中的about.md文件是这样配置的。
-
title:
设定页面标题,通常会显示在网页的浏览器标签中或页面的显著位置。 -
redirect_from:
设置重定向路径,可以让其他链接自动跳转到此页面。路径/publications2/
和/publications2.html
将自动跳转到当前页面。路径名通常与permalink:
保持一致。
-
-
-
关于非导航栏页面的相互跳转。一个简单的实现思路是,把所有页面以md的形式写好、YAML front matter信息配置好,放到_pages中,然后把目标页面的路径链接到其他页面中。 比如中文页最底部的test演示