eeacms/forests-frontend

镜像概述

本镜像为FISE（特定项目/系统）提供Volto前端框架支持，基于React构建，用于前端应用的开发、构建、测试和生产部署。Volto是Plone CMS的现代前端解决方案，本镜像集成了开发所需的核心工具和命令，简化前端工作流。

核心功能和特性

• 开发模式支持：提供热重载功能，修改代码后页面自动刷新，提升开发效率
• 生产构建优化：生成压缩的生产版本，文件名包含哈希值，优化缓存策略
• 测试框架集成：内置Jest测试运行器，支持交互式测试和增量测试
• 国际化处理：自动提取翻译字符串并生成所需文件，简化多语言支持
• 多包开发支持：集成mr_developer工具，实现多包协同开发

使用场景和适用范围

• 前端开发阶段：需实时预览和热重载的开发环境
• 生产部署准备：构建优化后的前端资源用于生产环境部署
• 测试验证：运行单元测试和集成测试验证代码质量
• 国际化适配：提取和管理应用中的翻译字符串
• 多包协同开发：同时开发多个关联npm包时的依赖管理

使用方法和配置说明

常用命令

以下是镜像中常用的核心命令：

yarn start

• 功能：以开发模式运行项目
• 访问地址：http://localhost:3000
• 特性：代码修改后页面自动重载，实时预览效果

yarn build

• 功能：构建生产环境应用到build文件夹
• 特性：代码被压缩，文件名包含哈希值（用于缓存控制），生成可直接部署的生产版本

yarn start:prod

• 功能：运行生产环境编译后的应用
• 访问地址：http://localhost:3000
• 适用场景：验证生产构建后的应用运行状态

yarn test

• 功能：以交互式模式运行测试监控器（Jest）
• 特性：默认仅运行上次提交后修改文件相关的测试，提升测试效率

yarn i18n

• 功能：运行国际化测试工具，提取所有翻译字符串并生成必要的翻译文件
• 用途：支持应用的多语言国际化适配

mr_developer工具集成

mr_developer 是一款用于多包协同开发的工具，可同时管理多个npm包的开发版本。

使用方法

1. 确保已安装mr_developer（可通过npm install -g mr-developer全局安装）
2. 在项目中执行以下命令：

   bash
   mrdeveloper --config=jsconfig.json
   

配置说明

Volto最新的razzle配置会自动识别jsconfig.json文件中的自定义设置，可通过该文件配置多包开发的路径和依赖关系。