Настройка GitHub Pages + Jekyll

• Создаем репозиторий на GitHub. Можно пустой, или с Readme.md.
• Клонируем.

  $ git clone ...
  $ cd CLONED_REPOSITORY_DIR
  

• Устанавливаем Jekkyl. Инструкции для разных ОСей. Я ставил под Ubuntu.

  $ sudo apt-get install ruby-dev build-essential zlib1g-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
  $ gem install jekyll bundler
  

• Настраиваем Jekyll. Здесь более подробно.

  $ git checkout --orphan gh-pages
  $ jekyll new .
  

• Gemfile.

  $ cat Gemfile
  

  source "https://rubygems.org"
  gem "minima"
  gem "github-pages", group: :jekyll_plugins
  group :jekyll_plugins do
   gem "jekyll-feed", "~> 0.12"
  end
  

• _config.yml

  $ cat _config.yml
  

  title: Some notes
  baseurl: "/some-notes"
  url: "https://dvg4000.github.io" 
  github_username:  dvg4000
  theme: minima
  plugins:
     - jekyll-feed
  

• Применяем изменения.

  $ bundle update
  

• Запускаем локально, смотрим.

  $ bundle exec jekyll serve --host 0.0.0.0
  

  --host 0.0.0.0 на случай, если нельзя зайти на 127.0.0.1. Я тестирую на 192.168.10.10:4000/some-notes/.

• Коммитим и пушим.

  $ echo "Gimfile.lock" >> .gitignore
  $ git add .
  $ git commit 
  $ git push origin "$(git_current_branch)"