Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Groups
  • Search
  • Get Qt Extensions
  • Unsolved
Collapse
Brand Logo
  1. Home
  2. Qt Development
  3. General and Desktop
  4. How to link to offline Qt Documentation with QDoc
Forum Updated to NodeBB v4.3 + New Features

How to link to offline Qt Documentation with QDoc

Scheduled Pinned Locked Moved Unsolved General and Desktop
4 Posts 2 Posters 975 Views 1 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • Resurr3ctionR Offline
    Resurr3ctionR Offline
    Resurr3ction
    wrote on last edited by Resurr3ction
    #1

    Following the manual to QDoc I have successfully created a Qt-style documentation for my project including the compressed *.qch file and correct stylesheet. I use Qt Creator context help a lot so it would be great if I could link to Qt classes from my documentation. According to the manual I need to specify in my *.qdocconf:

    indexes =  /path/to/qt.index
    

    First of all qt.index no longer exists in Qt 5 and one has to link individual modules as far as I know. Additionally the links generated are to the online help as is specified in the *.index files shipped with Qt.

    Do I have to build offline documentation myself and link with that? Or is there another way to link directly to Qt Creator documentation? That is unfortunately already packaged so no *.index file to use there.

    1 Reply Last reply
    0
    • SGaistS Offline
      SGaistS Offline
      SGaist
      Lifetime Qt Champion
      wrote on last edited by
      #2

      Hi,

      Why not just add your documentation like shown here ?

      Interested in AI ? www.idiap.ch
      Please read the Qt Code of Conduct - https://forum.qt.io/topic/113070/qt-code-of-conduct

      1 Reply Last reply
      0
      • Resurr3ctionR Offline
        Resurr3ctionR Offline
        Resurr3ction
        wrote on last edited by Resurr3ction
        #3

        Well I do but it does not link with the Qt classes. For example if I use QString as parameter or return value it will not generate a link to the QString docs. The way to do it is with that indexes directive in *.qdocconf but that generates online links only so when I click on them in Qt Creator help it opens browser instead of going to the documentation Qt Creator has already (and packaged to *.qch).

        So I would like to include index that would specify local (or Qt Creator specific?) URL as base for the links (as the docs shipped with Qt specifies online URL). The only way I can achieve that I know of is to build the docs myself and manually change the files to reference the offline docs - but I am not even sure what url Qt Creator internally uses when it packaged its version of the docs.

        Perhaps I could change the indexes only to use correct URL and that could be done programatically as well but again, what url to put there instead so that Qt Creator would recognize it?

        1 Reply Last reply
        0
        • SGaistS Offline
          SGaistS Offline
          SGaist
          Lifetime Qt Champion
          wrote on last edited by
          #4

          Did you set the depends variable ?

          Interested in AI ? www.idiap.ch
          Please read the Qt Code of Conduct - https://forum.qt.io/topic/113070/qt-code-of-conduct

          1 Reply Last reply
          0

          • Login

          • Login or register to search.
          • First post
            Last post
          0
          • Categories
          • Recent
          • Tags
          • Popular
          • Users
          • Groups
          • Search
          • Get Qt Extensions
          • Unsolved