Настройка онлайн-документации

Общая информация

Интеграция с онлайн-справкой доступна в любом продукте по умолчанию, и ведет на общедоступный хостинг https://doc.ru.universe-data.ru/. В каждом разделе продуктов доступна контекстная ссылка, которая ведет на инструкции по работе с соответствующим разделом.

Чтобы перейти на сайт документации:

  1. Перейдите в требуемый раздел. Например, в раздел "Дубликаты".

  2. Наведите курсор на правый край экрана - на красную полоску (Рисунок 1).

  3. Дождитесь, пока полоска не сменит вид на кнопку (Рисунок 2).

  4. Нажмите кнопку Справка.

Область для появления кнопки

Рисунок 1 – Область для появления кнопки

Кнопка перехода в справку

Рисунок 2 – Кнопка перехода в справку

Установка онлайн-справки на собственном сервере

Установка на Nginx

Установка Nginx на базе CentOS 7:

  1. Добавьте EPEL-репозиторий:

    # sudo yum install epel-release
    
  2. Установите Nginx:

    # sudo yum install nginx
    
  3. Разрешите HTTP и HTTPS-трафик на брандмауэре:

    # sudo firewall-cmd --permanent --add-service=http
    # sudo firewall-cmd --permanent --add-service=https
    
  4. Перезагрузите брандмауэр:

    # sudo firewall-cmd --reload
    
  5. Запустите Nginx:

    # sudo systemctl start nginx
    
  6. Настройте автозапуск Nginx при перезагрузке системы:

    # sudo systemctl enable nginx
    
  7. Проверьте статус службы Nginx (он должен быть - active):

    # sudo systemctl status nginx
    

Настройка Nginx под локальную справку:

  1. Настройте конфигурацию Nginx в файле /etc/nginx/nginx.conf. В блоке server замените часть кода на:

    server {
    listen 80;
    server_name localhost;
    
    location / {
    root /usr/share/nginx/html/;
    index index.html index.htm;
    error_page 404 /page404.html;
    }
    }
    
  2. Перезапустите Nginx:

    # sudo systemctl reload nginx
    
  3. Проверьте статус службы Nginx (должен быть - active):

    #sudo systemctl status nginx
    
  4. Полностью очистите каталог /usr/share/nginx/html.

  5. Скопируйте содержимое из каталога dg в каталог /usr/share/nginx/html.

  6. Структура каталогов и файлов должна иметь следующий вид:

    #ls /usr/share/nginx/html
    2.9.0-EE index.html page404.html
    
    • где 2.9.0-EE - версия справки для системы,

    • index.html - страница стартовая (ссылка на url=/2.9.0-EE/index.html),

    • page404.html - страница ошибки 404 (ссылка на url=/2.9.0-EE/content/404.html).

  7. Для проверки работоспособности справки зайдите на localhost:80.

Установка с помощью Docker

Подготовка сервера:

  • Установите Docker через официальный репозиторий. Документацию см. по ссылке https://docs.docker.com/.

  • Установите Docker Compose (версия выше 1.29).

Установка:

  1. Для разворачивания справки на локальном сервере клиенту поставляются архивы:

    • Архив с конфигурацией docs-configs.zip. Также архив можно скачать ниже.

    • Архив с каталогом справки. Каталог имеет имя, отражающее номер релиза и редакцию. Например, 2.9.0-EE.

  2. Создайте в любом удобном месте каталог, где будет храниться справка. Например, opt/docs/.

  3. Скопируйте содержимое архива docs-configs.zip в созданный каталог.

  4. Переименуйте каталог site/[name] в каталог site/dg.

  5. Скопируйте содержимое архива с каталогом справки в каталог site/dg.

  6. В docker-compose.yml укажите путь к каталогу site/dg. При необходимости, измените порты. Если разворачивается несколько сайтов со справкой, то их порты не должны повторяться.

  7. В site/dg/index.html и site/dg/page404.html укажите номер и редакцию релиза чтобы значения соответствовали имени каталога справки. Если устанавливается 2.9.0-EE, то это же название должно быть в файлах.

  8. Запустите контейнер. При первом запуске загрузятся все необходимые образы. Команда:

    docker-compose up -d
    
  9. Проверьте статус контейнера. Команда:

    docker-compose ps
    
  10. Сайт со справкой будет доступен по адресу http://localhost:8090/.

Структура каталогов

Рисунок 3 – Структура каталогов

Статус контейнера

Рисунок 4 – Статус контейнера

Содержимое основных файлов конфигурации

Скачать архив с конфигурацией docs-configs.zip

docker-compose.yml

version: '3'

services:
nginx:
   image: nginx:alpine
   container_name: nginx-doc-dg
   restart: unless-stopped
   ports:
   - "8090:80"

   volumes:
      - /opt/doc/site/dg:/usr/share/nginx/html
      - /opt/doc/nginx.conf:/etc/nginx/conf.d/default.conf

nginx.conf

server {
   listen       80;
   server_name  localhost;

   location / {
      root   /usr/share/nginx/html/;
      index  index.html index.htm;
      error_page 404 /page404.html;
   }
}

index.html

<!DOCTYPE html>
<meta http-equiv="Refresh" content="0; url=/2.9.0-EE/index.html" />

page404.html

<!DOCTYPE html>
<meta http-equiv="Refresh" content="0; url=/2.9.0-EE/content/404.html" />

Смена адреса хоста для интеграции с продуктом

Адрес хоста настраивается в файле customer.json.

Для смены хоста укажите в параметре WIKI_HOST адрес, по которому доступна онлайн-справка. Если в ссылке указывается порт, то его тоже необходимо добавить.

Пример:

"WIKI_HOST": "https://yourhost/",

В результате будут формироваться ссылки вида https://yourhost/2.9.0-EE/index.html.

Включение / отключение интеграции

Интеграция управляется файлом customer.json.

Для включения интеграции укажите смены хоста, укажите значение параметра WIKI_ENABLED = true, для отключения = false.

Пример:

"WIKI_ENABLED": true,