AZ
обмазываешь код doxygen, пакетишь в conan\vcpkg, и при пуше оно сразу генерит доку из кода и публикует в docs.cpp
Size: a a a
2020 November 14
AM
но в любом случае - такого инструмента я не знаю. скорее всего придется что-то колхозить
соглашусь!
AZ
обмазываешь код doxygen, пакетишь в conan\vcpkg, и при пуше оно сразу генерит доку из кода и публикует в docs.cpp
@antoshkka вот можешь в яндексе эту идею протолкнуть. ВЕСЬ С++ МИР тебе спасибо скажет
AZ
* который согласится конечно пакетить свои либы в Conan/vcpkg
AP
Блин, пошёл колхозить (
Боюсь что уражай нормальных доков будет только к лету (
Боюсь что уражай нормальных доков будет только к лету (
D
@antoshkka вот можешь в яндексе эту идею протолкнуть. ВЕСЬ С++ МИР тебе спасибо скажет
Это точно
AZ
Это точно
жаль, что это всего лишь влажные мечты. и шансы на это примерно такие же, как и на что-то дельное от группы тулинга в комитете
AM
Блин, пошёл колхозить (
Боюсь что уражай нормальных доков будет только к лету (
Боюсь что уражай нормальных доков будет только к лету (
(((
Ушел плакать..
Ушел плакать..
D
жаль, что это всего лишь влажные мечты. и шансы на это примерно такие же, как и на что-то дельное от группы тулинга в комитете
А группа тулинга чем-то занимается?
AZ
А группа тулинга чем-то занимается?
:)
AZ
ну вот в слаке последнее сообщение было 25 сентября. на него так и не ответили - це был вопрос. до этого следующее сообщение было 22 августа
AZ
Работа кипит, так сказать
TS
Подскажите кто в теме:
Есть doxygen разметка C++ кода, есть github wiki. Хочется их подружить и сделать нормальную документацию для C++ фреймворка в gh-pages, попутно натянув нормальную тему на полученную документацию
Что-то готовое есть для этого?
Есть doxygen разметка C++ кода, есть github wiki. Хочется их подружить и сделать нормальную документацию для C++ фреймворка в gh-pages, попутно натянув нормальную тему на полученную документацию
Что-то готовое есть для этого?
Sphinx, Breathe (как сделал Виктор Зверович, например). Но wiki тут мимо (да вики и невозможно использовать для коллабораций с внешними)
TS
Это ближайший аналог
Хахаха
DF
Тимур а можно вам в ЛС написать?
AP
Sphinx, Breathe (как сделал Виктор Зверович, например). Но wiki тут мимо (да вики и невозможно использовать для коллабораций с внешними)
Я вчера попробовал, и мне не понравилось
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
CD
Я вчера попробовал, и мне не понравилось
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
Найдите техписа в яндексе ближайшего и обрисуйте ему задачу, он скажет про инструменты (они точно у вас есть :) )
AP
Найдите техписа в яндексе ближайшего и обрисуйте ему задачу, он скажет про инструменты (они точно у вас есть :) )
Да я так и хотел сделать, а потом заметил что сегодня суббота )
AP
+ есть сомнения, что техписы знакомы с doxygen и как его вкорячивать
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
CD
+ есть сомнения, что техписы знакомы с doxygen и как его вкорячивать
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
документация API один из базовых компонентов их работы, а как они doxygen и markdown-ы дружат скорее всего они знают