修改api模板

Author: songyumeng

build/jsdocs/leaflet/docs.json

@@ -8,8 +8,7 @@
     "disqus":"",
     "tags": {
         "allowUnknownTags": true,
-        "linkdoc-leaflet":"http://leafletjs.com/reference-1.0.3.html",
-	"linkdoc-htmlExtension":true
+        "linkdoc-leaflet":"http://leafletjs.com/reference-1.0.3.html"
     },
     "source": {
         "includePattern": ".+\\.js?$",

build/jsdocs/openlayers/docs.json

@@ -7,8 +7,7 @@
     "disqus":"",
     "tags": {
         "allowUnknownTags": true,
-        "linkdoc-openlayers":"https://openlayers.org/en/latest/apidoc/",
-        "linkdoc-htmlExtension":true
+        "linkdoc-openlayers":"https://openlayers.org/en/latest/apidoc/"
     },
     "source": {
         "includePattern": ".+\\.js?$",

build/jsdocs/plugins/linkdoc.js

@@ -8,7 +8,7 @@ exports.handlers = {
             for (var i = 0; i < e.doclet.augments.length; i++) {
                 var a = e.doclet.augments[i];
                 if (a.indexOf("@linkdoc")) {
-                    var reg = new RegExp("@(.*?)/");
+                    var reg = new RegExp("@(linkdoc.*?)/");
                     var match = a.match(reg);
                     if (match) {
                         e.doclet.augments[i] = a.replace("@" + match[1] + "/", env.conf.tags[match[1]]);
@@ -20,5 +20,18 @@ exports.handlers = {
                 }
             }
         }
+        if (e.doclet.params) {
+            for (var i = 0; i < e.doclet.params.length; i++) {
+                var a = e.doclet.params[i].description;
+                if (a && a.indexOf("@linkdoc")) {
+                    var reg = new RegExp("@(linkdoc.*?)/");
+                    var match = a.match(reg);
+                    if (match) {
+                        var str="@" + match[1] + "/";
+                        e.doclet.params[i].description = a.replace(new RegExp(str,'g'), "@link "+ env.conf.tags[match[1]]);
+                    }
+                }
+            }
+        }
     }
 };

build/jsdocs/template/publish.js

@@ -206,10 +206,12 @@ function attachModuleSymbols(doclets, modules) {
 function buildNav(members) {
     var nav = [];
 
-    if (members.namespaces.length) {
-        _.each(members.namespaces, function (v) {
+
+
+    if (members.classes.length) {
+        _.each(members.classes, function (v) {
             nav.push({
-                type: 'namespace',
+                type: 'class',
                 longname: v.longname,
                 name: v.name,
                 members: find({
@@ -231,11 +233,10 @@ function buildNav(members) {
             });
         });
     }
-
-    if (members.classes.length) {
-        _.each(members.classes, function (v) {
+    if (members.namespaces.length) {
+        _.each(members.namespaces, function (v) {
             nav.push({
-                type: 'class',
+                type: 'namespace',
                 longname: v.longname,
                 name: v.name,
                 members: find({
@@ -257,7 +258,6 @@ function buildNav(members) {
             });
         });
     }
-
     return nav;
 }
 

src/leaflet/mapping/BaiduTileLayer.js

@@ -7,11 +7,11 @@ import L from "leaflet";
  * @extends L.TileLayer{@linkdoc-leaflet/#tilelayer}
  * @param url -{string} 切片地址
  * @param options -{Object} 切片参数。如：<br>
- *        minZoom - {number} 最小缩放级别
- *        maxZoom - {number} 最大缩放级别
- *        bounds - {L.bounds} 显示范围
- *        retina - {L.Browser} 浏览器显示分辨率
- *        attribution - {string} 版权信息
+ *        minZoom - {number} 最小缩放级别 <br>
+ *        maxZoom - {number} 最大缩放级别 <br>
+ *        bounds - {[L.LatLngBounds]{@linkdoc-leaflet/#latlngbounds}} 显示范围 <br>
+ *        retina - {[L.Browser]{@linkdoc-leaflet/#browser}} 浏览器显示分辨率 <br>
+ *        attribution - {string} 版权信息 <br>
  */
 export var BaiduTileLayer = L.TileLayer.extend({