代码工作室 Piskel
这是自定义的优秀版本 Piskel 编辑器 以 @juliandescottes (英语) 财务报告和审定财务报表 @grosboudddha (英语),设计用于与Code.org代码工作室学习平台的嵌入式使用. 关于使用或开发Piskel的更多信息,请参见: 主仓库。 。 。 .
该项目在 npm 上公布为 @ code- dot- org/ piskel。 。 。 .
使用此软件包
从 npm 安装软件包 :
npm install @code-dot-org/piskel
这将安装 Piskel 的释放构建到 node_modules/@code-dot-org/piskel。应用程序根位于 node_modules/@code-dot-org/piskel/dest/prod您可以打开 Piskel 的静态版本 index.html 在文件夹里.
A 类 piskel-root 设备也安装在 node_modules/.bin/piskel-root 打印应用程序根的绝对路径。 建议您在任何构建的脚本中依赖这个工具来抵御皮斯克尔套件内部布局的未来变化.
本地开发设置
注意: 要运行本地集成测试, 您应该安装 CasperJS 1.0.2( 不包括在本 repo 中作为一个依赖性) , 并确保它能够访问 PhantomJS 1. 9.2( 下載到 node modules/. bin上) npm install 但不一定在你的路径.
捐款
关于贡献的更多信息,请参见 主 Piskel 重播
先决条件
要建造皮斯克尔,你需要:
- 安装 节点。这个repo与节点版10最有效.
- 安装 grunt- cli
npm install grunt-cli -g。 。 。 . - 运行
npm install
Grunt 构建目标
服务
grunt serve 将:
- 构建应用程序
- 在端口9001上启动服务器( 服务)
dest文件夹) - 打开浏览器
http://localhost:9001 - 监视更改,并在需要时重建应用程序
注:使用 grunt serve --force
- 如果您尝试了 grunt 服务, 它会因警告而中止
grunt serve --force
注:如果对JSON文件作新的修改,请使用 grunt build-dev
- 如果您在 locales 目录中添加了 JSON 文件的新字符串, 您需要看到修改
grunt build-dev
播放
grunt play 将:
- 以调试模式构建应用程序
- 在端口9901上启动服务器( 服务)
dest文件夹) - 打开浏览器
http://localhost:9901/?debug - 监视更改,并在需要时重建应用程序
出版新版本
此寄存器依赖于节点版本QQ7和 < 11. 在构建和更新时请使用 QQ7 和 < 11 piskel向国家防范机制提供的新资料.
要发布新版本到 npm 切换到主分支, 请使用 npm login 作为账户登录 @code-dot-org 范围,然后 npm version [major|minor|patch] 对于合适的版本起伏。 这将实现以下目标:
- 运行起伏和测试 以验证您的本地还款.
- 重建发行软件包.
- 跳出版本,添加相应的承诺和版本标记.
- 将承诺和标记推到地上.
- 将新发行软件包发布到 npm.
如果您在测试中看到一个错误, 围绕缺失的蟒蛇(env: python: Not a directory),安装了python 2的版本(例如, 2.17.8 联合国) (中文(简体) ).
国际化(i18n)
Piskel 用户界面可以通过设置 window.piskel_locale 改为四个字母的地块代码,即:. en_us, (中文(简体) ), es_mx等 (中文(简体) ).
可用的字符串在 i18n/locales 目录和每个地方都有自己的文件。 例如: en_US.json 地点 en 是英语和 US 是美国
注意 en US. json 应当包含所有可用的字符串, 因为这是其它语言的语言, 如果不存在英语的翻译的话, 则会回落到其它语言 .
所有语言的字符串被装入 window.piskel_locales 而语言特定字符串可以使用四个字母的地语编码访问. 例如:
var i18n = window.piskel_locales[window.piskel_locale];
console.log(i18n.simplePenDrawingTool());
JSON 文件在构建期间被转换为 Javascript 文件 tasks/build-i18n.js编辑 信件格式 库用于将静态的JSON字符串转换为Javascript函数,这样能将动态内容注入字符串.
许可证
代码工作室 Piskel 是版权 2016 Code.org
Piskel是2016年Julian Descottes版权公司
两者均根据Apache许可证2.0版("License")获得许可; 您不得使用此文件,除非符合许可证. 您可在下列地点获得许可证副本:
http://www.apache.org/licenses/LICENSE-2.0
除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.