AY
AuthorIT, с локализацией -> Sphinx, reStructuredText
Да. Это мне близко
Size: a a a
2020 February 09
AY
А как ты решил проблемы перевода созданного до твоих реформ массива текстов в другой формат?
AY
Help and Manual - у него очень много текстов в каком-то своём формате. И сложная структура проекта
AS
H&M вполне годно собирает docx. Может, как-то в эту сторону подумать?
NV
В целом идея такая: найти промежуточный формат F, чтобы оптимально конвертировать HM -> F -> язык разметки.
NV
У нас это был HTML, но мог бы быть и XML какой-нибудь или даже DOCX (по сути, тоже XML)
AY
Спасибо!
AY
H&M вполне годно собирает docx. Может, как-то в эту сторону подумать?
Хорошая мысль, да
AS
Расскажите потом, что получилось
2020 February 10
А
Коллеги! А есть у кого-то опыт перевода с одного инструмента публикации -на другой? Мне сейчас надо реализовать переезд с Help and Manual - на что-то менее глючное и более простое.
Андрей, расскажите, пожалуйста, почему решили уйти с Help and Manual?
AY
Андрей, расскажите, пожалуйста, почему решили уйти с Help and Manual?
Сложно, проприетарно, глючно. Если вкратце. Подробнее напишу чуть позже
NV
Ещё по нашему опыту с аналогичным AuthorIT: долгая сборка и публикация, много ручных действий, риски всё протерять, изолирует техписателей и не допускает других людей к работе над доками, нет инструмента для ревью
А
Да, в HM тоже инструмент для ревью плохой. И с изоляцией согласен. Но интеграция с Subversion снижает риски, все потерять.
Хотя и других сложностей хватает.
Хотя и других сложностей хватает.
NK
Сегодня мои коллеги из KnowledgeConf пришли на конференцию TeamLeadConf. У них там стенд — участок Полиции Знаний. Если вы на конфе — приходите к ним и чистосердечно признавайтесь. :)
FM
Из всего, чем я пользовался - oxygen XML best of the best.
AY
Андрей, расскажите, пожалуйста, почему решили уйти с Help and Manual?
В продолжение:
1) какие-то свои форматы файлов, которые сложно редактировать, не имея H&M под рукой;
2) очень сложная процедура сборки, часто вылезают непонятные ошибки;
3) часто собирает очень долго, даже слишком долго;
4) сложно с чем-то интегрировать
1) какие-то свои форматы файлов, которые сложно редактировать, не имея H&M под рукой;
2) очень сложная процедура сборки, часто вылезают непонятные ошибки;
3) часто собирает очень долго, даже слишком долго;
4) сложно с чем-то интегрировать
AY
Ещё он очень глючный
S
Здравствуйте. Каким образом используют маркдаун в swagger? Кто-нибудь знает?
S
Можно ли в принципе отказаться от json и yaml в свагере?
DB
Можно ли в принципе отказаться от json и yaml в свагере?
можешь развернуть вопрос?