# @code-dot-org/piskel 中文文档

规范地址：https://npmcn.com/package/%40code-dot-org/piskel/

版本：0\.13\.0-cdo\.14
npm 元数据更新时间：2026-07-31T20:37:14.389Z
中文译文更新时间：2026-11-10T08:49:15.318Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40code-dot-org/piskel
原文对照：https://npmcn.com/package/%40code-dot-org/piskel/?lang=original
项目主页：http://github.com/code-dot-org/piskel
源码仓库：https://github.com/code-dot-org/piskel

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.8 MB，127 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2016-06-04T00:07:42.258Z
- 最新版本发布：2026-07-31T20:37:14.118Z
- 近 30 天下载量：1998（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 1 个）

## 中文简介

Code.org分叉 Juliandescottes/piskel 用于代码工作室学习环境范围内.

## 安装

```sh
npm install @code-dot-org/piskel
```

也可以使用：`pnpm add @code-dot-org/piskel`、`yarn add @code-dot-org/piskel`、`bun add @code-dot-org/piskel`

## README

# 代码工作室 Piskel

[![Travis Status](https://api.travis-ci.org/code-dot-org/piskel.png?branch=master)](https://travis-ci.org/code-dot-org/piskel)

这是自定义的优秀版本 [Piskel 编辑器](https://github.com/juliandescottes/piskel) 以 [@juliandescottes (英语)](https://github.com/juliandescottes) 财务报告和审定财务报表 [@grosboudddha (英语)](https://github.com/grosbouddha),设计用于与Code.org代码工作室学习平台的嵌入式使用. 关于使用或开发Piskel的更多信息,请参见: [主仓库](https://github.com/juliandescottes/piskel)。 。 。 .

该项目在 npm 上公布为 [@ code- dot- org/ piskel](https://www.npmjs.com/package/@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 重播](https://github.com/piskelapp/piskel/wiki#contributing)**

### 先决条件

要建造皮斯克尔,你需要:

-   安装 [节点](https://nodejs.org/)。这个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 联合国](https://www.python.org/downloads/release/python-2718/)) (中文(简体) ).

## 国际化(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`编辑 [信件格式](http://messageformat.github.io/messageformat/) 库用于将静态的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上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

## 常见问题

### @code-dot-org/piskel 是什么？

Code\.org分叉 Juliandescottes/piskel 用于代码工作室学习环境范围内\.

### 如何安装 @code-dot-org/piskel？

在项目目录运行 npm install @code-dot-org/piskel，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 piskel-root，可以用 npx piskel-root 直接运行。

### @code-dot-org/piskel 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/code-dot-org\_\_piskel 是否存在。

### @code-dot-org/piskel 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @code-dot-org/piskel 可以商用吗？

@code-dot-org/piskel 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @code-dot-org/piskel 的下载量有多少？

根据 npm 官方下载统计，@code-dot-org/piskel 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,998 次，日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @code-dot-org/piskel 还在维护吗？

最新版本 0\.13\.0-cdo\.14 发布于 2026/08/01（3 个月前）；至今共发布 36 个版本，其中过去 12 个月发布了 1 个；首次发布于 2016/06/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。