Подскажите кто в теме: Есть doxygen разметка C++ кода, есть github

Question

Подскажите кто в теме: Есть doxygen разметка C++ кода, есть github

wiki. Хочется их подружить и сделать нормальную документацию для C++ фреймворка в gh-pages, попутно натянув нормальную тему на полученную документацию

Что-то готовое есть для этого?

#c++ #embedded #programming #russian

0

14.11.2020

8 ответов

18 просмотров

Alexander Malkov

во, я надеюсь - это про Userver?)

0

14.11.2020

🐙 Antony Polukhin Автор вопроса

Alexander Malkov
во, я надеюсь - это про Userver?)

:)

0

14.11.2020

Timur Safin

Sphinx, Breathe (как сделал Виктор Зверович, например). Но wiki тут мимо (да вики и невозможно использовать для коллабораций с внешними)

0

14.11.2020

🐙 Antony Polukhin Автор вопроса

Timur Safin
Sphinx, Breathe (как сделал Виктор Зверович, напри...

Я вчера попробовал, и мне не понравилось Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)

0

14.11.2020

Constantine Drozdov

🐙 Antony Polukhin
Я вчера попробовал, и мне не понравилось Как я по...

Найдите техписа в яндексе ближайшего и обрисуйте ему задачу, он скажет про инструменты (они точно у вас есть :) )

0

14.11.2020

🐙 Antony Polukhin Автор вопроса

Constantine Drozdov
Найдите техписа в яндексе ближайшего и обрисуйте е...

Да я так и хотел сделать, а потом заметил что сегодня суббота )

0

14.11.2020

Timur Safin

🐙 Antony Polukhin
Я вчера попробовал, и мне не понравилось Как я по...

Основная претензия у доксигену - стиль веб сайта 20летней давности. Сфинкс с readthedocs темой позволяет это исправить. К сожалению Breathe(ссылки на Доксиген) надо кропотливо интегрировать в RST и много ручной работы за пределами доксиген блоков, и Exhale как-то это не решает. Но Всё привыкли к readthedocs теме, и игра стоит свеч

0

14.11.2020

Alexander "SonnySlave" Zaitsev · Accepted Answer

Alexander "SonnySlave" Zaitsev

что-то вроде такого? https://github.com/piconomix/doxygen-github-markdown-theme

0

14.11.2020

170 похожих чатов

Подскажите кто в теме: Есть doxygen разметка C++ кода, есть github

8 ответов

Похожие вопросы