Windows 上安装 Jekyll

Jekyll是一个静态网站生成工具。它允许用户使用HTML、Markdown或Textile来建立静态页面，然后通过模板引擎Liquid（Liquid Templating Engine）来运行.

原文链接：Setup Jekyll on Windows

目前，网上有许多Jekyll的安装方法，大都相似，为了方便更多准备学习Jekyll的人，特翻译如下：

共分为以下几个重要步骤

  • 安装 Ruby
  • 安装 DevKit
  • 安装 Jekyll
  • 安装 Pygments
    • 安装 Python
    • 安装 ‘Easy Install’
    • 安装 Pygments
  • 启动 Jekyll
  • 故障诊断

安装 Ruby

  1. 前往 http://rubyinstaller.org/downloads/
  2. 在 “RubyInstallers” 部分，选择某个版本点击下载。
    例如， Ruby 2.0.0-p451 (x64) 是适于64位 Windows 机器上的 Ruby 2.0.0 x64 安装包。
  3. 通过安装包安装
    • 最好保持默认的路径 C:\Ruby200-x64， 因为安装包明确提出 “请不要使用带有空格的文件夹 (如： Program Files)”。
    • 勾选 “Add Ruby executables to your PATH”，这样执行程序会被自动添加至 PATH 而避免不必要的头疼。

  4. 打开一个命令提示行并输入以下命令来检测 Ruby 是否成功安装。

    ruby -v

    输出示例：

    ruby 2.0.0p451 (2014-02-24) [x64-mingw32]

安装 DevKit

DevKit 是一个在 Windows 上帮助简化安装及使用 Ruby C/C++ 扩展如 RDiscount 和 RedCloth 的工具箱。 详细的安装指南可以在程序的wiki 页面 阅读。

  1. 再次前往 http://rubyinstaller.org/downloads/
  2. 下载同系统及 Ruby 版本相对应的 DevKit 安装包。 例如，DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe 适用于64位 Windows 系统上的 Ruby 2.0.0 x64。

    下面列出了如何选择正确的 DevKit 版本：

    Ruby 1.8.6 to 1.9.3: DevKit tdm-32-4.5.2
    Ruby 2.0.0: DevKit mingw64-32-4.7.2
    Ruby 2.0.0 x64: DevKit mingw64-64-4.7.2

  3. 运行安装包并解压缩至某文件夹，如 C:\DevKit
  4. 通过初始化来创建 config.yml 文件。在命令行窗口内，输入下列命令：

    cd “C:\DevKit”
    ruby dk.rb init
    notepad config.yml

  5. 在打开的记事本窗口中，于末尾添加新的一行 - C:\Ruby200-x64，保存文件并退出。
  6. 回到命令行窗口内，审查（非必须）并安装。

    ruby dk.rb review
    ruby dk.rb install

安装 Jekyll

  1. 确保 gem 已经正确安装

    gem -v

    输出示例：

    2.0.14

  2. 安装 Jekyll gem

    gem install jekyll

安装 Pygments

Jekyll 里默认的语法高亮插件是 Pygments。 它需要安装 Python 并在网站的配置文件_config.yml 里将highlighter 的值设置为pygments。

不久之前，Jekyll 还添加另一个高亮引擎名为 Rouge， 尽管暂时不如 Pygments 支持那么多的语言，但它是原生 Ruby 程序，而不需要使用 Python。 更多信息请点此关注。

