Как установить генератор статических сайтов Jekyll на Ubuntu 22.04

Jekyll — это бесплатный и открытый генератор статических файлов, написанный на Ruby. Это простая и удобная система управления контентом, используемая для создания веб-сайта за считанные минуты. Она принимает текст, написанный на вашем любимом языке разметки, и использует макеты для создания статического веб-сайта. Вы можете использовать встроенные функции Jekyll, чтобы настроить внешний вид сайта, URL-адреса, данные, отображаемые на странице, и многое другое. Он предлагает множество функций, таких как постоянные ссылки, категории, страницы, записи, пользовательские макеты и многое другое.

В этом руководстве мы покажем вам, как установить Jekyll CMS на Ubuntu 22.04.

Предварительные требования

• Сервер с установленной Ubuntu 22.04.
• Пароль root, настроенный на вашем сервере.

Начало работы

Перед началом рекомендуется обновить вашу систему до последней стабильной версии. Вы можете обновить её с помощью следующей команды:

apt update -y  
apt upgrade -y

После того как ваша система будет обновлена, установите другие необходимые зависимости, выполнив следующую команду:

apt install make build-essential curl git tree -y

После установки всех зависимостей вы можете перейти к следующему шагу.

Установка Ruby

Jekyll написан на Ruby, поэтому вам нужно установить его в вашу систему. По умолчанию пакет Ruby включен в стандартный репозиторий Ubuntu.

Выполните следующую команду для установки Ruby:

apt install ruby ruby-dev -y

После завершения установки вам нужно будет сообщить менеджеру пакетов Ruby gem, чтобы он размещал гемы в домашней папке нашего пользователя.

Вы можете сделать это, отредактировав файл ~/.bashrc:

nano ~/.bashrc

Добавьте следующие строки в конец файла:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Сохраните и закройте файл, затем активируйте переменную окружения с помощью следующей команды:

source ~/.bashrc

Далее вы можете установить Jekyll и bundler, используя команду gem, как показано ниже:

gem install jekyll bundler

После завершения установки вы можете перейти к следующему шагу.

Создание нового веб-сайта с Jekyll

На этом этапе Jekyll установлен в вашей системе. Теперь выполните следующую команду, чтобы создать новый веб-сайт с именем jekyll.example.com:

jekyll new jekyll.example.com

После создания веб-сайта вы должны получить следующий вывод:

  Bundler: Using jekyll 4.2.2
  Bundler: Fetching jekyll-seo-tag 2.8.0
  Bundler: Fetching jekyll-feed 0.16.0
  Bundler: Installing jekyll-feed 0.16.0
  Bundler: Installing jekyll-seo-tag 2.8.0
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 7 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
  Bundler: installing your bundle as root will break this application for all non-root
  Bundler: users on this machine.
New jekyll site installed in /root/jekyll.example.com. 

Далее вы можете перечислить все файлы и директории, созданные Jekyll, с помощью следующей команды:

tree jekyll.example.com

Вы должны получить следующий вывод:

jekyll.example.com
??? 404.html
??? about.markdown
??? _config.yml
??? Gemfile
??? Gemfile.lock
??? index.markdown
??? _posts
    ??? 2022-09-25-welcome-to-jekyll.markdown

1 directory, 7 files

Запуск сервера Jekyll

Сначала перейдите в директорию веб-сайта и добавьте зависимость webrick с помощью следующей команды:

cd jekyll.example.com  
bundle add webrick

Затем запустите веб-сервер Jekyll, выполнив следующую команду:

jekyll serve --host=0.0.0.0

После успешного запуска сервера вы должны получить следующий вывод:

Configuration file: /root/jekyll.example.com/_config.yml
            Source: /root/jekyll.example.com
       Destination: /root/jekyll.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.375 seconds.
 Auto-regeneration: enabled for '/root/jekyll.example.com'
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

Доступ к веб-сайту Jekyll

На этом этапе Jekyll запущен и слушает на порту 4000. Теперь откройте ваш веб-браузер и введите URL http://your-server-ip:4000. Вы будете перенаправлены на страницу по умолчанию Jekyll:

Заключение

В приведенном выше руководстве вы узнали, как установить Jekyll на Ubuntu 22.04. Теперь вы можете исследовать Jekyll и создать свой собственный веб-сайт, используя автоматически сгенерированный контент.