Предыдущий урок: Developing Discourse Plugins - Part 3 - Add custom site settings
Теперь, когда ваш плагин становится более сложным, пора и вам стать более продвинутым в том, как вы его разрабатываете.
Мы рекомендуем использовать git для контроля версий вашего плагина. Мы также рекомендуем использовать github для обмена кодом вашего плагина с другими.
Создание репозитория Git
После того как вы создали аккаунт на GitHub, перейдите по этому адресу, чтобы создать новый репозиторий. Вы можете назвать его как угодно, но обычно хорошо, если название начинается с discourse-. Убедитесь, что репозиторий является публичным. Вот как выглядел мой экран:
Создание локальной рабочей папки
На этом этапе я создаю локальную директорию на своем компьютере для хранения плагина. Обычно я кладу его в ~/code, но вы можете разместить его в любом месте на вашем компьютере:
mkdir -p ~/code/discourse-plugin-test
cd ~/code/discourse-plugin-test
Теперь давайте последуем инструкциям от github, чтобы инициализировать репозиторий с файлом README:
echo "# discourse-plugin-test" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin git@github.com:eviltrout/discourse-plugin-test.git
git push -u origin main
Наконец, создайте файл plugin.rb для вашего плагина, как описано в части 1. Для этого примера я просто создал заглушку:
plugin.rb
# name: discourse-plugin-test
# about: Shows how to set up Git
# version: 0.0.1
# authors: Robin Ward
Создание символической ссылки
Поскольку вы следовали нашему руководству разработчика, у вас где-то на компьютере должна быть копия discourse. Я клонировал свою в ~/code/discourse, но опять же, вы могли разместить ее где угодно, и это должно по-прежнему работать, если вы соответствующим образом отрегулируете следующий код:
cd ~/code/discourse/plugins
ln -s ~/code/discourse-plugin-test .
Приведенный выше код создал символическую ссылку между вашим кодом discourse и папкой вашего плагина. Перезапустите сервер разработки, и вы обнаружите, что ваш плагин работает!
Красота такой настройки заключается в том, что вы можете просто коммитить свой плагин в github и не беспокоиться о кодовой базе discourse, внутри которой он находится. Ваши изменения будут изолированы внутри самого плагина. Если вам нужно редактировать код discourse, вы все еще можете это сделать, но git будет отслеживать изменения отдельно!
Я рекомендую использовать одно окно редактора для кодовой базы вашего плагина и одно для самого Discourse. Так проще, если вы рассматриваете их как две разные вещи.
Больше в серии
Часть 1: Основы плагинов
Часть 2: Выходы плагинов
Часть 3: Настройки сайта
Часть 4: Эта тема
Часть 5: Административные интерфейсы
Часть 6: Приемочные тесты
Часть 7: Опубликуйте свой плагин
Этот документ находится под контролем версий - предложите изменения на github.



