优化jsdoc模板。增加namespace

Author: songyumeng

build/jsdocs/classic/docs.json

@@ -24,7 +24,7 @@
             "src/classic/libs","src/classic/theme","src/classic/resource"
         ]
     },
-    "plugins": ["plugins/markdown","../plugins/linkdoc"],
+    "plugins": ["plugins/markdown"],
     "templates": {
         "cleverLinks": false,
         "monospaceLinks": false,

build/jsdocs/leaflet/docs.json

@@ -24,7 +24,7 @@
         ]
 
     },
-    "plugins": ["plugins/markdown","../plugins/factoryFunction","../plugins/linkdoc"],
+    "plugins": ["plugins/markdown","../plugins/factoryFunction"],
     "templates": {
         "cleverLinks": true,
         "monospaceLinks": true,

build/jsdocs/mapboxgl/docs.json

@@ -22,7 +22,7 @@
             "src/common","src/mapboxgl"
         ]
     },
-    "plugins": ["plugins/markdown","../plugins/linkdoc"],
+    "plugins": ["plugins/markdown"],
     "templates": {
         "cleverLinks": false,
         "monospaceLinks": false,

build/jsdocs/openlayers/docs.json

@@ -22,7 +22,7 @@
             "src/common","src/openlayers"
         ]
     },
-    "plugins": ["plugins/markdown","../plugins/linkdoc"],
+    "plugins": ["plugins/markdown"],
     "templates": {
         "cleverLinks": false,
         "monospaceLinks": false,

build/jsdocs/template/publish.js

@@ -12,6 +12,7 @@ var template = require('jsdoc/template'),
     _ = require('underscore'),
     htmlsafe = helper.htmlsafe,
     linkto = helper.linkto,
+    registerLink = helper.registerLink,
     resolveAuthorLinks = helper.resolveAuthorLinks,
     scopeToPunc = helper.scopeToPunc,
     hasOwnProp = Object.prototype.hasOwnProperty,
@@ -20,7 +21,6 @@ var template = require('jsdoc/template'),
     language,
     outdir = env.opts.destination;
 var util = require('util');
-
 function find(spec) {
     return helper.find(data, spec);
 }
@@ -511,20 +511,14 @@ exports.publish = function (taffyData, opts, tutorials) {
             doclet.kind = 'member';
         }
     });
-
+    for (const typeLink in view.typeLinks) {
+        registerLink(typeLink, view.typeLinks[typeLink]);
+    }
     var members = helper.getMembers(data);
     members.tutorials = tutorials.children;
-    var extendLinkto = function (longname, linkText, cssClass, fragmentId) {
-        if (longname && view.typeLinks && view.typeLinks[longname]) {
-            linkText = longname;
-            longname = view.typeLinks[longname];
-        }
-        return linkto(longname, linkText, cssClass, fragmentId);
-
-    }
     // add template helpers
     view.find = find;
-    view.linkto = extendLinkto;
+    view.linkto = linkto;
     view.resolveAuthorLinks = resolveAuthorLinks;
     view.tutoriallink = tutoriallink;
     view.htmlsafe = htmlsafe;

build/jsdocs/template/tmpl/container.tmpl

@@ -12,14 +12,10 @@
 <section>
 
 <header>
-    <h2><?js if (doc.ancestors && doc.ancestors.length) { ?>
-        <span class="ancestors"><?js= doc.ancestors.join('') ?></span>
-    <?js } ?>
-    <?js= doc.name ?>
+    <h2><?js if (doc.ancestors && doc.ancestors.length) { ?><span class="ancestors"><?js= doc.ancestors.join('') ?><?js } ?></span><?js= doc.name ?>
     <?js if (doc.variation) { ?>
         <sup class="variation"><?js= doc.variation ?></sup>
     <?js } ?>
-    <span class="static">static</span>
     </h2>
     <?js if (doc.classdesc) { ?>
         <div class="class-description"><?js= doc.classdesc ?></div>

src/common/overlay/levelRenderer/LevelRenderer.js

@@ -3,7 +3,6 @@ import {Util} from '../../commontypes/Util';
 import {Render} from './Render';
 
 /**
- * @private
  * @class  SuperMap.LevelRenderer
  * @category Visualization Theme
  * @classdesc LevelRenderer 渲染器

src/leaflet/core/Base.js

@@ -1,13 +1,19 @@
 /**
- *SuperMap Leaflet基类
+ * @namespace L
+ */
+/**
+ * @namespace L.supermap
+ */
+/**
+ * SuperMap Leaflet基类
  * 定义命名空间
  * 提供公共模块
  */
 import L from "leaflet";
 import './NonEarthCRS';
 import './Proj4Leaflet';
 import './ExtendsCRS';
-import Attributions from './Attributions'
+import Attributions from './Attributions';
 
 L.supermap = L.supermap || {};
 L.supermap.control = L.supermap.control || {};

src/mapboxgl/core/Base.js

@@ -2,6 +2,12 @@
  * SuperMap mapboxgl基类
  * 定义命名空间
  */
+/**
+ * @namespace mapboxgl
+ */
+/**
+ * @namespace mapboxgl.supermap
+ */
 import mapboxgl from 'mapbox-gl';
 import './MapExtend';
 

src/openlayers/services/ServiceBase.js

@@ -1,5 +1,13 @@
 import ol from 'openlayers';
-
+/**
+ * @namespace ol
+ */
+/**
+ * @namespace ol.supermap
+ */
+/**
+ * @namespace ol.source
+ */
 ol.supermap = ol.supermap || {};
 
 /**