Работа с Jekyll на Linux

 Jekyll - это простой статический генератор сайтов, который ориентирован на блоги, но может использоваться для любых сайтов. Для создания статического веб-сайта, который готов к развертыванию на вашем любимом веб-сервере, требуются HTML-шаблоны и сообщения, написанные в Markdown . Кроме того, вы можете разместить его на GitHub и опубликовать на страницах GitHub , абсолютно бесплатно.

Веб-сайт Jekyll находится по адресу http://jekyllrb.com/ , а документацию можно найти по адресу http://jekyllrb.com/docs/home/ .

 

   Debian 9+, Ubuntu 18.04+ и Mint 19+

Установите jekyll на Linux Mint 19

$ sudo apt install ruby
$ sudo apt install build-essential
$ sudo apt install ruby-dev
$ sudo gem install jekyll

Быстрый запуск для Jekyll

 $ gem install jekyll
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site 
 $ jekyll serve

Теперь перейдите к http: // localhost: 4000

Быстрый запуск для Jekyll с Bundler

 $ gem install jekyll bundler
 $ jekyll new my-awesome-site
 $ cd my-awesome-site
~/my-awesome-site 
 $ bundle exec jekyll serve

Теперь перейдите к http: // localhost: 4000

Установка Jekyll в Windows

1. Откройте командную строку с доступом администратора
2. Установите Chocolatey:
 @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
3. Закройте командную строку, так как Chocolatey будет недоступен до закрытия и повторного открытия.
4. Откройте командную строку с доступом администратора
5. Intall Ruby:
 choco install ruby -y
6. Закройте и откройте новую командную строку с доступом администратора
7. Установите Jekyll:
 gem install jekyll

   Fedora 28+, CentOS / RHEL 8+

Установка

 $ sudo dnf install ruby-devel
 $ gem install jekyll

 Использование

 $ jekyll new my-site 
 $ cd my-site 
 $ jekyll serve

Затем перейдите в браузере по адресу http: // localhost: 4000 и увидите страницу.

   OpenSUSE 15+

Для openSUSE Leap 15.1 нет официального пакета

Смотрите следующие шаги, чтобы получить работающие rbenv и jekyll.

Установите необходимые зависимости (например, nokogiri):
Замените версию libgdbm4 любой версией, которую предоставляет ваш выпуск.
 $ sudo zypper in autoconf libopenssl-devel libyaml-devel readline-devel libxslt-devel ncurses-devel libffi-devel zlib-devel gdbm-devel libgdbm4
Клонируйте rbenv в вашу домашнюю папку: ~/.rbenv
 $ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
Добавьте ~/.rbenv/bin к вашему $PATH чтобы вы могли использовать утилиту командной строки rbenv. Также добавьте ~/.rbenv/bin/rbenv init в ваш файл ~/.bashrc позволит вам автоматически загрузить rbenv.
 $ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc $ echo 'eval "$(rbenv init -)"' >> ~/.bashrc
Источник вашего .bashrc для загрузки изменений конфигурации.
 $ source ~/.bashrc
Введите rbenv, чтобы обеспечить его работу:
 $ rbenv
вывод rbenv:

rbenv is a function rbenv () { local command; command="${1:-}"; if [ "$#" -gt 0 ]; then shift; fi; case "$command" in rehash | shell) eval "$(rbenv "sh-$command" "$@")" ;; *) command rbenv "$command" "$@" ;; esac }
Чтобы использовать команду install rbenv, которая упрощает процесс установки новых версий Ruby, вам необходимо установить ruby-build, который мы установим как плагин для rbenv через git:
 $ git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
Список доступных версий Ruby для установки:
 $ rbenv install -l
Это выложит длинный список версий ruby, выберите одну для установки, например 2.5.0
Не используйте sudo, поскольку это не требуется из вашего собственного домашнего каталога. "локальный пользователь"

 $ rbenv install 2.5.0
Дождитесь окончания установки.

Установите новую установку Ruby в качестве глобальной версии ruby.
 $ rbenv global 2.5.0
Проверьте вашу заявленную версию ruby:
 $ ruby -v ruby 2.5.0p0 (2016-12-24 revision 57164) [x86_64-linux]
Установите Джекилл.
 $ gem install jekyll 

 Создать новую страницу Jekyll 

Чтобы создать новую страницу Jekyll, создайте новый файл в любой папке или директории, не исключенной Jekyll в каталоге проекта.

about.html
contact/company_info.md

ПРИМЕЧАНИЕ. Для файлов « Page и « Post требуются дефисы «Передняя Материя» для обработки. В противном случае они просто обозначаются как StaticFile .

Символы Front Matter должны быть в самом начале, перед вашим контентом, и просто выглядеть так:

---

< your content >

Написание поста

Jekyll делает ведение блога легким и увлекательным. Вам не нужно ни настраивать базу данных, ни писать свои посты в каком-то неудобном веб-редакторе. Все, что вам нужно сделать, это просто создать текстовый файл в _posts . Такой файл должен быть назван в следующем шаблоне YEAR-MONTH-DAY-some-post-title.md (т.е. 2016-05-02-my-first-post.md ).

В начале файла сообщения находится заголовок YAML, за которым следует ваш текст. Пожалуйста, смотрите этот пример сообщения.

--- layout: post title: My first post --- Here goes some text formated in Markdown. We can do **bold text**, hyperlinks to our favorite pages, such as [developer-portal](https://developer.fedoraproject.org), and many other cool stuff. See <https://daringfireball.net/projects/markdown/syntax>

Обновите страницу, и пост будет там. Это так просто.