Pytrainer技术文档

1. 安装指南

1.1 使用现成包安装

如果你的Linux发行版（如Debian、Ubuntu、Fedora等）已经包含了pytrainer的包，直接使用包管理器安装即可。

1.2 从源码包安装

将源码包复制到具有写入和执行权限的位置（例如你的$HOME目录）。

tar -xzf pytrainer-X.Y.Z.tar.gz
cd pytrainer-X.Y.Z
pip install ."[gui]"
pytrainer

1.3 在虚拟环境中安装（用于开发）

此安装方法与基本源码安装相似。对于开发来说，从git克隆开始而不是使用tarball更有意义，并且安装到虚拟Python环境中也更合适。

git clone https://github.com/pytrainer/pytrainer.git
cd pytrainer
python3 -m venv .venv
.venv/bin/pip install -e ".[gui]"
.venv/bin/pytrainer

1.4 额外包

为了使用地图功能，需要安装WebKit2的GIR绑定。

某些插件和扩展也需要安装额外的软件：

软件包	插件或扩展
GPSBabel	Garmin通过GPSBabel和Google Earth插件（即garmin-hr）
garmintools	从Garmin GPS设备导入（Garmin通过garmintools插件即garmintools_full）
Perl	Garmin FIT插件
wordpresslib	Wordpress扩展，已包含在pytrainer源码包中
httplib2	Wordpress扩展
SOAPpy	Dotclear扩展
GDAL	高程校正扩展，通过gdal-python或python-gdal

2. 项目使用说明

Pytrainer是一个桌面应用程序，用于记录和绘制运动活动，如跑步或骑行会话的数据。可以从GPS设备、文件或手动输入导入数据。当前Pytrainer支持GPX、TCX和FIT文件。

3. 项目API使用文档

本文档不包含具体的API使用说明，因为readme中未提供相关信息。用户可以查阅项目源码和开发指南以获取API的使用方法。

4. 项目安装方式

项目安装方式已在“安装指南”部分详细说明。用户可以根据自己的需求选择从现成包安装、从源码包安装或在虚拟环境中安装（用于开发）。