Browse Source

调整生成代码

zhangweixin 4 years ago
parent
commit
670d6425fd

+ 7 - 16
docs/.vuepress/config.js

@@ -68,7 +68,7 @@ module.exports = {
                         text: "后台开发",
                         items: [
                             {text: "数据中心", link: "/dev/data-center/"},
-                            {text: "物理世界同步", link: "/dev/dataplatform-sync/"},
+                            // {text: "物理世界同步", link: "/dev/dataplatform-sync/"},
                             {text: "模型管理", link: "/dev/revit-center/"},
                             {text: "数据中台参考", link: "/dev/paas/"},
                             {text: "服务支持库", link: "/dev/lib/"}
@@ -102,28 +102,19 @@ module.exports = {
             {
                 text: "新兵手册",
                 items: [
-                    {
-                        text: "微服务",
-                        items: [
+                    // {
+                    //     text: "微服务",
+                    //     items: [
                             {
                                 text: "eureka服务器搭建",
                                 items: [
                                     {text: "CentoOS 部署", link: "/setup/server/centos/"},
                                     {text: "Windows 部署", link: "/setup/server/windows/"}
                                 ]
-                            },
-                            {
-                                text: "开发环境",
-                                items: [
-                                    {text: "IDEA", link: "/setup/dev/idea"},
-                                    {text: "Revit", link: "/setup/dev/revit"},
-                                    {text: "Visual Studio", link: "/setup/dev/vsts"}
-                                ]
                             }
-
                         ]
-                    }
-                ]
+                    // }
+                // ]
             },
             {
                 text: "API参考",
@@ -146,7 +137,7 @@ module.exports = {
                 ]
             },
             {
-                text: "编码规范",
+                text: "规范",
                 items: [
                     { text: "C#", link: "/style/csharp/" },
                     { text: "Kotlin", link: "/style/kotlin/" },

+ 2 - 3
docs/.vuepress/enhanceApp.js

@@ -3,10 +3,9 @@
 
 import Vue from 'vue'
 // import SDoc from 'sybotan-vue-doc'
+import PDoc from '@persagy-vue/doc'
 import Element from 'element-ui'
 import 'element-ui/lib/theme-chalk/index.css'
-import './public/plugin/prism.css'
-import './public/plugin/prism'
 
-// Vue.use(SDoc);
+Vue.use(PDoc);
 Vue.use(Element);

+ 0 - 299
docs/.vuepress/public/plugin/prism.css

@@ -1,299 +0,0 @@
-/* PrismJS 1.21.0
-https://prismjs.com/download.html#themes=prism-okaidia&languages=markup+clike+bash+bison+c+csharp+cpp+cmake+git+groovy+ini+java+json+json5+kotlin+nginx+plsql+powershell+python+regex+scala+shell-session+sql+vim+xml-doc+yaml&plugins=line-highlight+line-numbers+show-language+highlight-keywords+toolbar */
-/**
- * okaidia theme for JavaScript, CSS and HTML
- * Loosely based on Monokai textmate theme by http://www.monokai.nl/
- * @author ocodia
- */
-
-code[class*="language-"],
-pre[class*="language-"] {
-	color: #f8f8f2;
-	background: none;
-	text-shadow: 0 1px rgba(0, 0, 0, 0.3);
-	font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;
-	font-size: 1em;
-	text-align: left;
-	white-space: pre;
-	word-spacing: normal;
-	word-break: normal;
-	word-wrap: normal;
-	line-height: 1.5;
-
-	-moz-tab-size: 4;
-	-o-tab-size: 4;
-	tab-size: 4;
-
-	-webkit-hyphens: none;
-	-moz-hyphens: none;
-	-ms-hyphens: none;
-	hyphens: none;
-}
-
-/* Code blocks */
-pre[class*="language-"] {
-	padding: 1em;
-	margin: .5em 0;
-	overflow: auto;
-	border-radius: 0.3em;
-}
-
-:not(pre) > code[class*="language-"],
-pre[class*="language-"] {
-	background: #272822;
-}
-
-/* Inline code */
-:not(pre) > code[class*="language-"] {
-	padding: .1em;
-	border-radius: .3em;
-	white-space: normal;
-}
-
-.token.comment,
-.token.prolog,
-.token.doctype,
-.token.cdata {
-	color: #8292a2;
-}
-
-.token.punctuation {
-	color: #f8f8f2;
-}
-
-.token.namespace {
-	opacity: .7;
-}
-
-.token.property,
-.token.tag,
-.token.constant,
-.token.symbol,
-.token.deleted {
-	color: #f92672;
-}
-
-.token.boolean,
-.token.number {
-	color: #ae81ff;
-}
-
-.token.selector,
-.token.attr-name,
-.token.string,
-.token.char,
-.token.builtin,
-.token.inserted {
-	color: #a6e22e;
-}
-
-.token.operator,
-.token.entity,
-.token.url,
-.language-css .token.string,
-.style .token.string,
-.token.variable {
-	color: #f8f8f2;
-}
-
-.token.atrule,
-.token.attr-value,
-.token.function,
-.token.class-name {
-	color: #e6db74;
-}
-
-.token.keyword {
-	color: #66d9ef;
-}
-
-.token.regex,
-.token.important {
-	color: #fd971f;
-}
-
-.token.important,
-.token.bold {
-	font-weight: bold;
-}
-.token.italic {
-	font-style: italic;
-}
-
-.token.entity {
-	cursor: help;
-}
-
-pre[data-line] {
-	position: relative;
-	padding: 1em 0 1em 3em;
-}
-
-.line-highlight {
-	position: absolute;
-	left: 0;
-	right: 0;
-	padding: inherit 0;
-	margin-top: 1em; /* Same as .prism’s padding-top */
-
-	background: hsla(24, 20%, 50%,.08);
-	background: linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0));
-
-	pointer-events: none;
-
-	line-height: inherit;
-	white-space: pre;
-}
-
-	.line-highlight:before,
-	.line-highlight[data-end]:after {
-		content: attr(data-start);
-		position: absolute;
-		top: .4em;
-		left: .6em;
-		min-width: 1em;
-		padding: 0 .5em;
-		background-color: hsla(24, 20%, 50%,.4);
-		color: hsl(24, 20%, 95%);
-		font: bold 65%/1.5 sans-serif;
-		text-align: center;
-		vertical-align: .3em;
-		border-radius: 999px;
-		text-shadow: none;
-		box-shadow: 0 1px white;
-	}
-
-	.line-highlight[data-end]:after {
-		content: attr(data-end);
-		top: auto;
-		bottom: .4em;
-	}
-
-.line-numbers .line-highlight:before,
-.line-numbers .line-highlight:after {
-	content: none;
-}
-
-pre[id].linkable-line-numbers span.line-numbers-rows {
-	pointer-events: all;
-}
-pre[id].linkable-line-numbers span.line-numbers-rows > span:before {
-	cursor: pointer;
-}
-pre[id].linkable-line-numbers span.line-numbers-rows > span:hover:before {
-	background-color: rgba(128, 128, 128, .2);
-}
-
-pre[class*="language-"].line-numbers {
-	position: relative;
-	padding-left: 3.8em !important;
-	counter-reset: linenumber;
-}
-
-pre[class*="language-"].line-numbers > code {
-	position: relative;
-	white-space: inherit;
-}
-
-.line-numbers .line-numbers-rows {
-	position: absolute;
-	pointer-events: none;
-	top: 0;
-	font-size: 100%;
-	left: -3.8em;
-	width: 3em; /* works for line-numbers below 1000 lines */
-	letter-spacing: -1px;
-	border-right: 1px solid #999;
-
-	-webkit-user-select: none;
-	-moz-user-select: none;
-	-ms-user-select: none;
-	user-select: none;
-
-}
-
-	.line-numbers-rows > span {
-		display: block;
-		counter-increment: linenumber;
-	}
-
-		.line-numbers-rows > span:before {
-			content: counter(linenumber);
-			color: #999;
-			display: block;
-			padding-right: 0.8em;
-			text-align: right;
-		}
-
-div.code-toolbar {
-	position: relative;
-}
-
-div.code-toolbar > .toolbar {
-	position: absolute;
-	top: .3em;
-	right: .2em;
-	transition: opacity 0.3s ease-in-out;
-	opacity: 0;
-}
-
-div.code-toolbar:hover > .toolbar {
-	opacity: 1;
-}
-
-/* Separate line b/c rules are thrown out if selector is invalid.
-   IE11 and old Edge versions don't support :focus-within. */
-div.code-toolbar:focus-within > .toolbar {
-	opacity: 1;
-}
-
-div.code-toolbar > .toolbar .toolbar-item {
-	display: inline-block;
-}
-
-div.code-toolbar > .toolbar a {
-	cursor: pointer;
-}
-
-div.code-toolbar > .toolbar button {
-	background: none;
-	border: 0;
-	color: inherit;
-	font: inherit;
-	line-height: normal;
-	overflow: visible;
-	padding: 0;
-	-webkit-user-select: none; /* for button */
-	-moz-user-select: none;
-	-ms-user-select: none;
-}
-
-div.code-toolbar > .toolbar a,
-div.code-toolbar > .toolbar button,
-div.code-toolbar > .toolbar span {
-	color: #bbb;
-	font-size: .8em;
-	padding: 0 .5em;
-	background: #f5f2f0;
-	background: rgba(224, 224, 224, 0.2);
-	box-shadow: 0 2px 0 0 rgba(0,0,0,0.2);
-	border-radius: .5em;
-}
-
-div.code-toolbar > .toolbar a:hover,
-div.code-toolbar > .toolbar a:focus,
-div.code-toolbar > .toolbar button:hover,
-div.code-toolbar > .toolbar button:focus,
-div.code-toolbar > .toolbar span:hover,
-div.code-toolbar > .toolbar span:focus {
-	color: inherit;
-	text-decoration: none;
-}
-
-/**
-*  覆盖
-*/
-
-.custom-code pre, .custom-code pre[class*="language-"] {
-	line-height: 1 !important;
-}

File diff suppressed because it is too large
+ 0 - 34
docs/.vuepress/public/plugin/prism.js


+ 6 - 0
docs/.vuepress/public/uml/plant.puml

@@ -0,0 +1,6 @@
+@startuml
+left to right direction
+skinparam packageStyle rectangle
+actor customer
+actor clerk
+@enduml

+ 1 - 3
docs/dev/lib/README.md

@@ -2,6 +2,4 @@
 
 ![架构图 idea](./img/system-img.jpg)
 
-
-
-
+<PPlantUML src="/uml/plant.puml" />

+ 1 - 1
docs/dev/lib/coding/README.md

@@ -42,7 +42,7 @@
 <<< @/docs/dev/lib/coding/src/PropertyController.kt
 :::
 
-<SCodeGit repos="server/data-center" src="/datacenter/src/main/kotlin/cn/sagacloud/server/datacenter/controllers/PropertyController.kt"/>
+<PCodeGit repos="server/data-center" src="/datacenter/src/main/kotlin/cn/sagacloud/server/datacenter/controllers/PropertyController.kt"/>
 
 标准的通用接口,增删改查统计
 

+ 5 - 0
docs/setup/index.js

@@ -12,6 +12,11 @@ const content = [
         path: "/setup/dev/",
         children: devCenter
     },
+    {
+        title: "开发环境",
+        path: "/setup/dev/",
+        children: devCenter
+    },
 ];
 
 module.exports = content;

+ 1 - 0
docs/setup/server/centos/README.md

@@ -5,6 +5,7 @@
 ### Tomcat
 ### Python
 ### PostgreSQL
+### docker
 
 ## 应用服务
 ### datacenter

+ 3 - 3
docs/setup/server/centos/app-server/revit-algorithm.md

@@ -1,6 +1,6 @@
 # Revit-algorithm
 ## 项目结构
-![项目结构](docs/setup/server/centos/app-server/img/revit_001.jpg)
+![项目结构](./img/revit_001.jpg)
 
     如图中所标记
     1. 后台任务模块, 处理模型的各个状态和状态流转
@@ -27,7 +27,7 @@
     5. 使用poi操作xlsx文件
     
 ## 打包
-![项目打包](docs/setup/server/centos/app-server/img/revit_002.jpg)
+![项目打包](./img/revit_002.jpg)
 
     如果打测试包, 在右侧Gradle的管理页面里双击任务buildDevJar或者buildDevWar即可. 打包内容中就会
     把左侧资源文件包resources和resources-dev的内容加入到打包的资源内, 建议在打包前把上次打包的文件删除
@@ -41,7 +41,7 @@
     
     
 ## 文件服务配置
-![项目打包](docs/setup/server/centos/app-server/img/revit_003.jpg)
+![项目打包](./img/revit_003.jpg)
     
     
 | 配置            | 描述                             |

+ 34 - 3
docs/setup/server/centos/os/config.md

@@ -11,6 +11,13 @@ vda 和 vda1 代表做过磁盘分区,只有 vdb 没有 vdb1 代表还没做
 /dev/vda  /dev/vda1  /dev/vdb
 ```
 ### 扩展盘分区
+::: danger 警告
+
+1.非专业人士不要进行操作,会导致系统崩溃,数据丢失,责任自负。
+
+2.已经做完分区的不需要执行此步骤。
+::: 
+
 创建分区命令,指定没有分区的磁盘
 ```metadata json
 fdisk /dev/vdb
@@ -20,11 +27,19 @@ fdisk /dev/vdb
 ![扩展盘分区 centos7-fdisk_001](./img/centos7-fdisk_001.jpg)
 
 ### 格式化
+::: danger 警告
+
+1.非专业人士不要进行操作,会导致系统崩溃,数据丢失,责任自负。
+
+2.已经做完分区的不需要执行此步骤。
+
+3.格式化时一定注意盘符,不要是vba1,注意,注意,注意 ,vba1 为系统盘符
+::: 
 ```
 mkfs.ext4 /dev/vdb1
 ```
 
-![格式化 centos7-fdisk_001](./img/centos7-mkfs_001.jpg)
+![格式化 centos7-fdisk_001](./img/centos7-fdisk_001.jpg)
 
 ### 查看磁盘的 UUID
 ```
@@ -34,12 +49,28 @@ mkfs.ext4 /dev/vdb1
 ```
 
 ### 编辑文件“/etc/fstab”,
+```metadata json
+vi /etc/fstab
+```
+
 将扩展盘挂载到“/opt”
 ```
-UUID=ee865766-b0d0-4518-8969-49e432f23838 /opt                    ext4    defaults        1 1
+UUID=ee865766-b0d0-4518-8969-49e432f23838 /opt                    ext4    defaults        0 0
+```
+
+### 执行挂载生效
+```metadata json
+mount -a
+```
+
+查询是否挂载成功
+```metadata json
+df -h
 ```
+![查看 centos7-fdisk_001](./img/centos7-fdisk_002.png)
+
+或者重启系统
 
-### 重启系统
 ```
 reboot
 ```

BIN
docs/setup/server/centos/os/img/centos7-fdisk_002.png


+ 116 - 0
docs/setup/server/centos/server/docker.md

@@ -0,0 +1,116 @@
+# docker
+## Docker 安装 
+
+此处在 Centos7 进行安装,linux 3.10 内核,docker 官方说至少 3.8 以上,建议 3.10 以上(ubuntu 下要 linux 内核 3.8 以上, RHEL / Centos 的内核修补过, centos6.5 的版本就可以——这个可以试试)
+
+### 查看 linux 发行版,内核
+查看版本号
+```metadata json
+[root@localhost persagy]# cat /etc/redhat-release
+```
+![docker 安装](./img/docker_0001.jpg)
+
+查看 Linux 内核
+```metadata json
+[root@localhost persagy]# uname -r
+```
+![docker 安装](./img/docker_0002.jpg)
+
+### 替换阿里云 yum 源
+下载阿里 yum 源
+```metadata json
+[root@localhost persagy]# wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo
+```
+![docker 安装](./img/docker_0003.jpg)
+
+生成仓库缓存 
+```
+[root@localhost persagy]# yum makecache
+```
+#### 安装 docker
+```metadata json
+[root@localhost persagy]# yum install docker -y
+```
+
+### docker 启动 
+启动 docker
+```metadata json
+[root@localhost persagy]# systemctl start docker
+```
+
+开机启动 docker
+```metadata json
+[root@localhost persagy]# systemctl enable docker
+```
+
+查看 docker 状态
+```metadata json
+[root@localhost persagy]# systemctl status docker
+```
+### 查看 docker 版本
+```metadata json
+[root@localhost persagy]# docker version
+```
+### 加速器
+DaoCloud 加速器 是广受欢迎的 Docker 工具,解决了国内用户访问 Docker Hub 缓慢的问题。DaoCloud 加速器结合国内的 CDN 服务与协议层优化,成倍的提升了下载速度。
+使用前请先确保您的 Docker 版本在 1.8 或更高版本,否则无法使用加速。
+http://guide.daocloud.io/dcs/daocloud-9153151.html 教程官网
+
+查看 daemon.json 中的内容 
+```
+[root@localhost persagy]# cat /etc/docker/daemon.json
+```
+![docker 安装](./img/docker_0004.jpg)
+
+如果是空的,直接修改 daemon.json
+```metadata json
+[root@localhost persagy]# vi /etc/docker/daemon.json
+```
+```metadata json
+{
+    "registry-mirrors": [
+        "http://95822026.m.daocloud.io"
+    ],
+    "insecure-registries": []
+}
+```
+保存退出,或者使用另外一条命令直接修改
+```metadata json
+[root@localhost persagy]# curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://95822026.m.daocloud.io
+```
+#### 注意 
+修改的内容里面可能多了一个逗号,使用命令查新
+```metadata json
+[root@localhost persagy]# cat /etc/docker/daemon.json
+```
+![docker 安装](./img/docker_0005.jpg)
+
+使用 vi 打开 daemon.json 文件去掉多余的逗号
+
+![docker 安装](./img/docker_0006.jpg)
+
+重启 docker
+```metadata json
+[root@localhost persagy]# systemctl restart docker
+```
+### 查看版本
+```metadata json
+[root@localhost persagy]# docker version
+```
+![docker 安装](./img/docker_0007.jpg)
+
+
+## 修改 docker 存储位置
+
+
+
+
+
+
+
+
+
+
+
+
+

BIN
docs/setup/server/centos/server/img/docker_0001.jpg


BIN
docs/setup/server/centos/server/img/docker_0002.jpg


BIN
docs/setup/server/centos/server/img/docker_0003.jpg


BIN
docs/setup/server/centos/server/img/docker_0004.jpg


BIN
docs/setup/server/centos/server/img/docker_0005.jpg


BIN
docs/setup/server/centos/server/img/docker_0006.jpg


BIN
docs/setup/server/centos/server/img/docker_0007.jpg


+ 1 - 0
docs/setup/server/index.js

@@ -22,6 +22,7 @@ const content = [
                     ["/setup/server/centos/server/tomcat", "Tomcat"],
                     ["/setup/server/centos/server/postgresql", "PostgreSQL"],
                     ["/setup/server/centos/server/postgresql-docker", "PostgreSQL(Docker版)"],
+                    ["/setup/server/centos/server/docker", "docker"],
                     ["/setup/server/centos/server/kafka", "Kafka"]
                 ]
             },

+ 17 - 7
docs/setup/server/windows/server/python.md

@@ -26,15 +26,25 @@
 点击“Disable path length limit”,取消路径长度限制。点击“Close”按钮完成安装。
 
 ## 配置 python 国内源
+```metadata json
+ # 阿里源
+pip3 config set global.index-url https://mirrors.aliyun.com/pypi/simple/
+```
+临时指定 pip3 源
+```metadata json
+ # 以使用清华大学的镜像源安装matplotlib为例
+ pip install matplotlib -i  https://pypi.tuna.tsinghua.edu.cn/simple/
+
+```
 
 ## 安装常用 python 库
 
 ```
-D:\SDK\Python37> pip3 install vg
-D:\SDK\Python37> pip3 install numpy
-D:\SDK\Python37> pip3 install matplotlib
-D:\SDK\Python37> pip3 install shapely
-D:\SDK\Python37> pip3 install networkx
-D:\SDK\Python37> pip3 install jieba
-D:\SDK\Python37> pip3 install short-text-sim -i http://dev.dp.sagacloud.cn:8082/repository/saga-pypi-group/simple --trusted-host dev.dp.sagacloud.cn
+ pip3 install vg
+ pip3 install numpy
+ pip3 install matplotlib
+ pip3 install shapely
+ pip3 install networkx
+ pip3 install jieba
+ pip3 install short-text-sim -i http://dev.dp.sagacloud.cn:8082/repository/saga-pypi-group/simple --trusted-host dev.dp.sagacloud.cn
 ```

+ 8 - 0
docs/standard/doc/kotlin/README.md

@@ -0,0 +1,8 @@
+---
+sidebarDepth: 2
+---
+
+# Kotlin 文档注释
+::: details 目录
+[[toc]]
+:::

+ 369 - 0
docs/standard/doc/kotlin/tags.md

@@ -0,0 +1,369 @@
+---
+sidebarDepth: 2
+---
+# 标签
+
+::: details 目录
+[[toc]]
+:::
+
+https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html
+## 标签
+### @author
+----
+
+作者。用于类和接口注释。可有零到多个。
+
+**语法:**
+```
+@author name-text
+```
+
+**参数:**
+
+* *name-text*
+
+&emsp;&emsp;    作者。
+
+**示例:**
+
+一个作者
+```typescript {4}
+/**
+ * 点数据类型定义
+ *
+ * @author 庞利祥 <sybotan@126.com>
+ */
+export class SPoint {
+    //
+}
+```
+
+多个作者
+```typescript {4,5}
+/**
+ * 点数据类型定义
+ *
+ * @author 庞利祥 <sybotan@126.com>
+ * @author 庞凌峰 <sandy@126.com>
+ */
+export class SPoint {
+    //
+}
+```
+
+### @deprecated
+----
+废除标志。标识过期API(为了保证兼容性,仍可用,但不推荐用)。最多一个。
+
+**语法:**
+```
+@deprecated deprecated-text
+```
+
+**参数:**
+* *deprecated-text*
+
+&emsp;&emsp;    废除的原因。
+
+**示例:**
+```typescript{5,14}
+/**
+ * 点数据类型定义
+ *
+ * @author 庞利祥 <sybotan@126.com>
+ * @deprecated  使用 SPoint 类代替。
+ */
+export class SPointF {
+
+    /**
+     * 平移点
+     *
+     * @param dx    X 轴位移
+     * @param dy    Y 轴位移
+     * @deprecated  不在支持
+     */
+    translate(dx: number, dy: number): void {
+        this.x += dx;
+        this.y += dy;
+    }
+}
+```
+
+### @exception 或 @throws
+----
+
+标识函数会抛出异常。
+
+**语法:**
+```
+@exception  class-name  description
+```
+或
+```
+@throws  class-name  description
+```
+
+
+**参数:**
+
+* *class-name*
+
+&emsp;&emsp;    抛出的异常类。
+
+* *description*
+
+&emsp;&emsp;    异常描述。
+
+**示例:**
+```typescript
+
+```
+
+
+### @param
+----
+函数入参。
+
+**语法:**
+```
+@param  parameter-name description
+```
+
+**参数:**
+
+* *parameter-name*
+
+&emsp;&emsp;    参数名。
+
+* *description*
+
+&emsp;&emsp;    参数描述。
+
+**示例:**
+
+函数入参
+
+```typescript {5,6}
+export class S {
+    /**
+     * 平移矩形
+     *
+     * @param   dx      x 轴位移
+     * @param   dy      y 轴位移
+     */
+    translate(dx: number, dy: number): void {
+        this.x += dx;
+        this.y += dy;
+    }
+}
+```
+
+构造函数入参
+
+```typescript {5-8}
+export class SRect {
+    /**
+     * 构造函数
+     *
+     * @param   x           x 轴坐标
+     * @param   y           y 轴坐标
+     * @param   width       宽度
+     * @param   height      高度
+     */
+    constructor(x: number, y: number, width: number, height: number) {
+    }
+}
+```
+
+带泛型的函数
+```typescript {4,5}
+/**
+ * 返回对象的标识符
+ *
+ * @param   <T>     泛型类型
+ * @param   arg     入参
+ */
+function identity<T>(arg: T): T {
+    return arg;
+}
+```
+
+### @return
+----
+函数返回值描述。
+
+**语法:**
+```
+@return  description
+```
+
+**参数:**
+
+* *description*
+
+&emsp;&emsp;    返回值描述。
+
+**示例:**
+```typescript{5}
+/**
+ * 旋转变形
+ *
+ * @param   angle       绕 z 轴旋转角度(单位角度)
+ * @return  返回自身
+ */
+rotate(angle: number): SMatrix {
+    ......
+    return matirx;
+}
+```
+
+### @see
+----
+
+**语法:**
+```
+@see  reference
+```
+
+**参数:**
+
+* *reference*
+
+&emsp;&emsp;    参考对象。
+
+**示例:**
+```typescript
+
+```
+
+### @serial
+----
+
+**语法:**
+```
+@serial  field-description | include | exclude
+```
+
+**参数:**
+
+**示例:**
+```typescript
+
+```
+
+### @serialField
+----
+
+**语法:**
+```
+@serialField  field-name  field-type  field-description
+```
+
+**参数:**
+
+**示例:**
+```typescript
+
+```
+
+### @serialData
+----
+
+**语法:**
+```
+@serialData  data-description
+```
+
+**参数:**
+
+**示例:**
+```typescript
+
+```
+
+### @since
+----
+
+**语法:**
+```
+@since  since-text
+```
+
+**参数:**
+
+* *since-text*
+
+&emsp;&emsp;    起始版本。
+
+**示例:**
+```typescript
+/**
+ * @since   1.0.0
+ */
+export class SObject {
+    //
+}
+```
+
+### @version
+----
+版本号。
+
+**语法:**
+```kotlin
+@version  version-text
+```
+
+**参数:**
+
+* *version-text*
+
+&emsp;&emsp;    版本号。
+
+**示例:**
+```typescript{2}
+/**
+ * @version 2.2.56
+ */
+export class SObject {
+    //
+}
+```
+
+### {@code text}
+----
+
+### {@docRoot}
+----
+
+### {@inheritDoc}
+----
+
+### {@link package.class#member label}
+----
+
+### {@linkplain package.class#member label}
+----
+
+### {@literal text}
+----
+
+### {@value package.class#field}
+----
+
+## 用途
+### Overview Tags
+@see reference || @since since-text || @serialField field-name field-type field-description || @author name-text || @version version-text || {@link package.class#member label} || {@linkplain package.class#member label} || {@docRoot}
+
+### Package Tags
+@see reference || @since since-text || @serial field-description | include | exclude || @author name-text || @version version-text || {@linkplain package.class#member label} || {@linkplain package.class#member label} || {@docRoot}
+
+### Class and Interface Tags
+@see reference || @since since-text || @deprecated deprecated-text || @serial field-description | include | exclude || @author name-text || @version version-text || {@link package.class#member label} || {@linkplain package.class#member label} || {@docRoot}
+
+### Field Tags
+@see reference || @since since-text || @deprecated deprecated-text || @serial field-description | include | exclude || @serialField field-name field-type field-description || {@link package.class#member label} || {@linkplain package.class#member label} || {@docRoot} || {@value package.class#field}
+
+### Constructor and Method Tags
+@see reference || @since since-text || @deprecated deprecated-text || @param parameter-name description || @return description || @throws class-name description || @exception class-name description || @serialData data-description || {@link package.class#member label} || {@linkplain package.class#member label} || {@inheritDoc} || {@docRoot}

+ 1 - 1
package.json

@@ -12,10 +12,10 @@
     "publish": "node publish.js"
   },
   "dependencies": {
+    "@persagy-vue/doc": "^1.1.36",
     "@persagy-web/base": "2.2.1",
     "axios": "^0.18.1",
     "element-ui": "^2.12.0",
-    "sybotan-vue-doc": "^1.1.20",
     "vue": "^2.6.10",
     "vue-property-decorator": "^8.4.2"
   },