Documentation:How to use the Parser - Revision history

Karen: 28 revisions imported

2022-03-08T08:25:45Z

28 revisions imported

← Older revision	Revision as of 08:25, 8 March 2022
(No difference)

Karen: Protected "Documentation:How to use the Parser" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2021-06-18T13:47:10Z

Protected "Documentation:How to use the Parser" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 13:47, 18 June 2021
(No difference)

Karen at 09:28, 15 June 2021

2021-06-15T09:28:10Z

← Older revision		Revision as of 09:28, 15 June 2021
Line 134:		Line 134:

	In the article they use a different text editor, which you may probably use as well (I just never used it, so I recommend the one I’m familiar with), but the syntax of regular expressions is the same no matter which text editor you use.		In the article they use a different text editor, which you may probably use as well (I just never used it, so I recommend the one I’m familiar with), but the syntax of regular expressions is the same no matter which text editor you use.

			==Converting Julian dates to Gregorian dates==
			Sometimes (very rarely though) the sources that you use may provide only old style dates. In this case you work with the data the same way, but in the end, after the dates are formatted, you just click the ''Julian to Gregorian'' button. All the dates after the calendar reform of 1582 will be converted. The dates before the reform will stay the same. Just make sure you don’t accidentally convert a date that was Gregorian to begin with.

			When testing such layer on the Timeline turn on Julian dates in the Menu. This way you'll be able to compare the dates on the Timeline with the dates in the sources that you used, as they will all be Julian dates.

Karen: /* The advanced technique */

2021-06-14T05:51:23Z

The advanced technique

