Jekyll中文文档__Installation

已于 2023-05-03 14:38:10 修改
阅读量310 收藏
点赞数
分类专栏： jekyll 文章标签： ruby
于 2023-04-01 14:33:18 首次发布
原文链接：https://jekyllrb.com/
版权

Jekyll是一个 Ruby Gem，可以安装在大多数系统上。

要求

  • Ruby 2.5.0或更高版本，包括所有开发需要的头文件 (通过使用 ruby -v 来检查您的Ruby版本)
  • RubyGems (通过使用 gem -v 来检查您的Gems版本)
  • GCC 和 Make (使用 gcc -v,g++ -v, 和 make -v 来检查版本号)

指南

有关详细的安装说明，请按照适用于您的操作系统的指南操作。

在Ubuntu中安装Jekyll

安装依赖项

安装 Ruby 和其它的必备组件：

sudo apt-get install ruby-full build-essential zlib1g-dev

避免以root用户身份安装RubyGems包（称为gems）。相反，为您的用户帐户设置一个gem安装目录。以下命令将向~/.bashrc文件中添加环境变量，以配置gem安装路径：

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

最后, 安装 Jekyll 和 Bundler:

gem install jekyll bundler

就是这样！您已经准备好开始使用Jekyll了。

在Windows上安装Jekyll

虽然Windows不是一个官方支持的平台，但经过适当的调整，它可以用来运行Jekyll。

安装 Ruby 和 Jekyll

通过 RubyInstaller 来安装

安装Ruby和Jekyll最简单的方法是使用 RubyInstaller for Windows。

RubyInstaller是一个独立的基于Windows的安装程序，包括Ruby语言、执行环境、重要文档等。

我们在这里只介绍RubyInstaller-2.4及更新版本。旧版本需要手动安装Devkit。

  1. 从RubyInstaller Downloads下载并安装Ruby+Devkit版本。使用默认选项进行安装。
  2. 在安装向导的最后阶段运行ridk install步骤。这是安装带有本机扩展的gem所必需的。您可以在RubyInstaller Documentation中找到有关此方面的其他信息。从选项中选择 MSYS2 and MINGW development tool chain。
  3. 从开始菜单中打开一个新的命令提示窗口，以便对PATH环境变量的更改生效。使用gem install jekyll bundler安装Jekyll和Bundler
  4. 检查Jekyll是否已正确安装： jekyll -v

注意：
在检查Jekyll是否未正确安装时，您可能会收到一个错误。重新启动系统并再次运行jekyll-v。如果错误仍然存在，请打开一个 RubyInstaller issue 。

就是这样！您已经准备好开始使用Jekyll了。

在Windows 10上通过Bash安装

如果您使用的是Windows 10的1607或更高版本，运行Jekyll的另一个选择是安装 Windows Subsystem for Linux。

注意：
您必须启用 Windows Subsystem for Linux 。

确保您的所有软件包和仓库都是最新的。打开一个新的命令提示符或PowerShell窗口，然后键入bash。

您的终端现在应该是一个Bash实例。接下来，更新您的仓库列表和包：

sudo apt-get update -y && sudo apt-get upgrade -y

接下来，安装Ruby。要做到这一点，让我们使用 BrightBox 的一个存储库，该存储库为Ubuntu托管Ruby的优化版本。

sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.5 ruby2.5-dev build-essential dh-autoreconf

接下来, 更新您的 Ruby gems:

gem update

安装 Jekyll：

gem install jekyll bundler

注意：
这里没有使用 sudo 。

检查您的 Jekyll 版本：

jekyll -v

就是这样！您已经准备好开始使用Jekyll了。

您可以通过检查_posts文件夹来确保时间管理器正常工作。您应该看到一个文件名中包含当前日期的markdown文件。

非超级用户帐户问题：
如果 jekyll new 命令打印这个错误信息 Your user account isn’t allowed to install to the system RubyGems ，请参阅疑难解答中的 以非超级用户身份运行Jekyll 这个说明。

注意：
Bash on Ubuntu on Windows 仍在开发中，因此您可能会遇到问题。

编码

