addedInput schema / properties / events / items / properties / color / description
Added value: +"Color as \"#rrggbb\": the fill of shapes with text inside, and the line and text of the others. The default is #37a70b for events and #1898e0 for periods. Editor palette: #2c3d4d dark blue, #37a70b green, #96ec39 light green, #587934 olive, #1898e0 blue, #ffcca3 peach, #f56c00 orange. Text inside RECTANGLE, VERTICAL_RECT, CIRCLE_IN, RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT gets a contrasting color from Time.Graphics. On the other types, the text has this color and lies right on the background: on the light background (#FCFCFC), #2c3d4d, #587934, #1898e0, #f56c00, and #37a70b read well, while #ffcca3 and #96ec39 are unreadable and fit only shapes with text inside. Pure black and pure white hide the hover highlight."
changedInput schema / properties / events / items / properties / date / description
Previous value: -"ISO date, negative year for BC, precision may be year only: \"-0509\", \"1957-10\", \"1969-07-20\""New value: +"Date of the event as an ISO string, as precise as is known. Years before Christ are negative. The month and the day can be omitted: \"-0509\", \"1957-10\", \"1969-07-20\"."
addedInput schema / properties / events / items / properties / description / description
Added value: +"Text that opens in a separate window; it is not drawn on the timeline. Plain text: one or two sentences on why this matters, up to 300 characters, read best."
changedInput schema / properties / events / items / properties / over_line / description
Previous value: -"true above the timeline line, false below it, default true"New value: +"Side of the line: true above it, false below it. The default is true for events and false for periods. The two sides stack independently. A plain list alternates sides; with two storylines, each keeps its own side (for example, politics above and culture below); background periods (FILL_AREA, BRACES) stay on one side."
changedInput schema / properties / events / items / properties / scale / description
Previous value: -"size, 100 is normal, default 100"New value: +"Size of the object, a whole number from 10 to 1000; the default is 100, the normal size. It multiplies the font, the icon, and the padding. 120-150 fits 1-3 key events, 100 regular ones, and 70-85 small details in dense parts. Below 60 the text is unreadable; above 200 the object covers its neighbors. Objects of one category read best at one scale."
changedInput schema / properties / events / items / properties / text_position / description
Previous value: -"text left or right of the icon, or CENTER above or below it (-1, 0, 1 in the style book), default CENTER"New value: +"Where the text stands relative to the icon; events only. CENTER, the default: above or below the icon. CENTER fits when events are sparse: more than one-fifteenth of the length of the whole timeline lies between neighboring dates. When neighboring events are closer, CENTER labels stack on top of each other in tiers and run off the edge of the canvas. LEFT on the earlier event and RIGHT on the later one move the labels apart, to opposite sides. In a run of close events, the labels fit in a single row with the order LEFT, LEFT, RIGHT, RIGHT."
addedInput schema / properties / events / items / properties / title / description
Added value: +"The fact itself, 2 to 6 words, without the date: the axis shows the time. A name does not wrap on its own; \"\\n\" separates lines. A line of up to 3 words reads best, and 2 words read better still: a 6-word name is three lines of 2 words each. In dense parts, one line of up to 3 words reads best."
changedInput schema / properties / events / items / properties / type / description
Previous value: -"icon type from the style book in timegraphics://guide, default RECTANGLE"New value: +"Icon type; the default is RECTANGLE. RECTANGLE: a rounded plate filled with the color, with the text inside; fits timelines of up to 15-20 events with room between neighboring dates. LINE: a thin stem from the line to the text, with no plate; the lightest look, fits a restrained style. CIRCLE: a dot on the line with the text beside it or above it; with LEFT or RIGHT its box is low. LINE and CIRCLE fit when there are more than 20 events or when events stand close together, so the labels do not pile up: LINE has the lowest and narrowest box, and CIRCLE with LEFT or RIGHT has a lower box than RECTANGLE. VERTICAL_RECT: a filled plate and a vertical line across the whole canvas height; very loud. VERTICAL_DOT: a dot and a vertical line across the whole canvas height; loud. VERTICAL_RECT and VERTICAL_DOT are for 1-3 turning points on the whole timeline. CIRCLE_IN: the text inside a filled circle that grows with the text; fits names of one to three words."
changedInput schema / properties / events / items / properties / url / description
Previous value: -"source or reading link shown with the event"New value: +"Link to a reliable source or further reading, http or https, shown with the event or period; fits when sources are requested."
addedInput schema / properties / periods / items / properties / color / description
Added value: +"Color as \"#rrggbb\": the fill of shapes with text inside, and the line and text of the others. The default is #37a70b for events and #1898e0 for periods. Editor palette: #2c3d4d dark blue, #37a70b green, #96ec39 light green, #587934 olive, #1898e0 blue, #ffcca3 peach, #f56c00 orange. Text inside RECTANGLE, VERTICAL_RECT, CIRCLE_IN, RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT gets a contrasting color from Time.Graphics. On the other types, the text has this color and lies right on the background: on the light background (#FCFCFC), #2c3d4d, #587934, #1898e0, #f56c00, and #37a70b read well, while #ffcca3 and #96ec39 are unreadable and fit only shapes with text inside. Pure black and pure white hide the hover highlight."
addedInput schema / properties / periods / items / properties / date_from / description
Added value: +"Start of the period as an ISO string, as precise as is known. Years before Christ are negative. The month and the day can be omitted: \"-0509\", \"1957-10\", \"1969-07-20\"."
addedInput schema / properties / periods / items / properties / date_to / description
Added value: +"End of the period, in the same format as date_from."
addedInput schema / properties / periods / items / properties / description / description
Added value: +"Text that opens in a separate window; it is not drawn on the timeline. Plain text: one or two sentences on why this matters, up to 300 characters, read best."
changedInput schema / properties / periods / items / properties / over_line / description
Previous value: -"true above the timeline line, false below it, default false"New value: +"Side of the line: true above it, false below it. The default is true for events and false for periods. The two sides stack independently. A plain list alternates sides; with two storylines, each keeps its own side (for example, politics above and culture below); background periods (FILL_AREA, BRACES) stay on one side."
changedInput schema / properties / periods / items / properties / scale / description
Previous value: -"size, 100 is normal, default 100"New value: +"Size of the object, a whole number from 10 to 1000; the default is 100, the normal size. It multiplies the font, the icon, and the padding. 120-150 fits 1-3 key events, 100 regular ones, and 70-85 small details in dense parts. Below 60 the text is unreadable; above 200 the object covers its neighbors. Objects of one category read best at one scale."
addedInput schema / properties / periods / items / properties / title / description
Added value: +"The fact itself, 2 to 6 words, without the date: the axis shows the time. A name does not wrap on its own; \"\\n\" separates lines. A line of up to 3 words reads best, and 2 words read better still: a 6-word name is three lines of 2 words each. In dense parts, one line of up to 3 words reads best."
changedInput schema / properties / periods / items / properties / type / description
Previous value: -"period type from the style book in timegraphics://guide, default RECT_TOP"New value: +"Period type; the default is RECT_TOP. RECT_TOP: a thin bar with the text under or above it; the name stays whole at any width. RECT_APPROX_TOP: RECT_TOP with fading edges on both sides. THIN: a 2-pixel line with the text under or above it; the most modest look, fits many overlapping periods. BRACES: a curly brace along the whole period with a light fill down to the line; fits eras and chapters that contain other objects. FILL_AREA: a thin line and a background band across the whole canvas height, drawn under everything else; fits the longest eras as a backdrop, at most three overlapping. RECT: a solid bar with the text inside, cut at the bar width. RECT_APPROX: RECT with fading edges on both sides (\"roughly from ... to ...\"). RECT_APPROX_LEFT: RECT with a fading left edge (the start is unknown). RECT_APPROX_RIGHT: RECT with a fading right edge (the end is unknown or it is still going on). By length: the longest eras fit FILL_AREA or BRACES; medium spans fit RECT_TOP or RECT_APPROX_TOP; short spans fit RECT_TOP or THIN; RECT, RECT_APPROX, RECT_APPROX_LEFT, and RECT_APPROX_RIGHT fit only periods that are long relative to the whole timeline and have short names."
addedInput schema / properties / periods / items / properties / url / description
Added value: +"Link to a reliable source or further reading, http or https, shown with the event or period; fits when sources are requested."