Inline Temporal Marks
MythTapestry provides two ways to reference dates inside your prose text. Each serves a different purpose and appears differently in the editor.
Date mentions (chips)
Section titled “Date mentions (chips)”A date mention is an inline chip — a small, non-editable block that displays a formatted date from your calendar. It replaces a section of text with a styled date badge.
Inserting a date mention
Section titled “Inserting a date mention”Type [[ in the editor to open the date picker popover. From there you can:
- Date tab — pick a date using the temporal scale picker for your world’s calendar
- Entity tab — reference a date from an entity’s temporal fields
- Events tab — insert the date of a world event
- Patterns tab — reference a recurring pattern’s next occurrence
You can also use the shortcut syntax [[date:429]] to insert a date mention for absolute day 429 directly.
Date mention attributes
Section titled “Date mention attributes”| Attribute | Description |
|---|---|
| Reference type | How the date is specified: absolute, entity_field, named_date, or recurring_pattern |
| Absolute day | The resolved day on the universal timeline |
| Time of day | Optional fractional time (0.0 to <1.0) |
| Calendar | Which calendar system to use for display |
| Format | Which date format string to use for rendering |
| Precision | Temporal scale name indicating how precise the date is |
| Display label | The formatted text shown in the chip |
Date links (inline marks)
Section titled “Date links (inline marks)”A date link is an inline mark that wraps existing text with datetime metadata — similar to how entity mentions wrap text like “the ancient city” with a link to a Location entity. The original text is preserved and remains editable.
When to use date links
Section titled “When to use date links”Date links are ideal when your prose uses natural temporal language:
- “tomorrow” → link to absolute day 430
- “during the Great War” → link to day range 15000–15800
- “three days later” → link to absolute day 433
- “the spring equinox” → link to absolute day 91
The text stays exactly as written, but the system knows precisely what date each phrase refers to.
Creating a date link
Section titled “Creating a date link”- Select text in the editor that refers to a time or date
- Right-click and choose “Assign Date/Time…” from the context menu
- Use the date picker to select the precise date, time range, calendar, and precision
- The selected text is now annotated with the datetime metadata
Date link appearance
Section titled “Date link appearance”Date links appear as subtly styled text with visual indicators:
- A coloured underline or background tint (depending on the current theme)
- A hover tooltip showing the resolved calendar date in the selected format
- Ctrl+Click (or Cmd+Click) navigates to the date in calendar context
The styling intensity can vary — from a minimal underline to a more prominent highlight — based on the precision level.
Date link attributes
Section titled “Date link attributes”| Attribute | Description |
|---|---|
| Start / End day | Range of absolute days this text refers to |
| Time of day | Optional start/end fractional times |
| Calendar | Calendar system for this mark (overrides content unit default) |
| Format | Date format for the hover tooltip |
| Precision | Temporal scale name (e.g. “Day”, “Month”, “Year”, “Season”) |
| Display label | Formatted date shown on hover |
Calendar inheritance
Section titled “Calendar inheritance”Each date link inherits its calendar and precision from the content unit’s narrative time context, which in turn inherits from the world’s default calendar. You can override any of these at the mark level:
World default calendar + precision └── Content unit override └── Date link override (per-mark)If a date link doesn’t specify a calendar, it uses whatever the content unit specifies. If the content unit doesn’t override, the world default is used.
Date mentions vs date links
Section titled “Date mentions vs date links”| Feature | Date mention (chip) | Date link (mark) |
|---|---|---|
| Text | Replaced with formatted date | Original text preserved |
| Editable | No (atomic block) | Yes (text stays editable) |
| Appearance | Styled chip/badge | Subtle underline/highlight |
| Best for | Explicit dates (“15th of Frostmoon, Year 42”) | Natural language (“tomorrow”, “during the war”) |
| Trigger | [[ keyboard shortcut | Select text → right-click → assign |
| Reference types | Absolute, entity field, named date, recurring pattern | Absolute (with calendar + precision) |
How your dates are kept in sync
Section titled “How your dates are kept in sync”Every date mention and date link is saved alongside your content when the unit saves — the same way entity mentions are. That means the dates woven into your prose aren’t just decoration: they’re indexed with your world’s timeline and ready for features like timeline views and time-based viewing.
Planned future enhancements
Section titled “Planned future enhancements”The following capabilities are planned but not yet available:
- Cross-world temporal queries — search for all content that references a specific date or time period
- Timeline integration with prose — the timeline view will surface prose passages that reference specific time periods, not just entity events
- Calendar cascade re-resolution — when you change a calendar’s structure (rename a month, adjust intercalation), display labels on existing date links will automatically update to reflect the new formatting
- Prose-based chatbot search — the chatbot will be able to find content units by the dates mentioned in their prose text (currently it can find entities and relationships at a given time point via the knowledge graph)