Какой движок выбрать для документации?

Question

[Антон]

Привет!
Появилась потребность в создании пространства для хранения документации (текстовые странички разнесённые по категориям).

Wiki отмели (сложная в установке/обслуживании, а также непривычный синтаксис)
daux.io и прочие Markdown-движки тоже исключили из-за сложности обновления базы статей.

Возможно, кто-то предложит более удобные движки?

PS На крайний случай рассматриваем WordPress, но необходимость создания темы не вдохновляет (очень понравился вид daux.io)

Answer 1

[Антон]

Всем спасибо. Влюбился в Wiki.js ))

Comments

[Тестировщик Реальности]

Довольно забавно, что у них у самих документация на GitBook =)

Answer 2

[Site Developer]

Wiki отмели

Весьма странно, тк этот класс движков как раз и заточен под документацию. Установить-обслуживать не сложнее чем любой другой двиджок, а синтаксис - дело привычки. К любому движку нужно привыкать и учится.

На крайний случай рассматриваем WordPress, но необходимость создания темы не вдохновляет (

Нет такой необходимости. В оф каталоге на сегодня более 4500 тем на любой вкус. (и брать нужно только тут, а не где-то с помоек интернета с вирусами).

Comments

[Антон]

Весьма странно, тк этот класс движков как раз и заточен под документацию. Установить-обслуживать не сложнее чем любой другой двиджок, а синтаксис - дело привычки. К любому движку нужно привыкать и учится.

Да, понимаю. Возможно, действительно, дело привычки, но хотелось бы что-то другое.

Нет такой необходимости.

Как я уже говорил понравилась демо-версия daux.io
Я конечно поищу подобную тему, но очень сомневаюсь что будет...

[Site Developer]

wowgamr: https://wordpress.org/themes/search/wiki/ (ну др ключи для поиска)
и дочерняя тема для изменений.

Answer 3

[bkosun]

https://readthedocs.org/
https://getgrav.org/
https://www.gitbook.com/

Comments

[Антон]

Grav взял на заметку, но не для этого проекта. Спасибо.

Answer 4

[Артем]

github же

Comments

[Антон]

Какой-то костыль чесслово)
Забыл уточнить один момент: нужно ограничивать доступ к документации. Если на своём хостинге сделать это легко, то на гитхабе надо денежку платить.

Answer 5

[xmoonlight]

Если Вы привыкли к WYSIWYG-редакторам, я бы посоветовал использовать ту же Joomla!-у с плагином автоматического кросс-линкинга между статьями, который сам создаёт ссылки, если видит упоминание на уже описанный объект.
Это довольно-таки удобно и Вы пишите в привычных условиях.
Также в Joomla есть создание пользовательских полей для статьи БЕЗ ПЛАГИНОВ, СРАЗУ "ИЗ КОРОБКИ" после установки.

PS: Если нужна помощь - я готов поучаствовать за недорого в создании подобного сайта. (т.к. я сам перевожу разного рода документацию и мне тоже это потребовался бы подобный функционал)

Answer 6

[MgmZog]

Ну если wiki отмели, то наверно нужно попробовать 1C-Bitrix.

Answer 7

[Egor]

Еще один неплохой вариант www.mkdocs.org.
Живой пример использования: docs.armbian.com