FitTrackee/docs/features.html

331 lines
13 KiB
HTML
Raw Normal View History

2020-12-30 11:12:35 +01:00
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
2021-11-03 12:41:23 +01:00
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<title>Features &#8212; FitTrackee 0.5.0
2020-12-30 11:12:35 +01:00
documentation</title>
2021-11-06 21:26:02 +01:00
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="_static/bootstrap-sphinx.css" />
2020-12-30 11:12:35 +01:00
<link rel="stylesheet" type="text/css" href="_static/custom.css" />
2021-11-06 21:26:02 +01:00
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
2020-12-30 11:12:35 +01:00
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
2021-11-29 18:24:22 +01:00
<link rel="next" title="Installation" href="installation.html" />
<link rel="prev" title="FitTrackee" href="index.html" />
2020-12-30 11:12:35 +01:00
<meta charset='utf-8'>
<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
<meta name="apple-mobile-web-app-capable" content="yes">
2021-10-17 09:28:56 +02:00
<script type="text/javascript" src="_static/js/jquery-1.12.4.min.js "></script>
2020-12-30 11:12:35 +01:00
<script type="text/javascript" src="_static/js/jquery-fix.js "></script>
2021-10-17 09:28:56 +02:00
<script type="text/javascript" src="_static/bootstrap-3.4.1/js/bootstrap.min.js "></script>
2020-12-30 11:12:35 +01:00
<script type="text/javascript" src="_static/bootstrap-sphinx.js "></script>
</head><body>
<div id="navbar" class="navbar navbar-default navbar-fixed-top">
<div class="container">
<div class="navbar-header">
<!-- .btn-navbar is used as the toggle for collapsed navbar content -->
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="index.html">
FitTrackee</a>
2021-11-03 12:41:23 +01:00
<span class="navbar-text navbar-version pull-left"><b>0.5.0
2020-12-30 11:12:35 +01:00
</b></span>
</div>
<div class="collapse navbar-collapse nav-collapse">
<ul class="nav navbar-nav">
<li><a href="https://github.com/SamR1/FitTrackee">GitHub</a></li>
<li class="dropdown globaltoc-container">
<a role="button"
id="dLabelGlobalToc"
data-toggle="dropdown"
data-target="#"
href="index.html">Docs <b class="caret"></b></a>
<ul class="dropdown-menu globaltoc"
role="menu"
aria-labelledby="dLabelGlobalToc"><ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Features</a></li>
2021-11-29 18:24:22 +01:00
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
2020-12-30 11:12:35 +01:00
<li class="toctree-l1"><a class="reference internal" href="api/index.html">API documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting/index.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="changelog.html">Change log</a></li>
</ul>
</ul>
</li>
<li class="dropdown">
<a role="button"
id="dLabelLocalToc"
data-toggle="dropdown"
data-target="#"
href="#">Page <b class="caret"></b></a>
<ul class="dropdown-menu localtoc"
role="menu"
aria-labelledby="dLabelLocalToc"><ul>
<li><a class="reference internal" href="#">Features</a><ul>
<li><a class="reference internal" href="#list">List</a><ul>
<li><a class="reference internal" href="#administration">Administration</a></li>
2021-11-12 19:25:31 +01:00
<li><a class="reference internal" href="#account-preferences">Account &amp; preferences</a></li>
<li><a class="reference internal" href="#workouts">Workouts</a></li>
2020-12-30 11:12:35 +01:00
<li><a class="reference internal" href="#translations">Translations</a></li>
</ul>
</li>
<li><a class="reference internal" href="#dashboard">Dashboard</a></li>
<li><a class="reference internal" href="#workout-detail">Workout detail</a></li>
<li><a class="reference internal" href="#workouts-list">Workouts list</a></li>
2020-12-30 11:12:35 +01:00
<li><a class="reference internal" href="#statistics">Statistics</a></li>
<li><a class="reference internal" href="#id1">Administration</a></li>
</ul>
</li>
</ul>
</ul>
</li>
<li>
2021-11-29 18:24:22 +01:00
<a href="index.html" title="Previous Chapter: FitTrackee"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; FitTrackee</span>
2020-12-30 11:12:35 +01:00
</a>
</li>
<li>
2021-11-29 18:24:22 +01:00
<a href="installation.html" title="Next Chapter: Installation"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Installation &raquo;</span>
2020-12-30 11:12:35 +01:00
</a>
</li>
<li class="hidden-sm">
<div id="sourcelink">
<a href="_sources/features.rst.txt"
rel="nofollow">Source</a>
</div></li>
</ul>
<form class="navbar-form navbar-right" action="search.html" method="get">
<div class="form-group">
<input type="text" name="q" class="form-control" placeholder="Search" />
</div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
</div>
<div class="container">
<div class="row">
<div class="body col-md-12 content" role="main">
2021-11-06 21:26:02 +01:00
<section id="features">
2020-12-30 11:12:35 +01:00
<h1>Features<a class="headerlink" href="#features" title="Permalink to this headline"></a></h1>
2021-11-06 21:26:02 +01:00
<section id="list">
2020-12-30 11:12:35 +01:00
<h2>List<a class="headerlink" href="#list" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<section id="administration">
2020-12-30 11:12:35 +01:00
<h3>Administration<a class="headerlink" href="#administration" title="Permalink to this headline"></a></h3>
<p>(<em>new in 0.3.0</em>)</p>
<ul>
<li><p><strong>Application</strong></p>
<p>The following parameters can be set:</p>
<ul class="simple">
2021-02-21 00:09:10 +01:00
<li><p>active users limit. If 0, registration is enabled (no limit defined)</p></li>
2020-12-30 11:12:35 +01:00
<li><p>maximum size of uploaded files</p></li>
<li><p>maximum size of zip archive</p></li>
2021-02-21 00:09:10 +01:00
<li><p>maximum number of files in the zip archive. If an archive contains more files, only the configured number of files is processed, without raising errors.</p></li>
2020-12-30 11:12:35 +01:00
</ul>
2021-02-21 00:09:10 +01:00
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>Updating server configuration may be necessary to handle large files (like <a class="reference external" href="https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size">nginx</a> for instance).</p>
</div>
2020-12-30 11:12:35 +01:00
</li>
<li><p><strong>Users</strong></p>
<ul class="simple">
<li><p>display users list and details</p></li>
<li><p>edit a user to add/remove administration rights</p></li>
<li><p>delete a user</p></li>
</ul>
</li>
<li><p><strong>Sports</strong></p>
<ul class="simple">
<li><p>enable or disable a sport (a sport can be disabled even if workout with this sport exists)</p></li>
2020-12-30 11:12:35 +01:00
</ul>
</li>
</ul>
2021-11-06 21:26:02 +01:00
</section>
2021-11-12 19:25:31 +01:00
<section id="account-preferences">
<h3>Account &amp; preferences<a class="headerlink" href="#account-preferences" title="Permalink to this headline"></a></h3>
2020-12-30 11:12:35 +01:00
<ul class="simple">
<li><p>A user can create, update and deleted his account</p></li>
2021-11-12 19:25:31 +01:00
<li><p>A user can set language, timezone and first day of week.</p></li>
2021-11-14 17:56:38 +01:00
<li><p>A user can reset his password (<em>new in 0.3.0</em>)</p></li>
<li><p>A user can choose between metric system and imperial system for distance, elevation and speed display (<em>new in 0.5.0</em>)</p></li>
2021-11-12 19:25:31 +01:00
<li><dl class="simple">
<dt>A user can set sport preferences (<em>new in 0.5.0</em>):</dt><dd><ul>
2021-11-13 12:20:35 +01:00
<li><p>change sport color (used for sport image and charts)</p></li>
2021-11-12 19:25:31 +01:00
<li><p>can override stopped speed threshold (for next uploaded gpx files)</p></li>
2021-11-13 12:20:35 +01:00
<li><p>disable/enable a sport.</p></li>
2021-11-12 19:25:31 +01:00
</ul>
</dd>
</dl>
</li>
2020-12-30 11:12:35 +01:00
</ul>
2021-11-13 12:20:35 +01:00
<div class="admonition note">
<p class="admonition-title">Note</p>
<div class="line-block">
<div class="line">If a sport is disabled by an administrator, it can not be enabled by a user. In this case, it will only appear in preferences if it has users workouts and the user can only change sport color.</div>
<div class="line">A disabled sport (by admin or user) will not appear in dropdown when <strong>adding a workout</strong>.</div>
<div class="line">A workout with a disabled sport will still be displayed in the application.</div>
</div>
</div>
2021-11-06 21:26:02 +01:00
</section>
<section id="workouts">
<h3>Workouts<a class="headerlink" href="#workouts" title="Permalink to this headline"></a></h3>
2020-12-30 11:12:35 +01:00
<ul class="simple">
<li><dl class="simple">
2021-11-06 21:26:02 +01:00
<dt>11 sports are supported:</dt><dd><ul>
2020-12-30 11:12:35 +01:00
<li><p>Cycling (Sport)</p></li>
<li><p>Cycling (Transport)</p></li>
<li><p>Hiking</p></li>
2021-11-06 21:26:02 +01:00
<li><p>Mountain Biking</p></li>
<li><p>Mountain Biking (Electric) (<strong>new in 0.5.0</strong>)</p></li>
<li><p>Rowing (<strong>new in 0.5.0</strong>)</p></li>
2020-12-30 11:12:35 +01:00
<li><p>Running</p></li>
2021-11-06 21:26:02 +01:00
<li><p>Skiing (Alpine) (<strong>new in 0.5.0</strong>)</p></li>
<li><p>Skiing (Cross Country) (<strong>new in 0.5.0</strong>)</p></li>
<li><p>Trail (<strong>new in 0.5.0</strong>)</p></li>
2020-12-30 11:12:35 +01:00
<li><p>Walking</p></li>
</ul>
</dd>
</dl>
</li>
2021-11-11 17:33:30 +01:00
<li><dl class="simple">
2021-11-12 19:25:31 +01:00
<dt>(<em>new in 0.5.0</em>) Stopped speed threshold used by <a class="reference external" href="https://github.com/tkrajina/gpxpy">gpxpy</a> is not the default one for the following sports (0.1 km/h instead of 1 km/h):</dt><dd><ul>
2021-11-11 17:33:30 +01:00
<li><p>Hiking</p></li>
<li><p>Skiing (Cross Country)</p></li>
<li><p>Trail</p></li>
<li><p>Walking</p></li>
</ul>
</dd>
</dl>
</li>
2021-11-12 19:25:31 +01:00
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>It can be overridden in user preferences.</p>
</div>
<ul class="simple">
<li><p>Dashboard with month calendar displaying workouts and record. The week can start on Sunday or Monday (which can be changed in the user preferences). The calendar displays up to 100 workouts.</p></li>
2021-11-14 17:56:38 +01:00
<li><p>Workout creation by uploading a gpx file (related data are stored in database with metric system). A workout can even be created without gpx (the user must enter date, time, duration and distance).</p></li>
2021-11-12 19:25:31 +01:00
<li><p>A workout with a gpx file can be displayed with map, weather (if the DarkSky API key is provided) and charts (speed and elevation). Segments can be displayed.</p></li>
2021-11-29 18:24:22 +01:00
<li><p>Workout gpx file can be downloaded (<strong>new in 0.5.1</strong>)</p></li>
2021-11-12 19:25:31 +01:00
<li><p>Workout edition and deletion. User can add a note.</p></li>
2021-11-28 11:39:11 +01:00
<li><dl class="simple">
<dt>User statistics, by time period (week, month, year) and sport:</dt><dd><ul>
<li><p>total distance</p></li>
<li><p>total duration</p></li>
<li><p>total workouts</p></li>
<li><p>total ascent (<strong>new in 0.5.0</strong>)</p></li>
<li><p>total descent (<strong>new in 0.5.0</strong>)</p></li>
<li><p>average speed (<strong>new in 0.5.1</strong>)</p></li>
</ul>
</dd>
</dl>
</li>
2020-12-30 11:12:35 +01:00
<li><dl class="simple">
<dt>User records by sports:</dt><dd><ul>
<li><p>average speed</p></li>
<li><p>farest distance</p></li>
<li><p>longest duration</p></li>
<li><p>maximum speed</p></li>
</ul>
</dd>
</dl>
</li>
2021-11-13 12:20:35 +01:00
<li><p>Workouts list and filter. Only sports with workouts are displayed in sport dropdown.</p></li>
2020-12-30 11:12:35 +01:00
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
2021-11-13 12:20:35 +01:00
<p>For now, only the owner of the workout can see it.</p>
2020-12-30 11:12:35 +01:00
</div>
2021-11-06 21:26:02 +01:00
</section>
<section id="translations">
2020-12-30 11:12:35 +01:00
<h3>Translations<a class="headerlink" href="#translations" title="Permalink to this headline"></a></h3>
2021-11-12 19:25:31 +01:00
<p>FitTrackee is available in English and French (which can be saved in the user preferences).</p>
2021-11-06 21:26:02 +01:00
</section>
</section>
<section id="dashboard">
2020-12-30 11:12:35 +01:00
<h2>Dashboard<a class="headerlink" href="#dashboard" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<figure class="align-default">
2020-12-30 11:12:35 +01:00
<img alt="FitTrackee Dashboard" src="_images/fittrackee_screenshot-01.png" />
2021-11-06 21:26:02 +01:00
</figure>
</section>
<section id="workout-detail">
<h2>Workout detail<a class="headerlink" href="#workout-detail" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<figure class="align-default">
<img alt="FitTrackee Workout" src="_images/fittrackee_screenshot-02.png" />
2021-11-06 21:26:02 +01:00
</figure>
</section>
<section id="workouts-list">
<h2>Workouts list<a class="headerlink" href="#workouts-list" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<figure class="align-default">
<img alt="FitTrackee Workouts" src="_images/fittrackee_screenshot-03.png" />
2021-11-06 21:26:02 +01:00
</figure>
</section>
<section id="statistics">
2020-12-30 11:12:35 +01:00
<h2>Statistics<a class="headerlink" href="#statistics" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<figure class="align-default">
2020-12-30 11:12:35 +01:00
<img alt="FitTrackee Statistics" src="_images/fittrackee_screenshot-04.png" />
2021-11-06 21:26:02 +01:00
</figure>
</section>
<section id="id1">
2020-12-30 11:12:35 +01:00
<h2>Administration<a class="headerlink" href="#id1" title="Permalink to this headline"></a></h2>
2021-11-06 21:26:02 +01:00
<figure class="align-default">
2020-12-30 11:12:35 +01:00
<img alt="FitTrackee Administration" src="_images/fittrackee_screenshot-05.png" />
2021-11-03 12:41:23 +01:00
</figure>
<figure class="align-default">
<img alt="FitTrackee Sports Administration" src="_images/fittrackee_screenshot-06.png" />
</figure>
</section>
</section>
2020-12-30 11:12:35 +01:00
</div>
</div>
</div>
<footer class="footer">
<div class="container">
<p class="pull-right">
<a href="#">Back to top</a>
</p>
<p>
2021-04-06 14:03:42 +02:00
&copy; Copyright 2018 - 2021, SamR1.<br/>
2021-11-29 18:24:22 +01:00
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 4.3.1.<br/>
2020-12-30 11:12:35 +01:00
</p>
</div>
</footer>
</body>
</html>