Translation request for IntroVox

[Rikdekker]

👤 App repository

To be done by you

• Link to your repository: https://github.com/nextcloud/IntroVox
• If the app is not in the Nextcloud organisation
  • Invite nextcloud-bot with write permissions
  • Make sure all translated branches do not have branch protection enabled, see https://docs.nextcloud.com/server/latest/developer_manual/basics/front-end/l10n.html#setup-of-the-transifex-sync for more details
• Create file l10n/.gitkeep with empty content
• Add .l10nignore to exclude compiled JS files and thirdparty code, e.g. ignoring compiled javascript assets and composer PHP dependencies in the vendor/ directory:

  js/
  vendor/
  

• Create file .tx/config with the following content, replace {{APPID}} with your app id 3 times:

  [main]
  host     = https://www.transifex.com
  lang_map = hu_HU: hu, nb_NO: nb, sk_SK: sk, th_TH: th, ja_JP: ja, bg_BG: bg, cs_CZ: cs, fi_FI: fi
  
  [o:nextcloud:p:nextcloud:r:{{APPID}}]
  file_filter = translationfiles/<lang>/{{APPID}}.po
  source_file = translationfiles/templates/{{APPID}}.pot
  source_lang = en
  type        = PO

• ⚙️ Validate your repository and translation strings:

  bash translations/validateSyncSetup.sh Owner Repository

🏗️ Sysadmin team

• 👀 Ensure access:

  • Nextcloud organisation repository: Add nextcloud-bot with admin permissions
  • Other repositories:
    • Ensure the invite was accepted
    • Ensure the app certificate is linked to the same repository/author https://github.com/nextcloud/app-certificate-requests

• ⚙️ Ensure repository setup and run initial source validation:

  bash translations/validateSyncSetup.sh Owner Repository

• 🧑‍💻 Run the first sync manually:

  ssh transifex-sync.nextcloud.com

  cd /srv/docker-ci
  docker run -v /srv/cronie-data/transifexrc:/root/.transifexrc \\
    -v /srv/cronie-data/gpg:/gpg \\
    -v /srv/cronie-data/ssh/id_rsa:/root/.ssh/id_rsa \\
    --rm -i ghcr.io/nextcloud/continuous-integration-translations-app \\
    AUTHOR APPID

• Transifex: New resource should appear

• GitHub: Check if there was a sync commit in the repository

  • If not, go to Transifex, translate some strings in a language you know and trigger the sync again with the docker command

• Transifex: On the resource go to Settings > Untick "Your translators can translate resource strings" > Save settings

• ➕ Add "Owner Repository", into https://github.com/nextcloud/docker-ci/edit/master/translations/config.json

  • Pull request: translations: add IntroVox #937
  • Request review from rakekniven

🔣 Translation team

Currently done by rakekniven

• Transifex: Check quality of the English source strings
• Transifex: Check translation guidelines
• GitHub: Approve the above pull request (and merge it)
• Transifex: On the resource go to Settings > Delete the resource
• Forum: Add resource to wiki

🏗️ Sysadmin team

• GitHub: Ensure the above pull request is merged
• 📅 Enable the daily sync:

  ssh transifex-sync.nextcloud.com

  cd /srv/docker-ci
  git pull origin master

---

Additional context

Owner/Repo: nextcloud IntroVox

App: IntroVox — interactive onboarding tour for new Nextcloud users (Vue 3 + Shepherd.js).

@nextcloud-bot already has admin access on nextcloud/IntroVox (verified via API), inherited org-wide. No invite needed.

Just released v1.6.0 which contains the full i18n overhaul to make the source strings Transifex-ready:

• All 16 wizard step titles/texts now use English source strings as msgids (were opaque step_* keys)
• ~50 previously-hardcoded Dutch strings in the PWA install instructions are now wrapped in t()
• Language picker auto-discovers display names via IFactory::getLanguages() so new Transifex languages appear automatically without code changes

POT file already committed at translationfiles/templates/introvox.pot (113 unique msgids, msgfmt -c passes).

Replaces my earlier (premature, now closed) PR #937. Thanks @rakekniven for the pointer to this template.

Originally requested by community in nextcloud/IntroVox#16.

[Rikdekker]

Hi @rakekniven — friendly ping on this. Is there anything I can do from my side to help move this forward? Happy to clarify the setup or fix anything in the IntroVox repo if needed.

Quick recap of what's ready:

• POT committed at translationfiles/templates/introvox.pot (113 unique msgids, msgfmt -c passes)
• .tx/config in PO format, l10n/.gitkeep and .l10nignore in place
• @nextcloud-bot already has admin on nextcloud/IntroVox (org-wide)
• 5 existing language translations (NL/DE/FR/DA/SV) ready to be pushed as starting translations

Originally requested by community in nextcloud/IntroVox#16.

[rakekniven]

Hello @Rikdekker ,

we have holiday season in Germany and next week is release of next Nextcloud version.

So nothing to do from your side.

Have some more patience.

Cheers

[nickvergessen]

I'll take care this week

[rakekniven]

@Rikdekker Is POT file at https://github.com/nextcloud/IntroVox/blob/main/translationfiles/templates/introvox.pot still up to date?

If so I can start checking your strings against our guidelines (https://docs.nextcloud.com/server/latest/developer_manual/basics/translations.html#guidelines) and provide feedback.

[rakekniven]

Related issue nextcloud/IntroVox#17 .

This needs to be clarified.

[rakekniven]

See nextcloud/IntroVox#18 as well.
This needs to be revised before the sync.

[nickvergessen]

Feel free to let me know when we can continue

[Rikdekker]

Thanks @nickvergessen! Status from my side:

• Android N changes #18 — string adaptations: done. All five strings rakekniven flagged are fixed at the source, POT regenerated, existing NL/DE/FR/DA/SV translations migrated to the new keys.
• update gradle deps #17 — six-language UI design: implementation in progress, landing in 1.7.0 before the sync. Model is being inverted: every Transifex-translated language becomes automatically available to end users via $l->t() defaults, and the admin UI shifts from "enable languages" to "manage overrides". No more wall of language tiles regardless of how many languages Transifex ships.

I'll ping here when 1.7.0 is tagged with both issues closed. Should be a matter of days.

[Rikdekker]

Both #17 and #18 are closed and shipped in IntroVox v1.7.0. Tarball uploaded to the App Store. POT is current on main at translationfiles/templates/introvox.pot. Ready for the first manual sync whenever you have a moment, @nickvergessen.

[nickvergessen]

Sysadmin part is done.

Not sure what you did with the POT file, but the sync only has 110 strings while your POT file had ~200.
Existing translations are wiped, that's kind of expected behaviour as we can not automatically upload content from the repo. But translators could copy the strings from the "before" directory:
https://github.com/nextcloud/IntroVox/tree/2e79d9e9b208fd35847e6fba63ba281a59deda71/l10n