Django-ForRunners

在django中存储您的跑步（或其他体育活动）的GPX轨迹。

(名称 Django-ForRunners 来自伟大的Android跟踪应用 ForRunners，由Benoît Hervier创建： http://rvier.fr/#forrunners )

django-for-runners_ynh 允许您在YunoHost服务器上快速简单安装Django-ForRunners。如果您没有YunoHost，请参阅 指南 了解如何安装它。

功能

• GPX轨迹管理
  • 上传GPX轨迹
  • 从命令行导入GPX轨迹
  • 轨迹分析
    • 基本：轨迹长度 / 持续时间 / 配速 / 心率上下坡
    • 在OpenStreetMap地图上显示路线
    • 海拔 / 心率 / 骑行节奏图（如果GPX数据中可用）
  • 从网络上自动提取的数据
    • 来自OpenStreetMap的起点/终点地址
    • 来自metaweather.com的起点/终点天气信息
  • 存储其他数据
    • 理想轨迹距离（便于分组/筛选轨迹）
• 体育赛事管理
  • 创建体育赛事列表
    • 添加对活动的参与
    • 将GPX轨迹与活动参与链接
    • 存储您的活动参与
      • 官方轨迹长度
      • 测量的完成时间
      • 完成您项目的参赛者数量
    • 添加与该活动相关的网页链接
    • 记录费用（报名费、T恤等）
• 通用
  • 支持多用户（然而：没有权限管理，目前仅适用于少数用户）

开发者信息

准备

要开始破解：只需克隆项目，然后运行 ./manage.py 以启动虚拟环境

# Install base requirements for bootstraping:
~$ sudo apt install python3-pip python3-venv

# Get the sources:
~$ git clone https://github.com/jedie/django-for-runners.git
~$ cd django-for-runners/

# Just call manage.py:
~/django-for-runners$ ./manage.py --help
...
[manage_django_project]
    code_style
    coverage
    install
    project_info
    publish
    run_dev_server
    safety
    tox
    update_req
...

此引导程序是通过以下方式实现的：https://github.com/jedie/manage_django_project

启动 Django 开发服务器

~/django-for-runners$ ./manage.py run_dev_server

网页在端口 8000 上可用，例如：http://127.0.0.1:8000/

运行测试，例如

~/django-for-runners$ ./manage.py test
# or with coverage
~/django-for-runners$ ./manage.py coverage
# or via tox:
~/django-for-runners$ ./manage.py tox

导入 GPX 文件

例如

~/django-for-runners$ ./manage.py import_gpx --username <django_username> ~/backups/gpx_files

注意：使用相同的 GPX 文件启动 import_gpx 没有问题：避免重复条目。比较开始/结束（时间/纬度/经度）。

备份

将备份创建到 .../backups/<timestamp>/，例如。

~/django-for-runners$ ./manage.py backup

备份操作包括

• 备份数据库
• 导出所有 GPX 轨迹
• 生成 .csv 文件
• 包含所有运行轨迹的完整文件
• 每个用户的文件一个

屏幕截图

（所有屏幕截图在此：github.com/jedie/jedie.github.io/tree/master/screenshots/django-for-runners）

for-runners v0.6.0 2018-07-31 GPX Track.png

for-runners v0.4.0 2018-6-26 GPX info.png

for-runners v0.6.0 2018-07-19 Event Costs.png

打印小概览

一些注释

GPX 存储

目前我们在 TextField 中存储未更改的 GPX 数据。

静态文件

我们收集了一些 JavaScript 文件，以便更容易启动。这些文件是

坐标精度

Garmin 的 GPX 文件（可能）包含

• 纬度有 29 位小数
• 经度有 28 位小数
• 海拔有 19 位小数

OpenStreetMap 上的路线没有更多细节，超过 5 位小数。

另请参阅：https://wiki.openstreetmap.org/wiki/Precision_of_coordinates

创建新版本

我们使用 cli-base-utilities 在本 README 中生成历史记录。

要创建新版本，请执行以下操作

• 增加您的项目版本号
• 运行测试以更新 README
• 提交更改
• 创建版本

Django 兼容性

（另请参阅 pyproject.toml 中的 tox 设置 和 github actions 中的组合）

向后不兼容的更改

v0.16.0

我们已从 Poetry 转换为 pip-tools 和 https://github.com/jedie/manage_django_project。只需删除旧 Poetry venv 并通过调用 ./manage.py 来引导，如上所述。

我们还从测试矩阵中删除了不同的 Django 版本，并仅使用当前最新版本。因为这是一个项目，而不是真正的可重用应用程序；)

