stadlerpeter/smufl-browser Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

SMuFL-Browser Docker镜像文档

镜像概述与主要用途

SMuFL-Browser是基于Web的Standard Music Font Layout (SMuFL)规范查看器，用于搜索和浏览音乐符号，并作为TEI（文本编码倡议）参考，帮助编码器在文本中添加音乐符号。本Docker镜像基于stadlerpeter/existdb构建，包含SMuFL-Browser特定配置，适用于生产环境，将SMuFL-Browser作为根应用运行。

核心功能与特性

• Web查看器：提供SMuFL规范的网页浏览界面，支持音乐符号的搜索与浏览
• TEI参考：作为TEI参考工具，帮助编码器在TEI文档中添加音乐符号
• ANT任务：包含一组ANT任务，可从SMuFL生成TEI charDecl描述
• 生产就绪：基于existdb镜像，配置为生产环境就绪，直接作为根应用运行

使用场景与适用范围

• 音乐符号研究与参考
• TEI文档中音乐符号的编码工作
• 音乐相关数字人文项目中SMuFL规范的应用
• 需要快速部署SMuFL查看工具的开发或生产环境

使用方法与配置说明

快速启动

通过以下命令运行Docker容器：

bash
docker run --rm -it \
    -p 8080:8080 \
    --name smufl-browser \
    stadlerpeter/smufl-browser

容器启动后，可通过http://localhost:8080访问SMuFL-Browser。

配置选项

该镜像基于stadlerpeter/existdb，更多配置选项（如持久化存储、环境变量设置等）可参考existdb-docker项目文档。

依赖项

运行或构建SMuFL-Browser需要以下依赖：

• Apache ANT
• XML Shell
• Saxon
• eXist-db XML数据库（2015年以后的版本，需包含修改后的HTML5序列化器）

ANT任务说明

使用ANT任务前，需安装上述依赖，并将build.properties复制为local.build.properties，根据系统配置修改路径和版本号。

charDecl目标

基于模板charDecl.xml.template生成TEI文件，包含每个SMuFL范围的charDecl元素，依赖Saxon和XML Shell。

otf2png目标

通过Alexander Erhard编写的程序，从Bravura字体生成PNG图像。

xar目标

执行上述所有任务，并将结果打包为eXist应用包（.xar）。

credits

• Daniel Spreadbury：SMuFL规范的主要开发者
• James Cummings：ENRICH Gaiji Bank项目，启发了SMuFL-Browser的功能

许可证

本作品采用双许可证：

• BSD 2-Clause许可证
• 知识共享署名4.0国际许可证（CC BY 4.0）