Новые эксперименты по документации

Продолжаю свои поиски решений по подготовке документации. До этого использовал Медиавики и Яндекс.Вики. Но у медиавики мне не нравится работа с файлами, да и в целом неудобно редактировать там содержание. А Яндекс Вики не дает никаких возможностей по экспорту данных, да и публичный доступ тоже никак не организовать. Начал смотреть другие решения. Первым делом решил опробовать gitbook как решение по хранению и управлению документацией. Скачал, поставил ноду, скачал репозиторий, запустил и... Ошибка отсутствия привязки к домену. Начал смотреть публичный гитхаб, чтобы понять что я делаю не так. А оказалось что gitbook теперь работает исключительно в привязке к облачному сервису в США. То есть полный облом. Начал гуглить альтернативы и нашел уже российскую разработку Gramax. Ребята сделали неплохое решение, которое позволяет хранить всю документацию в гит формате (со всеми плюшками распределенной работы), довольно богатый редактор, поддержка markdown и экспорт в форматы word и pdf. Из минусов - чтобы было разграничение доступа и другие возможности, нужно покупать лицензию на сервер. В него же встроен свой гит сервер, видимо его возможностями ограничивается доступ. Но зато есть удобные клиенты под все основные операционки, а если чего не хватает - на гитхабе лежат исходники. А мне уже не хватает подсветки синтаксиса 1С:Элемент и 1С:Предприятия. За сегодня перегнал всю документацию в Gramax, благо хранится это на собственном гитлаб сервере, так что даже если вдруг откажусь от конкретно этого решения - то все материалы все равно остаются у меня в открытом стандартизированном формате.

Новые эксперименты по  документации | Сетка — социальная сеть от hh.ru Новые эксперименты по  документации | Сетка — социальная сеть от hh.ru