首先向您表示感谢,开源社区因为有您而生机勃勃,jsMind也因您而有了更大的价值。
向 jsMind 贡献代码的基本流程是:
- fork jsmind
- 开发新功能或改进当前版本
- 测试您的代码
- 给 jsmind 提交 pull-request
- 等待审查,审查期间可能会请你对您的代码进行修改
- 合并你的 pull-request 到 jsMind 项目中
Pull-Request 及 Fork : 阅读 github pull-request 文档, 了解如何通过 fork 及 pull-request 提交你的代码。
Node.js : 项目中使用 jsMind 并不依赖 Node.js 环境,但是在开发时,我们需要在 Node.js 环境下执行单元测试、代码格式化检查、及打包和压缩。jsMind 的 CI 环境里使用的 Node 版本是 18.x。
Visual Studio Code : 如果您使用的 IDE 是 VS Code, 建议您安装这个插件: esbenp.prettier-vscode
。这样你的 VS Code 将能自动按 jsMind 的配置对代码进行格式化。
jsMind 使用 ES6 编写,代码在 /src
目录里,一般情况下只需要改动此目录里的代码。
开发过程中请记得随时格式化代码。在命令行中执行以下代码即可对代码进行格式化:
npm run format
单元测试的代码位于 /tests/unit
目录,请为新代码的代码补充单元测试,并确保所有的单元测试都能通过。
在命令行中执行以下命令即可运行单元测试。
npm run test-es6
在命令行中执行以下命令将代码打包为便于在浏览器中执行的js文件:
npm run build
生成的代码位于 /es6
目录。
在命令行中执行以下命令可以在本机启动一个简易的 http server
npm run server
执行后会提示 http server 的访问地址,一般情况下应该是 http://127.0.0.1:8080 。这时访问 http://127.0.0.1:8080/example/2_features_es6.html 即可在本地进行调试。
无论开发新功能还是修复bug, 都建议把页面上所有的用例全部测试一遍。
需要提醒的是,调试过程中如果修改了 js 文件,请重新执行打包命令 npm run build
并刷新页面才能查看到新的效果。
禁止转载、禁止演绎。
jsMind 项目仍在不断升级变化,版本更新时会同时更新对应的文档。为避免给使用者带来困惑,在没有得到书面许可前,禁止转载本文档,同时禁止对本文档进行任何形式的更改。