Multilingual setup

[xplosionmind]

Hi! First of all, allow me to thank you for creating this wonderful template, it is really cool!

I would be super interested in having a unified and consistent system to have the YAML data and the CV compiled both in English and other language(s).

I would be very happy to contribute to the project, but I would need some guidance. Could you give me some suggestions about the first steps to achieve this?

Thanks a lot!

[jskherman]

Thank you. As for multilingual support, there's a fork by jmml97 that changes the language of this template to Spanish with code es.

One way that could be done is to define the language in a lang field within the uservars variable. This should follow the format of ISO 639-1/2/3. This lang value can then be passed to a show rule and used to set the lang parameter for the text function for the entire template, as per the docs.

Next, using the same lang value, we can create a function that sets variables containing the strings for specific parts of the template, such as txt.education, txt.experience, txt.awards, and so on. Instead of hardcoding these strings in the template, we can use these variables.

The source for these text variables could be a dictionary of arrays that contains the strings, organized by ISO 639-1/2/3 language code. Alternatively, for simplicity, this data could be stored in a JSON or YAML file instead.

Edit: I forgot to mention the dates. I'm not sure if Typst automatically changes the strings output by the display() method for datetime types to be same as the language set in the text() function. Probably not. Since the template uses this method, this is another issue to look out for.

[joaoymoreira]

@573 i just began doing some work on this but just saw your commit... well, i was looking forward into adding language support for Brazilian Portuguese. It seems like you only implement lang, but not region which would be needed for e.g. pt-BR, pt-PT, en-US, en-UK, en-DK, etc e.g. text(lang: "pt", region: "BR").

See

• https://typst.app/docs/reference/text/text/#parameters-lang
  • https://iso639-3.sil.org
• https://typst.app/docs/reference/text/text/#parameters-region
  • https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Decoding_table

edit: working on adding that on top of your fork
edit 2: your fork seems a WIP, thought you had multilang support already working.
edit 3: ok i got it to work, i will try sending a PR soon.
edit 4: just noticed there's already a PR lol, but then I'll have to make some suggestions there... #31
edit 5: my pr supersedes 31 #32