Skip to content

Latest commit

 

History

History
29 lines (15 loc) · 2.35 KB

File metadata and controls

29 lines (15 loc) · 2.35 KB

Concepts

This plugin was designed to read code blocks in YAML format. The key-value pairs in the code blocks tell the plugin what data to collect and how to represent the result.

Here are all the parameters (key-value pairs) defined in this plugin. They are used for collecting data, evaluating targets, data preprocessing, and rendering output.

Collecting Data

Providing parameters searchType and searchTarget is the minimum requirement for a successful data collection. searchType can be tag, frontmatter, wiki, dvField, table, fileMeta, task, or text. Then the cooresponding searchTarget should be provided according to the specified type.

Target Evaluation

Depends on the searchType and the searchTarget you provided, the evaluation of a target would be different. Simply speaking, you can track the occurrences of a target or the value attached/embedded in it.

To see the detail about the target evaluation, please check the document Target Evaluation.

Rendering Output

Currently, obsidian-tracker provides five kinds of rendering output: line, bar, summary, bullet, and month. You have to provide at least one output parameter in a code block.

With output set to line or bar, Tracker plugin will generate a customizable chart. These charts are very good at seeing the variation of collected number in the notes.

With the summary output, a text block based on your 'template' parameter will be created. You can use pre-defined template variables like '{{sum}}' or '{{maxStreak}}' in the template parameter, to get a statistical summary of collected data.

bullet output creates a bullet chart and could serve as a gauge showing the status (level, performance, progress) of a dataset.

month output creates a month view with circled dates exceeding the given threshold and streaks showing how long it persisted.

Detailed description for all parameters of the output types can be found here.