Что нового
Апрель 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, их также можно просматривать в приложении. Достаточно подключить это хранилище.
Ссылка на ревью. Теперь можно поделиться ссылкой на редактирование каталога даже с теми, у кого нет доступа к репозиторию. Проверяющий будет вносить исправления и комментарии под данными редактора.