Discourse Theme CLI — это ruby-гем, который позволяет использовать ваш любимый редактор при разработке тем и компонентов тем для Discourse. При сохранении файлов CLI обновляет удалённую тему или компонент, и изменения сразу же отображаются на сайте!
Установка
Чтобы попробовать, убедитесь, что у вас установлен Ruby 2.5 или более новая версия.
Если вы используете Windows, у вас есть 2 варианта:
Вариант 1: Windows Subsystem for Linux.
В Windows 10 есть доступ к полноценной среде Linux, вы можете использовать её для установки ruby простой командой sudo apt-get install ruby, это даст вам Ruby 2.3.
Вариант 2: Старые версии Windows
В старых версиях Windows нет доступа к WSL, вы можете легко установить Ruby с помощью Ruby Installer, выберите рекомендуемую версию и настройки по умолчанию для установки.
В Mac OS версии 10.13.3 Ruby 2.3 предустановлена из коробки, ничего особенного не требуется. Если вы используете более раннюю версию Mac OS, рассмотрите возможность использования rvm, rbenv или homebrew для установки последней версии ruby.
После того как Ruby 2.2 или более поздняя версия будет запущена, откройте терминал или командную строку и выполните:
gem install discourse_theme
После установки, чтобы узнать больше о нём:
discourse_theme
Обновление
gem update discourse_theme
Возможности
CLI предоставляет 3 основные функции:
discourse_theme new
Вы можете использовать её для быстрого создания новой темы с помощью discourse_theme new YOUR_DIR_NAME
discourse_theme watch
Вы можете использовать её для мониторинга темы и синхронизации с сайтом discourse (с обновлением в реальном времени) с помощью discourse_theme watch YOUR_DIR_NAME
Это означает, что вы можете использовать свой собственный редактор для редактирования вашей темы, и сайт волшебным образом
обновится с изменениями!
discourse_theme download
Вы можете скачать существующую тему из Discourse с помощью discourse_theme download YOUR_DIR_NAME. Затем у вас появится возможность сразу же начать «наблюдение»!
Учётные данные
Вам нужно будет создать API-ключ. Перейдите в административную область и создайте ключ там.
При создании ключа выберите «Уровень пользователя» Single User, а неAll Users.
Убедитесь, что отмечен пункт Global Key, иначе вы получите ошибки 403 forbidden.
Учётные данные (опционально) хранятся в ~/.discourse_theme. API-ключи хранятся для каждого сайта отдельно, а также отслеживаются URL и theme_id для каждой директории. Если вам когда-нибудь нужно будет изменить настройки, просто добавьте --reset к любой команде, и от вас снова запросят все значения.
Отзывы
«Этот инструмент — настоящий GEM!» @awole20
«Это очень, очень хорошо.» @awesomerobot
«Работает
И это довольно круто. Отлично!» @angus
«ОМГ. Это невероятно.» @pfaffman
Этот документ управляется по версиям — предложите изменения на github.

