atuinframework/atuin-tools

Atuin工具 - Atuin Web框架的工具套件

https://img.shields.io/docker/automated/atuinframework/atuin-tools.svg](https://hub.docker.com/r/atuinframework/atuin-tools/) https://img.shields.io/docker/build/atuinframework/atuin-tools.svg](https://hub.docker.com/r/atuinframework/atuin-tools/) https://img.shields.io/docker/pulls/atuinframework/atuin-tools.svg](https://hub.docker.com/r/atuinframework/atuin-tools/) https://readthedocs.org/projects/atuin-tools/badge/?version=latest](https://atuin-tools.readthedocs.io/en/latest/?badge=latest)

现代开发中需使用多种工具处理资源（如编译JS、压缩文件等），本容器通过创建运行https://www.npmjs.com/package/gulp的环境，简化Atuin Web框架的静态资源构建流程，可生成app/static/min目录下的资源文件。

核心功能

• Python模块更新
• SASS转CSS编译
• CSS合并与压缩
• JS合并、压缩与混淆
• 无质量损失的图片优化
• 翻译管理（基于Babel_实现）
• 部署前准备任务（CSS、JS、图片精细优化）

使用场景

1. 开发阶段：实时监控CSS/JS文件变化，自动重建压缩文件（支持生产模式）
2. 部署前：执行静态资源最终优化，确保文件适合生产环境
3. 翻译管理：提取、更新、编译多语言翻译文件

配置与任务说明

主要Gulp任务

GULP任务
default | help
	显示可用任务列表

update
	依赖管理：更新requirements.txt中指定的依赖

monitor [--type production]
	实时监控CSS和JS文件变化，处理错误并重建压缩文件。
	--type production：启用CSS压缩和JS混淆（生产模式）

prepare-deploy
	部署前准备：对静态文件进行压缩、混淆等优化，适用于生产环境

clean[:min|:css|:js|:img]
	清理文件：
	- 无参数：清理项目中所有*.pyc、*.pyo、*.~文件
	:min：清理app/static/min目录下所有文件
	:css：清理app/static/min/css目录下文件
	:js：清理app/static/min/js目录下文件
	:img：清理app/static/min/img目录下文件


本地化子系统
translations<:extract|:update|:compile|:init>
	翻译管理：每种语言需通过:init初始化
	:extract：从源码中提取翻译内容
	:update：更新所有语言的翻译消息文件
	:compile：编译所有语言的messages.po文件
	:init --lang <code>：初始化新语言（code为语言代码，如'en'、'de'）

部署前操作示例

在应用部署前，可通过以下命令完成静态文件优化：

bash
docker-compose run --rm tools gulp prepare-deploy

该命令会以生产模式对项目静态文件进行压缩、混淆，使其适合部署。

其他说明

• 本容器专为Atuin Web框架设计，若用于其他项目需根据需求调整
• 容器在Docker Hub自动构建，可直接拉取使用

链接

• https://atuin-tools.readthedocs.io/
• https://hub.docker.com/r/atuinframework/atuin-tools/