|
Название: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 10:44 Раньше обходился без него, сейчас потребовалось. Надо сделать выход на русском, комменты тоже на русском. Использую виндозную версию 1.8.6 с сайта разработчика. Для начала пробую получить RTF. Запустил Doxygen GUI, в визарде сначала настроил маршруты, потом Run. Получил каталог rtf, в нём документы с нечитаемыми русскими текстами и всём остальном на английском. В Expert добавил cp1251 в поля DOXYFILE_ENCODING и INPUT_ENCODING, указал OUTPUT_LANGUAGE Russian. Больше ничего не менял. Нажимаю на Run - простыня сообщений, в конце
error: <мой файл>: failed to translate characters from cp1251 to UTF-8: check INPUT_ENCODING Каталог rtf пустой. Что я делаю не так? Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 11:34 вариант сделать исходники в utf8 не рассматривается?
Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 11:37 нет
Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 12:31 нет и хорошо... оно всё равно не поможет =)error: <мой файл>: failed to translate characters from cp1251 to UTF-8: check INPUT_ENCODING этого быть было не должно, если они в 1251... может они и так в utf8?про rtf... похоже проблема в самом генераторе rtf... на выходе у него вот такая бабуйня \'D0\'A1, вместо положенного utf16-го \u1057. Ни каких похожих опций для его настройки я не нашёл, так что ИМХО — баг... Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 12:35 в исходниках комменты в cp1251, это совершенно точно
а генератор RTF как-то сработал без задания кодировки и языка выхода, файлов насоздавал, но после задания - никак вообще, пустой выходной каталог Название: Re: Изучаю doxygen, есть вопросы... Отправлено: VPS от Март 25, 2014, 12:52 А с предыдущей версией doxygen пробовали сгенерировать документацию?
П.С.: на 1.8.3 вроде нормально отрабатывает... Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 13:04 а может кто-нибудь на 1.8.6 аналогичное проверить, у кого уже установлена? а то как-то туда-сюда сносить-ставить, не очень хочется
оппа... и при выходе из программы с записью Doxyfile получил GPF дыряво :( Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 13:55 Убрал cp1251 из кодировки, оставил только Language Russian. И сработало - сгенерились документы, все тексты читаются. Вот тебе, бабушка, и Юрьев день... ???
Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 14:10 но всё равно косяк - почему-то в RTF нет номеров страниц, и соответственно, в оглавлениях и текстовых ссылках написано pagenum вместо номеров
и в настройках RTF или где-либо еще нет опции записи номеров страниц Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 14:25 Убрал cp1251 из кодировки, оставил только Language Russian. И сработало - сгенерились документы, все тексты читаются. Вот тебе, бабушка, и Юрьев день... ??? мда... прям чёрная магия...я забыл Language = Russian включить... правда у меня подзаголовки, например «Возвращаемое значение» для функций всё равно ломаются... но всё равно косяк - почему-то в RTF нет номеров страниц, и соответственно, в оглавлениях и текстовых ссылках написано pagenum вместо номеров у меня номера страниц есть, в либроффисе отображаются... но оглавление вообще не генерируется...и в настройках RTF или где-либо еще нет опции записи номеров страниц Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 14:34 подзаголовки - да, ломаются, но не все, не могу пока определить, в каких именно случаях
ВРУ! есть номера страниц, не там искал, они справа внизу страницы, а я искал наверху но в алфавитных указателях и ссылках их нет, только pagenum на их местах я под оглавлением имел в виду несколько алфавитных указателей а как такового, самого Оглавления нет, есть только его заголовок и пустая страница Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 15:08 подзаголовки - да, ломаются, но не все, не могу пока определить, в каких именно случаях у меня перестали после перекодировки исходника в utf-8...но в алфавитных указателях и ссылках их нет, только pagenum на их местах у меня: «Ошибка: источник перёкрестной ссылки не найден»... что в общем то тоже самое...ЗЫ: а откуда такая потребность генерировать именно rtf? Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 25, 2014, 15:21 ЗЫ: а откуда такая потребность генерировать именно rtf? Надо включить приличный кусок текста в другую документацию, которую делают другие люди на Офисе. Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 15:52 Надо включить приличный кусок текста в другую документацию, которую делают другие люди на Офисе. в качестве извращения, можно сгенерировать в тех, а потом перегнать в rtf... но факт успеха не гарантирую...Кстати, Цитата: из доков Note that the RTF output probably only looks nice with Microsoft's Word. If you have success with other programs, please let me know. у тебя MS'овский?Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Fat-Zer от Март 25, 2014, 16:22 в качестве извращения, можно сгенерировать в тех, а потом перегнать в rtf... но факт успеха не гарантирую... не.... не слушай... идея глупая...Название: Re: Изучаю doxygen, есть вопросы... Отправлено: Гурман от Март 26, 2014, 08:00 Цитата: из доков Note that the RTF output probably only looks nice with Microsoft's Word. If you have success with other programs, please let me know. у тебя MS'овский?офис мелкомягкий используется, пытались на Либре делать, не получается, есть проблемы с форматированием по ЕСПД Цитата: author=Fat-Zer идея глупая зачем вообще что-то, если нужно просто copy-paste Название: Re: Изучаю doxygen, есть вопросы... Отправлено: ustsv от Апрель 03, 2014, 16:57 Тоже делаю RTF документ из исходников, нашел, что SHOW_NAMESPACES=NO напрочь ломает генерацию нормального RTF, хотя HTML создается.
Код: error: problems opening rtf file namespaces.rtf for reading Возник вопрос как убрать из графа вызовов функции, которые doxygen берет из строки connect() и добавить граф для emit, или лучше всех SIGNAL-SLOT? И в RTF ставить картинки с подписями, а не текст-картинка? |