У Joplin есть два файла стилей, которые определяют, как Joplin выглядит для пользователя. Joplin использует свои встроенные стили, но эти два файла могут быть использованы для переопределения этих стилей. Эти файлы аналогичны каскадным таблицам стилей (CSS), используемым при создании веб-сайтов. Файлы называются userchrome.css и userstyle.css.

  • userchrome.css позволяет создавать стили для самого приложения, включая редактор Markdown,
  • userstyle.css позволяет стилизовать панель просмотра Markdown / форматированный текстовый редактор.

Хотя изменения css для панели Markdown Viewer и редактора форматированного текста записаны в один и тот же файл userstyle.css, это не означает, что внесенные вами изменения будут автоматически работать в обоих файлах. В элементах css, используемых панелью Markdown Viewer и редактором форматированного текста для элемента, который вы хотите изменить, могут быть незначительные различия.

На рисунках ниже показаны области, охватываемые каждой таблицей стилей.

markdown_editor

Редактор Markdown с панелью просмотра

rich_text_editor

Форматированный текстовый редактор

Доступ к обоим этим файлам можно получить из Joplin, перейдя на страницу настроек и выбрав Внешний вид ** > ** Показать дополнительные настройки и нажав “Пользовательская таблица стилей для рендеринга Markdown” (которая открывает userstyle.css) или “Пользовательский таблица стилей для настроек в Joplin” (которая открывает userchrome.css). Файлы будут открыты любым приложением в вашей системе, настроенным на открытие файлов .css. Файлы css - это обычные текстовые файлы, поэтому, если в вашей операционной системе нет установленного приложения и вас попросят выбрать его, выберите редактор **.обычный текстовый редактор.

Фактическим расположением файлов является “~/.config/joplin-desktop” в системах Linux / macOS и “C:\users<имя пользователя>.config\joplin-desktop” в системах Windows. Если вы еще не открывали файлы css из Joplin, они изначально могут отсутствовать в папке, и поэтому их нужно будет создать вручную. ** Не трогайте другие файлы в этой папке **, они не имеют никакого отношения к стилю Joplin и могут привести к повреждению ваших данных Joplin в случае их изменения.

Важно отметить, что эти пользовательские таблицы стилей загружаются при запуске Joplin. Если вы измените любую из таблиц стилей, вам необходимо ** выйти из программы и перезапустить Joplin, чтобы изменения вступили в силу **. Это не просто закрытие окна Joplin, для этого требуется, чтобы Joplin был ** Закрыт ** (Файл > Выход или CTRL+Q).

Кроме того, поскольку это всего лишь изменения стиля, если вы что-то перепутаете, вы можете просто удалить таблицы стилей или их содержимое. После завершения работы с Joplin или перезапуска Joplin вернется в нормальное состояние.

Поиск названия вещей, которые вы хотите изменить

Конечно, все это бесполезно, если вы не можете найти названия элементов, которые хотите настроить.

Если вы нажмете “Справка” на панели инструментов Joplin, в меню появится опция “Переключение инструментов разработки”. Откроется окно, в котором будет показано, что происходит под поверхностью Joplin. Выбор “средства выбора” ([1] на рисунке ниже) позволит вам с помощью курсора указать на ту часть интерфейса Joplin, которую вы хотите настроить. При этом появится всплывающее окно ([2] на картинке) и код ([3] на картинке), которые помогут вам определить элемент / класс, который вы хотите изменить.

dev_tools_info

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

В интернете вы можете найти множество примеров, которые можно попробовать, доработать и на которых можно учиться. Эта страница - хорошая отправная точка 609. Поначалу это непросто сделать, если у вас нет большого опыта использования таблиц стилей. Но со временем логика становится понятнее, и это действительно становится немного проще. Такие сайты, как “Справочник по CSS w3schools” 87, полезны для ознакомления с терминами, с которыми вы сталкиваетесь при изучении CSS.

На свой страх и риск

**Эта возможность настройки Joplin считается “неподдерживаемой” функцией **. По сути, это означает, что если пользовательская таблица стилей работает не так, как вы ожидаете, или нет способа изменить определенную часть Joplin, это не ошибка. Отсутствие поддержки также означает, что Joplin не обязан поддерживать совместимость с любыми пользовательскими таблицами стилей. По мере разработки Joplin названия элементов стиля могут меняться (и это происходило в прошлом), и ваша пользовательская таблица стилей может перестать работать в полной мере. Таким образом, поддержание совместимости зависит от пользователя. Это также означает, что при просмотре форума в поисках идей существует вероятность того, что примеры из старых сообщений не сработают.