README: format descriptions in smaller font size
This commit is contained in:
parent
c02e23fb3e
commit
41f8701c06
34
README.md
34
README.md
@ -70,43 +70,43 @@ Supported export formats:
|
||||
|
||||
- ``gpx``: activity GPX file (XML).
|
||||
|
||||
[GPX](https://en.wikipedia.org/wiki/GPS_Exchange_Format) is an open
|
||||
<sub>[GPX](https://en.wikipedia.org/wiki/GPS_Exchange_Format) is an open
|
||||
format, mainly for storing GPS routes/tracks. It does support extensions
|
||||
and Garmin appears to annotate the GPS data with, for example, heart-rate
|
||||
and cadence, when available on your device.
|
||||
and cadence, when available on your device.</sub>
|
||||
|
||||
- ``tcx``: an activity TCX file (XML).
|
||||
*Note: a ``.tcx`` file may not always be possible to export, for example
|
||||
if an activity was uploaded in gpx format. In that case, Garmin won't try
|
||||
to synthesize a tcx file.*
|
||||
|
||||
[TCX](https://en.wikipedia.org/wiki/Training_Center_XML) (Training Center
|
||||
XML) is Garmin's own XML format. It is, essentially, an extension of GPX
|
||||
which includes more metrics and divides the GPS track into "laps" as
|
||||
recorded by your device (with "lap summaries" for each metric).
|
||||
<sub>[TCX](https://en.wikipedia.org/wiki/Training_Center_XML) (Training
|
||||
Center XML) is Garmin's own XML format. It is, essentially, an extension
|
||||
of GPX which includes more metrics and divides the GPS track into "laps"
|
||||
as recorded by your device (with "lap summaries" for each metric).</sub>
|
||||
|
||||
- ``fit``: activity FIT file (binary format).
|
||||
*Note: a ``.fit`` file may not always be possible to export, for example
|
||||
if an activity was entered manually rather than imported from a Garmin device.*
|
||||
|
||||
The [FIT](https://www.thisisant.com/resources/fit/) format is the "raw
|
||||
data type" stored in your Garmin device and should contain all metrics
|
||||
your device is capable of tracking (GPS, heart rate, cadence, etc). It's a
|
||||
binary format, so tools are needed to read its content.
|
||||
<sub>The [FIT](https://www.thisisant.com/resources/fit/) format is the
|
||||
"raw data type" stored in your Garmin device and should contain all
|
||||
metrics your device is capable of tracking (GPS, heart rate, cadence,
|
||||
etc). It's a binary format, so tools are needed to read its content.</sub>
|
||||
|
||||
- ``json_summary``: activity summary file (JSON).
|
||||
|
||||
Provides summary data for an activity. Seems to lack a formal schema and
|
||||
should not be counted on as a stable data format (it may change at any
|
||||
<sub>Provides summary data for an activity. Seems to lack a formal schema
|
||||
and should not be counted on as a stable data format (it may change at any
|
||||
time). Only included since it *may* contain additional data that could be
|
||||
useful for developers of analysis tools.
|
||||
useful for developers of analysis tools.</sub>
|
||||
|
||||
- ``json_details``: activity details file (JSON).
|
||||
|
||||
Provides detailed activity data in a JSON format. Seems to lack a formal
|
||||
schema and should not be counted on as a stable data format (it may change
|
||||
at any time). Only included since it *may* contain additional data that
|
||||
could be useful for developers of analysis tools.
|
||||
<sub>Provides detailed activity data in a JSON format. Seems to lack a
|
||||
formal schema and should not be counted on as a stable data format (it may
|
||||
change at any time). Only included since it *may* contain additional data
|
||||
that could be useful for developers of analysis tools.</sub>
|
||||
|
||||
All files are written to the same directory (``activities/`` by default).
|
||||
Each activity file is prefixed by its upload timestamp and its activity id.
|
||||
|
Loading…
Reference in New Issue
Block a user