4,007
edits
Difference between revisions of "Documentation:How to use the Parser"
Jump to navigation
Jump to search
Documentation:How to use the Parser (view source)
Revision as of 07:34, 12 June 2021
, 07:34, 12 June 2021no edit summary
| Line 1: | Line 1: | ||
Before reading this article you need to be familiar with the basic syntax of events in a layer, which is described [[Documentation:The Editor and data format|here]]. | Before reading this article you need to be familiar with the basic syntax of events in a layer, which is described [[Documentation:The Editor and data format|here]]. | ||
You can open the Parser by clicking the Parser button in the bottom right corner of the Editor. | You can open the Parser by clicking the ''Parser'' button in the bottom right corner of the Editor. | ||
[[File:ParserButton.png|600px]] | [[File:ParserButton.png|600px]] | ||
| Line 10: | Line 10: | ||
==The workflow== | ==The workflow== | ||
You need to put the source text (usually wiki text from a Wikipedia article) in the left field. Then, using the buttons at the bottom you highlight the needed information in the text: event texts and dates. The techniques for doing that will be described in this article. After that you click | You need to put the source text (usually wiki text from a Wikipedia article) in the left field. Then, using the buttons at the bottom you highlight the needed information in the text: event texts and dates. The techniques for doing that will be described in this article. After that you click ''Move selected'' button and the data is moved into the right field. Usually you need to format the data a bit more using the buttons below the right text field and then you can copy the resulting text and paste it into the Editor so that you can test the data on the timeline. | ||
==Example== | ==Example== | ||
| Line 25: | Line 25: | ||
Now you need to mark all the presidents with red color, and all the dates with orange color. You can see that in the left bottom corner of the screen there is a button that is red already. And it says ‘Texts’. Thats exactly what we need. That means we are in the text selection mode. To select dates you will need to change the mode to single date selection mode or double dates selection mode. For now don’t do anything with the red button. | Now you need to mark all the presidents with red color, and all the dates with orange color. You can see that in the left bottom corner of the screen there is a button that is red already. And it says ‘Texts’. Thats exactly what we need. That means we are in the text selection mode. To select dates you will need to change the mode to single date selection mode or double dates selection mode. For now don’t do anything with the red button. | ||
If you click | If you click ''Select'' button, by default all the links will be selected: | ||
[[File:PresidentsTooMuchLinks.png|500px]] | [[File:PresidentsTooMuchLinks.png|500px]] | ||
| Line 31: | Line 31: | ||
You can manually unhighlight all the links that you don’t need (by selecting a range of text containing the highlighted parts and pressing Option/Alt key on the keyboard), but that’s too much work. | You can manually unhighlight all the links that you don’t need (by selecting a range of text containing the highlighted parts and pressing Option/Alt key on the keyboard), but that’s too much work. | ||
Instead let’s do something else. First, clear the selection by clicking | Instead let’s do something else. First, clear the selection by clicking ''Clear'' button. | ||
Now let’s pay attention to the fact that all the links containing presidents’ names are enclosed in triple apostrophes like this: <code><nowiki>'''[[George Washington]]'''</nowiki></code>. We can use this fact to our advantage. | Now let’s pay attention to the fact that all the links containing presidents’ names are enclosed in triple apostrophes like this: <code><nowiki>'''[[George Washington]]'''</nowiki></code>. We can use this fact to our advantage. | ||
Put prefix <code><nowiki>'''[[</nowiki></code> and postfix <code><nowiki>]]'''</nowiki></code> in the two small input fields, and then click Select button. | Put prefix <code><nowiki>'''[[</nowiki></code> and postfix <code><nowiki>]]'''</nowiki></code> in the two small input fields, and then click ''Select'' button. | ||
[[File:PrefixPostfixExample.png|300px]] | [[File:PrefixPostfixExample.png|300px]] | ||
| Line 43: | Line 43: | ||
[[File:Presidents_Links.png|500px]] | [[File:Presidents_Links.png|500px]] | ||
Click on the red button to change it to orange. To find dates just click the | Click on the red button to change it to orange. To find dates just click the ''Find dates'' button. As you can see all the dates are highlighted, even the ones we don’t need. | ||
[[File:PresidentsTooMuchDates.png|500px]] | [[File:PresidentsTooMuchDates.png|500px]] | ||
Now you have to manually unhighlight the ones that are not needed, by selecting parts of text with a mouse and pressing Option/Alt button. | Now you have to manually unhighlight the ones that are not needed, by selecting parts of text with a mouse and pressing ''Option/Alt'' button. | ||
Once you are done, you can click ‘Move selected’ and the data will be moved into the right field with almost correct syntax. | Once you are done, you can click ‘Move selected’ and the data will be moved into the right field with almost correct syntax. | ||
| Line 53: | Line 53: | ||
[[File:Presidents_Almost_Done.png|800px]] | [[File:Presidents_Almost_Done.png|800px]] | ||
Now you can click | Now you can click ''Format dates'' button to change date format: | ||
[[File:PresidentsResult.png|400px]] | [[File:PresidentsResult.png|400px]] | ||