scratch-www项目安装与配置指南
scratch-www Standalone web client for Scratch 项目地址: https://gitcode.com/gh_mirrors/scr/scratch-www
1. 项目基础介绍
scratch-www 是 Scratch 开源项目的一部分,由 Scratch Foundation 维护。该项目是 Scratch 网站的核心组成部分,提供了项目页面、主页、创意页面、Scratch 扩展的着陆页以及 Scratch 桌面信息页面等功能。主要使用 JavaScript 进行开发,是一个基于 Node.js 的 web 应用程序。
2. 项目使用的关键技术和框架
- 编程语言:JavaScript
- 关键技术:
- Node.js:作为服务端运行环境
- Webpack:用于打包和编译前端资源
- React:用于构建用户界面的 JavaScript 库
- Redux:用于管理应用状态
- Sass:CSS 预处理器,用于扩展 CSS
- 测试技术:
- Jest:用于编写大部分新测试
- Tap:正在逐步弃用,但许多测试仍在使用
- Enzyme:用于 React 组件测试
- Selenium:用于端到端测试
3. 项目安装和配置的准备工作与详细步骤
准备工作
在开始安装之前,请确保您的系统中已经安装了以下软件:
- Node.js:版本 16
- npm (Node Package Manager):用于管理和更新项目所需的包
安装步骤
-
克隆项目
使用 Git 命令克隆项目到本地:
git clone https://github.com/scratchfoundation/scratch-www.git cd scratch-www
-
安装依赖
在项目目录中,运行以下命令安装项目依赖:
npm install
注意:在安装过程中可能会出现一些警告,这些警告可以安全地忽略。
-
编译项目
为了在浏览器中查看项目,需要编译源代码。可以一次性构建项目,也可以启动一个本地服务器,实时编译更改的文件。
-
一次性构建:
npm run build
-
启动本地服务器:
首先运行翻译命令:
npm run translate
然后启动服务器:
npm start
在开发过程中,
npm start
会监视./static
或./src
目录下文件的更改,并重新构建项目。
-
-
查看本地站点
在完成构建后,可以通过浏览器访问
localhost:8333
来查看本地的站点。 -
停止本地服务器
若要停止
npm start
进程,可以在终端中使用^C
(control-c)。
配置
npm start
可以通过以下环境变量进行配置,将这些变量设置在命令的开始部分,位于 npm start
之前:
API_HOST
:API 请求的主机名,默认为https://api.scratch.mit.edu
ASSET_HOST
:资源请求的主机名,默认为https://assets.scratch.mit.edu
BACKPACK_HOST
:背包功能的主机名,默认为https://backpack.scratch.mit.edu
以上就是 scratch-www 项目的详细安装和配置指南。按照以上步骤操作,您应该能够成功地在本地运行该项目。
scratch-www Standalone web client for Scratch 项目地址: https://gitcode.com/gh_mirrors/scr/scratch-www