增加内部public变量、方法检测脚本，修正处理文档链接的逻辑

Author: rdkmaster

.travis.yml

@@ -31,10 +31,11 @@ before_script:
   - # ./build/scripts/sauce_connect_setup.sh
 
 script:
+  - node build/scripts/check-demo-import.js
+  - node build/scripts/check-public-variables.js
   - gulp ensure-url-matches-path
   - gulp generate-demo-info
   - gulp build:jigsaw
-  - node build/scripts/check-demo-import.js
   - ng test jigsaw  --code-coverage false --watch false
   - # cat ./coverage/lcov.info | ./node_modules/.bin/coveralls
   - sh build/scripts/doc-generator/generate.sh ./temp/doc/

build/scripts/check-public-variables.js

@@ -0,0 +1,68 @@
+const fs = require('fs');
+const path = require('path');
+
+let hasError = false;
+checkAll();
+if (hasError) {
+    process.exit(1);
+} else {
+    console.error(`Everything's fine!`);
+}
+
+// checkPublicVariables('D:\\Codes\\jigsaw\\src\\jigsaw\\mobile-components\\alert\\alert.ts');
+
+function checkAll(folder) {
+    const cmpHome = path.resolve(`${__dirname}/../../src/jigsaw`);
+    const cmpFolders = fs.readdirSync(cmpHome);
+    cmpFolders.forEach(cmpFolder => {
+        const pathname = path.join(cmpHome, cmpFolder);
+        const stat = fs.lstatSync(pathname);
+        if (stat.isDirectory()) {
+            checkSourceFiles(pathname);
+        }
+    });
+}
+
+function checkSourceFiles(sourceFolder) {
+    const files = fs.readdirSync(sourceFolder);
+    files.forEach(file => {
+        const pathname = path.join(sourceFolder, file);
+        const stat = fs.lstatSync(pathname);
+        if (stat.isDirectory()) {
+            checkSourceFiles(pathname)
+        } else {
+            checkPublicVariables(pathname);
+        }
+    });
+}
+
+function checkPublicVariables(srcPath) {
+    if (!srcPath.match(/.+\.ts$/i)) {
+        return;
+    }
+
+    console.log(`Checking ${srcPath} ...`);
+    const source = fs.readFileSync(srcPath).toString();
+
+    const vars = source.match(/\spublic\s+(static\s+)?_\$?\w+/g);
+    if (!vars) {
+        return;
+    }
+
+    vars.forEach(variable => {
+        const fixed = variable.replace(/\$/g, '\\$');
+        const reg = new RegExp(`[\\s\\S]*\\/\\*\\*([\\s\\S]*?)\\*\\/\\s*(@\\w+.*\\s*)?${fixed}\\b`);
+        const match = source.match(reg);
+        if (!match || match[1].indexOf('@internal') === -1) {
+            const name = variable.replace(/public\s*(static\s+)?/, '').trim();
+            error(`Error: variable "${name}" has no @internal flag!`);
+        }
+    });
+}
+
+function error(msg) {
+    console.error(msg);
+    hasError = true;
+}
+
+

src/app/demo/pc/dialog/absolute-position/demo.component.ts

@@ -67,5 +67,5 @@ export class DialogAbsolutePositionDemoComponent {
     // ignore the following lines, they are not important to this demo
     // ====================================================================
     summary: string = '这个demo介绍了弹出对话框四个方位弹出的绝对位置：靠上、靠左、靠右、考下';
-    description: string = '[这里详细介绍了`PopupService`，请仔细阅读](/#/pc/popup/introduce)。';
+    description: string = '这里[详细介绍](#/pc/popup/introduce)了`PopupService`，请仔细阅读。';
 }

src/app/markdown/markdown.ts

@@ -58,9 +58,8 @@ export class JigsawMarkdown extends AbstractJigsawComponent implements OnInit {
         markdown = marked(markdown.trim());
 
         // redirect internal doc link to the ued site
-        markdown = markdown.replace(/<a href="\/(components\/api\/\w+?\/.*?)">/g,
-            `<a href="${InternalUtils.uedSiteHost}/$1" target="_blank">`);
-        markdown = markdown.replace(/\$uedHost/g, InternalUtils.uedSiteHost);
+        markdown = markdown.replace(/<a\s+href="(\/components\/api\/.*?)"/g,
+            `<a href="javascript:top.location.hash='$1'" target="_self"`);
 
         // add class to raise the css priority
         markdown = markdown.replace(/<(\w+)(\s|>)/g, (found, tag, border) => {

src/jigsaw/common/core/data/graph-data.ts

@@ -123,6 +123,9 @@ export abstract class AbstractGraphData extends TableDataBase {
         return this._fromObject(data);
     }
 
+    /**
+     * @internal
+     */
     public _fromObject(data: any): AbstractGraphData {
         if (!AbstractGraphData.isGraphData(data)) {
             throw new Error('invalid graph data, need at least a "data" property which type is Array!');

src/jigsaw/common/core/utils/internal-utils.ts

@@ -7,10 +7,8 @@ import {TranslateHelper} from "./translate-helper";
  */
 // @dynamic
 export class InternalUtils {
-    public static uedSiteHost = 'http://rdk.zte.com.cn';
-
-    public static _uniqueIdIndex = 0;
-    public static _defaultPrefix = '__unique_id__';
+    private static _uniqueIdIndex = 0;
+    private static _defaultPrefix = '__unique_id__';
 
     /*
      * 初始化对象标识，转化为数组

src/jigsaw/common/service/popup.service.ts

@@ -31,7 +31,7 @@ export enum PopupEffect {
  * 用于控制弹出视图的各种参数，包括是否模态、弹出位置、视图尺寸、弹出动画等等，`PopupService`能够覆盖所有弹出场景，
  * 很大程度上得益于这个参数的强大扩展性，熟悉这个参数的各个属性对是否能够用好`PopupService`有着决定性的影响。
  *
- * [这个demo](/components/dialog/demo#popup-option)详细的说明了如何使用这个对象。
+ * [这个demo]($demo=dialog/popup-option)详细的说明了如何使用这个对象。
  */
 export class PopupOptions {
     /**

src/jigsaw/mobile-components/icon/icon.ts

@@ -19,6 +19,9 @@ import {CommonUtils} from "../../common/core/utils/common-utils";
     }
 })
 export class JigsawMobileIcon extends AbstractJigsawComponent {
+    /**
+     * @internal
+     */
     public _$secureUrl;
     private _href: string = 'javascript:void(0);';
 

src/jigsaw/mobile-components/tabs/tab.ts

@@ -120,6 +120,9 @@ export class JigsawMobileTab extends AbstractJigsawComponent implements AfterVie
     @Input()
     public editable: boolean;
 
+    /**
+     * @internal
+     */
     public _$headless: boolean = false;
 
     /**

src/jigsaw/mobile-components/tag/tag.ts

@@ -51,6 +51,9 @@ export class JigsawMobileTag extends AbstractJigsawComponent implements OnInit {
     public _state: string;
 
     constructor(private _renderer: Renderer2,
+                /**
+                 * @internal
+                 */
                 public _elementRef: ElementRef) {
         super();
     }