Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ReconVirus/Historium
Historium is a tool that lets you create and view a timeline of your notes based on tags. You can organize your notes by date, topic, or any other criteria,
https://github.com/ReconVirus/Historium
obsidian-plugin vis-timeline
Last synced: 3 months ago
JSON representation
Historium is a tool that lets you create and view a timeline of your notes based on tags. You can organize your notes by date, topic, or any other criteria,
- Host: GitHub
- URL: https://github.com/ReconVirus/Historium
- Owner: ReconVirus
- License: other
- Created: 2023-09-02T21:00:29.000Z (about 1 year ago)
- Default Branch: Main
- Last Pushed: 2024-04-25T13:31:25.000Z (7 months ago)
- Last Synced: 2024-05-23T00:34:55.991Z (6 months ago)
- Topics: obsidian-plugin, vis-timeline
- Language: SCSS
- Homepage:
- Size: 1.15 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- project-awesome - ReconVirus/Historium - Historium is a tool that lets you create and view a timeline of your notes based on tags. You can organize your notes by date, topic, or any other criteria, (SCSS)
README
Historium
[![Legacy GitHub Release][Legacy GitHub Release-shield]][Legacy GitHub Release-URL]
[![Legacy GitHub Issues Count][Legacy GitHub Issues Count-shield]][Legacy GitHub Issues Count-URL]
A chronological timeline created from notes with the specific tag or combination of tags
Table of Contents
About The Project
Historium is a tool that allows you to create and visualize a timeline of your notes based on the tags you assign to them. You can use Historium to organize your notes by date, topic, category, or any other criteria you choose. Historium will automatically generate a chronological timeline of your notes with the specified set of tags, and display them in a user-friendly interface.
## Usage
Properties:
how a typical event Property might be set up as
## Creating a Timeline
To render a timeline in a note, you can use either the horizontal or vertical timeline format:
**Horizontal Timine**:
````ssh
```timeline-vis
(list of tags would go here, mainly a timeline tag)
```
````
**Vertical Timeline**:
````ssh
``` timeline
(list of tags would go here, or just leave it blank to gather all events)
```
````
### Date:
The date is the most essential information for the timeline entry. It is specified as YEAR-MONTH-DAY. All four segments must be present and can contain only numbers, but can be any length. The YEAR (first segment) can be negative.
- -123-45-678 is a valid date.
Segments containing leading or trailing zeros will be omitted when the timeline is generated, for example:
- 2300-02-00-00 will display as 2300-2
- 2300-00-00-00 will display as 2300
- 0023-02-10-00 will display as 23-2-10
### Title:
The title is optional. If not specified, the name of the note will be used.
### Description:
The description is also optional. It adds text to the Vertical Timeline Card to serve as a summary of the event.
### Background Image:
You can optionally specify a background image for each event. If an image is not specified or an invalid URL is given, no image will be shown.
### Indicator:
Indicators are optional badge-like icons added to the events to help distinguish or represent what the event is. The supported indicators currently are shown below:.
|  |  |
| :-------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------: |
| Horizontal Timeline | Vertical Timeline |
### Type:
The type property tells the timeline how each event should be displayed.
Note: Acceptable values for data-type are:
- background, best used for time periods
- box, idenify any extreme outlier, or important event
- point, which is exactly what it sounds like, and
- range, a way to show a span of extent of the event
### Color:
Acceptable values for color useage are:
blue, green, gray, orange, pink, purple, red, yellow, white
### Path:
The path property is optional and allows you to specify an alternate path to link the event to, but you can use this to specify other notes or link to headers or blocks internally within the note.
path: [[My Note#SubHeader]] would link directly to the Event Subheader in My Note
### Groups and Nested Groups:
Groups allow you to categorize events together on their own line in the timeline. This feature leverages vis-timeline’s groups and nested groups functionality to provide a more organized view of events.
## Roadmap
- [x] Add Changelog
- [x] Redesign Vertical Timeline
- [x] Redesign Horizontal Timeline
- [ ] Calendarium\Fantasy Calendar API Support
- [ ] Additonal Features
- [/] Icons
- [x] Group support
- [x] Nested Group support
See the [open issues]() for a full list of proposed features (and known issues).
## Contributing
Thank you for your interest in this project.
If you want to improve this project, you can fork the repo and create a pull request with your changes. You can also open an issue with the label "enhancement" to share your feedback or ideas.
Please show your support by giving the project a star! I appreciate your collaboration!
To contribute to this project, follow these steps:
1. Fork the repo
2. Create a new branch on your local machine
```sh
git checkout -b Development/Historium
```
3. Make your changes and commit them
```sh
git commit -m 'Added some Feature'
```
4. Push your branch to GitHub
```sh
git push origin Development/Historium
```
5. Create a pull request and wait for review
## License
[![License][License-shield]][License-URL]
See `LICENSE.txt` for more information.
## Acknowledgments
Credit to
- 
- 
[License-shield]: https://img.shields.io/badge/license-WTFPL-white?link=http%3A%2F%2Fwww.wtfpl.net%2F
[License-URL]: http://www.wtfpl.net
[Legacy GitHub Issues Count-shield]: https://img.shields.io/github/issues/Darakah/obsidian-timelines?logo=github&label=Legacy%20Issues&labelColor=%23181717&link=https%3A%2F%2Fgithub.com%2FDarakah%2Fobsidian-timelines%2Fissues
[Legacy GitHub Issues Count-URL]: https://github.com/Darakah/obsidian-timelines/issues
[Legacy GitHub Release-shield]: https://img.shields.io/github/v/release/Darakah/obsidian-timelines?logo=github&label=Last%20Legacy%20Release&labelColor=%23181717&color=red&link=https%3A%2F%2Fgithub.com%2FDarakah%2Fobsidian-timelines%2Freleases
[Legacy GitHub Release-URL]: https://github.com/Darakah/obsidian-timelines