LiXueLong

别让等待成为遗憾!

这是我用来记录平日学习笔记的地方,欢迎您的访问.


使用Jekyll + GitHub Pages搭建个人博客

前言

一直就想搭建一个属于自己的博客网站,但是一直拖着没有执行,在一次偶然的机会看到了鸿洋大神的 如何利用github打造博客专属域名,就心血来潮,马上自己动手做了一个,耗时了近一个星期,终于差不多完成了,特意记录下来,供他人参考。

目录

关于Jekyll

 Jekyll 是一个免费的生成静态网页的工具,不需要数据库支持。它有一个模版目录,其中包含原始文本格式的文档,通过 Markdown (或者 Textile) 以及 Liquid 转化成一个完整的可发布的静态网站,可以配合第三方服务例如: Disqus(评论)、多说(评论) 以及分享 等等扩展功能,Jekyll 可以直接部署在 Github(国外) 或 Coding(国内) 上,可以绑定自己的域名。Jekyll中文文档Jekyll英文文档Jekyll主题列表

关于GitHub Pages

 官方说法是Websites for you and your projects.GitHub Pages是一个免费的静态网站托管平台,由github提供,它具有以下特点:

  1. GitHub Pages 有 300M 免费空间,资料自己管理,保存可靠;
  2. 学着用 GitHub,享受 GitHub 的便利,上面有很多大牛,眼界会开阔很多;
  3. 顺便看看 GitHub 工作原理,最好的团队协作流程;
  4. GitHub 是趋势;
  5. 可以自定义域名

本地环境搭建

如果你只是想使用本主题,而不想搭建本地环境,那么可以直接跳过这部分,不搭建本地环境则不能实现本地预览,以下安装操作都是在Windows系统环境下进行。(安装有点烦,会出现你意想不到的错误,祝你好运!)

安装Ruby

jekyll本身基于Ruby开发,因此,想要在本地构建一个测试环境需要具有Ruby的开发和运行环境。在windows下,可以使用Rubyinstaller安装,ruby安装官方说明,Windows下只需要保持默认状态一路下一步就可以了。

安装RubyDevKit

从这里下载DevKit,注意版本要与Ruby版本一致。

下载下来的是一个sfx格式的文件,如果你安装有7-zip,可以直接双击,它会自解压到你所选择的目录。

解压完成之后,用cmd进入到刚才解压的目录下,运行下面命令,该命令会生成config.yml。

$ ruby dk.rb init

config.yml文件实际上是检测系统安装的ruby的位置并记录在这个文件中,以便稍后使用。但上面的命令只针对使用rubyinstall安装的ruby有效,如果是其他方式安装的话,需要手动修改config.yml

最后,执行如下命令,执行安装:

$ ruby setup.rb

如果没有setup.rb的话,执行:

$ ruby dk.rb install

安装Git

Git下载

创建本地仓库myblog

$ git init myblog

安装Bundler

建议使用Bundler来安装和运行Jekyll。

直接使用下面命令即可:

$ gem install bundler

然后在上面的myblog目录创建一个叫Gemfile的文件,注意没有后缀,输入


source 'https://ruby.taobao.org/'
gem 'github-pages', group: :jekyll_plugins

保存后,在命令行中执行

$ bundle install

命令会根据当前目录下的Gemfile,安装所需要的所有软件。这一步所安装的东西,可以说跟github本身的环境是完全一致的,所以可以确保本地如果没有错误,上传后也不会有错误。而且可以在将来使用下面命令,随时更新环境,十分方便

$ bundle update

使用下面命令,启动转化和本地服务:

$ bundle exec jekyll serve

在浏览器里输入: http://localhost:4000,就可以看到你的博客效果了。

so easy !(PS:说起来都是泪啊,国内的网络你懂得,下载安装有点慢请耐心等待,或者使用淘宝源)

