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. Adding external documentation to QT Assistant.

Adding external documentation to QT Assistant.

Scheduled Pinned Locked Moved General and Desktop
5 Posts 2 Posters 3.2k Views
  • 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.
  • M Offline
    M Offline
    mercellus
    wrote on last edited by
    #1

    I have successfully built a .qhp file and made the compressed help file (.qch) and loaded it into Qt Assistant. It is displaying propery in Qt Assistant. However, it looks very basic and is not using a stylesheet. I've tried adding a reference to a .css file in the header of the .qhp file. It builds successfully, but does not use the styles in the .css.

    What is the best way to get the external document I'm adding to Qt Assistant to use nice-looking styles?

    [apologies if this is the wrong forum group; it seemed rather "general" to me]

    1 Reply Last reply
    0
    • sierdzioS Offline
      sierdzioS Offline
      sierdzio
      Moderators
      wrote on last edited by
      #2

      Are you using qdoc3 or doxygen?

      (Z(:^

      1 Reply Last reply
      0
      • M Offline
        M Offline
        mercellus
        wrote on last edited by
        #3

        [quote author="sierdzio" date="1365832136"]Are you using qdoc3 or doxygen?[/quote]

        Thank you for your response.

        I am not using qdoc3 or doxygen. What I am documenting are UI guidelines for our designers using Qt Designer. We use a different application to develop the documentation. Here is the process I use to get the .qch file generated.

        1. Create documentation in HTML5.
        2. Build a .qhp file.
        3. Run qhelpgenerator [filename].chp -o [filename].qch.
        4. Import [filename].qch into Qt Assistant.

        The .qhp file builds properly into the .qch file and the documentation is viewable in Qt Assistant. However, it is very basic and the .css styles I want to use are not displayed.

        How can I make the documentation use my .css styles? Or, how can I have it use the styles that are used in the default help documentation stored in Qt Assistant? The default Qt Assistant documentation looks good and uses a .css or stylesheet.

        1 Reply Last reply
        0
        • sierdzioS Offline
          sierdzioS Offline
          sierdzio
          Moderators
          wrote on last edited by
          #4

          I don't know, sorry.

          (Z(:^

          1 Reply Last reply
          0
          • M Offline
            M Offline
            mercellus
            wrote on last edited by
            #5

            Thanks for your response. I think I've figured out what needs to happen.

            The file structure of the HTML5 needs to include the .css in the root of the file structure, prior to generating the .qch file from the .qhp file. If the .css is buried in a directory in the HTML5, it is not built into the .qch file.

            Also, the reference to the .css file needs to be included in the .qhp file used to build the .qch.

            For example:

            @ <files>
            <file>.htm</file>
            <file>
            .css</file>
            <file>Images/*.png</file>
            </files>
            @

            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