Вчера обновился популярный онлайн редактор документов ONLYOFFICE DocumentServer 9.0. Давно знаю и работаю с этим продуктом. Он нравится больше любого другого бесплатного аналога. Хотя аналогов особо и нет. Есть только Collabora Online на базе LibreOffice.

Изменений не сказать, что много. Самое заметное - новый интерфейс. Он существенно отличается от старого, так что можно не узнать продукт, если мельком увидеть. Появилась тёмная тема. Не уверен, что именно в этом обновлении, но раньше я не обращал на неё внимание. Ещё много обновлений на тему внедрения AI в разные места.

Для тех, кто не знает, поясню, что это за продукт и какие вопросы закрывает. У компании целая линейка различных продуктов и сразу неочевидно, какой за что отвечает.

🔹DocumentServer - непосредственно редактор документов. Он полностью open source, но есть в платной и бесплатной редакциях. Ограничение бесплатной версии - 20 одновременно открытых вкладок на редактирование. Если их превышаешь, то документ открывается только на чтение. В целом, это комфортное ограничение для небольших коллективов. Не всем и не всегда нужно открывать документы на редактирование. DocumentServer интегрируется с множеством других популярных продуктов - NextCloud, OwnCloud, есть плагин для Wordpress и многих других продуктов. Так как это open source, есть исправленные версии сервера, где ограничение снято. Я лично их не использовал, но они легко гуглятся.

🔹Workspace - портал для совместной работы, который включает в себя помимо работы с документами через DocumentServer, почтовый клиент, CRM систему, управление проектами, календарь, wiki, чат, форумы. Сам портал полностью бесплатен. Есть коммерческие версии, где в состав включены лицензии на некоторые другие продукты.

🔹Desktop Editors - полностью бесплатные десктопные редакторы документов.

🔹DocSpace - ещё один продукт на базе DocumentServer, который организует отдельные комнаты с набором документов для совместной работы. Для него тоже есть бесплатная версия, но не смог найти описание ограничений. Раньше было главное ограничение - только одна учётная запись администратора, который всем управляет. Я лично этот продукт не использовал и нигде не внедрял. Не увидел применения.

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

# wget https://download.onlyoffice.com/install/workspace-install.sh
# bash workspace-install.sh

Выбирайте установку через Docker. Скрипт workspace-install.sh скачает ещё один скрипт для установки через Docker - http://download.onlyoffice.com/install/install.sh. В этом скрипте есть проверка на наличие 8 GB оперативной памяти и 40 GB доступного места на диске. Для тестов можно урезать осетра и вручную подправить требования по памяти до 4 GB. Стек запустится и будет неспешно работать. Для комфортной работы памяти, конечно, лучше побольше отдать.

Скрипт всё сделает сам. Дальше нужно будет пойти в браузере по IP адресу сервера и выполнить начальную настройку. Всю настройку и обслуживание можно делать через веб интерфейс. В целом, там всё нормально работает. Но лично я для бэкапов пишу свои костыли на bash, не использую встроенные средства. Там необходимо скопировать непосредственно файлы (/app/onlyoffice) и дамп базы данных.

Если ищите себе продукт для совместной работы с документами, то обязательно попробуйте Onlyoffice. На его базе работает сервис документов Яндекса. Сейчас они запустили версию beta нового интерфейса. Не знаю, на базе чего он работает. На Onlyoffice уже не похож внешне. А текущая версия точная копия 1 в 1.

❗️Если заметка вам полезна, не забудьте 👍 и забрать в закладки.

#onlyoffice #docs #управление_проектами

Собрал подборку из заметок на канале на тему инструментов для ведения документации. Ни разу этого не делал, а материала накопилось прилично. В списке явно прослеживаются 2 категории продуктов:

🔹классические в формате wiki;
🔹статические генераторы.

Так что список будет состоять из двух этих категорий, и в конце всё остальное, что останется, в третьей.

Wiki:

◽️DocuWIKI, MediaWiki - по ним не было отдельных заметок, но не мог пропустить эти очень старые и известные продукты. Я сам не раз составлял документацию в DocuWIKI. Это очень простая wiki-подобная панель управления документами, которая работает на php, не требует СУБД, а все заметки хранит в текстовых md файлах. Очень легко бэкапить и синхронизировать документацию.
◽️Wiki.js - современная реализация технологии wiki. Очень хорошая функциональность. Среди всех современных wiki, это самая навороченная и красивая. Там и API, и аутентификаций куча всяких, продвинутый поиск, синхронизация с git и многое другое.
◽️BookStack - ещё один движок на базе wiki, но не только. Больше похож на классическую CMS на PHP, которая в том числе поддерживает wiki. Это для любителей олдскула, хотя проект не брошен. Развивается и поддерживается. Есть аутентификация через AD.

Статические генераторы:

◽️MkDocs - как мне кажется, наиболее популярный генератор именно для документации. С его помощью написана документация для многих известных проектов. Например - Rocky Linux. Принцип там такой - пишите документация в формате md, хранить можно в git. Отдельно пишите инструкцию по генерации сайта в формате yaml. И после каждого обновления контента запускаете генерацию новых страничек или всего сайта.
◽️Hugo - это в целом самый популярный генератор статических сайтов, который в том числе используют для документации, но вообще он для сайтов общего назначения. Многие техноблогеры используют этот движок для своих блогов.
◽️Antora - продвинутый инструмент для ведения документации профессиональными техническими писателями. Там есть деление на продукты, вертки, версии. Управление документацией ведётся по принципу docs as code.
◽️Grav - универсальная CMS, которая в том числе подходит для хранения документации. У неё есть отдельная тема для синхронизации контента с git репозиторием. Сама CMS вместе с markdown редактором работает на PHP. Это может быть удобно, если хочется писать текст во встроенном редакторе, а не где-то на стороне.
◽️Docusaurus - ещё один статический генератор, который изначально был заточен под ведение документации и написан в Facebook. У него простой, лаконичный дизайн, интеграция с git, документы хранит в формате md. Написан на Go, расширяется плагинами. Нормальное современное решение для простой документации.

Разное:

◽️Onlyoffice - это целый портал для совместной работы, который включает в том числе отдельный раздел для wiki. Но лично мне нравится в нём вести текстовую документацию в формате обычных документов docx и xlsx с общим доступом к файлам. Это в целом удобно, так как хранится наглядная история версий, можно скачать файл локально, куда-то переслать, поработать с ним на компе в десктопном редакторе.

Перечислил то, что знал и частично использовал. Если у вас есть ещё рекомендации бесплатных продуктов для ведения документации, поделитесь в комментариях.

❗️Если заметка вам полезна, не забудьте 👍 и забрать в закладки.

#wiki #docs #подборка