{"thread":{"id":"55276","subject":"Core translation should be documented on po/README","startedAt":"2021-03-09T11:40:45Z","lastAt":"2021-03-10T11:34:35Z","messageCount":2,"participants":["Bagas Sanjaya","Jiang Xin"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"418589","messageId":"d536f4fe-a857-0307-db3b-139ff4ff25b2@gmail.com","threadId":"55276","inReplyTo":null,"subject":"Core translation should be documented on po/README","fromName":"Bagas Sanjaya","fromEmail":"bagasdotme@gmail.com","sentAt":"2021-03-09T11:40:02Z","receivedAt":"2021-03-09T11:40:45Z","isPatch":false,"sender":{"key":"bagasdotme@gmail.com","avatar":"https://avatars.githubusercontent.com/u/40219486?v=4"},"body":"Hello,\n\nI had learned the following when I submitted Indonesian translation [1].\n\nThe documentation at po/README missed mentioning about \"core translation\",\nwhich IMO is minimum translated messages needed to complete the translation.\nSo the l10n coordinator had to instructed me to complete it.\n\nTo translate core messages, I ran `po-helper.sh check id.po` first and\ndo the translation work on the generated po/core-id.po. Next, I merged\npo/core-id.po to id.po by `msgcat`, however he didn't tell me the order of\nPO files to be passed to `msgcat`, so AFAIK I `ran msgcat core-id.po id.po`\nand fixed \"fuzzy\" errors (such as misplaced translated messages).\n\nI think these above should be mentioned in po/README.\n\nNOTE: po-helper.sh can be found on po-helper branch of l10n coordinator\nrepo. [2]\n\n[1]: https://github.com/git-l10n/git-po/pull/500\n[2]: https://github.com/git-l10n/git-po/blob/po-helper/utils/po-helper.sh\n\n-- \nAn old man doll... just what I always wanted! - Clara\n"},{"id":"418683","messageId":"CANYiYbFFwBXFEJwAd4ft7A-KLMrfjd0+Cw+An0oo0VbC3TJp2Q@mail.gmail.com","threadId":"55276","inReplyTo":"d536f4fe-a857-0307-db3b-139ff4ff25b2@gmail.com","subject":"Re: Core translation should be documented on po/README","fromName":"Jiang Xin","fromEmail":"worldhello.net@gmail.com","sentAt":"2021-03-10T11:32:12Z","receivedAt":"2021-03-10T11:34:35Z","isPatch":false,"sender":{"key":"worldhello.net@gmail.com","avatar":"https://avatars.githubusercontent.com/u/183860?v=4"},"body":"Bagas Sanjaya <bagasdotme@gmail.com> 于2021年3月9日周二 下午7:40写道：\n>\n> Hello,\n>\n> I had learned the following when I submitted Indonesian translation [1].\n>\n> The documentation at po/README missed mentioning about \"core translation\",\n> which IMO is minimum translated messages needed to complete the translation.\n> So the l10n coordinator had to instructed me to complete it.\n\nWhen we started l10n for git, there were only about 700 entries in\n\"po/git.pot\", but there are over 5000 entries now for git 2.31.0.\nProviding a complete translation is not a piece of cake for a new l10n\nteam. So, I defined a minimal l10n template based on source code for\nsome daily used commands, such as wt-status.c, builtin/clone.c, etc.\nThe first contribution of a new l10n team should cover this minimal\nl10n template, which I called as \"core.pot\" (I'm not good at naming).\n\nIt's a good suggestion to add notes in \"po/README\". But without a\nhelper, it is hard to describe how to generate the minimal l10n\ntemplate. The personal used helper \"po-helper.sh\" may have bugs, and I\nwant to rewrite it to check author date and committer date in order to\nprevent unecessarly calibrated the corrected committer date in\ncommit-graph.\n\n>\n> To translate core messages, I ran `po-helper.sh check id.po` first and\n> do the translation work on the generated po/core-id.po. Next, I merged\n> po/core-id.po to id.po by `msgcat`, however he didn't tell me the order of\n> PO files to be passed to `msgcat`, so AFAIK I `ran msgcat core-id.po id.po`\n> and fixed \"fuzzy\" errors (such as misplaced translated messages).\n> I think these above should be mentioned in po/README.\n>\n\nI think the order of PO files to `msgcat` is not important, commands\nare as follows:\n\n        msgcat <input1.po> <input2.po> -s -o <output.po>\n        mv <output.po>  XX.po\n        msgmerge --add-location --backup=off -U XX.po  git.pot\n\n\n> NOTE: po-helper.sh can be found on po-helper branch of l10n coordinator\n> repo. [2]\n>\n> [1]: https://github.com/git-l10n/git-po/pull/500\n> [2]: https://github.com/git-l10n/git-po/blob/po-helper/utils/po-helper.sh\n>\n> --\n> An old man doll... just what I always wanted! - Clara\n"}]}