Size: a a a

DocOps-сообщество

2020 January 27

НН

Нац Нац in DocOps-сообщество
Гетсби на реакте
источник

KC

Kseniya Chudakova in DocOps-сообщество
Ещё есть https://docusaurus.io/en/ на реакте с платным или кастомным поиском, md
источник

RG

Ramil G in DocOps-сообщество
источник

НН

Нац Нац in DocOps-сообщество
Stas Rychkov
Привет, друзья.

Хотим сделать базу знаний.

Замучались мы с иксами, запутались в нулях. Подскажите.

## Хотим возможности:
* установка в частном облаке и on-premise;
* устойчивость к нагрузке (~10 тыс. в день);
* интеграция с Active Directory;
* открытая платформа;
* удобное редактирование (чтобы без консольных git stash apply version)
* хорошая аналитика посещаемости;

Это может быть готовая открытая платформа, а может быть и набор фреймворков.

Посмотрели:

## Платформы
* https://openkm.com
* https://jivesoftware.com

## Статические сайты
* https://gihugo.io
* https://sphinx-doc.org
* https://gatsbyjs.org
* https://jekyllrb.com

## Поиск
* https://sphinxsearch.com
* https://lucene.apache.org

## Хранение данных
* postgresql.org
* mongodb.com

Глаз смотрит в сторону Sphinx + Sphinx Search + PostgreSQL. Но может это в корне не верно. Для базы знаний.

А как правильно? Буду рад советам. Спасибо.
Самый мутный пункт тут - актив директори, по нём ничего не смогу сказать.

После долгих рисёрчей, пришел к выводу, что самое топовое, что сейчас можно сделать, что удовлетворяет всем требованиями — Gatsby (открытый, стойкий, в зависимости от вашего железа, разворачивайте где хотите), но самая tricky часть - удобное редактирование. Нормальных цмс-ок для ssg раз два и обчёлся, поэтому берём CMS-ку от Ghost, т.к она самая развитая и лепится очень хорошо (есть шаблоны готовые) через GraphQL к Gatsby.

Я щупал Netlify CMS в связке с Hugo, там вот всё как надо, три столбца с draft, in progress, published, при перетягивании из столбца в столбец, на фоне происходит пулл реквест и всякое такое, но сама по себе цмс-ка сыровата, хоть и довольно шустро развивается. Еще есть штуки типа Bookstack, если вы втиснитесь в рамки предлагаемых фич - может зайти.
источник

AY

Andrei Yemelianov in DocOps-сообщество
Нац Нац
Самый мутный пункт тут - актив директори, по нём ничего не смогу сказать.

После долгих рисёрчей, пришел к выводу, что самое топовое, что сейчас можно сделать, что удовлетворяет всем требованиями — Gatsby (открытый, стойкий, в зависимости от вашего железа, разворачивайте где хотите), но самая tricky часть - удобное редактирование. Нормальных цмс-ок для ssg раз два и обчёлся, поэтому берём CMS-ку от Ghost, т.к она самая развитая и лепится очень хорошо (есть шаблоны готовые) через GraphQL к Gatsby.

Я щупал Netlify CMS в связке с Hugo, там вот всё как надо, три столбца с draft, in progress, published, при перетягивании из столбца в столбец, на фоне происходит пулл реквест и всякое такое, но сама по себе цмс-ка сыровата, хоть и довольно шустро развивается. Еще есть штуки типа Bookstack, если вы втиснитесь в рамки предлагаемых фич - может зайти.
с Active Directory будут серьёзные проблемы
я никогда такого не делал и не сталкивался
сейчас попробую у коллеги спросить
источник

NV

Nick Volynkin in DocOps-сообщество
Stas Rychkov
Привет, друзья.

Хотим сделать базу знаний.

Замучались мы с иксами, запутались в нулях. Подскажите.

## Хотим возможности:
* установка в частном облаке и on-premise;
* устойчивость к нагрузке (~10 тыс. в день);
* интеграция с Active Directory;
* открытая платформа;
* удобное редактирование (чтобы без консольных git stash apply version)
* хорошая аналитика посещаемости;

Это может быть готовая открытая платформа, а может быть и набор фреймворков.

Посмотрели:

## Платформы
* https://openkm.com
* https://jivesoftware.com

## Статические сайты
* https://gihugo.io
* https://sphinx-doc.org
* https://gatsbyjs.org
* https://jekyllrb.com

## Поиск
* https://sphinxsearch.com
* https://lucene.apache.org

## Хранение данных
* postgresql.org
* mongodb.com

Глаз смотрит в сторону Sphinx + Sphinx Search + PostgreSQL. Но может это в корне не верно. Для базы знаний.

