美文网首页计算机杂谈我爱编程
Github Pages + Jekyll 创建个人博客

Github Pages + Jekyll 创建个人博客

作者: 胖若两人_ | 来源:发表于2018-05-28 21:38 被阅读9次

    正文之前

    在去年的时候接触到了Github,同时也了解到了Github Pages,这是Github为每位用户提供的一个能够作为个人主页的仓库,上个月才开始搭建个人仓库,应网友的请求,写一篇搭建个人博客的过程,最后当然要打一波我的博客的广告了

    关于题目中说到的Jekyll,是一个静态博客网站生成器,也就是说,用MarkDown写完的文章,经过你选定的Jekyll模板的转换,就能够生成面向公众的静态网页了,而且Jekyll集成了服务器,支持本地预览

    正文

    接下来说重点:

    1. 创建仓库

    既然是每个用户只能有一个主页,所以仓库的名字肯定是要特殊化的:

    用户名.github.io

    我创建了一个小号来做这个示范:



    2. Jekyll工具

    准备一个Linux系统,来使用Jekyll工具,我用的是虚拟机里的Ubuntu系统

    具体的Jekyll下载过程:

    1. 需要配置按照官网给出的环境:
    1. 安装Jekyll:

    Ubuntu镜像应该自带上述环境,我直接进行了jekyll的安装:

    gem install jekyll
    
    1. 挑选模板

    在jekyll的模板目录中挑选自己喜欢的,并找到模板的GitHub地址,这里要将一点,推荐选用那些有空白模板的,免得有很多需要修改的信息

    我们以模板中的第一个模板为例

    找到模板的源码位置:



    3. 本地编辑

    把这个模板仓库和你刚才创建的博客仓库下载到本地,并且认真阅读模板项目中的README文档,文档里有关于模板的基础配置,一些特点以及博客文章的规范等信息

    具体的操作试模板而定,我是直接把模板里的所有文件(除了README文档)全部复制到我的仓库里,简单粗暴,然后push

    4. Jekyll目录

    官网给出的基本的目录是这样的:

    然后我以我的博客目录来解释一下这些文件夹:

    • _config.yml

    是核心的配置文件,里面包含了你的博客的基本信息,网页的地址,其他的链接以及MarkDown格式等信息

    • _includes

    是一些可重用的组件,比如Github、知乎和简书的链接,谷歌分析的代码等等

    • _layouts

    是你博客网页的布局

    • _posts

    这里存放要发表的文章,也就是需要被转换成.html.md文件

    • _site

    这个文件夹是存放Jekyll转换完成的页面,官方推荐最好放入.gitignore 文件中,以免被他人查看

    其他没有提到的是我没有使用到的,当然我使用的博客模板中还有一些如css, js, img, font之类的目录,这些都视模板而定

    5. 发布文章

    • 文章标题

    年-月-日-标题.MARKUP,比如当前这篇文章就是:

    2018-05-28-Github Pages + Jekyll 创建个人博客.md

    • YAML头信息

    每篇文章都需要YAML头信息,具体的信息是由你的模板决定的

    • Jekyll转换

    把添加了头信息和修改了标题的文章放至_posts文件夹中,然后在博客仓库内使用 jekyll serve 命令:

    运行之后可以在本地预览博客内容,端口为http://localhost:4000

    预览完成之后,用git命令来进行add和commit,并且push本地仓库,过几分钟登陆博客地址,就能够看到内容更新了:

    git add
    git commit
    git pull
    git push

    这四条命令就够了,博客的基础搭建就这样结束了,祝大家都能挑选到心仪的模板,最后再次抛出我的博客

    相关文章

      网友评论

        本文标题:Github Pages + Jekyll 创建个人博客

        本文链接:https://www.haomeiwen.com/subject/mddeaxtx.html