Qt Forum

    • Login
    • Search
    • Categories
    • Recent
    • Tags
    • Popular
    • Users
    • Groups
    • Search
    • Unsolved

    Linking documentation to source files

    Qt.io webservices
    4
    9
    2554
    Loading More Posts
    • 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.
    • D
      daviddoria last edited by

      Is there a way to link to a source file (in the qt source tree) from the documentation? Or better yet, I want to display multiple source files on the same page, something like: http://programmingexamples.net/wiki/Qt/ModelView/ListViewComboBox

      I am trying to link documentation to examples, but I don't think we should include the full example inline with the documentation (simply for length sake), but rather link to it. I would suggest something like an “Examples” section that would appear in the “Contents” menu on the documentation page. Any thoughts on a good way to do this?

      1 Reply Last reply Reply Quote 0
      • H
        hamid kamran last edited by

        when you open qt creator in the first window go through the getting started tab there is combo that show the examples written in qt all the example in demo and documentation are there...

        1 Reply Last reply Reply Quote 0
        • D
          daviddoria last edited by

          What I am trying to do is link to examples from the documentation - I want a page like this: http://developer.qt.nokia.com/doc/qt-4.8/qtimer.html to link to a few files in qt/examples.

          1 Reply Last reply Reply Quote 0
          • T
            troubalex last edited by

            You can add your links in the notes at the bottom of the page. It's one of their purposes.

            THE CAKE IS A LIE
            Web Community Manager - Qt Development Frameworks

            1 Reply Last reply Reply Quote 0
            • D
              daviddoria last edited by

              Ok, that is where to add them (though I think they should be in the actual source file so that they are in the actual distribution, not separated and existing only on the website) - but I'm still not sure what to link to? I.e. if I want to link to qt/examples/graphicsview/anchorlayout/main.cpp - what do I make the actual link?

              1 Reply Last reply Reply Quote 0
              • T
                troubalex last edited by

                Ahhhhh! Sorry, I missed that. Would this work?

                http://qt.gitorious.org/qt/qt/blobs/4.8/examples/graphicsview/anchorlayout/main.cpp

                [Updated the link, I grabbed the wrong one initially...]

                THE CAKE IS A LIE
                Web Community Manager - Qt Development Frameworks

                1 Reply Last reply Reply Quote 0
                • D
                  daviddoria last edited by

                  Alexandra -

                  That is a good start... it will certainly work for a first pass.

                  Ideally I would like to display a few files on the same page, so the user can see everything "at a glace" without having to switch back and forth between pages - like this:
                  http://programmingexamples.net/wiki/Qt/ModelView/ListViewComboBox

                  Any thoughts on how to do something like that?

                  1 Reply Last reply Reply Quote 0
                  • M
                    markc last edited by

                    And keep in mind you can link to exactly a single line of code...

                    http://qt.gitorious.org/qt/qt/blobs/4.8/examples/graphicsview/anchorlayout/main.cpp#line58

                    1 Reply Last reply Reply Quote 0
                    • T
                      troubalex last edited by

                      I assume you want to avoid to copy a whole file. You could copy parts of it into the notes, but I believe linking would work just fine. Maybe along with some explanations as to what to look for in the example?

                      THE CAKE IS A LIE
                      Web Community Manager - Qt Development Frameworks

                      1 Reply Last reply Reply Quote 0
                      • First post
                        Last post