Jekyll


Устанока

Все довольно тривиально

Обновляем пакеты, устанавливаем


sudo apt-get update
sudo apt-get install ruby ruby-dev make gcc
sudo gem install jekyll bundler
...

avis@avis-PC:~/develop/doc$ jekyll --version
WARN: Unresolved specs during Gem::Specification.reset:
      rb-fsevent (>= 0.9.4, ~> 0.9)
      ffi (< 2, >= 0.5.0)
WARN: Clearing out unresolved specs.
Please report a bug if this causes problems.
jekyll 3.7.3

avis@avis-PC:~/develop/doc$ bundle --version
Bundler version 1.16.1

avis@avis-PC:~/develop/doc$ ruby --version
ruby 2.3.1p112 (2016-04-26) [x86_64-linux-gnu]

Баг 1


$ jekyll-server
/var/lib/gems/2.3.0/gems/bundler-2.0.1/lib/bundler/spec_set.rb:87:in `block in materialize':

sudo gem install public_suffix --version 3.0.1

Баг 2


$ jekyll
/var/lib/gems/2.3.0/gems/bundler-2.0.1/lib/bundler/spec_set.rb:87:in `block in materialize'

sudo bundle update

Проверяем


$ cd /tmp
$ jekyll new test
New jekyll site installed in /tmp/test.
avis@avis-PC:/tmp$ cd test/
vis@avis-PC:/tmp/test$ jekyll serve
...

В браузере заходим на http://localhost:4000/

Если при запуске jekyll serve -LR 4001 возникла ошибка типа:

/usr/lib/ruby/vendor_ruby/bundler/spec_set.rb:94:in `block in materialize':
    Could not find public_suffix-3.0.2 in any of the sources (Bundler::GemNotFound)
....

Нужно запускать bundle exec jekyll serve -LR 4001

И если в этом случае не запускается, последовать инструкции и установить доп. модули:

$ jekyll-server-bundle 
Could not find public_suffix-3.0.2 in any of the sources
Run `bundle install` to install missing gems.
avis@avis-PC:~/develop/doc$ bundle install
Warning: the running version of Bundler is older than the version that created the lockfile. We suggest you upgrade to the latest version of Bundler by running `gem install bundler`.
Fetching gem metadata from https://rubygems.org/......

gem install bundler