Size: a a a

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

2021 February 22

GR

Gabriela Rondon in DocOps-сообщество
😂😂😂
источник
2021 March 02

AY

Andrei Yemelianov in DocOps-сообщество
Всем привет!
Ситуация такая:  есть исходник документа в формате Markdown.  Из этого исходника c помощью pandoc собирается документ в PDF и HTML. При этом в тексте есть абзацы, которые должны попадать только в HTML-версию, а в PDF — не должны.  Как сделать, чтобы часть текста попадала в собранный документ только при соблюдении определённых условий (например, чтобы именно этот конкретный абзац попадал именно в PDF, а в HTML не попадал)?
Решал ли кто-нибудь такую задачу?
источник

AY

Andrei Yemelianov in DocOps-сообщество
как это лучше сделать?
источник

AY

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

А

Александр Мокрушин... in DocOps-сообщество
У Фолианта есть препроцессор Flags
https://foliant-docs.github.io/docs/preprocessors/flags/
источник

AY

Andrei Yemelianov in DocOps-сообщество
о, спасибо!
источник

v

vito in DocOps-сообщество
Andrei Yemelianov
читал про препроцессор filepp
источник

FM

Fox Mulder in DocOps-сообщество
Кто хочет мозговой штурм?
Есть gradle, есть pandoc.
Как выяснилось, градле не хочет делать  >2 exec.
Всегда обрабатывается самый последний таск.
Ответ: делать таск в таске не подходит, так как пакетная конвертация может обрабатывать > 10 файлов.
источник

NV

Nick Volynkin in DocOps-сообщество
Завернуть в Makefile!
источник

NV

Nick Volynkin in DocOps-сообщество
либо сделать корневую таску в gradle и в ней условиями/зависимостями/шагами указать остальные таски в нужном порядке
источник

FM

Fox Mulder in DocOps-сообщество
Вот как раз второй и пыталсч
Я. Не пашет
источник
2021 March 03

J

Jonny Cuba in DocOps-сообщество
Коллеги, делаем большой проект на опенсорс для госзаказчика. Сейчас рассматриваем варианты и возможности автогенерации документации из кода. Какие технологии и инструменты сейчас актуальны? 100% импортозамещение  т.е  не платные буржуазные. Пока видел только jawadoc и swagger
источник

S

Sergey in DocOps-сообщество
лучшая документация это сам код и есть :)
источник

FM

Fox Mulder in DocOps-сообщество
Я могу быть не прав, но с каких пор jawadoc и swagger - 100% импортозамещение
источник

V

Vasiliy in DocOps-сообщество
Jonny Cuba
Коллеги, делаем большой проект на опенсорс для госзаказчика. Сейчас рассматриваем варианты и возможности автогенерации документации из кода. Какие технологии и инструменты сейчас актуальны? 100% импортозамещение  т.е  не платные буржуазные. Пока видел только jawadoc и swagger
doxygen?
источник

J

Jonny Cuba in DocOps-сообщество
Fox Mulder
Я могу быть не прав, но с каких пор jawadoc и swagger - 100% импортозамещение
Они вроде с открытой лицензией? Если да, то подойдут
источник

J

Jonny Cuba in DocOps-сообщество
Vasiliy
doxygen?
Swagger
Javadoc  
DOXYGEN
SPHINX
NATURAL DOCS
источник

FM

Fox Mulder in DocOps-сообщество
Jonny Cuba
Они вроде с открытой лицензией? Если да, то подойдут
лицензия Apache говорит что продукт должен иметь упоминание компании-разработчика. Иначе это торрент-эдишен )
источник

J

Jonny Cuba in DocOps-сообщество
Fox Mulder
лицензия Apache говорит что продукт должен иметь упоминание компании-разработчика. Иначе это торрент-эдишен )
ну это не пугает, упомянуть можно)
источник

L

Lex in DocOps-сообщество
Jonny Cuba
Swagger
Javadoc  
DOXYGEN
SPHINX
NATURAL DOCS
DocFX
источник