安装 Python

  1. 前往 http://www.python.org/download/
  2. 下载合适的 Python windows 安装包，如 Python 2.7.6 Windows Installer。 请注意，Python 2 可能会更合适，因为暂时 Python 3 可能不会正常工作。
  3. 安装
  4. 添加安装路径 (如： C:\Python27) 至 PATH。(如何操作? 请参见 故障诊断 #1)
  5. 检验 Python 安装是否成功

    python –V

    输出示例：

    Python 2.7.6

安装 ‘Easy Install’

  1. 浏览 https://pypi.python.org/pypi/setuptools#installation-instructions 来查看详细的安装指南。
  2. 对于 Windows 7 的机器，下载 ez_setup.py 并保存，例如，至C:\。 然后从命令行使用 Python 运行此文件：

    python “C:\ez_setup.py”

  3. 添加 ‘Python Scripts’ 路径 (如： C:\Python27\Scripts) 至 PATH

安装 Pygments

  1. 确保 easy_install 已经正确安装

    easy_install --version

    输出示例：

    setuptools 3.1

  2. 使用 “easy_install” 来安装 Pygments

    easy_install Pygments

启动 Jekyll

按照官方的 Jekyll 快速开始手册 的步骤， 一个新的 Jekyll 博客可以被建立并在localhost:4000浏览。

jekyll new myblog
cd myblog
jekyll serve

故障诊断

  1. 错误信息：

    “python” is not recognized as an internal or external command, operable program or batch file.

    其他情况： 这里的 “python” 也可能是 “ruby”， “gem” 或是 “easy_install” 等。

    可能原因： 该程序可能未被正确地安装或未在 PATH 里设置成功。

    尝试解法： 确保程序已被正确安装。然后手动将其添加至 PATH，请参考如下步骤[1]。

    1. 按住 Win 键再按下 Pause
    2. 点击 Advanced System Settings
    3. 点击 Environment Variables
    4. 将 ;C:\python27 添加至 Path 变量的末尾
    5. 重启命令行
  2. 错误信息： 
    ERROR:  Error installing jekyll:
ERROR: Failed to build gem native extension.

"C:/Program Files/Ruby/Ruby200-x64/bin/ruby.exe" extconf.rb

creating Makefile
make generating stemmer-x64-mingw32.def
compiling porter.c
...
make install
/usr/bin/install -c -m 0755 stemmer.so C:/Program Files/Ruby/Ruby200-x64/lib/ruby/gems/2.0.0/gems/fast-stemmer-1.0.2/li
/usr/bin/install: target `Files/Ruby/Ruby200-x64/lib/ruby/gems/2.0.0/gems/fast-stemmer-1.0.2/lib‘ is not a directory
make: *** [install-so] Error 1

    可能原因： Ruby 被安装在含有空格的路径里。

    尝试解法： 重新安装 Ruby，这次请不要使用带有空格的路径，或者请直接选择使用默认路径。

  3. 错误信息： 
    Generating... Liquid Exception: No such file or directory - python c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/pygments.rb-0.4.2/lib/pygments/mentos.py in 2013-04-22-yizeng-hello-world.md

    可能原因： Pygments 未能被正确安装或是 PATH 设置尚未生效。

    尝试解法： 首先请确保 Pygments 已成功安装且 Python 的 PATH 设置正确未包含空格和最后多余的斜杠。 然后重启命令行。如果依旧失败，请尝试注销并重新登录 Windows。 甚至使用终极解法，重启电脑。

  4. 错误信息： 
    Generating... Liquid Exception: No such file or directory - /bin/sh in _posts/2013-04-22-yizeng-hello-world.md

    可能原因： 与 pygments.rb 0.5.1/0.5.2 版本的兼容性问题。

    尝试解法： 将 pygments.rb gem 的版本从 0.5.1/0.5.2 降至 0.5.0。

    gem uninstall pygments.rb –version ‘=0.5.2’
    gem install pygments.rb –version 0.5.0

  5. 错误信息： 
    c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/dependency.rb:296:in `to_specs‘: Could not find ‘pygments.rb‘ (~> 0.4.2) - did find: [pygments.rb-0.5.0] (Gem::LoadError)
from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1196:in `block in activate_dependencies‘
from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1185:in `each‘
from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1185:in `activate_dependencies‘
from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1167:in `activate‘
from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/core_ext/kernel_gem.rb:48:in`gem‘
from c:/Ruby200-x64/bin/jekyll:22:in `<main>‘`

    可能原因：如错误信息所述，找不到 pygments.rb 0.4.2，仅找到 pygments.rb 0.5.0。 （此问题出现于此文初稿时的 Jekyll 版本，现版本应已修复）

    尝试解法： 将 pygments.rb gem 的版本降级至 0.4.2

    gem uninstall pygments.rb –version “=0.5.0”
    gem install pygments.rb –version “=0.4.2”

  6. 错误信息： 
    Generating... You are missing a library required for Markdown. Please run:
$ [sudo] gem install rdiscount
Conversion error: There was an error converting ‘_posts/2013-04-22-yizeng-hello-world.md/#excerpt‘.

ERROR: YOUR SITE COULD NOT BE BUILT:
   ------------------------------------
   Missing dependency: rdiscount

    可能原因： 依赖包 rdiscount 未找到。 此问题最有可能的原因是，网站使用的是 rdiscount 作为 Markdown 引擎，而不是 Jekyll 默认的引擎，故需要手动自行安装。

    尝试解法：

    gem install rdiscount

  7. 错误信息： 
    c:/Ruby200-x64/lib/ruby/site_ruby/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require‘: cannot load such file -- wdm (LoadError)
from c:/Ruby200-x64/lib/ruby/site_ruby/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require‘
from c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/listen-1.3.1/lib/listen/adapter.rb:207:in `load_dependent_adapter‘
from c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/listen-1.3.1/lib/listen/adapters/windows.rb:33:in `load_dependent_a
dapter‘
...

    可能原因： wdm gem 未被安装。因为 Jekyll 只官方地支持 *nix 系统，所以 Windows Directory Monitor 并没有作为依赖包而被自动安装。

    尝试解法：

    gem install wdm

8.为了能够让这里网站正常运行，这里需要删除_post文件夹里的文件（应该有一个xxxx-xx-xx-welcome-to- jekyll.markdown字样的文件），因为这个文件内部使用了语法高亮插件（另外不删，则可以修改配置文件禁用该语法高亮插件，即修改根目录下 _config.yml中的pygments: true为false便可。），这个需要另外安装，不再本文范围内，不删会导致生成的静态页面有问题，因时间有限本文暂不提此问题。

时间： 2024-02-20 07:10:57

Windows 上安装 Jekyll的相关文章

Windows上安装Jekyll

Run Jekyll on Windows 目录 Jekyll介绍 安装Ruby 安装DevKit 安装Jekyll 安装Python 安装pip 运行Jekyll Introduction Jekyll jekyll是一个简单的免费的Blog生成工具,是一个静态站点生成器,它会根据网页源码生成静态文件. 它提供了模板.变量.插件等功能,所以实际上可以用来编写整个网站. 我们可以使用jekyll bootstrap来搭建一个静态博客网站,本篇先介绍如何在Windows下安装jekyll 安装je

在 Windows 系统上安装 Jekyll

目录 安装 Ruby 环境 用 Bundler 安装 Jekyll 本文是写给完全未用过 Ruby 乃至命令行工具者的.对于一般的开发者,Jekyll 官方文档的相关内容已然足够. 本文为钱院学辅技术小组公开课专门编写. Jekyll 是由 Ruby 语言开发而成的网站搭建工具,其可完成由 Markdown 代码仓库(及若干自定义的 CSS/Sass 样式表.HTML 模板等)生成网站的流程.GitHub Pages 服务即内置了一套附有若干插件的 Jekyll 工具,用于直接在代码仓库的基础上

在Windows上安装虚拟机详细图文教程

用虚拟机来安装最新的软件,安装最新的系统等等比较保险,可以避免安装不顺利影响自己原来的系统和应用,想尝鲜又担心自己完全更换系统不适应的朋友可以尝试. 虚拟机下载:https://yunpan.cn/cqdKMyu9AWjsw  访问密码 7be7 在Windows上安装虚拟机. 选择自己的路径: 在桌面创建一个图标: 启动虚拟机,新建虚拟机,并进行各种硬件定制.

在 Windows 上安装 Hadoop 教程（转）

在 Windows 上安装 Hadoop 教程 一见 2010.1.6 www.hadoopor.com/[email protected] 1. 安装 JDK 不建议只安装 JRE,而是建议直接安装 JDK,因为安装 JDK 时,可以同时安装 JRE. MapReduce 程序的编写和 Hadoop 的编译都依赖于 JDK,光 JRE 是不够的. JRE 下载地址:http://www.java.com/zh_CN/download/manual.jsp JDK 下载地址:http://jav

windows上安装db2 spatial extender和ArcSDE的问题

因客户的DB2版本是9.7的版本,所以测试环境也只能安装这个版本,但在ArcSDE的最小支持版本里至少需要V9.7 pack 4的版本,低于这个版本是不行的. 安装DB2和spatial extender 安装好DB2后创建空间数据库(假如名字叫mysdedb),这里最好能优化一下以下的配置: 1.注意创建数据库时的字符编码. 2.最好创建自己的缓存池(使用16或者32k的pagesize). create bufferpool sdepool size 12800 pagesize 32K c

在Windows上安装MongoDB

原文官方文档:https://docs.mongodb.org/v2.6/tutorial/install-mongodb-on-windows/ 基于版本:MongoDB 2.6 概览 通过这个示例在Windows上安装MongoDB. 平台支持: 从2.2版本开始,MongoDB不支持Windows XP了,请使用最新版本的Windows使用较新的MongoDB的版本. 重要: 如果你使用的Windows Server 2008 R2的edition版本或者是Windows 7,请安装a h

在Windows上安装Nexus 3.2.0-01

在Windows上安装Nexus 环境: Windows 7 apache-maven-3.3.9 JDK 1.8 下载Nexus: https://sonatype-download.global.ssl.fastly.net/nexus/3/nexus-3.2.0-01-win64.zip 解压后看可以到nexus-3.2.0-01和sonatype-work两个文件夹: 配置到系统环境Path:\Path\to\nexus 运行: Path\to\nexus\nexus-3.2.0-01\

在Windows上安装PyCUDA和Theano

最近几个月在学习Deep Learning,刚开始的时候什么条件都不具备.自己从淘宝上面买了一个GT 240,搭建一个GPU环境用于程序的调试.折腾了几个月,以前PyCUDA总是搭建失败,最近几天才尝试成功.为了学习Deep Learning的源代码,自己又搭建了Theano环境.由于时间紧张,自己概略总结如下,以备忘记. 一. 在Windows上安装PyCUDA 1. 安装条件 (1) pytools库 安装PyCUDA还需要pytools库,而pytools库又需要six,appdirs,d

在windows上安装和简单配置VirtualBox

VirtualBox是一款开源且免费虚拟机软件,其简单易用且性能优异.最重要的是VirtualBox有不同操作系统版本,但是其导出的虚拟机都是通用的. 适用系统:windwos7_64bit & windows8_64bit 下面由小河给大家介绍:在Windows上安装和简单配置VirtualBox4.3.14. 1.下载VirtualBox. (1)百度搜索"virtualbox",出现VirtualBox官方网站和百度软件中心,两者都可下载到该软件. (2)以"百