chore: README

This commit is contained in:
ccmdi 2025-11-24 20:03:59 -05:00
parent d491fe0171
commit d183ecab65
No known key found for this signature in database

View file

@ -45,9 +45,40 @@ Higher tags take precedence in locations with multiple tags.
The timeline view type filters map markers by date.
- **Date property**: Property containing dates (supports `YYYY-MM-DD`, `YYYY-MM`, `YYYY`, and negative years like `-1000-01-01` for BC)
- **Group by property**: Deduplicate markers with the same value - for tracking the same object at different times
- **Grouping uniqueness mode**: Show all entries, only the most recent, or only the least recent per group (per date property)
The slider and text box filter markers up to a specific date. You can manually type in the text box the exact date you want to jump to. The granularity level is determined by the dropdown.
### Using search and geocoding
Enable "Search geocoding" in plugin settings to add a search bar to your map views.
The search bar supports:
- **Natural language search**: Type location names and select from search results
- **Coordinate paste**: Paste coordinates in various formats:
- Decimal degrees: `40.7128, -74.0060`
- Degrees/minutes/seconds formats
- Google Maps links
- Other common coordinate formats
Select a result from the dropdown to navigate to that location on the map.
### Customizing map appearance
In plugin settings under "Map":
- **Stroke width for icons**: Adjust the outline thickness of map markers (0.5-5)
- **Fill icons**: Toggle whether icons are filled or outlined
- **Auto-center on update**: Automatically zoom and center the map when data changes
- **Transition duration**: Control the animation speed when the map view changes (0-2000ms)
### Performance optimization
**Thumbnail cache**: Enable in settings under "Performance" to cache downsized versions of location cover images for instant tooltips.
- **Thumbnail target size**: Set the target file size for cached thumbnails (10-50 KB)
- **Cache status**: View number of cached thumbnails and total cache size
- **Rebuild cache**: Regenerate all thumbnails if images have changed
- **Clear cache**: Delete all cached thumbnails