Инструментарий разработчика

:discourse2: Сводка Developer Toolbox предоставляет быстрый доступ к часто используемым ссылкам, действиям и настройкам при разработке на Discourse.
:hammer_and_wrench: Ссылка на репозиторий https://github.com/discourse/discourse-dev-utils
:open_book: Новичок в темах Discourse? Руководство для начинающих по использованию тем Discourse

:information_source: Предназначено только для локальной разработки. Не подходит для продакшн-сайтов.

Возможности

Как это работает

По умолчанию компонент разработан так, чтобы быть ненавязчивым: модальное окно вызывается нажатием клавиши с символом обратной косой черты ` на клавиатуре. Также можно включить кнопку вызова в интерфейсе через настройку темы.

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

Настройки

Название Описание
show header button Показать кнопку вызова dev toolbox в панели заголовка
remove button from flow Закрепляет кнопку заголовка в правом нижнем углу. (Требуется включение show_header_button)
actions close modal Выполнение действия в toolbox также закрывает модальное окно toolbox.
custom links
Перевод По умолчанию
dev_utils.toggle_btn Dev Toolbox
dev_utils.modal.title Developer Toolbox
dev_utils.modal.cancel Отмена
dev_utils.actions.title Быстрые действия
dev_utils.actions.toggle_alerts Переключить оповещения
dev_utils.actions.toggle_plugin_outlets Переключить выходы плагинов
dev_utils.links.title Быстрые ссылки
dev_utils.links.themes Темы
dev_utils.links.components Компоненты тем
dev_utils.links.colors Цвета
dev_utils.links.settings Настройки
dev_utils.links.plugins Плагины
dev_utils.links.user_prefs Настройки пользователя
dev_utils.links.text Текст
dev_utils.links.plugin_api API плагинов
dev_utils.links.docs Документация Discourse
dev_utils.common_settings.title Общие настройки
dev_utils.common_settings.none Выберите настройку
42 лайка

Спасибо за этот отличный компонент, Киган!

Сейчас иконка в заголовке отображается всегда. Небольшое улучшение могло бы заключаться в том, чтобы показывать её только администраторам. Так при просмотре сайта обычным пользователем внешний вид не будет изменён.

5 лайков

Мне довольно нравится этот компонент. Спасибо! :slight_smile: :+1:

Я только что заметил, что кнопка «Discourse Docs» ведёт на ссылку Plugin API вместо документации.

2 лайка

Спасибо, что указали на это, @Lilly. Я внёс обновление, которое решает эту проблему:

Спасибо за предложение, @manuel. Я уже добавил это:

3 лайка

Выглядит очень хорошо — мне нужно найти все выходы, но и Toggle Outlets, и Toggle Alerts, похоже, ничего не делают, кроме закрытия модального окна.

Должны ли они отображать/показывать или выделять что-то на экране при включении?

1 лайк

Добавление/установка этого компонента темы в дополнение к Developer Toolbox позволяет работать кнопке Toggle Outlets

2 лайка

Ссылка на Plugin API не открывает файл. Похоже, её нужно обновить на app/assets/javascripts/discourse/app/lib/plugin-api.gjs?

2 лайка

Спасибо, я сделал PR :+1:

https://github.com/discourse/discourse-dev-utils/pull/13

3 лайка

Спасибо @Arkshine за исправление, я объединил его в основную ветку :tada:

Я также добавил несколько обновлений (исправлений/модернизаций), а также новую функцию, которая позволяет добавлять пользовательские ссылки, определяя их в настройках темы:

3 лайка

Можно ли отправить перевод для этого компонента на Crowdin? Я не нашел вход в него.

1 лайк

Привет @th21, спасибо, что сообщили нам. Я добавил это как проект перевода в Crowdin.

3 лайка

Каков ожидаемый результат при нажатии на «Переключить уведомления», если ничего не произошло?

1 лайк

Предназначено для скрытия любых уведомлений на вашем экземпляре Discourse. Если на вашем форуме есть такие уведомления:

они будут скрыты со страницы. Это довольно полезно, например, при настройке темы, когда вы хотите временно увидеть страницу без каких-либо уведомлений.

2 лайка