Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-23402

The DITA map is wrong in a few places, and the file name should be changed.

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P3: Somewhat important
    • 5.0.0
    • 5.0.0
    • Documentation
    • None
    • 08c6d81418230bcc1c5c61d1a9e425bbbf8b85a3

    Description

      Below are described the needed changes:

      2. I also change the maps from cxx maps to normal maps and fixed a couple of other things that broke the DITA processing. Here's the search-replace script (with comments) to show what gets changed:
      <replace dir="${content.workdir}/api" includes="**/qt-dita-map.xml" summary = "true" >
      <replacefilter -> cxx map to normal map
      token='!DOCTYPE cxxAPIMap PUBLIC "-//NOKIA//DTD DITA C++ API Map Reference Type v0.6.0//EN" "dtd/cxxAPIMap.dtd"'
      value='!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"'
      />
      <replacefilter -> more cxx map to normal map changes
      token='cxxAPIMap id="Qt-DITA-Map" title="Qt DITA Map"'
      value='map'
      />
      <replacefilter -> and more cxx to normal
      token='/cxxAPIMap'
      value='/map'
      />
      <replacefilter -> removed map self-reference that is always generated at the end of the map
      token='<topicref href="qt-dita-map.xml" type="topic"/>'
      value=''
      />
      <replacefilter ->
      token='type="topic"'
      value=''
      />
      </replace>

      3. Also, with respect to the maps, the script changes the map filename to api.ditamap so it's easy to spot the map file amongst all the .xml topic files. "qt.ditamap" would be a better name since the content is not always an api.

      Attachments

        For Gerrit Dashboard: QTBUG-23402
        # Subject Branch Project Status CR V

        Activity

          People

            gbk Martin Smith (Qt)
            gbk Martin Smith (Qt)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes