本地运行jekyll服务器

记录本地运行jekyll服务器操作步骤

Posted by WW on April 6, 2021

在ubuntu 20.0.4 上安装jekyll

48 个你需要知道的 Jekyll 使用技巧 CrispDev

安装ruby

jekyll文档

由于 ubuntu 20 上已经安装有ruby,因此只需要安装ruby-dev

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

配置用户路径

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

更换成 Ruby-China 的源

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

安装jekyll

gem install jekyll

gem install jekyll-paginate bundler

启动服务器

下载模板仓库

git clone https://github.com/qiubaiying/qiubaiying.github.io

在命令行输入

jekyll serve

jekyll s

就能在本地浏览器中输入http://127.0.0.1:4000/ 预览主题,对主题的修改也能实时展示(需要强刷浏览器)。

raw markdown

How to escape liquid template tags? - Stack Overflow 方法一

How to escape liquid template tags? - Stack Overflow方法二

注意以下代码在博客中显示才是正常的。 如果在markdown中查看,使用c例子即可。

使用以下代码a

{% raw %}
{% this %}
{% endraw %}

或者b


{{ "{% this " }}%}

生成结果c


{% this %}

页面异常修复

博客主页显示异常,看不到文章列表

Jekyll 本地调试博客遇到的问题及解决办法 - YEY 的博客 YEY Blog

首先是博客仓库根目录下的配置文件 _config.yml 缺少 jekyll-paginate 模块。

gem install jekyll-paginate

修改 _config.yml,增加

plugins: [jekyll-paginate]

html文件报错

Liquid Warning: Liquid syntax error (line 145): 
Unexpected character { in "tag[1].size > {{site.featured-condition-size}}" 
in /_layouts/post.html

_layout 文件夹里找到对应的html文件 将其中的双层花括号删除。

tag[1].size > {{site.featured-condition-size}}

修改为

tag[1].size > site.featured-condition-size