拓展阅读

前言

由于个人一直喜欢使用 markdown 来写个人博客，最近就整理了一下有哪些博客引擎。

感兴趣的小伙伴也可以选择自己合适的。

jekyll 搭建教程

jekyll 搭建教程

Gem

安装 Ruby，请访问下载地址。

Jekyll

Jekyll 是一个简单且具备博客特性的静态网站生成器。

使用以下命令安装 Jekyll。

$ gem install jekyll

在中国可能需要使用代理软件。然后，请等待并学习如何使用它。

或者，您可以使用 rails 替代 Jekyll。

如果您使用的是 Mac，请使用以下命令。

$ sudo gem install jekyll

您需要了解如何使用 Git。

Git 文档

在 Windows 下安装 Jekyll

有时候工作需要，在 Windows 系统下编辑博客，想要看到效果却十分麻烦。因此尝试在 Windows 下安装 Jekyll。

安装 Ruby

下载

下载适合你计算机的合适版本的安装程序；
安装

安装时勾选上 Add Ruby executables to your PATH;

查看版本

在命令行中输入如下命令：

$ ruby -v
ruby 2.3.3p222 (2016-11-21 revision 56859) [x64-mingw32]

安装 DevKit

下载

下载适合你计算机的合适版本的安装程序；

选择匹配的软件。本次选择 DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe, For use with Ruby 2.0 to 2.3 (x64 - 64bits only)
解压

下载并解压文件至路径如D:\Devkit下：

运行

$   cd d:\Devkit

[D:\Devkit]$ ruby dk.rb init
[INFO] found RubyInstaller v2.3.3 at D:/Ruby23-x64

Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit.

查看 config.yml 应该有如下内容

# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#
---
- D:/Ruby23-x64

查看和安装

[D:\Devkit]$ ruby dk.rb review
Based upon the settings in the 'config.yml' file generated
from running 'ruby dk.rb init' and any of your customizations,
DevKit functionality will be injected into the following Rubies
when you run 'ruby dk.rb install'.

D:/Ruby23-x64

[D:\Devkit]$ ruby dk.rb install
[INFO] Updating convenience notice gem override for 'D:/Ruby23-x64'
[INFO] Installing 'D:/Ruby23-x64/lib/ruby/site_ruby/devkit.rb'

安装 Jekyll

确保 gem 已安装
```
[D:\Devkit]$ gem -v
2.5.2
```
安装 Jekyll
```
$ gem install jekyll
```

问题

错误：Permission denied - bind(2) for 127.0.0.1:4000

bind localhost:4000 failed

使用如下命令：
```
$ netstat -ano
$ tasklist /svc /FI "PID eq ${pid}"
```
pid 是占用 localhost:4000 的线程的结果；使用任务管理器结束该线程；
请在 Gemfile 中添加以下内容以避免轮询更改：
```
gem 'wdm', '>= 0.1.0' if Gem.win_platform?
```
gem ‘wdm’, ‘>= 0.1.0’ if Gem.win_platform?

我尝试了很多次，但仍然失败。幸运的是，Jekyll 仍然可以正常工作
jekyll-paginate

配置文件: /Users/houbinbin/blog/houbb.github.io/_config.yml
  依赖错误: 哎呀！看起来你没有安装 jekyll-paginate 或者它的某个依赖项。为了按照当前配置使用 Jekyll，你需要安装这个 gem。来自 Ruby 的完整错误信息是: 'cannot load such file -- jekyll-paginate' 如果遇到问题，你可以在 http://jekyllrb.com/help/ 找到有用的资源！
jekyll 3.1.3 | 错误:  jekyll-paginate

解决方法：

$ sudo gem install jekyll-paginate

谷歌文件加载慢

fonts.googleapis.com加载慢解决办法

我是直接将semantic引用此文件的地方注释掉了。

TOC 目录

TOC

把这个添加到文件中，就可以生成目录。

* any list
{:toc}

分页

base page zh_CN

最多页数限制

分页功能插件使得 paginator liquid 对象具有下列属性：

属性	说明
page	当前页码
per_page	每页文章数量
posts	当前页的文章列表
total_posts	总文章数
total_pages	总页数
previous_page	上一页页码或 nil（如果上一页不存在）
previous_page_path	上一页路径或 nil（如果上一页不存在）
next_page	下一页页码或 nil（如果下一页不存在）
next_page_path	下一页路径或 nil（如果下一页不存在）

Search

nice query

SEO

掌心 SEO

Rang SEO

优化 jekyll 站点的 SEO 技巧

博客写好之后，直接搜索基本搜索不到。

双边括号

特殊符号，比如使用 vue 学习的时候，就会用到双边花括号，但是这个是 jekyll 的内置符号。

解决方案如下：

{% comment %} 这里是各种包含奇怪花括号 {{{0}}} 的地方 {% endcomment %}

TODO

文章置顶

has done!

多说

sitemap

报错

$ gem install jekyll-sitemap
ERROR:  Could not find a valid gem 'Jekyll-sitemap' (>= 0), here is why:
          Unable to download data from https://gems.ruby-china.org/ - bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)

解决

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

日志

https://gems.ruby-china.com/ added to sources
source https://rubygems.org/ not present in cache

重新执行

sudo gem install jekyll-sitemap

日志

Fetching: jekyll-sitemap-1.2.0.gem (100%)
Successfully installed jekyll-sitemap-1.2.0
Parsing documentation for jekyll-sitemap-1.2.0
Installing ri documentation for jekyll-sitemap-1.2.0
Done installing documentation for jekyll-sitemap after 0 seconds
WARNING:  Unable to pull data from 'https://gems.ruby-china.org/': bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)
1 gem installed

参考资料

http://vdaubry.github.io/2014/10/21/SEO-for-your-Jekyll-blog/

https://crispgm.com/page/48-tips-for-jekyll-you-should-know.html

Jekyll自动生成站点地图

如何让谷歌和百度搜索到自己GitHub上的博客

Jekyll SEO Tag

https://github.com/jekyll/jekyll-seo-tag

sitemap

http://faso.me/notes/2013/07/27/jekyll-sitemap-without-plugin/index.html

ruby

https://www.jianshu.com/p/60f3707cb3ce?utm_campaign=maleskine&utm_content=note&utm_medium=seo_notes&utm_source=recommendation

GitHub 博客– Jekyll–代码高亮，Liquid 转义字符

Jekyll 中文文档

极客学院中文文档

拓展阅读
前言
jekyll 搭建教程
Gem
Jekyll
在 Windows 下安装 Jekyll
问题
TOC 目录
分页
Search
SEO
双边括号
TODO
sitemap
参考资料

blog-engine-01-通过博客引擎 jekyll 构建 github pages 博客实战笔记

拓展阅读

前言

jekyll 搭建教程

Gem

Jekyll

在 Windows 下安装 Jekyll

安装 Ruby

安装 DevKit

安装 Jekyll

问题

TOC 目录

分页

Search

SEO

双边括号

TODO

sitemap

参考资料

更多学习