Russian Qt Forum

Qt => Вопросы новичков => Тема начата: QuAzI от Февраль 22, 2012, 23:23



Название: Qt Help через Doxygen
Отправлено: QuAzI от Февраль 22, 2012, 23:23
Совсем запарился.
Doxygen создаёт директорию html в которую пихает кучу html-хлама, и создаёт в нём index.qhp
Отдельно создаётся директория qch, содержащая qch-файл по имени класса.
Файлов qhc и qhcp нет вообще. Без qhc ассистент никаким боком не отображает справку (тобишь qch). Приходится ручками создавать qhcp и уже из него запускать ручками команду создания qch.
За сим вопрос: а как вы воюете с документацией? Как настраиваете doxygen или чем дополнительно проходитесь для автогенерации всех файлов? И главное - а какие файлы справки реально нужно потом с собранным приложением тягать. Я как-то думал что qch-файла должно хватать, но т.к. ничего толком из него отобразить в QTextBrowser не получилось и Qt Assistant с ним в упор не работает, что-то я в ступоре. Если нужны ещё какие-то файлы, то по идее должен же их сам doxygen был генерить.
И в экземплах то через ассистент всё тянется (что не есть красиво, не хотелось бы его с прогой тягать), то через qhc (которого на выхлопе doxygen нет, а есть qch).

Сделал чтобы справку тянуло из qhc, первую страницу показывает, а при переходе на любую другую выдаёт
Код:
QTextBrowser: No document for class.html
Тоесть он пытается искать html-файлы мимо qch-архива. Тогда не ясно, как он первую страницу из qch вытянул (директорию html не подкидывал к отлаживаемому проекту специально чтобы с qch разобраться)


Название: Re: Qt Help через Doxygen
Отправлено: QuAzI от Февраль 24, 2012, 13:04
Ну хоть подскажите, как добавить конкретный кусок для поиска в keywords ? Запихнул например в хедер краткое описание, в справку оно попадает, но по тегу "About" найти не могу, соответственно вызвать из меню "О программе" напрямую, чтобы не клацать по всей справке, не получается.
Код:
/*! \mainpage About
 ... бла бла бла, про прогу...
*/