如果您使用UTF-8编码，如果文件以表示BOM的字符开头，那么Jekyll将中断。因此，如果此字节序列出现在文件的开头，请将其删除。

此外，您可能需要将控制台窗口的代码页更改为UTF-8，以防在站点生成过程中出现 Liquid Exception: Incompatible character encoding 错误。运行以下操作：

chcp 65001

时区管理

由于 Windows 没有本地的 zoneinfo 数据源，Ruby解释器无法理解 IANA 时区。使用它们时，TZ环境变量默认为 UTC/GMT 00:00 。

尽管Windows用户或者可以通过设置相应的"键"，使用 POSIX 格式的定义时区来定义博客的时区，但在更改时钟以改变DST-rules时，这并是对用户友好的。

Jekyll现在使用 rubygem，根据已建立的 IANA Timezone Database 在内部配置时区。

虽然使用 Jekyll v3.4及更高版本创建的“新”博客，默认情况下会将以下内容添加到其 Gemfile 中，但现有网站必须更新其 Gemfle（和已安装的Gem）才能在 Windows 上进行开发：

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", ">= 1", "< 3"
  gem "tzinfo-data"
end

自动重新生成

当在 build 或 serve 期间指定了--watch开关时，Jekyll 使用 listen gem来监视更改。虽然 listen 内置了对 UNIX系统的支持，但它可能需要额外的 gem 才能与 Windows 兼容。

如果您仅在Windows上有自动重新生成问题，请将以下内容添加到您网站的 Gemfile 中：

gem 'wdm', '~> 0.1.1', :install_if => Gem.win_platform?

您必须使用 RubyInstaller 的 Ruby+Devkit 版本，并安装 MSYS2构建工具才能成功安装wdm gem。

在其它Linux上安装Jekyll

在其他 Linux发行版上安装与在 Ubuntu上安装类似。

安装必备组件

Fedora

sudo dnf install ruby ruby-devel openssl-devel redhat-rpm-config @development-tools

RHEL8/CentOS8

sudo dnf install ruby ruby-devel
sudo dnf group install "Development Tools"

Debian

sudo apt-get install ruby-full build-essential

Gentoo

sudo emerge -av jekyll

或者

sudo emerge --ask --verbose jekyll

ArchLinux

sudo pacman -S ruby base-devel

OpenSUSE

sudo zypper install -t pattern devel_ruby devel_C_C++
sudo zypper install ruby-devel

Clear Linux

sudo swupd bundle-add ruby-basic

安装Jekyll

参考 Ubuntu。

在macOS上安装Jekyll

支持的 macOS 版本

  • Monterey (macOS 12)
  • Big Sur (macOS 11)
  • Catalina (macOS 10.15)

较旧的 macOS 版本可能有效，但我们不对它们做官方支持。

安装 Ruby

要在macOS上安装Jekyll，您需要一个合适的Ruby开发环境。虽然macOS预装了Ruby，但我们不建议使用该版本来安装Jekyll。这篇外部文章介绍了 why you shouldn’t use the system Ruby 的各种原因。

相反，您需要使用版本管理器（如 asdf, chruby, rbenv, 或 rvm ）来安装一个单独的、更新的Ruby版本。版本管理器允许您轻松地安装多个版本的Ruby，并在它们之间切换。

我们建议使用 chruby ，因为这是最简单、最不可能引起问题的方法。

下面的说明摘录自 install Ruby on Mac 这本详细外部指南。如果你是第一次在Mac上设置开发工具，它们的效果最好。如果您已经尝试在Mac上安装Ruby或Jekyll，或者遇到任何问题，请阅读该指南。

步骤1：安装 Homebrew

Homebrew 使得在Mac上安装开发工具变得很容易。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤2： 用 ruby-install 来安装 chruby 和最新得 Ruby

用 Homebrew 来安装 chruby 和 ruby-install :

brew install chruby ruby-install xz

安装Ruby的最新稳定版本（由Jekyll支持）：

ruby-install ruby {{ site.data.ruby.current_version }}

这将需要几分钟的时间，完成后，将您的 shell 配置为自动使用chruby：

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
echo "chruby ruby-{{ site.data.ruby.current_version }}" >> ~/.zshrc # run 'chruby' to see actual version

