YAML in PIRATEZ questions

[Bartojan]

I never worked with YAML before, so there are my questions:

1) Is it possible to use "one: ... few: .... other: ...." notation in every place where {N} or {0} is used? Is it possible only on places with {N}? Or have it be coded in the application, to use this notation?

Code: [Select]

STR_UNITS_IN_CRAFT:
  one: "{N} Unit aboard"
  other: "{N} Units aboard"
2) I like the "variable" &FIRST_NAMES used in Pirate.nam file. Is it possible to use similar "variables" for strings used inside the texts? E.g.

Code: [Select]

GunButt (Stun = 20+STR*0.6, Skill = MA/2+50, Acc = 80%, 18 TUs)is used many times in Piratez_lang.rul file and I would like to have some shortcut for it like &GUNBUT.

[ohartenstein23]

1) This depends on how the engine is reading the YAML file, and for OXC/OXCE/OXCE+ this is not supported.

2) The "variables" you see are YAML anchors - you can mark the value of a particular tag as an anchor with ampersand (&), and reference it with asterisk (*).  This is useful for copy-paste like functions, but only if the values of the tags are exactly the same. This is not the case for Bootypedia articles, where there is unique text before the gunbutt, and also not all gunbutts are created equal.

This tutorial might be helpful if you want to learn more YAML.

[Bartojan]

1) This depends on how the engine is reading the YAML file, and for OXC/OXCE/OXCE+ this is not supported.

There are at least 2 strings with one... many... notation. I will test it myself.

Thanks for the manual So, no text replacement in pure YAML. I am going to use some tool for it. Troff or FreeMarker.

[ohartenstein23]

News to me if that's supported in how the strings are read - I should probably just check the source code to see...

[Meridian]

News to me if that's supported in how the strings are read - I should probably just check the source code to see...

Yes, it is supported, e.g.

Code: [Select]

  STR_DAY:
    one: "{N} deň"
    few: "{N} dni"
    other: "{N} dní"
  STR_HOUR:
    one: "{N} hodina"
    few: "{N} hodiny"
    other: "{N} hodín"

https://github.com/SupSuper/OpenXcom/blob/master/src/Engine/Language.cpp#L516

https://github.com/SupSuper/OpenXcom/blob/master/src/Engine/Language.cpp#L675

[ohartenstein23]

I stand corrected. Thank you Meridian for linking the code, I like the rare example of good documentation in a comment.