Привет! Я новичок в Discourse и мне очень нравятся его возможности и функционал. Я хочу серьёзно кастомизировать его внешний вид и способ отображения контента. Я читаю различные ветки и посты, пытаясь разобраться, но, несмотря на опыт работы с JavaScript, я запутался. Под «серьёзной кастомизацией» я имею в виду: удаление боковой панели, добавление пунктов навигации в верхнюю панель. Отображение тем с именем автора, аватаром, заголовком и превью текста, а также с информацией о последнем ответе и его превью с аватаром и именем автора ответа. Темы, сгруппированные по категориям в одном большом списке категорий и их тем (по-старинке). Похоже, мне нужно понять, как переопределить данные, которые отображаются или извлекаются для отображения, но я не знаю, как лучше всего это сделать. Будет ли это один «тема», компонент темы? Или это будет плагин? Может, несколько тем, компонентов и плагинов? В чём разница между компонентом и плагином? Хотелось бы увидеть видео на YouTube, где показан процесс разработки такой сильно кастомизированной «темы». Сейчас я собираю список «дополнений», которые делают что-то похожее на то, что я хочу реализовать, и пытаюсь изучить их код, но, черт возьми, это действительно запутанно для новичка, который только что «вышел на улицу». Я лучше усваиваю информацию, глядя видео, чем читая. Есть ли какие-то советы, рекомендации или видео, о которых я мог бы не знать? Любая помощь будет очень кстати.
Falco
(Falco)
08.Ноябрь.2023 03:28:30
2
Поскольку желаемые вами изменения потребуют получения дополнительных данных для страниц, темы или компонента будет недостаточно — для реализации вашей задумки потребуется плагин.
Спасибо У меня гора литературы для чтения. Надеюсь, всё постепенно начнёт складываться в логичную картину. Я нашёл очень актуальную тему:
Идеальный способ кастомизации Discourse с помощью тем или плагинов — использовать CSS, JavaScript Plugin API или plugin outlets . Если ни один из этих вариантов не подходит для вашего случая, вы можете открыть PR в ядро Discourse или создать тему в разделе Development на Meta. Мы всегда рады обсудить добавление новых outlets/API, чтобы упростить кастомизацию.
Если вы исчерпали все остальные варианты, возможно, вам придется прибегнуть к переопределению шаблонов (template overrides). Эта техника п…
А теперь просто делюсь ссылками и заметками для тех, кто, возможно, находится в аналогичной ситуации:
HTML-шаблоны находятся здесь: https://github.com/discourse/discourse/tree/main/app/assets/javascripts/discourse/app/templates
Руководство для новичков по темам:
Это краткий курс по основам тем Discourse. Целевая аудитория — все, кто не знаком с темами Discourse. Если вы уже использовали темы или компоненты тем Discourse, вам, вероятно, не нужно читать это руководство.
Что такое темы и компоненты тем?
Тема или компонент темы — это набор файлов, упакованных вместе, предназначенных для визуального изменения Discourse или добавления новых функций.
Начнем с тем.
Темы
Как правило, темы не должны быть совместимы друг с другом, поскольку по сути представляю…
Руководство для разработчиков по темам:
Discourse Themes and Theme Components can be used to customize the look, feel and functionality of Discourse’s frontend. This section of the developer guides aims to provide all the reference materials you need to develop simple themes for a single site, right up to complex open-source theme components.
This introduction aims to provide a map of all the tools and APIs for theme development. If you prefer a step-by-step tutorial for theme development, jump straight to:
Themes vs. Theme Compon…
Руководство для дизайнеров по началу работы с темами в Discourse:
Это возможно, и я рекомендую именно этот метод. Единственное, о чём стоит помнить: все изменения будут сразу же отображаться на форуме по мере их внесения.
Что я делаю: делаю тему выбираемой пользователем, устанавливаю её в личных настройках своего аккаунта, оставляя тему по умолчанию для всех остальных пользователей. Это позволяет видеть любые проблемы, возникающие при настройке темы, только вам.
Создание компонента темы:
Компонент темы для отображения мест размещения плагинов (мест для внедрения нового HTML/скриптов/стилей):
Contribute to communiteq/plugin-outlets-theme-component development by creating an account on GitHub.
Разработка плагинов:
Научитесь создавать вещи с нуля:
There are a few ‘how to start’ guides for working with Discourse already and a wealth of useful info on meta, but I thought it might help to give an insight to the mental processes of starting from little, if any, prior coding experience to building substantial Discourse plugins.
Discourse is written by experienced developers and has a large codebase. This can feel intimidating. This intimidation factor can be a significant barrier for novice developers. This is a kind of ‘psychological primer’…
Установка Discourse на Ubuntu/Debian для разработки:
Это руководство содержит инструкции по установке в среде разработки. Для руководства по установке в продакшене см.: Install Discourse in production with the official supported instructions
Итак, вы хотите настроить Discourse на Ubuntu или Debian, чтобы работать с ним и разрабатывать?
Мы предполагаем, что вы работаете локально и не устанавливали Ruby/Rails/Postgres/Redis на вашей системе Ubuntu или Debian. Начнем!
Требования
Мы рекомендуем иметь как минимум 4 ГБ ОЗУ и 2 ядра CPU…
То, что я действительно хочу изменить, — это «topic-list» или главная страница
• Эта тема уже создала нужный формат списка тем:
• Имя автора + аватар:
Author name plus avatar или Show Original Poster Avatars
• Группы категорий:
• Иконки избранных категорий:
Также можно попробовать онлайн-редактор тем:
Дополнительно:
• Единый вход (SSO)?
DiscourseConnect — это ключевая функция Discourse, позволяющая настроить «Единый вход (SSO)» для полной делегации всей регистрации и входа пользователей из Discourse на другой сайт. Доступно для наших клиентов с тарифами Pro, Business и Enterprise .
(Февраль 2021) «Discourse SSO » теперь называется «DiscourseConnect ». Если вы используете старую версию Discourse, настройки ниже будут называться sso_..., а не discourse_connect_...
Проблема
Многие сайты, желающие интегриров…
• Бот для Discord
Назначение этого плагина
Этот плагин выполняет несколько задач:
Позволяет использовать ваш сервер Discourse для управления ботом Discord, связывая две системы. Разветвите этот репозиторий и расширьте его с помощью простого Ruby, чтобы создать всевозможный функционал бота.
Существующий функционал служит примерами и полезными утилитами:
Обеспечивает двустороннюю автоматическую публикацию контента, соответствующего определенным критериям.
Команда для разовой копирования сообщений в Discou…
pfaffman
(Jay Pfaffman)
08.Ноябрь.2023 05:14:39
4
SinisterSpatula:
удаление боковой панели
Вы можете сделать это, нажав на иконку «гамбургер», так что это довольно просто понять.
Посмотрите Пользовательские ссылки в заголовке .
Это может помочь вам начать работу.