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

Товрищи библиотекописатели С помощью чего вы делаете документацию?

13 ответов

28 просмотров

Не делаем( а надо бы

doxygen ?

отказываюсь от комментариев

Не пишу, но варианта два - либо Doxygen либо Sphinx

Danya🔥- Автор вопроса
Макс Воробьев
doxygen ?

Некрасивый сайтик выходит Мусорить комментариями в коде не очень хочется, хотя удобно..

Danya🔥- Автор вопроса
Alexander Karaev
sphinx? с красивой sphinx_book_theme

Ну я думал, да Но красивого там мало Думаю docusaurus.io воспользоваться

Danya🔥
Ну я думал, да Но красивого там мало Думаю docusau...

Если найдёшь что-нибудь красивое, пингани. Или если получится что-то с https://docusaurus.io/. Я в своё время разочаровался и остался на сфинксе

Danya🔥- Автор вопроса
Alexander Karaev
Если найдёшь что-нибудь красивое, пингани. Или есл...

Пингану Сейчас буду пытаться docusarus тыкать Скажи, норм если я в мейне буду держать исходники к документации?

Danya🔥
Пингану Сейчас буду пытаться docusarus тыкать Скаж...

Не вижу проблем. У многих проектов есть папка /docs. При этом сгенерированный сайт по документации обычно в отдельной ветке

Danya🔥- Автор вопроса
Alexander Karaev
Не вижу проблем. У многих проектов есть папка /doc...

Ну я вместе с сайтом хочу хранить в мастере

Danya🔥
Некрасивый сайтик выходит Мусорить комментариями в...

можно попробовать подкрутить https://www.doxygen.nl/manual/customize.html

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

Обсуждают сегодня

Господа, а что сейчас вообще с рынком труда на делфи происходит? Какова ситуация?
Rꙮman Yankꙮvsky
29
А вообще, что может смущать в самой Julia - бы сказал, что нет единого стандартного подхода по многим моментам, поэтому многое выглядит как "хаки" и произвол. Короче говоря, с...
Viktor G.
2
30500 за редактор? )
Владимир
47
а через ESC-код ?
Alexey Kulakov
29
Гайс, вопрос для разносторонее развитых: читаю стрим с юарта, нада выделять с него фреймы с определенной структурой, если ли чо готовое, или долбаться с ринг буффером? нада у...
Vitaly
9
Чёт не понял, я ж правильной функцией воспользовался чтобы вывести отладочную информацию? но что-то она не ловится
notme
18
У меня есть функция где происходит это: write_bit(buffer, 1); write_bit(buffer, 0); write_bit(buffer, 1); write_bit(buffer, 1); write_bit(buffer, 1); w...
~
14
Добрый день! Скажите пожалуйста, а какие программы вы бы рекомендовали написать для того, чтобы научиться управлять памятью? Можно написать динамический массив, можно связный ...
Филипп
7
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
длина пакета фиксированная, или меняется?
Okhsunrog
7
Карта сайта