Skip to content

Latest commit

 

History

History
137 lines (82 loc) · 8.18 KB

README.md

File metadata and controls

137 lines (82 loc) · 8.18 KB

IDE для markdown

Решение позволяет работать с git репозиторием с markdown файлами в удобном интерфейсе и использовать преимущества оных технологий.

Цель — сделать инструменты для работы с базой знаний/документацией.

Альтернативной является использование IDE наподобие IntelliJ IDEA, Visual Studio и прочих. Но преимуществом данного решения должна быть кроссплатформенность и более лёгкая расширяемость за счёт использования веб-технологий и открытости кода.

Дописать IntelliJ IDEA настолько просто нельзя.

Все существующие веб-IDE и CMS не умеют работать нормально с ветками, а это огромное преимущество. А платформы вроде GitHub/GitLab не предоставляют интерфейсов, понятных не-технарям (по коей причине они популяризируют Confluence).

Термины:

Репозиторий — хранилище с материалами

Артефакт — один markdown файл, лежащий в репозитории.

Функциональные требования

  1. WYSIWYG редактор markdown c возможностью подключения плагинов
  2. Артефакты могут иметь свойства, описанные в соответствии со стандартами markdown, в шапке файла в формате yaml
    1. Строки
    2. Енум (см. Extensions)
    3. Булеан
    4. Ссылки на другие файлы
  3. WYSIWYG позволяет редактировать свойства Артефактов
  4. IDE должна позволять подключать-отключать extension-ы к проектам
  5. Настройки IDE хранятся локально
  6. IDE должна работать локально, на desktop-е, даже в отсутствии интернета (это очень актуально для людей в «режимных» организациях и в госах)
  7. diff веток
  8. решение конфликтов при пушах-пуллах-мерджах
  9. должна поддерживаться вставка картинок из визивига
  10. должна поддерживаться загрузка картинок из визивига

Интерфейсы

Главный экран

Позволяет выбрать проект.

Экран проекта

Показываем выпадашку с ветками и кнопки:

  • Пуш
  • Пулл
  • "Сравнить с мастером", если мы не в мастер-ветке
  • И одна из двух кнопок, если мы не в мастере:
    • "Влить в мастер" если мы обгоняе мастер
    • "Влить мастер сюда", если мастер нас обгоняет

Экран файла

Отображает файл в режими WYSIWYG.

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

Экран сравнения с мастером

В идеале - должен повторять интерфейсы IntelliJ IDEA, что-то типа такого:

Экран мерджа с конфликтами

В идеале - должен повторять интерфейсы IntelliJ IDEA.

Extension #0: enum значения

  • enum значения
  • Варианты enum значений должны храниться в файлах .docs/<названиесвойства>. Так, если у вас есть свойство type – должен быть файл .docs/type с текстом, например
article
contact
known bug

На коммите enum значения должны валидироваться (делается с помощью гит-хуков, например).

Extension #1: контроль ссылок

На коммите контролирует ссылки.

  • Валидирует, что внутренние ссылки не побились
  • Валидирует внешние ссылки
  • Автоматически генерирует магическое свойство «на этот документ ссылаются из ХХХ»
  • В интерфейсах красиво отображает «на этот документ ссылаются из ХХХ»

Extension #2: быстрое создание новых артефактов

Прямо со страницы просмотра одного Артефакта можно создавать новые Артефакты. Они сразу создаются связанными.

Например, так можно разбивать Требования на Тезисы.

Пользователь может выделить текст и создать на основе него новый Артефакт.

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

Extension #3: поиск

добавляем строку поиска в интерфейс. Он позволяет искать по маркдаун файлам (к сожалению, без морфологии и тем более без учёта смысла) и поддерживает поиск по аттрибутам, подобно тому, как это сделано в слаке/гитлабе.

Архитектура

Строго необходимо разделить публичную часть (редактор) и хранилище, работающее с гитом — они должны общаться по http, через задокументированное API.

Причина: существует множество движков git с разными кастомизациями, и они по-разному работают с разным объёмом/количеством файлов. Это действительно критичная проблема на тяжёлых операциях.

И фронтэнд и бэкэнд должны запускаться на desktop-е.

Этого можно достигнуть с помощью «обычных» технологий, например, публичку сделать на React, а бэкэнд общающийся с гитом — на python.

Фронтэнд часть на React:

Бэкэнд на питоне:

я могу сесть и написать за несколько вечеров

Апи:

Был бы повод - можно и нужно написать за вечер.