Jekyll 安装、使用方法与卸载

Jekyll 安装、使用与卸载方法

最近用Jekyll在Github上架网站,前后花了几天时间深入了解一下Jekyll,现在将Jekyll的安装、使用与卸载方法分享出来。

Jekyll 是一个简单的网站静态页面生成工具。由于是用Ruby语音编写的,所以在Windows系统上配置起来还是稍微有点繁琐的。主要步骤如下:

  1. 安装Ruby:windows系统上使用rubyinstaller,猛戳我下载。根据官网体系下载相关版本。
  2. 安装Ruby DevKit:在上面那个官网的下方有下载地址。
  3. 安装Jekyll

安装方法

从rubyinstalll下载安装包并安装到某个磁盘中,如E:\Ruby193,勾选上安装界面的所有选项(不要问我为什么);把下载的DevKit解压到某个目录,比如E:\devit

注意:安装DevKit时最好在安装目录新建一个文件夹devit然后,运行安装程序选定该文件夹

git bash 环境进入devit安装目录,运行如下命令

cd /E/devit
ruby dk.rb init

来生成一个config.yml配置文件,该配置文件包含了前面的Ruby的安装目录E:\Ruby193(系统会自动帮你寻找Ruby的安装目录,cat config.yml可以看到该文件里面已经写入了ruby目录的绝对路径)。

接下来运行ruby dk.rb install

最后运行命令gem install jekyll结束整个流程

检测是否安装成功jekyll -v

简要介绍

在谈使用方法前有必要简单介绍一下什么是Jeklly、以及Jeklly的工作原理。这些核心的概念能解决你的一些疑惑,帮助你更深入的理解,也为后面学习使用模板使用打基础,不至于在出现错误的时候漫天的debug

如果你只是想要简答了解或知道怎样使用jeklly,那么此部分可以跳过。

Jeklly是什么

Jekyll is a ruby gem you install on your local system. Once there you can call jekyll --server on a directory and provided that directory is setup in a way jekyll expects, it will do magic stuff like parse markdown/textile files, compute categories, tags, permalinks, and construct your pages from layout templates and partials.

Once parsed, Jekyll stores the result in a self-contained static _site folder. The intention here is that you can serve all contents in this folder statically from a plain static web-server.

Jeklly是一个静态站点生成器,它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能,所以实际上可以用来编写整个网站。

Jeklly是怎么工作的

安装完jeklly后你需要以jeklly可以识别的方式来组织你的目录。

它希望你使用下面的目录结构:

.
|-- _config.yml
|-- _includes
|-- _layouts
|   |-- default.html
|   |-- post.html
|-- _posts
|   |-- 2011-10-25-open-source-is-good.markdown
|   |-- 2011-04-26-hello-world.markdown
|-- _site
|-- index.html
|-- assets
    |-- css
        |-- style.css
    |-- javascripts
  • _config.yml

    配置文件数据

  • _includes

    This folder is for partial views.

  • _layouts

    这个目录主要包含模板,你可以为不同的页面(page)使用不同的模板。

  • _posts

    这个目录包含你的文章(post),且必须按照格式 @[email protected]来进行命名

  • _site

    这个目录将被用来存放Jekyll生成的静态网站。

  • assets

    这个目录不属于Jekyll的标准结构。它代表了任何你希望放置在根目录下的目录,并且被Jekyll忽略。

