Repository navigation
Help dock knowledge ru
База знаний хранит документацию проекта в разделах и Markdown-статьях с поиском. Читателям доступны навигация, оглавление, вложения и история, а авторизованным авторам — черновики, форматирование, связи с объектами и управляемая публикация.
Все пользователи могут просматривать статьи и искать по заголовкам, описаниям и полному тексту. Супервайзеры могут создавать разделы, форматировать статьи, вставлять веб-ссылки и skey, прикладывать файлы, изображения и видео, а также копировать серч-ключ статьи в заметки или сообщения.
Разделы и статьи образуют компактное дерево. Стрелка только раскрывает раздел, а остальная строка открывает его. Выделение меняется сразу, пока страница загружается; устаревший ответ игнорируется, если пользователь уже выбрал другую страницу.
При достаточной ширине статья показывает оглавление. Выберите заголовок для перехода или скройте оглавление, чтобы вернуть место чтению. В шапке указаны примерное время, автор, создание и обновление. История изменений по запросу читает транзакции TACTIC и показывает старые заголовок, сводку и текст, не меняя актуальную статью.
Открытый раздел показывает полное содержимое как раскрытый список с подписанными вложенными разделами. Назад к статьям появляется, когда просмотр или редактор заменил либо скрыл навигацию. Скрытие навигации в широком доке включает тот же одностраничный режим, что и в узком: Назад к статьям открывает дерево на всю ширину, а выбор статьи возвращает страницу статьи. Если скрыть навигацию кнопкой в шапке, изменение ширины дока не покажет её снова; состояние меняется только следующим нажатием этой кнопки.
Текст статьи хранится как обычный Markdown. Режим «Визуально» показывает форматированный редактор,
а Markdown позволяет править тот же исходник напрямую; при переключении синхронизируется один
черновик без второй HTML-копии. Размер изображения остаётся виден и доступен для правки в суффиксе
{width=… height=… fit=content} после изображения.
Обычный Markdown схлопывает несколько пустых строк между блоками. База знаний сохраняет
дополнительные строки как пустые абзацы, поэтому отступы между текстом, картинкой, цитатой или кодом
остаются видимыми после публикации.
Статьи, оставшиеся от прежнего rich-text редактора, преобразуются в памяти при открытии. Данные на
сервере не меняются, пока вы явно не сохраните статью.
Кнопки жирного, курсивного, подчёркнутого и зачёркнутого начертания показывают формат текущего
выделения или позиции курсора. Без выделения нажатая кнопка форматирует следующий ввод, пока её не
отключат. «Цитата», «Выносная цитата» и «Блок кода» открывают панель вставки и подхватывают текущий
выделенный текст. Там же выбирается язык кода; для Python работает синтаксическая подсветка. Цитаты
имеют заметные кавычки и отдельный фон, а код отображается одним блоком с рамкой и заголовком языка.
Отдельная кнопка «Разделитель» вставляет линию и оставляет после неё пустую строку для продолжения
текста. Кнопки разделены на группы истории, текста, блоков и выравнивания. При достаточной
ширине выравнивание и другие действия показываются сразу, а на узкой панели переключатель
«Визуально / Markdown» сокращается до иконок и не выходит за границы.
Визуальный режим использует те же фон, типографику,
отступы и оформление блоков, что и сохранённая статья; добавляются только каретка, выделение и
элементы управления редактора.
У новой статьи сначала задаются заголовок и сводка, затем содержимое. У существующей статьи эти поля свёрнуты до запроса. Сохранить, Отмена и Удалить остаются в шапке и при нехватке места превращаются в иконки. Несохранённый текст фоново записывается в локальный черновик и остаётся в дереве при переходе на другую страницу. После принудительного перезапуска редактор восстанавливает последнюю контрольную копию, поэтому сбой приложения не должен молча уничтожать текст статьи. Перемещение курсора или изменение выделения не закрывает редактор.
Ссылки базы знаний в заметках и сообщениях выглядят как компактные карточки с заголовком, типом и описанием страницы; выбор карточки открывает её во встроенной базе знаний. Наведите мышь на существующую текстовую ссылку, чтобы появилась кнопка «Редактировать ссылку».
Откроется та же панель с текущими адресом и подписью; изменения сохранятся именно в эту ссылку независимо от текущего выделения текста. Наведение использует нативное определение ссылок и не перехватывает обычное выделение мышью и не синхронизирует его непрерывно.
Скрепка в строке форматирования показывает или скрывает библиотеку вложений; в закрытом состоянии она не занимает высоту редактора и не загружает скрытые миниатюры. Картинки, вставленные в текст статьи, продолжают отображаться. Нажмите «Прикрепить файлы» или перетащите любые файлы в область подготовки. Изображения сразу показываются как локальные превью, остальные типы — как плитки с расширением. Затем файлы загружаются в серверную библиотеку статьи. Та же область принимает картинку из буфера обмена и позволяет очистить очередь.
Первая загрузка резервирует новую статью как личный серверный черновик. «Сохранить как черновик» создаёт или обновляет доступный только автору серверный черновик и оставляет редактор открытым; «Опубликовать» делает статью видимой читателям.
Изображения можно вставлять в текст по постоянному веб-адресу, а остальные файлы — как ссылки. У каждого элемента есть подписанные действия «Вставить» и «Копировать ссылку», а после копирования подпись сразу меняется на «Скопировано».
Вставленное изображение изначально не шире 560 пикселей и текущей области текста. Выделите изображение, чтобы увидеть его отображаемый, сохранённый и исходный размеры.
Включите «Растягивать по ширине контента», чтобы изображение занимало ширину статьи; выключите этот режим, чтобы задать строгую ширину ползунком или рамкой. Рамка продолжает менять размер, даже если при быстром движении курсор пересёк границу изображения или редактора. Просмотрщик загружает изображение отдельно, сначала пробует оригинал и только при ошибке использует лёгкое превью, а также всегда удерживает изображение внутри доступной ширины текста.
Визуальный редактор также показывает оригинал поверх прозрачного места в документе, сохраняя его постоянный адрес в Markdown. При ошибке он переключается на лёгкое превью, не блокируя статью.
Крупные изображения статьи используют ограниченную текстуру для просмотра и остаются загруженными. Обычные абзацы и заголовки отображаются небольшими блоками простого текста, а богатое форматирование рассчитывается только для затронутого блока.
Во время изменения размера дока редактор сохраняет текущую раскладку изображений и подгоняет их один раз после отпускания мыши; при открытии изображения по-прежнему используется исходный файл. При возврате к фиксированной ширине изображение перерисовывается сразу, а рамка выделения остаётся на отрисованной картинке при любом выравнивании абзаца.
Любое превью изображения в режиме чтения открывает исходный файл или связанный объект. Все вложения статьи также перечислены после её текста в виде файловых карточек.
Изображение вставляется в текущую позицию текстовой каретки. Перетащите само выделенное изображение, чтобы переместить его к другой позиции каретки в статье.
Визуальный редактор и режим чтения сначала используют уменьшенные превью вложений, но сохраняют исходные ссылки в Markdown; постоянный файл остаётся запасным источником и открывается из статьи. Компактные карточки используют те же превью.
Заголовки статей и исходные имена загрузок никогда не становятся техническими именами файлов. Хранимые вложения сочетают стабильный код статьи с непрозрачным идентификатором вложения, а библиотека продолжает показывать исходное имя.
Транспорт загрузки поддерживает Unicode-имена файлов. Загруженные файлы остаются в одном компактном списке с превью, именем, размером и действиями вставки, копирования ссылки и удаления с подтверждением.
При удалении статьи архивируются все её снапшоты вложений, но связанные sObject'ы не удаляются; вложенные страницы нужно перенести или удалить отдельно. Перетащите статью или раздел на нужный раздел, чтобы вложить его, либо выше или ниже другой строки, чтобы изменить порядок.
Кнопка сохранения порядка появляется только при наличии несохранённых изменений структуры. В редакторе новой страницы материнский раздел показан до начала редактирования.
Статью можно связать с одним или несколькими выбранными серч-объектами. В шапке статьи показываются их актуальные превью и описания; стрелками можно листать несколько связанных объектов.
Во время редактирования статьи контекстная кнопка привязывает текущее выделение из поиска и не занимает место в навигации. Кнопка открепления убирает из статьи только тот объект, который сейчас показан в её шапке.
Связь обновляется при сохранении черновика или публикации; сам sObject никогда не удаляется.
- Администратор TACTIC подтверждает одну общую инициализацию для сообщений и базы знаний.
- Она создаёт локальную таблицу статей проекта и при необходимости добавляет две колонки metadata для сообщений; перед применением предупреждение перечисляет все изменения.
- Markdown хранится как исходник статьи, а отрисованный форматированный текст очищается перед показом.
- Ctrl+B, Ctrl+I, Ctrl+U и Ctrl+K форматируют текст или вставляют ссылки.
- Ссылки HTTP, HTTPS, FTP, сохранённые поиски, объекты, файлы и статьи используют общую навигацию приложения.
- В результате поиска кнопка базы знаний появляется только тогда, когда в лёгком индексе связей проекта есть статья для этого серч-объекта; кнопка открывает связанную статью.
- Если база знаний в проекте не инициализирована, индекс возвращается пустым: обычные результаты поиска не меняются и ошибки запросов статей не показываются.
- Кнопка базы знаний остаётся у правого края группы действий, когда при наведении появляются дополнительные кнопки.
Навигация, оглавление, команды чтения и редактирования и панель форматирования используют одни описания Frame в Handler и Stream. На узкой панели команды переходят на следующую строку; дополнительные действия доступны через Другие действия форматирования. Qt и браузер сохраняют собственные редакторы Markdown, выделение, работу с изображениями и вложениями; отрисовка текста может отличаться.
При первом запуске Инициализировать открывает подтверждение с описанием изменений метаданных сообщений и таблицы статей проекта. Отмена ничего не записывает. Подтверждение сохраняет существующие столбцы и данные. Смена проекта закрывает подтверждение; запоздалые ответы предыдущего проекта не меняют статьи и права нового. Уже отправленная серверная запись остаётся операцией исходного проекта.
TACTIC-Handler · Releases · Issues · English · Русский
English
- Home
- Installation
- Feature tour
- User guide
- Assistant
- Dashboards
- Knowledge Base
- Maya / Shelf
- Plugins / Плагины
Русский
- Главная
- Установка
- Обзор возможностей
- Руководство пользователя
- Помощник
- Дашборды
- База знаний
- Maya / Shelf
- Plugins / Плагины
Development / Разработка