Generate Timeline

Generate Timeline is a plugin to help users generate timelines based on folders, tags, or files. With this plugin, users can easily view and manage their notes in chronological order.

中文文档

Functional Overview

1. Generate Timeline Based on Folders:

   • Select a folder, and the plugin will scan all files (including subfolders) within it to generate a timeline based on the time attributes in the files.
   • Supports both timeline view and Markdown file formats.

2. Generate Timeline Based on Tags:

   • Select a tag, and the plugin will scan all content with that tag (including subtags) to generate a timeline based on the time attributes.
   • Supports both timeline view and Markdown file formats.

3. Generate Timeline Based on File Links:

   • Extract all internal links from a specified file and generate a timeline based on the linked files' time attributes.
   • Supports both timeline view and Markdown file formats.

How to Use

1. Generate Timeline from Folder

   • Open the Command Palette and choose one of the following:
     • Generate Timeline: Generate Timeline View from Folder for a timeline view
     • Generate Timeline: Generate Timeline File from Folder for a Markdown file
   • Select your target folder and the timeline will be generated automatically

2. Generate Timeline from Tags

   • Open the Command Palette and choose one of the following:
     • Generate Timeline: Generate Timeline View from Tags for a timeline view
     • Generate Timeline: Generate Timeline File from Tags for a Markdown file
   • Select your desired tag and the timeline will be generated automatically

3. Generate Timeline from File Links

   • Open the Command Palette and choose one of the following:
     • Generate Timeline: Generate Timeline View from File Links for a timeline view
     • Generate Timeline: Generate Timeline File from File Links for a Markdown file
   • Select the source file containing the links

Customization Options

The plugin offers various customization settings:

1. Timeline Appearance:

   • Timeline line width and color
   • Item spacing
   • Card background color
   • Animation duration

2. Content Settings:

   • Date attribute: Choose which frontmatter date property to use for sorting (e.g., created, updated, date)
   • File name prefix and suffix: Customize the naming pattern for generated timeline files

3. View Position:

   • Choose whether the timeline view appears in the left or right sidebar

Contribution

We welcome contributions of any kind! If you have suggestions, questions, or would like to add new features, please submit an Issue or Pull Request on the GitHub repository.

License

This plugin is released under the MIT License. For more details, please refer to the LICENSE file.