QDoc: Add hand-written ditamaps as children of qt.ditamap

Known issues: the hand-written ditamap has to be a flat list. The
function used should preferably become a recursive function, which would
allow you to have as many nested items as you want.

Change-Id: I0dc897da5222f6409e2e58c42200c342bc8cacf2
Reviewed-by: Martin Smith <martin.smith@nokia.com>

src/tools/qdoc/ditaxmlgenerator.cpp

@@ -3886,12 +3886,14 @@ QString DitaXmlGenerator::guidForNode(const Node* node)
 /*!
   Constructs a file name appropriate for the \a node and returns
   it. If the \a node is not a fake node, or if it is a fake node but
-  it is neither an external page node nor an image node, call the
+  it is neither an external page node nor an image node or a ditamap,
-  PageGenerator::fileName() function.
+  call the PageGenerator::fileName() function.
  */
 QString DitaXmlGenerator::fileName(const Node* node)
 {
     if (node->type() == Node::Fake) {
+        if (static_cast<const FakeNode*>(node)->pageType() == Node::DitaMapPage)
+            return node->name();
         if (static_cast<const FakeNode*>(node)->subType() == Node::ExternalPage)
             return node->name();
         if (static_cast<const FakeNode*>(node)->subType() == Node::Image)
@@ -5974,38 +5976,89 @@ void DitaXmlGenerator::writeTopicrefs(NodeMultiMap* nmm, const QString& navtitle
         return;
     writeStartTag(DT_topicref);
     xmlWriter().writeAttribute("navtitle",navtitle);
-    NodeMultiMap::iterator i = nmm->begin();
+    NodeMultiMap::iterator i;
-    while (i != nmm->end()) {
+    NodeMultiMap *ditaMaps = pageTypeMaps[Node::DitaMapPage];
-        // Hardcode not writing index.dita multiple times in the tree.
+
-        // index.dita should only appear at the top of the ditamap.
+    /*!
-        if (fileName(i.value()) == "index.dita") {
+       Put all pages that are already in a hand-written ditamap not in
-            i++;
+       the qt.ditamap separately. It loops through all ditamaps recursively
-            continue;
+       before deciding to write an article to qt.ditamap.
+     */
+    if ((navtitle == "articles" && ditaMaps && ditaMaps->size() > 0)) {
+        NodeMultiMap::iterator mapIterator = ditaMaps->begin();
+        while (mapIterator != ditaMaps->end()) {
+            writeStartTag(DT_mapref);
+            xmlWriter().writeAttribute("navtitle",mapIterator.key());
+            xmlWriter().writeAttribute("href",fileName(mapIterator.value()));
+            writeEndTag();
+            ++mapIterator;
         }
-        writeStartTag(DT_topicref);
+        i = nmm->begin();
-        xmlWriter().writeAttribute("navtitle",i.key());
+        while (i != nmm->end()) {
-        xmlWriter().writeAttribute("href",fileName(i.value()));
+            // Hardcode not writing index.dita multiple times in the tree.
-        switch (i.value()->type()) {
+            // index.dita should only appear at the top of the ditamap.
-        case Node::Class: {
+            if (fileName(i.value()) == "index.dita") {
-            const NamespaceNode* nn = static_cast<const NamespaceNode*>(i.value());
+                i++;
-            const NodeList& c = nn->childNodes();
+                continue;
-            for (int j=0; j<c.size(); ++j) {
+            }
-                if (c[j]->isInternal() || c[j]->access() == Node::Private || c[j]->doc().isEmpty())
+            bool foundInDitaMap = false;
-                    continue;
+            mapIterator = ditaMaps->begin();
-                if (c[j]->type() == Node::Class) {
+            while (mapIterator != ditaMaps->end()) {
-                    writeStartTag(DT_topicref);
+                const DitaMapNode *dmNode = static_cast<const DitaMapNode *>(mapIterator.value());
-                    xmlWriter().writeAttribute("navtitle",c[j]->name());
+                for (int count = 0; count < dmNode->map().count(); count++) {
-                    xmlWriter().writeAttribute("href",fileName(c[j]));
+                    if (dmNode->map().at(count)->navtitle() == i.key()) {
-                    writeEndTag(); // </topicref>
+                        foundInDitaMap = true;
+                    }
+                    ++mapIterator;
                 }
             }
-            break;
+            if (!foundInDitaMap) {
+                writeStartTag(DT_topicref);
+                xmlWriter().writeAttribute("navtitle",i.key());
+                xmlWriter().writeAttribute("href",fileName(i.value()));
+                writeEndTag(); // </topicref>
+            }
+            ++i;
         }
-        default:
+    }
-            break;
+    /*!
+       Shortcut when there are no hand-written ditamaps or when we are
+       not generating the articles list.
+     */
+    else {
+        i = nmm->begin();
+        while (i != nmm->end()) {
+            // Hardcode not writing index.dita multiple times in the tree.
+            // index.dita should only appear at the top of the ditamap.
+            if (fileName(i.value()) == "index.dita") {
+                i++;
+                continue;
+            }
+            writeStartTag(DT_topicref);
+            xmlWriter().writeAttribute("navtitle",i.key());
+            xmlWriter().writeAttribute("href",fileName(i.value()));
+            switch (i.value()->type()) {
+            case Node::Class: {
+                const NamespaceNode* nn = static_cast<const NamespaceNode*>(i.value());
+                const NodeList& c = nn->childNodes();
+                for (int j=0; j<c.size(); ++j) {
+                    if (c[j]->isInternal() || c[j]->access() == Node::Private || c[j]->doc().isEmpty())
+                        continue;
+                    if (c[j]->type() == Node::Class) {
+                        writeStartTag(DT_topicref);
+                        xmlWriter().writeAttribute("navtitle",c[j]->name());
+                        xmlWriter().writeAttribute("href",fileName(c[j]));
+                        writeEndTag(); // </topicref>
+                    }
+                }
+                break;
+            }
+            default:
+                break;
+            }
+            writeEndTag(); // </topicref>
+            ++i;
         }
-        writeEndTag(); // </topicref>
-        ++i;
     }
     writeEndTag(); // </topicref>
 }