zoukankan      html  css  js  c++  java
  • 用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 | 阿呜的边城

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

  • 相关阅读:
    C# 日志本地化工具
    javascript面向对象的写法01
    VM12-Pro 安装CentOS7 并配置静态IP出坑记
    基于CentOS7.x安装Nginx-1.18.0
    程序员思维导图、web初学者必备、web前端知识集锦-不断更新中...
    js知识
    swiper的使用
    web 移动端键盘处理-vue移动端那些事
    vue学习计划-vuex生态
    vue 组件复用
  • 原文地址:https://www.cnblogs.com/dev2007/p/13925703.html
Copyright © 2011-2022 走看看