Seite 1 von 1

Doxygen externen Link zur Qt-Hilfe

Verfasst: 15. Juli 2014 12:13
von Pixtar
Hallo Community,

in der Version Qt4.x.x gab es die Hilfedateien als HTML aus denen man sich ein TAGFILE erstellen konnte (qt.tag). TAGFILE in Doxygen einbinden und schon wurden alle Klassen wie QWidget zu aktuellen Qt-Hilfe gelinkt. Fertig.

Habe mir jetzt die Finger wund gegoogled, aber nichts weiteres zu diesem Problem gefunden, deshalb dieser Thread.

Qt5.x.x besitzt alle Hilfedateien nurnoch als qch, welche ich nicht zu einem TAGFILE verarbeiten kann.

Es muss doch mit der aktuellen Doxygen und Qt Version möglich sein, seine eigene Dokumentation auf die Qt-Dokumentation Verweisen zu lassen. Vorallem unter dem Aspekt, dass Doxygen mitlerweile Qt-Support hat und umgekehrt auch. Ich verstehe das nicht. Qt-Source ziehen, entpacken und mit Doxygen selbst ein TAGFILE erstellen geht halt eben auch nicht mehr, da im Source auch nurnoch QtDoc-Dateien rumhampeln. :-O

Grüße,
pixtar

PS: Ja ich weiß, dass es mitlerweile QtDoc gibt mit dem man auch Dokumentationen erstellen kann - aber das kommt für meine Projekte gerade nicht in Frage, weil alle bereits in Doxygen-Style dokumentiert sind.

-------NACHTRAG-------
Notfalls erstelle ich mir das TAGFILE aus den qdoc-Dateien, nachdem ich die Hilfe als HTML erstellt habe, aber ich komme auch hier nicht vorwärts.
Ich denke folgendes File ist DIE Dokumentationsdatei: qt-everywhere-opensource-src-5.2.1\qtbase\doc\global\qt-module-defaults-offline.qdocconf
Folgender Befehl dazu erstellt mir eine .index-Datei anstatt eine HTML-Datei: qdoc "C:\qt-everywhere-opensource-src-5.2.1\qtbase\doc\global\qt-module-defaults-offline.qdocconf" -outputdir html
Muss man die Indexdatei ab hier jetzt noch weiterverwursten?!

Re: Doxygen externen Link zur Qt-Hilfe

Verfasst: 15. Juli 2014 15:20
von Pixtar
Hiho,

sorry für den Doppelpost, aber ich bin ein großes Stück weiter.

Die *.pdocconf-Datei für die QtWidgets liegt unter:
"C:\qt-everywhere-opensource-src-5.2.1\qtbase\src\widgets\doc\qtwidgets.qdocconf"

Diese Datei habe ich jetzt durch die qdoc.exe gejagt und in die *.qdocconf-Datei um den Parameter "tagfile" erweitert:
tagfile= ./html/qtwidgets.tags

Dieses Tagfile habe ich jetzt meiner *.doxygen-Datei beigefügt:
TAGFILES = C:\qt-everywhere-opensource-src-5.2.1\qtbase\src\widgets\doc\html\qtwidgets.tags=http://qt-project.org/doc/qt-5

Jetzt werden alle im Namespace von QtWidgets vorhandenen Klassen wie z. B. QToolTip auf die Online-Dokumentation referenziert.


Wenn jetzt jemand weiß, WO die *.qdocconf-Datei für die GESAMTE Qt-Dokumentation liegt oder wie ich ALLE Namespaces in einem Tagfile versenken kann wäre ich überglücklich. :D

Grüße,
Mike

Re: Doxygen externen Link zur Qt-Hilfe

Verfasst: 28. August 2014 16:25
von hilefoks
Wenn du den Qt Quellcode ausgecheckt haben solltest, dann:

Code: Alles auswählen

./configure -prefix $PWD/qtbase -opensource && make docs
Danach sollten alle Dateien in qtbase/doc/qtxxx zu finden sein.

Falls dir zur Zeit auch die Tags-Dateien von Qt 5.2 reichen, dann findest du hier welche (und eine Ebene höher gibt es entsprechende Qt 4 Dateien).

MfG
Hilefoks