目录结构

   Jekyll 的核心其实是一个文本转换引擎。它的概念其实就是: 你用你最喜欢的标记语言来写文章,可以是 Markdown,也可以是 Textile,或者就是简单的 HTML, 然后 Jekyll 就会帮你套入一个或一系列的布局中。在整个过程中你可以设置URL路径, 你的文本在布局中的显示样式等等。这些都可以通过纯文本编辑来实现,最终生成的静态页面就是你的成品了。

一个基本的 Jekyll 网站的目录结构一般是像这样的:

.
├── _config.yml
├── _includes
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── default.html
|   ├── post.html
|   └── page.html
├── _posts
|   └── 2017-08-01-welcome-to-jekyll.markdown
├── _sass
|   ├── _base.scss
|   ├── _layout.scss
|   └── _syntax-highlighting.scss
├── about.md
├── css
|   └── main.scss
├── feed.xml
└── index.html

这些目录结构以及具体的作用可以参考 官网文档

进入 _config.yml 里面,修改成你想看到的信息,重新 jekyll server ,刷新浏览器就可以看到你刚刚修改的信息了。

到此,博客初步搭建算是完成了,

部署到服务器

我这里讲的是部署到 Github Page 创建一个 github 账号,然后创建一个跟你账户名一样的仓库,如我的 github 账户名叫 skylarklxlong,我的 github 仓库名就叫 skylarklxlong.github.io,创建好了之后,把刚才建立的 myblog 项目 push 到 username.github.io仓库里去(username指的是你的github用户名),检查你远端仓库已经跟你本地 myBlog 同步了,然后你在浏览器里输入 username.github.io ,就可以访问你的博客了。

编写文章

  所有的文章都是 _posts 目录下面,文章格式为 mardown 格式,文章文件名可以是 .mardown 或者 .md。

  编写一篇新文章很简单,你可以直接从 _posts/ 目录下复制一份出来 2017-08-01-welcome-to-myblog.md ,修改名字为 2017-08-01-article1.markdown ,注意:文章名的格式前面必须为 2017-08-01- ,日期可以修改,但必须为 年-月-日- 格式,后面的 article1 是整个文章的连接 URL,如果文章名为中文,那么文章的连接URL就会变成这样的:%E6%90%AD%E5, 所以建议文章名最好是英文的或者阿拉伯数字。 双击 2017-08-01-article1.markdown 打开


---
layout: post
title: 欢迎来到我的博客
date: 2017-08-01
tags: Jekyll
---

正文...

title: 显示的文章名, 如:title: 我的第一篇文章
date: 显示的文章发布日期,如:date: 2016-10-16
tags: tag标签的分类,如:tags: 随笔

注意:文章头部格式必须为上面的,…. 就是文章的正文内容。

我写文章使用的是 MarkdownPad2 编辑器,如果你对 markdown 语法不熟悉的话,可以在网上查找写资料,后续我也会写关于如何使用markdown的相关文章。

使用我的模版

虽然博客部署完成了,你会发现博客太简单不是你想要的,如果你喜欢我的模板的话,可以使用我的模板。

首先你要获取的我博客,Github项目地址,你可以直接点击下载博客,进去skylarklxlong.github.io/ 目录下, 使用命令部署本地服务

$ jekyll server   

就可以看到的博客样式了。

修改成你自己的博客

  • 如果你想使用我的模板请把 _posts/ 目录下的文章都去掉。
  • 修改 _config.yml 文件里面的内容为你自己的。

然后使用 git push 到你自己的仓库里面去,检查你远端仓库,在浏览器输入 username.github.io 就会发现,你有一个漂亮的主题模板了。

写在最后

刚开始写博客不久(是真的刚开始),难免会出现一些语法及其他错误,还请各位多多包含。

如果你在搭建博客遇到问题,可以在我的联系方式中给我提问。

后面会继续介绍,如何绑定你自己的固定域名,欢迎继续关注我博客的更新。

参考资源

转载请注明:XueLong的博客 » 使用Jekyll + GitHub Pages搭建个人博客

打赏一个呗

取消

感谢您的支持,我会继续努力的!

扫码支持
扫码支持
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

最近的文章

欢迎来到我的博客

自留地^_^…

继续阅读