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.
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.
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
| Syntax | Meaning |
|---|---|
timeline "Title" { | open a timeline |
Events
| Syntax | Meaning |
|---|---|
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
| Syntax | Meaning |
|---|---|
scale time | time (gaps to scale) or even (order only) |
orientation vertical | horizontal or vertical |
Look
| Syntax | Meaning |
|---|---|
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 //) |
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 & exportingWrite 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.Something unclear? Contact support or read the Privacy Policy.