В приложении База Знаний и Тестирование доступны публичные ссылки на статьи и разделы, которыми вы можете делиться с другими пользователями Интернета.
У нас имеется старый функционал публикации разделов, с которым можно ознакомиться здесь. Он по-прежнему работает, однако речь сегодня не о нем.
Мы создали второй способ публикации разделов, который по сути является конструктором простого сайта на основе содержимого опубликованной папки из вашей Базы Знаний. Внешний вид получившейся страницы можно настраивать, в этой статье расскажем об особенностях таких настроек.
Этот способ публикации раздела является функционалом расширенной версии Базы Знаний.
Как опубликовать раздел Базы Знаний во внешний интернет
Перейдите на страницу вашего раздела в Базе Знаний и нажмите на кнопку:
Задайте адрес
Откроется окно, где вы сможете указать желаемый адрес для опубликованного раздела (4). Адрес опубликованного раздела будет представлять собой следующую конструкцию: https://домен_вашей_базы_знаний.kdb24.ru/public/путь_к_папке(4 на картинке ниже)/.
Домен вашей Базы Знаний задается в настройках вот по этой инструкции.
Настройте дополнительные ссылки в шапке страницы
Опубликованный раздел будет представлять собой мини-сайт, где в виде страниц разместится весь контент из этого раздела. Как и в любом другом сайте, его верхняя часть будет статична и видна на всех страницах. Вы можете добавить в эту шапку сайта ссылки по вашему желанию, к примеру, на сайт вашей компании, на группу в соцсетях и так далее.
1 - сюда можно написать текст, который отобразится в шапке
2 - сюда поставить необходимую ссылку
3 - после того, как заполнили 1-2, нажмите кнопку Добавить, чтобы сохранить ссылку. После этого добавленная ссылка появится в списке вверху окна, а поля 1-2 очистятся, и вы сможете добавить еще ссылку.
Внимание! Конструктор шапки пока находится в разработке, поэтому нужно иметь ввиду, что:
- количество ссылок в шапке не ограничено, и если сделать очень много таких ссылок верстка поедет. На текущий момент ограничений нет, так что рассчитывать нужно на здравый смысл
- сразу после добавления ссылки будут не стилизованные, внешний вид получится достаточно простой.
Вот как выглядит несколько ссылок в шапке опубликованного раздела.
Когда все поля, которые вам нужны, были заполнены, нажмите кнопку Опубликовать раздел (5).
***
Функционал опубликованного раздела
Скопируйте ссылку на опубликованный раздел и перейдите на получившуюся страницу. Этим адресом уже можно делиться с любыми пользователями Интернета.
По умолчанию опубликованный раздел выглядит следующим образом:
- Заголовок страницы. Берется из названия опубликованного раздела
- Ссылки, добавленные в шапку страницы во время настроек публикации раздела
- Поиск. Работает по всему контенту опубликованного раздела
- Теги. Нажмите на "облако тегов", чтобы попасть на страницу со всеми имеющимися тегами, по ним можно фильтровать статьи опубликованного раздела. Теги берутся только из статей, включенных в опубликованный раздел.
- Меню. Тут покажутся все статьи и вложенные разделы со всем содержимым. Навигация аналогична той, что на странице самого приложения База Знаний на вашем портале.
- Превью статей. По умолчанию тут показаны статьи которые лежат на первом уровне в опубликованном разделе. Превью вложенных разделов пока в разработке. Здесь же покажется описание раздела, если оно заполнено в приложении (подробнее в инструкции).
- Плашка "Создано с помощью Базы Знаний".
***
Настройки опубликованного раздела
Страницы, созданные в результате публикации раздела вышеописанным способом, можно настраивать под ваш вкус.
На текущий момент вы не сможете попасть в настройки опубликованного раздела через интерфейс, поэтому переходите туда по прямому адресу:
https://ссылка_на_опубликованный_раздел/settings/Через интерфейс можно перейти вот по этой ссылке
По умолчанию настройки публичного раздела имеют следующий вид:
Заполняйте значения, чтобы настроить внешний вид страницы, поменять заголовок, отображающийся в шапке, поставить свой логотип, подключить Яндекс-метрику.
Вместо null вы можете подставлять свои значения.
Таблица существующих настроек
| Параметр | Расшифровка |
|---|---|
| "logo_url": | сюда напишите ссылку на сайт, куда должен вести логотип |
| "styles": | сюда можно задавать ссылки на файлы с CSS стилями. Подробности ниже в статье |
| "header_items": | тут будут ссылки, если вы добавили ссылки для шапки страницы |
| "logo_img": | сюда добавьте url картинки с вашим логотипом. Ссылка на картинку должна оканчиваться на расширение для изображений .jpeg, .png и т.п. |
| "title": | сюда запишите заголовок. Заголовок изменится только в шапке |
| "yandex_metrika_counter_id" | ID Яндекс-метрики |
Важно! В настройках используется JSON, поэтому значения нужно вносить в кавычках ""!
Пример: зададим собственный заголовок:
"title": "интеграция битрикс24 и 1с",
Подключение CSS стилей
В параметр "styles": можно подключать файлы с CSS стилями. В этот параметр требуется передавать массив, поэтому значения должны храниться в квадратных скобках [].
Пример: подключим файл, который красит фон страницы в синий цвет:
"styles": [ "https://articles.it-solution.ru/media/release/style_blue.css" ],
Стили CSS вы можете прописать прямо в окне настроек, либо записать ссылку на готовые стили.
Пример: подключим файл, который применяет к опубликованной странице такие же стили, как на страницах курсов Битрикс24:
"styles": ["https://testingitsolution.kdb24.ru/article/read/d86336120e9b43c6ac907f54942b0521/?v=1"
],
В результате применения этого стиля, ваша страница станет выглядеть так:
Посмотреть страницу из примера выше вживую можно по этой ссылке. Все, что там находится, сделано с помощью Базы Знаний.
Как включить индексацию поисковиками для статей опубликованной Базы Знаний
Очень просто, достаточно активировать переключатель Разрешить индексацию поисковыми системами в окне публикации, где вы задавали адрес.