3,987
edits
Difference between revisions of "Documentation:The Editor and data format"
Jump to navigation
Jump to search
m
Documentation:The Editor and data format (edit)
Revision as of 21:15, 7 March 2022
, 21:15, 7 March 202279 revisions imported
m (79 revisions imported) |
|||
| (24 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Let’s see how the information about events is stored on the server. Make sure that the library is open (click | Let’s see how the information about events is stored on the server. Make sure that the library is open (click ''Events'' button in the bottom right corner of the screen if needed) | ||
Then open Menu (click | Then open Menu (click ''Menu'' button in the bottom left corner of the screen). Now select ''Show Cache and Edit buttons''. | ||
[[File:ShowCacheAndEditButtons.png]] | [[File:ShowCacheAndEditButtons.png]] | ||
You should see that | You should see that ''Clear cache'' and ''Edit'' buttons have appeared in the Library next to each folder and layer of events. | ||
[[File:CacheAndEventButtons.png]] | [[File:CacheAndEventButtons.png]] | ||
Click an Edit button next to some layer, and another Edit button next to some folder. Pages with wikitext should open in separate tabs. Examine the data and compare it to what you see on the timeline. Here is an example for a [https:// | Click an ''Edit'' button next to some layer, and another ''Edit'' button next to some folder. Pages with wikitext should open in separate tabs. Examine the data and compare it to what you see on the timeline. Here is an example for a [https://timeline.oldera.org/wiki/index.php?title=HistoryTimelineLayer:Kings%20of%20Rome&action=edit layer]. Here is an example for a [https://timeline.oldera.org/wiki/index.php?title=HistoryTimelineFolder:Ancient%20Rome&action=edit folder]. | ||
Let's look at this example: | Let's look at this example: | ||
| Line 20: | Line 20: | ||
==The Editor== | ==The Editor== | ||
There should be a button called | There should be a button called ''Editor'' in the bottom left corner of the screen next to the Menu button. If you don’t see it, it’s because the browser window is too small to fit the Editor. On a desktop try making the browser window fullscreen. If you have a small-screen device like a mobile phone, you won’t be able to use the Editor. | ||
Open the Editor. Let's add a couple of events, like so: | Open the Editor. Let's add a couple of events, like so: | ||
| Line 38: | Line 38: | ||
There are 7 data fields for each event: | There are 7 data fields for each event: | ||
[[File: | [[File:NewDataFormat.png]] | ||
Some data fields are used by one kind of event but not the other. Others are used by both. | Some data fields are used by one kind of event but not the other. Others are used by both. | ||
Let’s go through all of the data fields one by one. | Let’s go through all of the data fields one by one. | ||
''Visible text'' - for time intervals try to put short titles here, not | ''Visible text'' - for time intervals try to put short titles here, not long sentences. You can use the ''Comment'' field to put longer text there. | ||
For instantaneous events the text can be longer, but don’t put entire articles there. One or two sentences should suffice. | For instantaneous events the text can be longer, but don’t put entire articles there. One or two sentences should suffice. | ||
You can use some of the features of Wikipedia’s wikitext in the cards. For example, to add a link, use double brackets. | You can use some of the features of Wikipedia’s wikitext in the cards. For example, to add a link, use double brackets. | ||
| Line 101: | Line 101: | ||
[[File:VisibleDynasty.png]] | [[File:VisibleDynasty.png]] | ||
''Link'' - this field is only used for time intervals. By default the visible text of the time interval is the link to the corresponding Wikipedia page. If you want the link to be different from the visible text, specify the actual link in this field. If you want to link to a page outside of Wikipedia, use the full link (which starts with http or https). If you don't want the text to be a link at all, put a | ''Link'' - this field is only used for time intervals. By default the visible text of the time interval is the link to the corresponding Wikipedia page. If you want the link to be different from the visible text, specify the actual link in this field. If you want to link to a page outside of Wikipedia, use the full link (which starts with http or https). If you don't want the text to be a link at all, put a minus sign <code>-</code> in the ''Link'' field. The text in this case will become grey instead of white and will not be clickable. | ||
''Custom dates'' - this field is only used for time intervals. By default every time interval has a range of years specified under its title. | |||
[[File:Rebel.png]] | |||
Those years are automatically taken from the ''Start date'' and ''End date'' fields. | |||
<code>Jean-Féry Rebel;;;;04.18.1666;01.02.1747;</code> | |||
But what if you want to provide more details. For example, sometimes you want to have something like this: | |||
[[File:CharlesDolle.png]] | |||
That’s what the ''Custom dates'' field is for. Simply specify whatever you want to see in the second line there. | |||
<code>Charles Dollé;;(fl. 1735–1755\; d. after 1755);;1735;1755;</code> | |||
Note, that you still have to specify dates in the ''Start date'' and ''End date'' field, because they actually tell the program how to draw the time interval on the Timeline. | |||
''Comment'' - this field is only used for time intervals. If you put some text in it (for example: <code><nowiki>some time interval;;;this is a comment with a [[Hannibal|link]];1978;1982;</nowiki></code>), the plus button will appear on the time interval: | ''Comment'' - this field is only used for time intervals. If you put some text in it (for example: <code><nowiki>some time interval;;;this is a comment with a [[Hannibal|link]];1978;1982;</nowiki></code>), the plus button will appear on the time interval: | ||
| Line 258: | Line 277: | ||
''Visible text'' - is usually the name of the page containing layer data. | ''Visible text'' - is usually the name of the page containing layer data. | ||
''Link'' - if the actual name of the | ''Link'' - if the actual name of the page differs from the visible text, specify the name of the page here. | ||
''Is list'' - This field is used for layers presented as a list of time intervals that you can toggle individually. | ''Is list'' - This field is used for layers presented as a list of time intervals that you can toggle individually. | ||