А как правильно? Буду рад советам. Спасибо.
А зачем Active Directory? Нужно управление доступом?
источник

KC

Kseniya Chudakova in DocOps-сообщество
Нац Нац
Самый мутный пункт тут - актив директори, по нём ничего не смогу сказать.

После долгих рисёрчей, пришел к выводу, что самое топовое, что сейчас можно сделать, что удовлетворяет всем требованиями — Gatsby (открытый, стойкий, в зависимости от вашего железа, разворачивайте где хотите), но самая tricky часть - удобное редактирование. Нормальных цмс-ок для ssg раз два и обчёлся, поэтому берём CMS-ку от Ghost, т.к она самая развитая и лепится очень хорошо (есть шаблоны готовые) через GraphQL к Gatsby.

Я щупал Netlify CMS в связке с Hugo, там вот всё как надо, три столбца с draft, in progress, published, при перетягивании из столбца в столбец, на фоне происходит пулл реквест и всякое такое, но сама по себе цмс-ка сыровата, хоть и довольно шустро развивается. Еще есть штуки типа Bookstack, если вы втиснитесь в рамки предлагаемых фич - может зайти.
а сам какую используешь CMS-ку  и в связке с чем?
источник

НН

Нац Нац in DocOps-сообщество
Nick Volynkin
А зачем Active Directory? Нужно управление доступом?
Если вопрос в управлении доступом, то гетсби это умеет, там есть спец плагины (чего, смею заметить, нету почти ни у каких других ssg), прийдется сервером всё решать
источник

НН

Нац Нац in DocOps-сообщество
Kseniya Chudakova
а сам какую используешь CMS-ку  и в связке с чем?
Никакую, это заказчик испугался слов markdown и vscode и попросил сделать штоб прям в бровзере всё писать, мне хватает vscode + markdown preview enhanced + gitlens + github pull requests
источник

НН

Нац Нац in DocOps-сообщество
но планирую расчехлиться с той, про которую писал выше, но там код кодировать прийдется всё равно
источник

KC

Kseniya Chudakova in DocOps-сообщество
Нац Нац
Никакую, это заказчик испугался слов markdown и vscode и попросил сделать штоб прям в бровзере всё писать, мне хватает vscode + markdown preview enhanced + gitlens + github pull requests
"штоб прям в бровзере всё писать" в техписательский цитатник
источник

AY

Andrei Yemelianov in DocOps-сообщество
Kseniya Chudakova
"штоб прям в бровзере всё писать" в техписательский цитатник
+++
источник

AY

Andrei Yemelianov in DocOps-сообщество
мне тоже понравилось
источник

KC

Kseniya Chudakova in DocOps-сообщество
Нац Нац
но планирую расчехлиться с той, про которую писал выше, но там код кодировать прийдется всё равно
надо ресёрч всего этого дела устроить
источник

НН

Нац Нац in DocOps-сообщество
Там у людей до этого был конфлюенс, в котором что-то редактируешь и оно всё сразу на живой сайт в продакшн улетает 🤷‍♀️
источник

AY

Andrei Yemelianov in DocOps-сообщество
@glu0n , увы, мои коллеги ничего не знают про интеграцию с Active Directory - опыта нет
источник

KC

Kseniya Chudakova in DocOps-сообщество
Нац Нац
Если вопрос в управлении доступом, то гетсби это умеет, там есть спец плагины (чего, смею заметить, нету почти ни у каких других ssg), прийдется сервером всё решать
Плагины, если что и подпилить можно. А использование Active Directory, с первого взгляда кажется избыточным.
источник

НН

Нац Нац in DocOps-сообщество
Kseniya Chudakova
Плагины, если что и подпилить можно. А использование Active Directory, с первого взгляда кажется избыточным.
У меня как раз была таска с ограничением прав на связке netlify cms+ hugo, чтобы юзер доки жили в одном (открытом) месте, а девелоперские - под замочком. Решается это или средставми aws, где всё потом будет жить, либо средствами самой netlify (не cms, а самого их хостинга, они как раз предоставляют такую опцию), плагины писать деняг нада, да и там не самая простая штука, но если есть финансы, наверняка можно придумать что-то
источник

SR

Stas Rychkov in DocOps-сообщество
Ребята, спасибо вам за ваши советы и правильные вопросы!
источник

SR

Stas Rychkov in DocOps-сообщество
Maria Ermakovich
> ~10 тыс. в день
открытий страниц, сёрчей, посетителей?
Прикидываем, что уникальных посещений. Хотелось услышать, много это или, например, не важно, 5 тыс., 10 тыс. или 100. Может не в этом для таким веб-систем бутылочное горлышко.
источник