如果您正在使用 Bash，请将..zshrc 替换为 .bash_profile。如果您不确定，请阅读这本外部指南，find out which shell you’re using。

退出并重新启动终端，然后检查是否一切正常：

ruby -v

它应该显示 ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) 或更新的版本。

接下来，阅读相同的外部指南，了解有关 setting and switching between Ruby versions with chruby 的重要注意事项。

安装 Jekyll

在用 chruby 安装 Ruby 之后，安装最新的Jekyll gem：

gem install jekyll

疑难解答

参阅 疑难解答 或者 在我们的论坛上寻求帮助 。

汉瑜
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
jekyll_blog_demo:Jekyll博客演示项目
05-28
**Jekyll博客演示项目详解** Jekyll是一款静态网站生成器，尤其适合个人博客的搭建。它基于Ruby语言，能够将Markdown格式的内容转换成静态HTML页面，这样不仅减轻了服务器负担，也使得博客的维护变得更加简单。...
jekyll_frontmatter_tests：一个Jekyll插件，用于测试Jekyll站点中帖子和其他文档的前题
02-04
可以在Jekyll网站上添加测试的工具，以确保您始终在帖子或其他收集文档中包括必填字段。 建立 现在，在jekyll站点的根目录的deploy/tests/schema中创建一个目录。 该命令应该可以解决问题： mkdir -p deploy/tests/...
jekyll安装
最新发布
m0_59183852的博客
03-22 931
gem安装jekyll以下都是终端命令。
Jekyll 教程——安装
老梁的专栏
09-21 1355
Jekyll 是一个静态网站生成器（static site generator），它是推荐的建站工具，支持 Markdown 和 HTML 两种文件类型，其中 HTML 使用了Liquid模板语言。所谓模板语言，是一种文本处理工具，它可以让我们更高效地生成 HTML 文件，Spring 框架的thymeleaf、Django 自有的 template language 等等，都属于此类，它们的语法大同小异，用法相差无几，Jekyll 之所以使用 Liquid，估计是因为它们都由 Ruby 写成。
使用 Jekyll 构建你的网站 - 初入门
Flora's Zone
12-25 2343
Jekyll 是一个开源的静态网站生成器。你可以使用 Markdown 编写内容，使用 HTML/CSS 来构建和展示，Jekyll 会将其编译为静态的 HTML。
使用Jekyll + GitHub Pages搭建个人博客
zzy979481894的博客
09-04 1944
本文将介绍如何使用Jekyll搭建个人博客，并部署在GitHub Pages上。
Jekyll（一）.使用Jekyll+Github Pages搭建自己的博客
qq_36816662的博客
12-24 1542
Jekyll 是一个静态站点生成器，内置 GitHub Pages 支持和简化的构建过程。Jekyll 使用 Markdown 和 HTML 文件，并根据您选择的布局创建完整静态网站。Jekyll 支持 Markdown 和 Lick，这是一种可在网站上加载动态内容的模板语言。所以在Github Pages上使用Jekyll很合适，其他有关介绍请参考，以及，，本篇部分内容参考了以上文档。在Linux，MacOS上使用Jekyll，安装过程较为简单，下面为。
jekyll_blog_source:jekyll配置源代码
03-23
**Jekyll博客源码解析** Jekyll是一款静态网站生成器，尤其适合个人博客的搭建。它基于Ruby语言，能够将Markdown、Textile等格式的文本转换成静态HTML页面，简化了博客的创建与维护过程。在"jekyll_blog_source:...
jekyll-pdf_generator:在Jekyll中生成PDF的宝石
03-31
Jekyll :: PdfGenerator 欢迎使用您的新宝石！ 在此目录中，您将找到能够将Ruby库打包为gem所需的文件。 将您的Ruby代码放在文件lib/jekyll/pdf_generator 。 要试验该代码，请运行bin/console进行交互式提示。 待...
jekyll_one_publish：预览发布到多个托管提供商的网站
02-17
**Jekyll_one_publish：预览与多平台托管的利器** Jekyll_one_publish 是一个基于 Ruby 的工具，专门设计用于帮助用户方便地预览并发布他们的 Jekyll 网站到多个不同的托管服务提供商。Jekyll，一个静态站点生成器...
Github+Jekyll —— 创建个人免费博客（二）Ruby+Jekyll部署
linshuhe1的专栏
04-13 4777
摘要：         本文中我将介绍一下如何在github上搭建个人Blog（博客），也顺便让我们掌握一下github Pages功能，另外还涉及到Jekyll技术。 ===============================分割线==================================== 一、环境部署： 1.资源下载： 我们之
实例讲解如何使用Jekyll搭建一个静态网站
WPHunter的编程技术资料库！
01-22 1108
在这篇文章中，我们将向你介绍流行的SSG之一–Jekyll，了解它是如何工作的，以及你如何用它创建一个静态网站。
windows环境搭建Jekyll本地服务器环境及Jekyll建站指南
芸兮的博客
08-12 732
Jekyll基于Ruby语言编写，需配置Ruby环境，参考：在Windows上安装Jekyll参考B站这个Up模板站链接
gem 安装jekyll 问题
小小的博客
11-19 2834
使用命令：gem install jekyllgem install jekyll ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why: Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0
Using Jekyll with Bundler
易得者易失
04-02 266
Jekyll中文文档，如何在Jekyll中使用Bundler
如何使用Jekyll在GitHub Pages上搭建网站（个人博客）
ZhongUncle的博客
11-19 3433
Jekyll 是一个基于 Ruby 语言的，用于搭建静态网站的生成器，主要用于搭建博客网站（官方自己的介绍为：Jekyll is a blog-aware, static site generator in Ruby）。但是虽然是静态网站，但是可以实现一些使用数据库的动态网站的效果和功能，是很不错的一个框架。。虽然 Jekyll 官网提供了教学，GitHub 也提供了教学，但是二者需要交叉起来看，所以这个框架还是有点简单并且复杂的。并且有一些细节没有提到。因此，写此文来记录一下。
【极客blog图文讲解】ruby以及Jekyll的环境配置（针对mac linux）
Garvin的专栏
12-06 5074
（转载请注明出处：http://blog.csdn.net/buptgshengod） 一.背景        你还在为想建立个人网站而没有免费稳定空间而苦恼么？这里将图文并茂讲解最geek的个人主页搭建方法-gitpage的实现。我们通过一个与git相连的博客工具Jekyll实现个人主页的搭建，Jekyll是由ruby语言编写。ruby语言是一种简单的绝对面向对象语言，有日本人发明。 二.
Windows上安装Jekyll
曼巴童鞋-博客
09-13 2408
jekyll是一个简单的免费的Blog生成工具,是一个静态站点生成器,它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能,所以实际上可以用来编写整个网站。本篇将介绍如何在Windows下安装jekyll。
macOS Monterey安装Jekyll
老码农重操旧事业
12-06 705
macOS版本Monterey。先看官方教程https://jekyllrb.com/docs/installation/macos/，结果执行到以下这一步时报错。 错误日志如下： 直接访问可以访问，Google、百度搜了半天没有找到相关解决方案。无奈去了Ruby官网 https://www.ruby-lang.org/en/documentation/installation/#homebrew 找到官方教程。 貌似一下装成功了。 用看了一下还是。按照提示执行以下下命令，切换到最新版本。 再命令，输入，对
jekyll serve
02-15
Jekyll是一个静态网站生成器，它可以将纯文本文件转换为静态网站。jekyll serve是Jekyll提供的一个命令，用于在本地启动一个开发服务器，以便预览和调试生成的静态网站。 当你在终端中运行jekyll serve命令时，Jekyll会读取你的项目文件夹中的配置文件（_config.yml），并根据配置文件的设置来生成静态网站。然后，它会在本地启动一个服务器，并将生成的网站文件提供给你进行预览。 通过jekyll serve命令启动的开发服务器会监听本地的某个端口（默认为4000），你可以在浏览器中访问http://localhost:4000来查看生成的静态网站。当你对项目文件进行修改时，Jekyll会自动重新生成网站，并刷新浏览器中的预览。 总结一下，jekyll serve命令是用于启动一个本地开发服务器，方便你在本地预览和调试生成的静态网站。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值