Náboj translation checklist

Text

At the beginning off the process you should have access to the English translation of the problems, already copied in the directory of your language along with symbolic links to all images. Each problem resides in its own directory and has three files: problem.md, solution.md and answer.md. Optionally picture files might be present, most often in svg format.

Example

• english
  • planets
    • problem.md
    • solution.md
    • answer.md
    • gravity.svg
• hungarian
  • planets
    • problem.md (different content)
    • solution.md (different content)
    • answer.md (different content)
    • gravity.svg (symlink to ../../english/planets/gravity.svg)
• russian
  • (same structure)
• (more languages)

Images

Please ensure that all problems contain appropriate images (either deduce from context, or compare with the english version). Most of the time pictures are identical across all translations, in this case there should only be symlinks to the slovak version and will be provided to you.

You need to include the @NP macro so that the correct image is included in the text. Again, this should already be there in the English translation provided to you, but please make sure this is actually the case. It is unfortunate if this is found during the competition. The macro should not be modified, except for its caption (only in solutions, images in problems do not have captions, the third {} pair should be empty).

Constants

There is a global YAML file containing all the constants needed for constant tables. This ensures different translations all use the same values. The names of the constants are stored in DeGeŠ's module file which is not accessible from Náboj git, so they have to be provided globally. Many constants are already there, but in case new constants are added in future volumes, you will need to provide translations directly to us.

Translation quality assurance tiers

Tier 1

Translate files offline. If done properly, this theoretically should be enough. If there is anything that is not completely clear to you, please consult. Things may be lost in translation sometimes though: either we might have introduced some errors into the English translation, or you erred independently. In any case, this is fatal if only found during the competition.

You do not need to translate solution.md if your local team does not wish to produce a booklet.

Tier 2

Translate and recalculate the problem as stated in your language. Make sure that the answer to the question in the problem statement is actually written in the answer file.

Tier 3

Cross-check: have someone read the translated problems and try to solve them independently. This helps us catch problems with translations (for instance, in volume 22 we inadvertently introduced an error and swapped "radius" for "diameter" in English translation and this led to correct results not being accepted in languages that used English as reference).

Tier 4

Organize a full-fledged test, with mock teams comprising people who had not seen the problems beforehand (and of course, who are not going to compete). The Slovak team organizes at least one such test before translations are provided.