← Older revision		Revision as of 05:51, 14 June 2021
Line 127:		Line 127:

	To use regular expressions you need a special text editor that programmers use. The one I’m using is VSCode. You can download it [https://code.visualstudio.com/ here]. Don’t worry, you don’t need to be a programmer to use it. Treat it as just a text editor. Your workflow will be:		To use regular expressions you need a special text editor that programmers use. The one I’m using is VSCode. You can download it [https://code.visualstudio.com/ here]. Don’t worry, you don’t need to be a programmer to use it. Treat it as just a text editor. Your workflow will be:
	Create new file, paste the text into it, do replacements. Before doing searching and replacing don’t forget to press the button with dot and asterisk to activate regular expressions:		Create new file, paste the text into it, do replacements. Before doing searching and replacing don’t forget to press the button with a dot and an asterisk to activate regular expressions:

	[[File:SearchWithRegExp.png]]		[[File:SearchWithRegExp.png]]

Karen: /* The advanced technique */

2021-06-14T05:50:07Z

The advanced technique

← Older revision		Revision as of 05:50, 14 June 2021
Line 109:		Line 109:
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

	What ~~you want~~ to do is to turn a block of text that looks like this:<blockquote><poem><nowiki>		What I needed to do was to turn a block of text that looks like this:<blockquote><poem><nowiki>
	\| align=center \| 502		\| align=center \| 502
	\| [[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]]		\| [[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]]
Line 120:		Line 120:
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

	~~You can do~~ it manually, but the problem is that there is almost 500 years worth of Roman consuls (I only did consuls of Roman Republic).		I could have done it manually, but the problem is that there is almost 500 years worth of Roman consuls (I only did consuls of Roman Republic).

	Regular expressions allowed me to find every such block of text and do the needed replacements automatically. In this particular case I created the final syntax right in the text editor without using Parser at all. But a lot of times I use the text editor to prepare the text for the Parser. It all depends on the situation.		Regular expressions allowed me to find every such block of text and do the needed replacements automatically. In this particular case I created the final syntax right in the text editor without using Parser at all. But a lot of times I use the text editor to prepare the text for the Parser. It all depends on the situation.

Karen: /* The advanced technique */

2021-06-14T05:47:21Z

The advanced technique

← Older revision		Revision as of 05:47, 14 June 2021
Line 109:		Line 109:
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

	What we want to do is to turn a block of text that looks like this:<blockquote><poem><nowiki>		What you want to do is to turn a block of text that looks like this:<blockquote><poem><nowiki>
	\| align=center \| 502		\| align=center \| 502
	\| [[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]]		\| [[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]]

Karen: /* The advanced technique */

2021-06-13T07:48:07Z

The advanced technique

← Older revision		Revision as of 07:48, 13 June 2021
Line 127:		Line 127:

	To use regular expressions you need a special text editor that programmers use. The one I’m using is VSCode. You can download it [https://code.visualstudio.com/ here]. Don’t worry, you don’t need to be a programmer to use it. Treat it as just a text editor. Your workflow will be:		To use regular expressions you need a special text editor that programmers use. The one I’m using is VSCode. You can download it [https://code.visualstudio.com/ here]. Don’t worry, you don’t need to be a programmer to use it. Treat it as just a text editor. Your workflow will be:
	Create new file, paste the text, do replacements. Before doing searching and replacing don’t forget to press the button with dot and asterisk to activate regular expressions:		Create new file, paste the text into it, do replacements. Before doing searching and replacing don’t forget to press the button with dot and asterisk to activate regular expressions:

	[[File:SearchWithRegExp.png]]		[[File:SearchWithRegExp.png]]
Line 133:		Line 133:
	To learn about regular expressions read this [https://docs.microsoft.com/en-us/visualstudio/ide/using-regular-expressions-in-visual-studio article].		To learn about regular expressions read this [https://docs.microsoft.com/en-us/visualstudio/ide/using-regular-expressions-in-visual-studio article].

	In the article they use a different text editor, which you may probably use as well (I just never used it, so I recommend the one I’m familiar with), but the syntax of regular expressions is the same no matter ~~what~~ text editor you use.		In the article they use a different text editor, which you may probably use as well (I just never used it, so I recommend the one I’m familiar with), but the syntax of regular expressions is the same no matter which text editor you use.

Karen: /* The advanced technique */

2021-06-13T07:44:52Z

The advanced technique

← Older revision		Revision as of 07:44, 13 June 2021
Line 110:		Line 110:

	What we want to do is to turn a block of text that looks like this:<blockquote><poem><nowiki>		What we want to do is to turn a block of text that looks like this:<blockquote><poem><nowiki>
	\| align=center \| ~~503~~		\| align=center \| 502
	\| [[~~Agrippa Menenius Lanatus~~ (consul ~~503~~ BC)\|~~Agrippa Menenius Lanatus~~]]		\| [[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]]
	\| [[~~Publius Postumius Tubertus~~\|P. ~~Postumius Tubertus~~]] II		\| [[Spurius Cassius Viscellinus\|Sp. Cassius Viscellinus]]
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

	into a block of text that looks like this:<blockquote><poem><nowiki>		into a block of text that looks like this:<blockquote><poem><nowiki>
	[[~~Agrippa Menenius Lanatus~~ (consul ~~503~~ BC)\|~~Agrippa Menenius Lanatus~~]];;;;09.01.-~~503~~;;		[[Opiter Verginius Tricostus (consul 502 BC)\|Opet. Verginius Tricostus]];;;;09.01.-502;;
	[[~~Publius Postumius Tubertus~~\|P. ~~Postumius Tubertus II~~]] (post.);;;;09.01.-~~503~~;;		[[Spurius Cassius Viscellinus\|Sp. Cassius Viscellinus]] (post.);;;;09.01.-502;;
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

Karen: /* The advanced technique */

2021-06-13T07:39:06Z

The advanced technique

← Older revision		Revision as of 07:39, 13 June 2021
Line 115:		Line 115:
	</nowiki></poem></blockquote>		</nowiki></poem></blockquote>

	~~Into~~ this:<blockquote><poem><nowiki>		into a block of text that looks like this:<blockquote><poem><nowiki>
	[[Agrippa Menenius Lanatus (consul 503 BC)\|Agrippa Menenius Lanatus]];;;;09.01.-503;;		[[Agrippa Menenius Lanatus (consul 503 BC)\|Agrippa Menenius Lanatus]];;;;09.01.-503;;
	[[Publius Postumius Tubertus\|P. Postumius Tubertus II]] (post.);;;;09.01.-503;;		[[Publius Postumius Tubertus\|P. Postumius Tubertus II]] (post.);;;;09.01.-503;;

Karen: /* Example */

2021-06-13T07:34:12Z

Example

← Older revision		Revision as of 07:34, 13 June 2021
Line 15:		Line 15:
	Let’s use US presidents as an example. Suppose you want to create a layer of US presidents (even though such layer already exists).		Let’s use US presidents as an example. Suppose you want to create a layer of US presidents (even though such layer already exists).

	First, you’d go to the corresponding Wikipedia page and open its source wiki text.		First, you’d go to the corresponding [https://en.wikipedia.org/wiki/List_of_presidents_of_the_United_States Wikipedia page] and open its source wiki text.

	[[File:EditSource.png\|300px]]		[[File:EditSource.png\|300px]]
Line 59:		Line 59:


	Now everything looks right. Copy the result and paste it into the Editor.		Now everything looks right. Copy the result and paste it into the Editor.

	==A harder task==		==A harder task==