Skip to content

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.

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.

Type [[ in the editor to open the date picker popover. From there you can:

  1. Date tab — pick a date using the temporal scale picker for your world’s calendar
  2. Entity tab — reference a date from an entity’s temporal fields
  3. Events tab — insert the date of a world event
  4. 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.

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

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.

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.

  1. Select text in the editor that refers to a time or date
  2. Right-click and choose “Assign Date/Time…” from the context menu
  3. Use the date picker to select the precise date, time range, calendar, and precision
  4. The selected text is now annotated with the datetime metadata

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.

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

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.

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)

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.

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)