Конструктор для публикации разделов Базы Знаний


В приложении База Знаний и Тестирование доступны публичные ссылки на статьи и разделы, которыми вы можете делиться с другими пользователями Интернета.

У нас имеется старый функционал публикации разделов, с которым можно ознакомиться здесь. Он по-прежнему работает, однако речь сегодня не о нем.

Мы создали второй способ публикации разделов, который по сути является конструктором простого сайта на основе содержимого опубликованной папки из вашей Базы Знаний. Внешний вид получившейся страницы можно настраивать, в этой статье расскажем об особенностях таких настроек.

Этот способ публикации раздела является функционалом расширенной версии Базы Знаний.

Как опубликовать раздел Базы Знаний во внешний интернет

Перейдите на страницу вашего раздела в Базе Знаний и нажмите на кнопку:

Задайте адрес

Откроется окно, где вы сможете указать желаемый адрес для опубликованного раздела (4). Адрес опубликованного раздела будет представлять собой следующую конструкцию: https://домен_вашей_базы_знаний.kdb24.ru/public/путь_к_папке(4 на картинке ниже)/.

Домен вашей Базы Знаний задается в настройках вот по этой инструкции.

Настройте дополнительные ссылки в шапке страницы

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

1 - сюда можно написать текст, который отобразится в шапке

2 - сюда поставить необходимую ссылку

3 - после того, как заполнили 1-2, нажмите кнопку Добавить, чтобы сохранить ссылку. После этого добавленная ссылка появится в списке вверху окна, а поля 1-2 очистятся, и вы сможете добавить еще ссылку. 

Внимание! Конструктор шапки пока находится в разработке, поэтому нужно иметь ввиду, что:

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

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

Когда все поля, которые вам нужны, были заполнены, нажмите кнопку Опубликовать раздел (5).

***

Функционал опубликованного раздела

Скопируйте ссылку на опубликованный раздел и перейдите на получившуюся страницу. Этим адресом уже можно делиться с любыми пользователями Интернета.

По умолчанию опубликованный раздел выглядит следующим образом:

  1. Заголовок страницы. Берется из названия опубликованного раздела
  2. Ссылки, добавленные в шапку страницы во время настроек публикации раздела
  3. Поиск. Работает по всему контенту опубликованного раздела
  4. Теги. Нажмите на "облако тегов", чтобы попасть на страницу со всеми имеющимися тегами, по ним можно фильтровать статьи опубликованного раздела. Теги берутся только из статей, включенных в опубликованный раздел.
  5. Меню. Тут покажутся все статьи и вложенные разделы со всем содержимым. Навигация аналогична той, что на странице самого приложения База Знаний на вашем портале.
  6. Превью статей. По умолчанию тут показаны статьи которые лежат на первом уровне в опубликованном разделе. Превью вложенных разделов пока в разработке. Здесь же покажется описание раздела, если оно заполнено в приложении (подробнее в инструкции).
  7. Плашка "Создано с помощью Базы Знаний".

***

Настройки опубликованного раздела

Страницы, созданные в результате публикации раздела вышеописанным способом, можно настраивать под ваш вкус. 

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

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"
],

В результате применения этого стиля, ваша страница станет выглядеть так:

Посмотреть страницу из примера выше вживую можно по этой ссылке. Все, что там находится, сделано с помощью Базы Знаний. 

Как включить индексацию поисковиками для статей опубликованной Базы Знаний

Очень просто, достаточно активировать переключатель Разрешить индексацию поисковыми системами в окне публикации, где вы задавали адрес.