Request translation sync for FormVox

Prologue

The Nextcloud community on Transifex produces the translations of your app. To this end, the app author undertakes to comply with the following requirements:

• The app must be available in the Nextcloud App Store. Should the app be removed from the store, the translation work on Transifex will be paused or the resource removed.
• The app author must create an account on Transifex and join the Nextcloud project. This makes it easier to respond to queries regarding the app’s strings.

👤 App repository

To be done by you

• Link to your repository: https://github.com/nextcloud/formvox

• If the app is not in the Nextcloud organisation — not applicable, FormVox is 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 app id (formvox) substituted 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:formvox]
  file_filter = translationfiles/<lang>/formvox.po
  source_file = translationfiles/templates/formvox.pot
  source_lang = en
  type        = PO
  

• ⚙️ Validate your repository and translation strings:

  bash translations/validateSyncSetup.sh nextcloud formvox
  

• Name of the Transifex user: rikdekker

  For details see https://nextcloud.com/translation/ .

App ID: formvox

Source template is translationfiles/templates/formvox.pot — 824 strings, extracted from both the Vue frontend and the PHP backend, validated with msgfmt --check.

Before opening this I ran the English source strings past the guidelines and fixed what they tripped: 29 Title Case strings rewritten to sentence case, 28 ... runs replaced with U+00A0 + U+2026, and one raw URL taken out of t(). Product names (Microsoft Forms, Export Excel) keep their capitals.

translationfiles/{nl,de,fr,ca,uk}/formvox.po are seeded with the app's existing hand-made translations, so those five languages don't start from zero:

All five validate with msgfmt --check. Happy to drop them if you would rather the resource started clean.

I am aware from #977 that new resources are on hold because translators cannot cope with the influx of strings. No rush on this one — I am filing it so it is ready whenever you get to it.

🏗️ 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
  

Start with translations/validateSyncSetup.sh and review the repository setup in .tx/config, l10n/, and .l10nignore. Run the validation command for nextcloud formvox, then follow the checklist for access and the first sync on transifex-sync.nextcloud.com. Done means validation passes and the initial translation sync is completed.