Wger Workout Manager安装与使用指南

Wger Workout Manager安装与使用指南

wgerSelf hosted FLOSS fitness/workout, nutrition and weight tracker written with Django项目地址:https://gitcode.com/gh_mirrors/wg/wger

1. 项目目录结构及介绍

Wger Workout Manager是一个自由开放源代码的网页应用程序，专为个人健身、体重管理以及饮食规划设计。以下是项目的主要目录结构及其简要说明：

• wger: 核心应用目录，包含Django的应用模块。
  • management: 包含Django管理命令。
  • models: 定义数据库模型。
  • views: 控制视图逻辑。
• templates: 存储HTML模板，用于呈现网站前端界面。
• static: 静态资源，如CSS、JavaScript和图像文件等。
• media: 用户上传的媒体文件（例如，锻炼图片）存放处。
• docker-compose.yml: 如果选择使用Docker部署，这是关键的配置文件，用于定义服务、网络和卷。
• requirements.txt: 列出了运行项目所需的Python库。

2. 项目的启动文件介绍

在Wger Workout Manager中，虽然没有特定命名为“启动文件”的文件，但项目部署的关键在于其Docker化配置或直接使用Django的标准运行方式。

使用Docker启动

如果你打算通过Docker来快速启动项目，主要参考的是位于项目根目录下的docker-compose.yml文件。执行以下步骤即可启动应用：

docker-compose up -d

这将基于docker-compose.yml中的配置启动所需的服务，包括数据库和应用服务器。

直接使用Django

对于开发者而言，不使用Docker的情况下，需先确保安装了必要的Python环境和依赖。典型启动步骤包括：

1. 虚拟环境创建与激活（推荐）。
2. 运行pip install -r requirements.txt以安装所有必需的Python包。
3. 执行python manage.py migrate进行数据库迁移。
4. 运行python manage.py runserver启动开发服务器。

3. 项目的配置文件介绍

Django的基本配置

Wger的大部分配置是基于Django的默认设置，主要配置位于wger/settings.py。该文件包含了数据库连接、应用配置、静态文件路径以及其他一系列的Django相关设定。

环境变量与额外配置

对于生产环境，特别是通过Docker部署时，配置通常通过环境变量来定制。这些变量可以在.env文件或直接在Docker Compose文件中指定，如数据库URL、密钥和其他敏感数据。

自定义配置

Wger允许对特定功能进行配置，比如启用或禁用某些模块、调整工作流设置等，这些配置可能分散在不同的地方，比如特定应用的models.py或者通过Django的settings中添加的自定义配置模块。

请注意，深入配置Wger通常涉及到对Django框架的理解，以及阅读项目文档来获取更详细的信息。在实际操作中，务必参考最新版本的项目文档和官方GitHub仓库中的说明。

wgerSelf hosted FLOSS fitness/workout, nutrition and weight tracker written with Django项目地址:https://gitcode.com/gh_mirrors/wg/wger