finish documenting settings
This commit is contained in:
parent
3d63a581a4
commit
e52aafaf7b
|
@ -556,15 +556,37 @@ auto_sheet_search_paths
|
|||
Not implemented. Kept for compatibility with ``timetrap``. Tracking issue:
|
||||
https://gitlab.com/categulario/tiempo-rs/-/issues/9
|
||||
|
||||
.. _commands:
|
||||
|
||||
commands
|
||||
........
|
||||
|
||||
**Type**: CommandsSettings,
|
||||
``tiempo`` allows having per-command configuration. For now it limits to
|
||||
per-command default formatters introduced introduced in ``1.4.0``. To set a
|
||||
default formatter other than the default ``text`` use something like this in
|
||||
your settings file:
|
||||
|
||||
**In toml**
|
||||
|
||||
.. code:: toml
|
||||
|
||||
[commands.week]
|
||||
default_formatter = "chart"
|
||||
|
||||
**In yaml**
|
||||
|
||||
.. code:: yaml
|
||||
|
||||
commands:
|
||||
week:
|
||||
default_formatter: chart
|
||||
|
||||
To set a default formatter for every command use :ref:`default_formatter`.
|
||||
|
||||
database_file
|
||||
.............
|
||||
|
||||
**Type**: string **Default** Depends on OS
|
||||
**Type**: string **Default**: Depends on OS
|
||||
|
||||
Absolute path to the database file.
|
||||
|
||||
|
@ -576,6 +598,8 @@ default_command
|
|||
Not implemented. Kept for compatibility with ``timetrap``. Implementation
|
||||
planned. Tracking issue: https://gitlab.com/categulario/tiempo-rs/-/issues/10
|
||||
|
||||
.. _default_formatter:
|
||||
|
||||
default_formatter
|
||||
.................
|
||||
|
||||
|
@ -585,6 +609,9 @@ Formatter used for the :ref:`t-display` family of commands when no ``--format``
|
|||
argument is passed. Included formatters are explained in the
|
||||
:ref:`default-formatters` section, they are: chart, text, ical, csv, json, ids.
|
||||
|
||||
To set a default formatter for only one command see the :ref:`commands` config
|
||||
above.
|
||||
|
||||
.. _formatter_search_paths:
|
||||
|
||||
formatter_search_paths
|
||||
|
@ -595,10 +622,50 @@ formatter_search_paths
|
|||
Array of paths to search for custom formatters. See :ref:`custom-formatters` to
|
||||
learn how to write them. Custom formatters must be executable files.
|
||||
|
||||
.. _formatters:
|
||||
|
||||
formatters
|
||||
..........
|
||||
|
||||
**Type**: FormattersSettings,
|
||||
The :ref:`chart` formatter introduced in ``1.4.0`` has a few settings. It is
|
||||
also possible to store settings for your custom formatters in this variable.
|
||||
Take a look at the following example:
|
||||
|
||||
.. code:: toml
|
||||
|
||||
[formatters.earnings]
|
||||
currency = "USD"
|
||||
hourly_rate = 400
|
||||
|
||||
[formatters.chart]
|
||||
daily_goal_hours = 4
|
||||
weekly_goal_hours = 20
|
||||
character_equals_minutes = 30
|
||||
|
||||
.. code:: yaml
|
||||
|
||||
formatters:
|
||||
earnings:
|
||||
currency: MXN
|
||||
hourly_rate: 280
|
||||
chart:
|
||||
daily_goal_hours: 4
|
||||
weekly_goal_hours: 20
|
||||
character_equals_minutes: 30
|
||||
|
||||
Check :ref:`custom-formatters` to learn how to read this settings in your
|
||||
formatters.
|
||||
|
||||
Available settings for the :ref:`chart` formatter are:
|
||||
|
||||
* ``daily_goal_hours`` (integer, default: 0) Number of hours you set as your
|
||||
daily goal. Will display a uniform gray bar at the set hours that will turn
|
||||
green as you make progress.
|
||||
* ``weekly_goal_hours`` (integer, default: 0) Number of hours you expect to work
|
||||
in a week. Controls wether the weekly hour count displays in green color.
|
||||
* ``character_equals_minutes`` (integer, default: 30). Controls how many minutes
|
||||
each character of the chart represents. Set lower for wider charts. Set to 0
|
||||
to make tiempo crash.
|
||||
|
||||
.. _interactive_entries:
|
||||
|
||||
|
@ -646,41 +713,8 @@ week_start
|
|||
**Type**: string **Default** ``"monday"``
|
||||
|
||||
Day of the week that should be considered as the start for :ref:`t-week`.
|
||||
|
||||
Per command default formatters
|
||||
..............................
|
||||
|
||||
.. note::
|
||||
|
||||
likely move this to the section above
|
||||
|
||||
**New in 1.4.0**
|
||||
|
||||
It might be the case that you want to use one default formatter for when you use
|
||||
``t week`` and a different one for ``t month`` or ``t today``. That's what
|
||||
per-command default formatters are for. To use them just add a ``commands``
|
||||
section to your config file and set ``default_formatter`` on some formatters.
|
||||
This is what it would look like:
|
||||
|
||||
**In toml**
|
||||
|
||||
.. code:: toml
|
||||
|
||||
[commands.week]
|
||||
default_formatter = "chart"
|
||||
|
||||
[commands.month]
|
||||
default_formatter = "ical"
|
||||
|
||||
**In yaml**
|
||||
|
||||
.. code:: yaml
|
||||
|
||||
commands:
|
||||
week:
|
||||
default_formatter: chart
|
||||
month:
|
||||
default_formatter: ical
|
||||
Options are ``"monday"``, ``"tuesday"``, ``"wednesday"``, ``"thursday"``,
|
||||
``"friday"``, ``"saturday"``, ``"sunday"``.
|
||||
|
||||
Files and paths
|
||||
---------------
|
||||
|
@ -731,6 +765,8 @@ Default formatters
|
|||
Tiempo comes with a handful of formatters that display your entries in different
|
||||
ways. Here's the full list.
|
||||
|
||||
.. _chart:
|
||||
|
||||
chart
|
||||
.....
|
||||
|
||||
|
@ -750,31 +786,7 @@ chart
|
|||
|
||||
Week 19.3/20.0
|
||||
|
||||
**Settings**
|
||||
|
||||
By default this formatter will only display a nice chart of the progress divided
|
||||
by week and respecting the ``week_start`` setting. However you may specify a
|
||||
daily goal and a weekly goal to customize the chart, as well as how many minutes
|
||||
each character represents:
|
||||
|
||||
In toml:
|
||||
|
||||
.. code:: toml
|
||||
|
||||
[formatters.chart]
|
||||
daily_goal_hours = 4
|
||||
weekly_goal_hours = 20
|
||||
character_equals_minutes = 30
|
||||
|
||||
In yaml:
|
||||
|
||||
.. code:: yaml
|
||||
|
||||
formatters:
|
||||
chart:
|
||||
daily_goal_hours: 4
|
||||
weekly_goal_hours: 20
|
||||
character_equals_minutes: 30
|
||||
This formatter comes with a few settings. See :ref:`formatters` for more.
|
||||
|
||||
text
|
||||
....
|
||||
|
|
Loading…
Reference in New Issue