历史记录

• v0.20.0
  • 2024-08-25 - 更新要求
  • 2024-08-25 - 应用 manageprojects 更新
  • 2024-08-13 - 修复了如果不存在事件则损坏的事件更改列表的 bug
  • 2024-08-13 - 允许在 GPX 更改列表中使用分面
  • 2024-08-13 - 导出版本
  • 2024-08-13 - 更新 README
  • 2024-08-13 - 更新到 Django 5.1
• v0.19.0
  • 2024-08-04 - 发布为 v0.19.0
  • 2024-08-04 - 修复了 3.11 安装中的 bug
  • 2024-08-04 - 修复代码风格
  • 2024-08-04 - 增强“更改列表”中的轨迹上传
  • 2024-08-04 - 设置最小 Python 版本 v3.11
  • 2024-08-04 - 更新要求
• v0.18.1
  • 2024-08-02 - 更新/修复 "fill_basedata" 命令
• v0.18.0
  • 2024-08-02 - 更新 README.md
  • 2024-08-02 - 扩展测试矩阵以包含 3.12 并移除 3.9 支持
  • 2024-08-02 - Bugfix CI: 添加 "*.snapshot.json" 文件 ;)
  • 2024-08-02 - 添加 https://pre-commit.git-scm.cn 钩子
  • 2024-08-02 - 将 "safety" 替换为 "pip-audit"
  • 2024-08-01 - 将 metaweather.com 替换为 open-meteo.com
  • 2024-08-01 - 更新 test_add_gpx()
  • 2024-08-01 - 更新 Leaflet 到 v1.9.4 并修复样式
  • 2024-08-01 - 支持 Pentax K-1 创建的 KML 轨迹导入
  • 2024-08-01 - 捕获 metaweather.com 错误
  • 2024-07-31 - 项目更新
  • 2024-07-31 - 更新 requirements
  • 2024-01-18 - +typeguard +manageprojects 更新
  • 2023-12-17 - 使用 cli_base.cli_tools.git_history.update_readme_history()
  • 2023-12-17 - 更新 requirements ; TODO: 更新到 Django 5.0
  • 2023-12-17 - 代码样式修复
  • 2023-12-17 - 应用 manageprojects 更新

链接

• 主页：http://github.com/jedie/django-for-runners
• PyPi：https://pypi.ac.cn/project/django-for-runners/

活动导出器

有时很难找到可以导出活动的项目。所以这里是目前我使用的工具

• Garmin-Connect-Export from rsjrny

替代方案（仅限开源）

• https://github.com/pytrainer/pytrainer（桌面程序）
• https://github.com/GoldenCheetah/GoldenCheetah/（桌面程序）

在线工具

• https://www.j-berkemeier.de/ShowGPX.html（德语）

致谢

整个项目基于许多优秀项目。特别是以下项目

• gpxpy GPX文件解析器
• Leaflet JS 一个用于交互式地图的JS库，用于在OpenStreetMap上渲染轨迹
• dygraphs 开源JavaScript图表库
• Chart.js HTML5图表
• geopy 获取GPX轨迹起点/终点的地理位置名称
• matplotlib 绘制2D图形
• autotask 安排后台作业
• svgwrite 生成SVG文件

捐赠

• paypal.me/JensDiemer
• Flattr 这！
• 向 比特币 地址 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F 发送