Mr Loser

Jekyll搭建博客食用指北

2019-06-05 18:31:21


前言

笔者闲得无聊所以搭建了个博客。

当时觉得Hexo用起来有点太麻烦,于是就找到了Jekyll这个工具。

环境要求

  • Ubuntu(或Windows)系统,笔者使用Linux演示。
  • Ruby环境(Ubuntu使用sudo apt-get install ruby-full命令安装,Windows请自行下载安装包安装)。

开始之前

安装Jekyll

使用sudo gem install jekyll(Linux)或gem install jekyll(Windows)安装。

安装bundler

使用sudo gem install bundle(Linux)或gem install bundle(Windows)安装。

初级使用

初步搭建

为你的网站新建一个文件夹,进入那个文件夹并运行jekyll new .,看到New jekyll site installed in 你的目录,就说明成功了。

成功后的文件夹内目录结构如下:

.
├── 404.html        //404页面
├── about.md        //About页面内容
├── _config.yml
├── Gemfile
├── Gemfile.lock
├── index.md
└── _posts      //文章
    └── 2019-06-05-welcome-to-jekyll.markdown

然后运行jekyll serve,输入http://localhost:4000(正常情况下)即可预览你的网站。若需停止,输入Control+C即可。

预览效果如下:

更改参数

显然,这个网站不是我们想要的。

我们找到网站目录下的_config.yml文件,这是网站的配置文件。打开我们发现有一大堆注释,还有一小部分配置代码(过度包装)

各种参数的功能如下(非全部):

参数名称 用途
title 网站标题
email 电子邮件
description 网站的介绍说明
baseurl 网站的根目录
url 网站的地址(主机名+协议)
twitter_username 推特用户名
github_username GitHub用户名
markdown markdown设置(请勿修改,否则部署到GitHub上会有编译错误)
theme 网站主题

各个参数所对应的网站的部分如下图(点击可查看高清大图):

按照这张图修改就好了。

发布文章

我们进入_posts文件夹,这是存储文章的文件夹。

文章的文件命名遵循以下格式:日期(年-月-日)-文章名称.markdown

新建好文章文件后,使用Markdown编辑器打开,在文章头部添加如下内容:

---
layout: post
title:  "文章标题"
date:   发布日期(年-月-日 时:分:秒 +0800(时区))
---

随后在下方使用Markdown撰写文章。

部署到GitHub

使用你的GitHub用户新建一个名为你的用户名.github.io的仓库,随后将网站文件夹下的所有文件上传上去,GitHub会自动部署。

稍等片刻,用浏览器访问你的用户名.github.io即可进入你的网站。

进阶使用

你会发现,这个网站不支持 $\LaTeX$ ,甚至连评论系统都没有。没关系,我么们接下来就要解决这一问题。

自定义布局