Add filtering for the timelines folder and its contents in the file suggestions, folder suggestions, and timeline generation functions to prevent recursive processing of self-generated timeline files Update the version number to 1.2.5 and improve the description |
||
|---|---|---|
| .github/workflows | ||
| node_modules | ||
| src | ||
| .gitignore | ||
| data.json | ||
| esbuild.config.mjs | ||
| LICENCE | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| styles.css | ||
| tsconfig.json | ||
| versions.json | ||
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
-
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.
https://github.com/user-attachments/assets/10b64bef-4a07-4e2e-bded-152dc82ab241
-
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.
https://github.com/user-attachments/assets/5da9d7ac-67f1-4c65-bbef-f703696463d8
-
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.
https://github.com/user-attachments/assets/b55edb9a-db6f-4a3d-929b-8bc279bd3c72
-
Milestone functionality :
- milestones can be marked with a custom frontmatter attribute.
- milestone cards have a special style.
https://github.com/user-attachments/assets/3e92a73a-2af5-4f75-90be-a13aca6c1375
How to Use
-
Generate Timeline from Folder
- Open the Command Palette and choose one of the following:
Generate Timeline: Generate Timeline View from Folderfor a timeline viewGenerate Timeline: Generate Timeline File from Folderfor a Markdown file
- Select your target folder and the timeline will be generated automatically
- Open the Command Palette and choose one of the following:
-
Generate Timeline from Tags
- Open the Command Palette and choose one of the following:
Generate Timeline: Generate Timeline View from Tagsfor a timeline viewGenerate Timeline: Generate Timeline File from Tagsfor a Markdown file
- Select your desired tag and the timeline will be generated automatically
- Open the Command Palette and choose one of the following:
-
Generate Timeline from File Links
- Open the Command Palette and choose one of the following:
Generate Timeline: Generate Timeline View from File Linksfor a timeline viewGenerate Timeline: Generate Timeline File from File Linksfor a Markdown file
- Select the source file containing the links
- Open the Command Palette and choose one of the following:
Customization Options
The plugin offers various customization settings:
-
Timeline Appearance:
- Timeline line width and color
- Item spacing
- Card background color, text color and border color
- Animation duration
- Milestone card background color, text color and border color
-
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
- Milestone property settings: custom property names and matching values
- The card preview preferentially displays the row where the label is located.
-
View Position:
- Choose whether the timeline view appears in the left or right sidebar
-
Language Settings:
- Support Chinese and English
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.