ok-oldking / ok-oldking/ok-script
i18n: document framework ok.po msgid baseline and info_set translation contract
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 739
- Forks
- 208
- Avg merge
- 7h 47m
- Merged PRs (30d)
- 1
Description
Per BnanZ0/ok-nte#112, missing msgids and task strings should be reported here.
When testing ok-nte with zh_TW, the task info panel still shows simplified Chinese for strings like 轮次, 开启, 任务结束. TaskTab already calls og.app.tr() on info_set keys/values (ok/gui/tasks/TaskTab.py:86-90); the issue is that derived projects' ok.po does not include these msgids.
Request
-
Framework msgid baseline — Publish a list of strings that ok-script itself looks up via
og.app.tr()/info_set(e.g.Log,Warning,Error,Alert,Confirm,Cancel,Export failed, …) so derived apps know what to add took.po. -
info_set translation contract — Document that derived tasks should use static simplified-Chinese msgids in
info_set()(notr()in tasks); display is handled byTaskTab. Include common key/value examples for translators. -
(Optional) Improve
gen_tr_po_files()/to_translateexport so derived projects can dump a complete missing-msgid list from runtime.
Note: ok-nte#112 is kept for the MainWindow.py / app.py notification-path bug (og.app.tr vs QCoreApplication.translate). This issue covers msgid catalog and documentation only.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with ok/gui/tasks/TaskTab.py:86-90 and inspect the framework’s og.app.tr() and info_set usage, along with gen_tr_po_files() and to_translate. Document the framework msgid baseline and the info_set contract with translator examples; done means derived projects can identify the required ok.po entries, with the export improvement treated as optional.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation, internationalization
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 65/100