Пути обнаружения — маршрут детализации каждого узла

Путь обнаружения — это маршрут, по которому браузер проходит внутри узла. Один и тот же узел может быть представлен как Исполнитель альбома → Альбом → Треки, или как единый плоский список треков, или сгруппирован по Жанру, а затем по Исполнителю, или по Году. Путь строится из одного или нескольких уровней (поле, по которому группируется каждый уровень), заканчивающихся листом (то, что показывает самый глубокий уровень — альбомы, затем их треки, или плоский список треков). Узел может даже содержать несколько путей одновременно, предлагая несколько способов входа.

Различное содержимое требует разных форм, и неправильная форма делает узел непригодным для использования. Музыка требует группировки по исполнителю альбома; плейлист требует плоского упорядоченного списка; подкасты требуют своих подписок. Каждый узел получает правильный ответ, потому что каждый содержит свой собственный путь.

Рабочий пример. У вас есть фильтр Jazz на 5000 треков и плейлист "Friday Night" на 30 треков, оба доступны.

• Для фильтра Jazz вы применяете шаблон, путь которого — Исполнитель альбома → Альбом → Треки. На устройстве вы детализируете: исполнители, затем альбомы этого исполнителя, затем треки альбома в порядке диска и трека.
• Для плейлиста вы применяете шаблон Плоские треки. Открытие его дает 30 треков в порядке плейлиста, без слоя исполнителя или альбома между ними — именно то, чем должен быть плейлист.

Один и тот же плагин, одно и то же диалоговое окно, два узла, две совершенно разные формы — потому что путь является свойством узла, а не глобальной настройкой. Вы не можете предсказать макет узла на устройстве, не зная, какой шаблон он несет; вот почему это нужно уточнить.

Узел не просто получает копию шаблона — он следует ему. Дерево просмотра показывает, какому шаблону следует каждый узел, сразу после имени узла, и редактирование шаблона на вкладке Пути немедленно изменяет форму каждого узла, следующего за ним — без повторного применения узла за узлом. Применение шаблона к скрытому узлу также делает его снова видимым: применение — это жест "покажи мне это, оформленное так", в то время как скрытие остается с флажком "Видимый". Каждая строка шаблона показывает живой счетчик (n) узлов, следующих за ним, и шаблон может быть удален только тогда, когда этот счетчик равен нулю — кнопка удаления остается отключенной, пока что-либо следует за шаблоном, поэтому узел никогда не может быть оставлен осиротевшим после удаления. Чтобы увидеть, какие именно узлы следуют шаблону, кнопка-воронка рядом с деревом просмотра фильтрует дерево до только этих узлов; выбор другого шаблона повторно фильтрует, а отключение воронки восстанавливает полное дерево. Удаление неиспользуемого шаблона теперь также сохраняется — поставляемые по умолчанию значения больше не пересоздаются незаметно при следующей загрузке плагина.

Когда путь заканчивается листом Альбом → Треки, вы также решаете, что считать одним альбомом. Вместо строгой группировки по названию альбома вы выбираете одно или несколько полей — Альбом, Сортировка альбома, Год, Исполнитель альбома — которые вместе определяют, какие треки объединяются в один альбом, как читается его заголовок, и порядок появления альбомов, каждое поле сортируется по возрастанию или убыванию. Добавление Исполнителя альбома разделяет два одноименных альбома разных исполнителей; добавление Года по убыванию перечисляет альбомы исполнителя от новейших к старейшим. При группировке по году MusicBee предлагает два поля, которые отражают его собственные — Год, полный тег даты (который может содержать полную дату, например 2024-03-15), и Год (гггг), только четырехзначный год — поэтому выбор Год (гггг) собирает все релизы года вместе, вместо того чтобы разделять их по точной дате.

Значения по умолчанию разумны — новые фильтры формируются по исполнителю альбома, плейлисты и Входящие получают разумные значения по умолчанию — поэтому в обычном случае вы ничего не меняете. Обратитесь к вкладке "Вид", когда вы хотите, чтобы конкретный узел был оформлен по-другому.

Настройки

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

Элемент управления	Что он делает
Применить к отмеченным конечным точкам	Заставляет каждый узел, который вы отметили в дереве, следовать текущему выбранному шаблону (и снова отображает его, если он был скрыт).
Развернуть все / Свернуть все	Разворачивает или сворачивает все дерево конечных точек.
Показывать только узлы, соответствующие выбранному шаблону	Переключатель воронки: фильтрует дерево конечных точек до только тех узлов, которые следуют выбранному шаблону. Выберите другой шаблон для повторной фильтрации; отключите, чтобы восстановить полное дерево.
Шаблон	Именованный шаблон пути, который редактируется.
↑ / ↓	Перемещает выбранный шаблон вверх или вниз в списке, чтобы упорядочить представление ваших шаблонов.
Группировать по	Поле(я), по которым группируется уровень (например, Исполнитель альбома).
Лист	Что показывает самый глубокий уровень.
Альбом → Треки (AT)	Режим листа: Альбом → Треки — детализация через альбомы к их трекам.
Плоские треки (T)	Режим листа: Плоские треки — единый плоский список треков.
Включить [Все треки] на каждом уровне	Добавляет ярлык [Все треки] на каждом уровне. Отображается только в режиме Альбом → Треки.
Группировать альбомы по	Определяет, что считается одним альбомом, как читается его название, и порядок появления альбомов — выберите одно или несколько полей (Альбом, Сортировка альбома, Год, Исполнитель альбома…), каждое со своим переключателем по возрастанию/убыванию. Отображается только в режиме Альбом → Треки.
Добавить / Удалить	Добавить или удалить путь в шаблоне.