(read more: https://github.com/mojombo/jekyll/wiki/Usage)

Jekyll怎样生成最终的静态文件

  1. 收集数据。

    Jeklly扫描posts目录收集文章(post file)作为post对象。然后扫描layout、assets,最后在其他目录中搜索页面文件(pages file)。

  2. 计算数据。

    Jeklly从上面那些对象中提取元数据(连接、标签、分类、标题、数据)并构造出一个很大的site对象来容纳所有的文章、页面、布局和元数据。在这一步中,你的站点简单来说就是一个ruby对象。

  3. 溶解文章和模板。

    Jeklly遍历所有文章(post file)并将它们镶嵌到各自的布局中。溶解过程如下:Jeklly初始化一个Liquid模板,传递一个代表ruby站点对象的散列表和一个代表ruby文章对象的散列表,这两个散列表可以通过模板读取。

  4. 生成输出。

    Liquid模板通过有模板提供的语法得到渲染,最终生成一个静态的表达文件。

使用方法

以bootstrap模板为例子简要介绍如何快速搭建起一个站点。

下载 Jekyll-bootstrap的模板项目到本地目录jekyll

git clone https://github.com/plusjade/jekyll-bootstrap.git demo

cd jekyll进入目录,jekyll serve启动服务

打开浏览器,地址栏输入http://localhost:4000/可以看到如下主页面

编写新文章

通过命令生成新文章

[email protected] /E/Git/demo (master)
$ rake post title="My first blog"
Creating new post: ./_posts/2015-02-11-my-first-blog.md

在_posts目录中可以找到该文件,并用Markdown编辑内容。

也可以直接将编辑好的文章放置到_posts目录中,但一定要在编辑好的文章开头使用YAML Front Matter模板、文章和页面都需要提供YAML Front Matter,这样Jekyll才知道该如何处理你的文章。

在模板/文章/页面的开头需要提供如下格式的YAML Front Matter

---
layout: post
category : pages
tags : [how-to, jekyll]
---

... contents ...

编写新页面

通过命令生成新页面

[email protected] /E/Git/demo (master)
$ rake page name="about.md"
mkdir -p .
Creating new page: ./about.md

[email protected] /E/Git/demo (master)
$ rake page name="pages/about"
mkdir -p ./pages/about
Creating new page: ./pages/about/index.html

卸载Jekyll

安装配置Jekyll难,卸载却极其的简单。只需一句

gem unistall jekyll
时间: 2024-11-05 22:03:41

Jekyll 安装、使用方法与卸载的相关文章

CentOS x64上Matlab R2015b的镜像安装方法与卸载

CentOS x64上Matlab R2015b的镜像安装方法与卸载 0. 原料 (1). CentOS_x64系统 CentOS 2.6.32-573.el6.x86_64 (2). Matlab  R2015b_glnxa64.iso,可以从百度网盘下载到:链接: http://pan.baidu.com/s/1dD9F8RJ 密码: t8zi 1. CentOS/Linux 安装MATLAB (0). Matlab的安装说明readme.txt,全文摘抄如下(可略过). I offer t

linux下软件安装的方法

linux下软件的安装与卸载   第一章   linux下安装软件,如何知道软件安装位置 注:一般的软件的默认安装目录在/usr/local或者/opt里,可以到那里去找找. 指令名称:whereis 功能介绍:在特定目录中查找符合条件的文件.这些文件的烈性应属于原始代码,二进制文件,或是帮助文件. 语法格式:whereis [-bfmsu][-B <目录>...][-M <目录>...][-S <目录>...][文件...] 常用参数说明: -b 只查找二进制文件.

Windows 10安装pip方法

pip是一款非常方便的python包管理工具,本文主要介绍在windows 10下安装pip方法. 1. 下载pip 地址:https://pypi.python.org/pypi/pip#downloads 注意选择tar.gz压缩包,目前最新版本为9.0.1,这里选择的版本是:pip-9.0.1.tar.gz (md5, pgp) 2. 解压安装 解压下载的压缩包至工作目录下(如D:\),打开Windows cmd,运行如下命令进入解压后的pip目录 cd /d D:\pip-9.0.1 使

详解Linux(centos7)下安装OpenSSL安装图文方法

OpenSSL是一个开源的ssl技术,由于我需要使用php相关功能,需要获取https的文件所以必须安装这个东西了,下面我整理了两种关于OpenSSL安装配置方法. 安装环境:  操作系统:CentOs7安静 OpenSSL Version:openssl-1.0.2j.tar.gz 目前版本最新的SSL地址为http://www.openssl.org/source/openssl-1.0.2j.tar.gz 1.将下载的压缩包放在根目录, 2.在文件夹下解压缩,命令:tar -xzf ope

linux中几种安装软件 方法

http://blog.csdn.net/u010509774/article/details/50593231 一.rpm包安装方式步骤: 1.找到相应的软件包,比如soft.version.rpm,下载到本机某个目录: 2.打开一个终端,su -成root用户: 3.cd soft.version.rpm所在的目录: 4.输入rpm -ivh soft.version.rpm 详细介绍: 1. 安装: 我只需简单的一句话,就可以说完.执行: rpm –ivh rpm的软件包名 更高级的,请见

burpsuite1.6安装使用方法详解

Burp Suite 是用于渗透测试web 应用程序的集成平台.它包含了许多工具,并为这些工具设计了许多接口,以促进加快渗透应用程序的过程.所有的工具都共享一个能处理并显示HTTP 消息,持久性,认证,代理,日志,警报的一个强大的可扩展的框架.其安装使用方法如下: 第一步. 下载并安装JDK. 百度搜索关键字 "JDK下载" ,进入Oracle官网(Java原属于Sun公司,Sun公司于2009年4月20被Oracle甲骨文公司收购,所以现在Java属于Oracle公司了). 进入官网

安装SQL Server和卸载SQL Server步骤

2017年8月6号下午21:12分,今天是我10年博客计划的第三周!今天我完成了一件大事,我想多年以后,这件事一定会让我骄傲和自豪,具体我在这里不想说,截几张图给懂的人 今天我想分享关于SQL Server数据库的安装和卸载步骤,网上关于这一类的图解也是比较多的,在这里我仅根据我自己学习过程中遇到的问题进行分享,总之一句话,SQL Server数据库的卸载和安装同等重要,卸载不当,只能重装系统,这里以SQL Server 2014示例说明! SQL Server2014 安装篇  打开安装包中s

MySQL 5.7.18 zip版本的安装使用方法

MySQL 5.7.18 zip版本的安装使用方法 这个版本的MySQL不像那种点击就可以立即安装,一直下一步就OK的,这个需要自己进行配置,虽然有点小麻烦,我还是比较喜欢使用这个版本,因为比较单一,不会因为安装数据库,还要安装其他插件工具. 1.下载路径 官网MySQL zip文件下载地址:https://dev.mysql.com/downloads/mysql/ 点击 download 按钮,根据提示进行下载,不用登录账号:(下载文件到,如:D:\\) 2.将下载到D:\\下的 mysql

EasyOpenJTAG驱动无法正确安装解决方法(Win10)

在安装EasyOpenJTAG驱动无法正确安装解决方法: 开始菜单->设置->更新和安全->恢复->立即重启 静心等待后电脑会进入一个设置界面,在设置界面中选择: 疑难解答->高级选项->启动设置->重启 电脑重启后,出现选择界面,F7选择禁止验证驱动签名. 而后打开电脑的设备管理器,对"其余设备"的选项中的所有设备驱动进行更新驱动程序,选择"手动查找并安装驱动程序软件",选择搜索驱动程序软件的位置,然后下一步.