Апрель 2024

  • Новый сайт Gramax. Добавили видео и описание быстрого старта работы в приложении на gram.ax.

  • Автоматическая генерация URL статьи. При создании статьи, URL автоматически транслитерируется из заголовка, но позже его можно изменить.

  • Ускорение и стабилизация операций с Git. Теперь смена ветки, публикация изменений, загрузка каталогов и другие операции с Git в браузерной версии выполняются быстрее и стабильнее.

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

  • Добавление пакетов иконок и отказ от Fontawesome. Перешли с иконок Fontawesome на иконки Lucide. Чтобы сохранить иконки Fontawesome в статьях, воспользуйтесь инструкцией по добавлению собственных пакетов иконок.

Март 2024

  • Переиспользуемые сниппеты. Теперь можно создавать переиспользуемые фрагменты текста, а затем добавлять их в статьи по принципу единого источника.

  • Вкладки. Добавили возможность создавать в статьях вкладки.

  • Превью статьи на ссылке. Превью статьи позволяет просмотреть её контент, наведя курсор на относительную ссылку в каталоге. Превью работает при наведении как в редакторе, так и на портале документации.

  • Настраиваемый интервал обновления портала документации. Теперь в настройках портала можно указать интервал автообновления. По умолчанию — раз в 3 минуты.

  • Улучшение формы обратной связи. Добавили в форму «Сообщить об ошибке» возможность отправить технические детали. Это может нам лучше понимать и решать проблемы.

Февраль 2024

  • Десктопная версия для Linux. Сделали бета-версию десктопного приложения для Linux. Скачать можно на gram.ax.

  • Улучшенный поиск. В новой версии поиск работает с учетом транслитерации и с текстом в неправильной раскладке клавиатуры.

  • Проверка названия при создании ветки. Gramax подскажет, если ветка с таким названием уже существует. А также, если название не соответствует требованиям Git.

  • Проверка названия репозитория при публикации. Теперь при публикации нового каталога Gramax проверяет, нет ли такого репозитория в хранилище.

  • Переход в приложение с портала для чтения. Перейти к редактированию теперь проще — достаточно кликнуть “Редактировать в приложении” на портале для чтения — откроется браузерное приложение и каталог автоматически загрузится.

  • Редактирование OpenAPI. Добавили в приложение редактор для описания OpenAPI.

  • Работа с пустым репозиторием. Раньше в Gramax нельзя было открыть репозиторий без системных файлов. Теперь такого ограничения нет — можно открывать любые репозитории.

Январь 2024

  • Простое открытие по ссылке. Теперь можно просто скопировать ссылку из браузера и кому-то отправить. При переходе по ссылке откроется именно эта статья в этом каталоге и ветке. Если каталог не был загружен — он загрузится, а если ветка не синхронизирована — Gramax предложит ее синхронизировать. По-прежнему важно, что был доступ к чтению каталога.

  • Диаграммы в офлайн-режиме. Теперь диаграммы Mermaid и Diagrams.net работают полностью локально, без подключения к интернету. Для PlantUML все еще нужен интернет — эти диаграммы формируются через публичный сервис PlantUML.com.

  • Отображение иллюстраций при публикации. В новой версии изображения и диаграммы отображаются в окне публикации изменений.

  • Автокомментарий об изменениях при публикации. Теперь комментарий к публикации можно не заполнять вручную — по умолчанию пропишется, сколько и какие конкретно файлы были изменены. Если нужно этот комментарий можно изменить.

  • Решение конфликта с удалением файла. Решили проблемы с конфликтом, когда вносились изменения в статью, которую кто-то удалил. Теперь такие конфликты решаются стандартно.

Ноябрь 2023

  • Публикация документации на собственном сервере. Сделали возможность развернуть портал для читателей на собственном сервере. Подробности в статье Быстрый старт.

  • Объединение (merge) веток в интерфейсе. Теперь в интерфейсе приложения можно объединять ветки и удалять их после объединения.

  • Многооконный режим. В десктопном приложении можно работать в нескольких каталогах параллельно — достаточно открыть каждый из них в новом окне.

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

  • Экспорт статей в DOCX и PDF. Любую статью можно экспортировать в DOCX или PDF. Позже такая возможность появится для каталога целиком.

  • Инлайновые комментарии. Раньше комментарий можно было оставить только на блок текста. Теперь — к конкретным фрагментам текста.

  • Переименование ресурсов вместе со статьей. Теперь, когда вы меняете название статьи в URL, также меняются названия всех зависимых ресурсов: картинок, диаграмм, загруженных файлов. Это нужно для того, чтобы лучше понимать, к какой статье относится ресурс.

  • Упрощенное создание каталогов. Раньше, чтобы создать каталог, нужно было сначала заполнить информацию о нем. Теперь каталог создается пустым, всю информацию можно заполнить позже.

  • Группировка элементов в панели форматирования. Навели порядок в панели форматирования текста, чтобы было проще ориентироваться в элементах.

  • Ссылка на ревью до статьи. Раньше, при отправке на ревью, ссылка отправлялась на весь каталог и открывалась самая первая статья. Теперь будет открываться статья, из которой эта ссылка отправлена.

  • Ускорение операций с Git в десктопной версии. Значительно ускорили синхронизацию каталога, смену ветки и загрузку истории изменения.

Сентябрь 2023

  • Решение конфликтов в интерфейсе. Теперь, если есть конфликт, его можно решить прямо в интерфейсе Gramax.

  • Добавление, настройка и удаление каталогов в интерфейсе. Раньше, чтобы добавить каталог, нужно было создавать репозиторий и наполнять его системными файлами. Теперь это можно сделать в интерфейсе приложения. Также можно изменить параметры каталога: приватность, название, стиль и так далее.

  • Упрощенное добавление относительных ссылок. Теперь не нужно мучаться с относительными путями — достаточно выбрать статью в выпадающем списке, путь проставится автоматически.

  • Экспорт статей в PDF. Теперь можно выгрузить любую статью в формате PDF.

  • Добавление файлов в статью. Теперь в статью можно добавить файл любого типа. По клику он скачается на компьютер.

  • Редактирование Markdown. Так как не все возможности у нас реализованы в интерфейсе, можно в правой панели открыть окно редактирования исходника статьи.

  • Подключение к GitHub. Если у вас есть личные каталоги на GitHub, их также можно просматривать в приложении. Достаточно подключить это хранилище.

  • Ссылка на ревью. Теперь можно поделиться ссылкой на редактирование каталога даже с теми, у кого нет доступа к репозиторию. Проверяющий будет вносить исправления и комментарии под данными редактора.