datasci4health/harena-space

Harena Space

Harena环境的基于Web的前端模块。Harena是一个集成创作环境、播放器引擎和Versum叙事脚本语言翻译器的平台，官方实例可访问：[***]

概述

本镜像提供Harena Space的Docker容器化部署，确保运行代码所需的最小配置环境，方便本地快速部署和使用Harena前端功能。

核心功能与特性

• Web前端界面：提供Harena环境的直观Web操作界面，支持创作、播放叙事内容
• Versum翻译器集成：内置Versum叙事脚本语言翻译器，支持语法解析与HTML输出
• 数字内容组件(DCCs)支持：提供数字内容组件的参考、实例化及定制功能
• Docker化部署：通过Docker容器确保环境一致性，简化本地部署流程

使用场景与适用范围

适用于内容创作者、开发者在本地环境运行Harena前端，进行叙事脚本的编写、翻译测试、数字内容组件的定制与集成，或扩展Harena平台功能。

使用方法

前提条件

• 安装Docker和Docker Compose，参考官方文档：Docker安装、Docker Compose安装
• （可选）配置Docker无需sudo执行：Linux post-installation步骤

Linux用户部署步骤

1. 克隆并构建harena-manager镜像

bash
git clone https://github.com/datasci4health/harena-manager.git
cd harena-manager
git checkout -b development
git pull origin development

docker build . -t manager
cd ..

2. 克隆harena-space代码

bash
git clone https://github.com/datasci4health/harena-space.git
cd harena-space
git checkout -b development
git pull origin development

3. 启动Docker容器

bash
docker-compose -f docker-compose-dev.yml up

首次启动需等待约5分钟，按Ctrl+c停止后重新启动：

bash
docker-compose -f docker-compose-dev.yml up

4. 访问服务

启动完成后，访问 http://localhost:***/ 验证系统运行状态。

5. 进入容器命令行（可选）

bash
docker exec -it harena-space_harena-space_1 bash

Harena技术细节

Versum翻译器

• 语法与对象表示：参考https://github.com/datasci4health/harena-docs/blob/master/versum/syntax.md
• 翻译器Playground：在线测试Versum翻译效果，查看HTML输出：Translator Playground

数字内容组件(DCCs)

• 参考与示例：查看DCCs的使用文档与示例：http://datasci4health.github.io/harena-space/src/adonisjs/public/dccs/
• DCC Playground：实例化和定制DCCs：http://datasci4health.github.io/harena-space/src/adonisjs/public/dccs/playground/

变更日志

发布更新详情见https://github.com/datasci4health/harena-space/blob/development/CHANGELOG.md%E3%80%82

分支组织

• master：生产环境分支，用于官方实例[***] Request从development分支合并更新
• development：开发分支，包含最新开发特性，运行于[***] Request合并新功能