用GitHub Pages搭建博客(四)

本篇介绍配置网站参数及发布文章

GitHub Pages一般使用的Jekyll,配置项基本都设置在_config.yml文件中,在此文件中,按参数描述进行配置即可。此处以上一篇使用的Jekyll主题为例进行介绍。

网站参数配置

如上图所示,常规的_config.yml中,常见的配置有以下:

  • title

title一般是网站的名称,显示在浏览器的页签上。

  • description

descripton一般是网站的描述,由Jekyll生成html元素添加在静态网页中

  • url

url 一般是网站部署后的域名,用于访问网页时正确定位资源路径,如果涉及到自定义域名,需要在此配置,才能正确访问。

  • baseurl

baseurl一般是指当前网站的内容路径,如果就在根目录下,就默认为“/”或“”,如果放在下一级目录中,需要在此配置指定。

  • author

author相关项,一般是主题作者定义的属性,用于配置在网站上显示的作者相关信息,按_config.yml中的注释进行配置即可

  • 其他项

其他项可以看主题作者的注释,一般涉及到网站的访问统计、搜索、留言组件的相关配置。除去作者定义的其他项,剩下的就是Jekyll本身的一般配置项,如plugins、kramdown之类的。这些Jekyll相关的,只有需要自行修改、开发主题的才涉及,我们只使用现在主题,不涉及。

创建文章

一般来说,GitHub Pages使用Jekyll主题,文章一般是放在目录_posts下,我们只要使用Markdown语法书写好文章放入此目录即可。

文章由于要被Jekyll转换为静态网页,所以需要按主题作者的配置,在文件中添加相关的属性说明,比如文章的名称等,详情的介绍。在用GitHub Pages搭建博客(三)中,挑选Jekyll主题时,每个主题的详情网站中都有介绍。

我们可以直接看我们下载的主题_posts目录中的示例文章的格式,按此格式创建我们的文章即可。此处还是以上一篇使用的Jekyll主题为例进行介绍。

如上图,我们看到文章的文件名格式,是日期+文章名,文件扩展名为md。我们新建文章时,按此规则创建文件名即可。

如上图,我们看具体文件内容。在文件头部,由“---”包围的是文章的相关属性,在“---”之后的是文章具体内容。我们新建的文章,也按此规则先填写文章属性,再写文章内容即可。以上图为例,文章属性有如下:

  • title

title一般是文章标题,为在网页中显示

  • layout

layout推荐代表文章所属,具体需要看作者的说明

  • categories

categories指文章的分类

  • image

image指文章的配图,一般显示在文章开头

  • description

description指文章的描述信息,常显示在生成的静态网页的head中,用于搜索网站采集。

按照以上规则,在文件中填写文章的属性后,开始书写文章内容,完成后,将文件保存在_posts目录中,然后按照用GitHub Pages搭建博客(三)中提交主题的方式,将文章提交到仓库即可。

稍等片刻,如果没有异常,在网站中即可看到我们新加的文章。

网站地址:用户名.github.io

欢迎关注我的博客:Awu's Blog | 阿呜的边城

欢迎关注我的公众号:阿呜的编程

原文地址:https://www.cnblogs.com/dev2007/p/13925703.html