Skip to content

Latest commit

 

History

History
78 lines (55 loc) · 2.97 KB

5.development.md

File metadata and controls

78 lines (55 loc) · 2.97 KB

目录

  1. 基本用法
  2. 选项
  3. 界面操控
  4. 参与贡献
  5. 附:贡献代码指南 *

首先向您表示感谢,开源社区因为有您而生机勃勃,jsMind也因您而有了更大的价值。

5.1. 基本流程

向 jsMind 贡献代码的基本流程是:

  1. fork jsmind
  2. 开发新功能或改进当前版本
  3. 测试您的代码
  4. 给 jsmind 提交 pull-request
  5. 等待审查,审查期间可能会请你对您的代码进行修改
  6. 合并你的 pull-request 到 jsMind 项目中

5.2. 开发前的准备

Pull-Request 及 Fork : 阅读 github 文档 中文, 英文, 了解如何通过 fork 及 pull-request 提交你的代码。

Node.js : 使用 jsMind 时是不需要在 Node.js 环境下的,但是在开发时,需要在 Node.js 环境下执行单元测试、代码格式化检查、及打包和压缩。对 Node.js 的版本没有强烈的要求,但是 CI 环境里使用的是 18.x 的版本,如果您提交 pull-request 后发现没有通过 CI 检测,请将你的 node 修改为 18.x 的版本。

Visual Studio Code : 如果您使用的 IDE 是 VS Code, 建议您安装这个插件: esbenp.prettier-vscode 。这样的话在本项目里,你的 VS Code 将能自动按 jsMind 的配置对代码进行格式化

5.3. 开发

jsMind 使用 ES6 编写,代码在 /src 目录里,一般情况下只需要在此目录里开发即可。

开发过程中请记得随时格式化代码。在命令行中执行以下代码即可对代码进行格式化:

npm run format

5.4. 单元测试

单元测试的代码位于 /tests/unit 目录,请为新代码的代码补充单元测试,并确保所有的单元测试都能通过。

在命令行中执行以下命令即可运行单元测试。

npm run test-es6

5.5. 打包及压缩

在命令行中执行以下命令将代码打包为便于在浏览器中执行的js文件:

npm run build

生成的代码位于 /es6 目录。

5.5. 本地预览及调试

在命令行中执行以下命令可以在本机启动一个简易的 http server

npm run server

执行后一会提示 http server 的访问地址,一般情况下应该是 http://127.0.0.1:8080 。这时访问 http://127.0.0.1:8080/example/2_features_es6.html 即可在本地进行调试。

无论开发的是否是新的feature, 都建议把页面上所有的用例全部测试一遍。

需要提醒的是,调试过程中如果修改了 js 文件,请重新执行打包命令 npm run build 并刷新页面才能查看到新的效果。

版权声明

禁止转载、禁止演绎。

jsMind 项目仍在不断升级变化,版本更新时会同时更新对应的文档。为避免给使用者带来困惑,在没有得到书面许可前,禁止转载本文档,同时禁止对本文档进行任何形式的更改。