Pikopong

It's all about knowledge

Fixing Blank Help in Qt Creator

View Comments

I just upgraded my SDK to Qt SDK 4.6.2 and installed Qt Creator 1.3.1. After running both editors (from the SDK and the one that I installed separately), I noticed that I’m getting blank pages in my help. I can’t search for any documentation. However, I can open the help file manually from the terminal (won’t work if your Qt is not in the PATH).

amree@pikopong:~$ assistant

Anyway, to solve it, we just need to point the the correct help file.

  1. Open your Qt Creator.
  2. Go to Tools > Options…
  3. Open the Documentation section.
  4. Clear everything you have in the list of Registered Documentation.
  5. Now, we must add all the help files back. The help files should be ending with .qch as the extension. Click Add… and browse to the directory where the help files are located.
    /* ----------------------------------------------------
     * LINUX
     *
     * Assuming your main SDK installation directory
     * is at '/opt/qt/qtsdk-2010.02'
     * ----------------------------------------------------/
    /opt/qt/qtsdk-2010.02/qt/doc/qch/assistant.qch
    /opt/qt/qtsdk-2010.02/qt/doc/qch/designer.qch
    /opt/qt/qtsdk-2010.02/qt/doc/qch/linguist.qch
    /opt/qt/qtsdk-2010.02/qt/doc/qch/qmake.qch
    /opt/qt/qtsdk-2010.02/qt/doc/qch/qt.qch

    // If you're going to use the editor from the SDK, add this one too
    /opt/qt/qtsdk-2010.02/share/doc/qtcreator/qtcreator.qch
    /* ----------------------------------------------------
     * WINDOWS
     *
     * Assuming your main SDK installation directory
     * is at 'C:\Qt\2010.02.1'
     * ----------------------------------------------------/
    C:\Qt\2010.02.1\qt\doc\qch\assistant.qch
    C:\Qt\2010.02.1\qt\doc\qch\designer.qch
    C:\Qt\2010.02.1\qt\doc\qch\linguist.qch
    C:\Qt\2010.02.1\qt\doc\qch\qmake.qch
    C:\Qt\2010.02.1\qt\doc\qch\qt.qch

    // If you're going to use the editor from the SDK, add this one too
    C:\Qt\2010.02.1\share\doc\qtcreator\qtcreator.qch
    /*
     * If your are using different editor (other than the one from SDK),
     * make sure you add the help file for the editor too.
     * The path for Linux and Windows should be the same
     */
    %QTCREATOR_INSTALLATION_PATH%/share/doc/qtcreator/qtcreator.qch
  6. Maybe there’ll be more files, just add every help files in the directory. Click OK and you’ll get your help files back. Good luck !
  • Digg
  • del.icio.us
  • Facebook
  • Google Bookmarks
  • PDF
  • Print
  • Reddit
  • Slashdot
  • Technorati
  • Twitter

Related Posts

Written by amree

April 11th, 2010 at 3:56 pm

Posted in guides

Tagged with ,

Leave a Reply

blog comments powered by Disqus