Size: a a a

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

2020 January 26

ME

Maria Ermakovich in DocOps-сообщество
Нац Нац
Полувшутку, комнада кат слепляет файлы, может есть трюк какой-то подходящий
в md файлах же всю нумерацию в списках можно сделать цифрой 1.
источник

ME

Maria Ermakovich in DocOps-сообщество
а потом когда генеришь из них почти везде, генерится правильная нумерация
источник

ME

Maria Ermakovich in DocOps-сообщество
по крайней мере в Docusaurus и Typora так :D
источник

RG

Ramil G in DocOps-сообщество
Maksim Lapshin
подскажите пожалуйста: у меня  сейчас  есть набор требований, они лежат в отдельных файликах.

Я хочу настроить генерацию из них единого файла в стиле гостдаун.

Т.е. мне хочется сделать из них сквозную нумерацию.

Я смотрю на маркдаун, аскидок и прочее и у меня возникает ощущение, что за предыдущую тысячу лет ничего кроме латеха тут рабочего не придумали =(

Может быть я ошибаюсь и есть способ  как-то перекомпоновать  файлы со сквозной нумерацией?

Я себе  вижу решение так:

делаем файл с содержимым вида:

include  useless_unreadable_gost_header.txt
include doc/text1.txt
include doc/text2.txt
include doc/text3.txt
include useless_unreadable_gost_footer.txt


Может я упускаю что и есть достаточно мощные инструменты для обработки таких шаблонов?
Все-таки, нумерация в гостоподобных документах не так уж проста.  Удобно делается только в латехе.  В ворде/либре постоянная борьба и боль.  Мне видится генерация латеха из asciidoc при помощи пандок.
источник

ML

Maksim Lapshin in DocOps-сообщество
Ramil G
Все-таки, нумерация в гостоподобных документах не так уж проста.  Удобно делается только в латехе.  В ворде/либре постоянная борьба и боль.  Мне видится генерация латеха из asciidoc при помощи пандок.
Удивительно. В 2005-м мой однокурсник перебрал все существующие системы документации и остановился на латехе: в нем он сделал single source. Неужели все там же осталось :((
источник

RG

Ramil G in DocOps-сообщество
Maksim Lapshin
Удивительно. В 2005-м мой однокурсник перебрал все существующие системы документации и остановился на латехе: в нем он сделал single source. Неужели все там же осталось :((
Ну asciidoc вполне развит в части функций.
источник

RG

Ramil G in DocOps-сообщество
Ramil G
Ну asciidoc вполне развит в части функций.
Есть инклюды, но вроде нету отдельных именованных рядов нумераций, как в латехе
источник

RG

Ramil G in DocOps-сообщество
Коллеги, а кто как хранит и синхронизирует бинарные файлы? Нужно типа файлошары для Команды. Дропбокс, onedrive не предлагать - внешние сервисы. Пробовали в onenote  через sharepoint - Не умеет синкать только изменённые файлы, синкает весь блокнот. Аттачить  в конфлюенс неудобно и ненаглядно.  Смотрю на git lfs либо на seafile, synthing
источник

L

Lana in DocOps-сообщество
Ramil G
Коллеги, а кто как хранит и синхронизирует бинарные файлы? Нужно типа файлошары для Команды. Дропбокс, onedrive не предлагать - внешние сервисы. Пробовали в onenote  через sharepoint - Не умеет синкать только изменённые файлы, синкает весь блокнот. Аттачить  в конфлюенс неудобно и ненаглядно.  Смотрю на git lfs либо на seafile, synthing
Git LFS звучит как подходящее решение, да
источник

RG

Ramil G in DocOps-сообщество
Lana
Git LFS звучит как подходящее решение, да
Кто пользовался? Что там со скоростью?
источник

ML

Maksim Lapshin in DocOps-сообщество
Ramil G
Кто пользовался? Что там со скоростью?
Прекрасно.
источник

ML

Maksim Lapshin in DocOps-сообщество
Git lfs годится для хранения сборок приложений
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Maksim Lapshin
подскажите пожалуйста: у меня  сейчас  есть набор требований, они лежат в отдельных файликах.

Я хочу настроить генерацию из них единого файла в стиле гостдаун.

Т.е. мне хочется сделать из них сквозную нумерацию.

Я смотрю на маркдаун, аскидок и прочее и у меня возникает ощущение, что за предыдущую тысячу лет ничего кроме латеха тут рабочего не придумали =(

Может быть я ошибаюсь и есть способ  как-то перекомпоновать  файлы со сквозной нумерацией?

Я себе  вижу решение так:

делаем файл с содержимым вида:

include  useless_unreadable_gost_header.txt
include doc/text1.txt
include doc/text2.txt
include doc/text3.txt
include useless_unreadable_gost_footer.txt


Может я упускаю что и есть достаточно мощные инструменты для обработки таких шаблонов?
Не совсем понятно, что значит сквозная нумерация. Если у каждого из требований свой заголовок, то они естественным образом переименуются. При необходимости, при вставке в главный файл можно менять уровень заголовка.

Если нужно что-то ручное, то в asciidoc есть специальный атрибут "счетчик", который каждый раз принимает новое значение. Счетчик может быть именованным. Можно также сбрасывать счетчик. Т.е. если у нас несколько файлов требований и они с помощью директивы include включены в единый документ, то нумерация будет сквозная. Или не сквозная (по желанию) или это может переключаться атрибутом в главном файле.
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Ramil G
Все-таки, нумерация в гостоподобных документах не так уж проста.  Удобно делается только в латехе.  В ворде/либре постоянная борьба и боль.  Мне видится генерация латеха из asciidoc при помощи пандок.
Возможно, у меня неудачный опыт. Но, во-первых, asciidoc pandoc'ом ужасно берется, лучше тогда сначала при помощи asciidoctor сделать docbook, а затем в pandoc. Во вторых, не совсем понятно, как tex в этом случае будет содержать необходимую мета-информацию для нумерации.
источник

СФ

Семён Факторович in DocOps-сообщество
источник
2020 January 27

rd

rus dacent in DocOps-сообщество
Ramil G
Коллеги, а кто как хранит и синхронизирует бинарные файлы? Нужно типа файлошары для Команды. Дропбокс, onedrive не предлагать - внешние сервисы. Пробовали в onenote  через sharepoint - Не умеет синкать только изменённые файлы, синкает весь блокнот. Аттачить  в конфлюенс неудобно и ненаглядно.  Смотрю на git lfs либо на seafile, synthing
NextCloud
источник

SR

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

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

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

## Хотим возможности:
* установка в частном облаке и 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. Но может это в корне не верно. Для базы знаний.

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

ME

Maria Ermakovich 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. Но может это в корне не верно. Для базы знаний.

А как правильно? Буду рад советам. Спасибо.
> ~10 тыс. в день
открытий страниц, сёрчей, посетителей?
источник

L

Lana 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. Но может это в корне не верно. Для базы знаний.

А как правильно? Буду рад советам. Спасибо.
Можно для начала ответить на два вопроса: на каком языке у вас есть разработчики (чтобы кастомизировать) 2. На какой размотке хочется писать, если есть предпочтения
источник

L

Lana in DocOps-сообщество
Ибо gatsby на руби, Sphinx на питоне, а Hugo на go
источник