Теги контента

Несмотря на наличие иерархической структуры для организации контента в BookStack, иногда возникает необходимость в дополнительной категории для классификации контента. Теги в BookStack предлагают такую гибкость, позволяя добавлять категорию и значения на всех уровнях иерархии.

Формат тегов

Теги в BookStack имеют название, но также могут иметь дополнительное значение. Это позволяет детализировать и классифицировать контент в зависимости от требований конкретного сценария.

Например, вы можете использовать тег с названием «Критический» без значения для выделения важной приоритетной страницы. Или, если у вас есть диапазон приоритетов, можно использовать тег с названием «Приоритет» и значением «Критический». Таким образом, можно будет легко находить любые страницы с установленным приоритетом, а также конкретно критические страницы.

Это также удобно, если вы хотите использовать теги для метаданных. Например, вы можете записывать даты проверки контента с помощью тега «Дата проверки» и соответствующего значения.

Добавление и управление тегами

Теги можно добавлять на любом уровне иерархии контента (полки, книги, главы и страницы). Их можно применить при редактировании любого элемента. Для полок, книг и глав теги расположены в выпадающем меню на странице редактирования:

Для страниц теги можно найти в боковой панели инструмента при редактировании страницы:

При редактировании имени или значения тега BookStack покажет список существующих подходящих вариантов, чтобы помочь вам быстро заполнить поле. Предложенные значения будут выбраны только для выбранного имени тега, а не для всех тегов.

Также при редактировании можно менять порядок и удалять теги. Все изменения тегов сохраняются вместе с элементом, к которому они применены.

Отображение и обзор тегов

Примененные теги отображаются в нескольких областях BookStack наряду с контентом, к которому они относятся:

• В боковой панели или информационной панели при просмотре любого отмеченного элемента.

• В результатах поиска.

• В ответах API для элементов.

При просмотре элемента с тегами можно щелкнуть по тегу, чтобы начать поиск по нему. Щелчок по имени тега начнет поиск всех элементов, имеющих тег с таким же именем. Щелчок по значению запустит поиск элементов с тем же именем тега и значением.

Чтобы просмотреть все используемые теги, можно перейти на страницу обзора тегов через действие «Просмотреть теги», расположенное на индексах книг или полок, или напрямую перейти по адресу /tags. Там вы увидите список всех используемых имен тегов с количеством использований для каждого типа контента.

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

Теги в индексе поиска

При индексации контента для поиска в BookStack учитываются имена и значения тегов, и они получают приоритет перед обычным содержимым. Это значит, что вы можете повышать значимость контента в результатах поиска по определенным ключевым словам с помощью тегов.

Операции поиска по тегам

Контент в BookStack можно запрашивать по имени или значению тега. Это можно делать в различных частях BookStack, где доступно окно поиска. Прямо в интерфейсе можно инициировать поиск по тегам, щелкая по самим тегам или статистике в обзоре тегов. Также можно использовать следующую синтаксическую конструкцию:

• Поиск по имени тега:

  • Синтаксис: [<имя>]

  • Пример: [Местоположение]

• Поиск по значению тега:

  • Синтаксис: [<оператор><значение>]

  • Пример: [=Лондон]

• Поиск по имени и значению тега:

  • Синтаксис: [<имя><оператор><значение>]

  • Пример: [Местоположение=Лондон]

Допустимые операторы: =, !=, <, >, <=, >=, like. При использовании оператора like можно использовать символ % для обозначения шаблона.

Таким образом, можно выполнять сложные запросы. Например, если вы используете теги «Дата проверки» с датами в формате 20240627 (YYYYMMDD), вы можете найти весь контент с проверочными датами до 2024 года, используя запрос [Дата проверки<20240101].

Теги для кастомизации

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

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