Skip to documentation content

Documentation · Thinking

Timeline

Write one event per line: its time, its caption, and a note if it needs one. Years drawn to scale need numbers; anything else is drawn in order.

Open Timeline

When to use it

Place events in time: a history, a project's milestones, a product's releases or a literature's development.

Write times as plain numbers, such as years, to draw the timeline to scale. Write them in quotes when only the order matters.

Working example

Copy this complete example into the Source tab, then press Generate. Change its labels or values to make your first version.

Tingraph source
timeline "The space race" {
  event 1957 "Sputnik 1" "first artificial satellite"
  event 1961 "Vostok 1" "first person in orbit"
  event 1965 "Voskhod 2" "first spacewalk"
  event 1969 "Apollo 11" "first Moon landing"
  event 1971 "Salyut 1" "first space station"
}

Syntax reference

The same reference used by the editor and AI briefing. Syntax is notation-specific; use the keywords listed here.

Figure

SyntaxMeaning
timeline "Title" {open a timeline

Events

SyntaxMeaning
event 1969 "Apollo 11"an event at a time written as a number
event 1969 "Apollo 11" "first landing"an event with a note under it
event "Mar 2024" "Kick-off"a time written as words; drawn in sequence

Axis

SyntaxMeaning
scale timetime (gaps to scale) or even (order only)
orientation verticalhorizontal or vertical

Look

SyntaxMeaning
color "#2a78d6"the colour of the dots and stems
text 13caption size, 9 to 22
size 820 300width and height on the sheet
# commentline comment (also //)

Language rules

  • The file is one timeline "Title" { ... } block. Nothing may sit outside it.
  • An event is event then its time, then its caption in quotes, then optionally a note in quotes on the same line.
  • A time written as a plain number (a year, a day) can be drawn to scale. A time in quotes ("Mar 2024", "Phase 2") is drawn in sequence, and so is the whole timeline if any event has one.
  • Events are drawn in the order they are written; write them in time order.
  • Settings are written as name value, in any order.
  • Do not invent settings. Every one the language has is listed above.

Edit on the canvas

  • Drag an event's dot along a to-scale timeline to change its time; rename any caption in place.
  • Add an event after the last with the + on the sheet, or edit every event in the Timeline panel.

Generate replaces the drawing from source. Save before generating again if you want to preserve manual finishing touches.

Read Saving & exporting

Write it with an assistant

Tingraph AI already knows this notation. For another assistant, copy the tutorial below, describe your diagram under MY DIAGRAM, then paste the returned source into the editor. This prompt includes every syntax row, rule and working example above.

Read the complete prompt
You are writing Tingraph source. Tingraph is a small text language that draws a timeline. Answer with Tingraph source only.

SYNTAX
Figure
  timeline "Title" {          open a timeline

Events
  event 1969 "Apollo 11"      an event at a time written as a number
  event 1969 "Apollo 11" "first landing"  an event with a note under it
  event "Mar 2024" "Kick-off"  a time written as words; drawn in sequence

Axis
  scale time                  time (gaps to scale) or even (order only)
  orientation vertical        horizontal or vertical

Look
  color "#2a78d6"             the colour of the dots and stems
  text 13                     caption size, 9 to 22
  size 820 300                width and height on the sheet
  # comment                   line comment (also //)

RULES
- The file is one `timeline "Title" { ... }` block. Nothing may sit outside it.
- An event is `event` then its time, then its caption in quotes, then optionally a note in quotes on the same line.
- A time written as a plain number (a year, a day) can be drawn to scale. A time in quotes ("Mar 2024", "Phase 2") is drawn in sequence, and so is the whole timeline if any event has one.
- Events are drawn in the order they are written; write them in time order.
- Settings are written as `name value`, in any order.
- Do not invent settings. Every one the language has is listed above.

WORKED EXAMPLE
timeline "The space race" {
  event 1957 "Sputnik 1" "first artificial satellite"
  event 1961 "Vostok 1" "first person in orbit"
  event 1965 "Voskhod 2" "first spacewalk"
  event 1969 "Apollo 11" "first Moon landing"
  event 1971 "Salyut 1" "first space station"
}

OUTPUT
- Reply with one fenced code block and nothing else.
- The block starts with `timeline "…" {` and ends with `}`.
- Do not invent keywords: use only the ones listed above.
- Keep labels short enough to read inside a box, and keep every ID unique.

MY DIAGRAM
Describe what you want here, then send this message.
How AI requests, attachments and privacy work

Something unclear? Contact support or read the Privacy Policy.