obsidian-release-timeline
obsidian-release-timeline copied to clipboard
Release Timeline for Obsidian
This plugin is inspired by the Wikipedia timeline of release years.
This plugin works only with Obsidian Dataview installed.
![](https://raw.githubusercontent.com/cakechaser/obsidian-release-timeline/master/assets/timeline.png)
How to use
1. Populate information about the year in the note metadata:
Plugin will automatically extract the year from the provided date.
Different date formats are supported, including: 2022
, 2022-12-31
, 2022-12
.
![](https://raw.githubusercontent.com/cakechaser/obsidian-release-timeline/master/assets/release%20year.png)
2. Add a codeblock to create a timeline:
You can choose from 3 different codeblock types:
-
release-timeline
- Year timelines -
release-timeline-month
- Month timelines -
release-timeline-week
- Week timelines
Release Timeline uses syntax compatible with Obsidian Dataview, which should be familiar if you already use Dataview.
Any query written for Release Timeline should also be a valid Dataview query.
That way you can change the codeblock type to dataview
at any point to check the returned results.
Query example:
```release-timeline
table
year_field, alias_field
from [[CRPG]] and [[Isometric games]]
where year_field > date(2000-01-01)
sort desc
```
Query elements:
-
table
- Needs to be present in the beginning of each query
-
year_field
- Name of the field in the notes metadata containing the year or date
-
alias_field
(optional)- Name of the field in the notes metadata containing an alternative name of the note
- Useful in case you want to show titles with characters not allowed in file names, such as
:
- For notes without this field, the standard note name will be used
-
from ...
(optional)- Conditions defining the notes for building the timeline
- Syntax is the same as in Dataview
-
where ...
(optional)- Conditions definining filters applied in the query
- Syntax is the same as in Dataview
-
sort (asc|desc)
(optional)- Sort order of the items in the timeline
- If not provided, the default order from plugin settings will be used (desc by default)
Options
Common settings
Default sort order
If sort
is not provided in the query block, sort order selected in settings will be used (ascending or descending).
Bullet points
Shows bullet points for years with multiple entries.
![](https://raw.githubusercontent.com/cakechaser/obsidian-release-timeline/master/assets/bullets.png)
Year timeline settings
Collapse empty years
When enabled, collapses multiple consecutive empty years into one range. You can choose the minimum number of years to be collapsed.
![](https://raw.githubusercontent.com/cakechaser/obsidian-release-timeline/master/assets/collapse%20years.png)
Week timeline settings
Collapse empty months
Weeks will not be displayed for months without actual data.
![](https://raw.githubusercontent.com/cakechaser/obsidian-release-timeline/master/assets/weekly%20timeline%20collapse%20months.png)
Week formatting
Week names: "W15"
Date names: "11-17"
Known issues
- If a note with the release timeline codeblock is opened when Obsidian starts, it will not be rendered. Switch to another note and back to view the timeline.
- Changing settings other than 'Bullet points' will not re-render the timeline. Switch to another note and back to view the updated timeline.