Translating add-ons - Revision history

Karellen: Updated for v20

2023-02-08T18:59:49Z

Updated for v20

← Older revision		Revision as of 18:59, 8 February 2023
Line 1:		Line 1:
	{{mininav\|Language portal}}		{{mininav\|[[Language portal]]}}

	= Submit your add-on or skin for translation =		= Submit your add-on or skin for translation =
Line 97:		Line 97:


			{{top}}
			{{updated\|20}}

	~~{{updated\|19}}~~
	[[Category:Development]]		[[Category:Development]]
	[[Category:Languages]]		[[Category:Languages]]

Gade: /* Submit your add-on or skin for translation */

2022-04-13T14:21:13Z

Submit your add-on or skin for translation

← Older revision		Revision as of 14:21, 13 April 2022
Line 27:		Line 27:
	This user will automatically accept any collaboration within 5 minutes.<br/>		This user will automatically accept any collaboration within 5 minutes.<br/>
	If pull requests are the preferred method, Weblate will push to the same pull request until merged or closed.		If pull requests are the preferred method, Weblate will push to the same pull request until merged or closed.
	~~<br/><br/>~~
	~~[https://forum.kodi.tv/showthread.php?tid=359836 Please visit this forum post for more information.]~~

	= Sync time schedule =		= Sync time schedule =

Gade: /* Submit your add-on or skin for translation */

2022-04-13T14:20:08Z

Submit your add-on or skin for translation

← Older revision		Revision as of 14:20, 13 April 2022
Line 10:		Line 10:
	<br/>		<br/>
	Summary, description and disclaimer in addon.xml can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>		Summary, description and disclaimer in addon.xml can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>
	[[Translating_add-ons#Workflows_and_scripts\|\|See below for more information]]		[[Translating_add-ons#Workflows_and_scripts\|See below for more information]]
	<br/>		<br/>
	<br/>		<br/>

Gade: /* Submit your add-on or skin for translation */

2022-04-13T14:19:44Z

Submit your add-on or skin for translation

← Older revision		Revision as of 14:19, 13 April 2022
Line 10:		Line 10:
	<br/>		<br/>
	Summary, description and disclaimer in addon.xml can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>		Summary, description and disclaimer in addon.xml can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>
			[[Translating_add-ons#Workflows_and_scripts\|\|See below for more information]]
			<br/>
	<br/>		<br/>
	We require the following info:		We require the following info:

Gade: /* Submit your add-on or skin for translation */

2022-04-13T14:18:50Z

Submit your add-on or skin for translation

← Older revision		Revision as of 14:18, 13 April 2022
Line 9:		Line 9:
	All languages at Weblate will be kept in sync with the en_gb source file.<br/>		All languages at Weblate will be kept in sync with the en_gb source file.<br/>
	<br/>		<br/>
	Summary, description and disclaimer can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>		Summary, description and disclaimer in addon.xml can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>
	<br/>		<br/>
	We require the following info:		We require the following info:

Gade at 13:54, 13 April 2022

2022-04-13T13:54:49Z

← Older revision		Revision as of 13:54, 13 April 2022
Line 27:		Line 27:
	<br/><br/>		<br/><br/>
	[https://forum.kodi.tv/showthread.php?tid=359836 Please visit this forum post for more information.]		[https://forum.kodi.tv/showthread.php?tid=359836 Please visit this forum post for more information.]

			= Sync time schedule =
			Changes to the main source en_gb file are synced instantly from Github to Weblate.<br/>
			Translations are pushed from Weblate to Github every 5 days (default, but can be configured) if any translations are made.

			= Syntax verification =
			For keeping the strings correctly formatted, we do a constant syntax verification at all times.<br/>
			Changes are either done at Weblate or by pull request to the upstream repository.

	= Best practices =		= Best practices =

Gade: /* Workflows and scripts */

2022-04-13T13:47:53Z

Workflows and scripts

← Older revision		Revision as of 13:47, 13 April 2022
Line 46:		Line 46:
	= Workflows and scripts =		= Workflows and scripts =
	We offer several workflows to help integrate Weblate translations into your add-ons.<br/>		We offer several workflows to help integrate Weblate translations into your add-ons.<br/>
	Required workflows are automatically offered to your add'on repository by pull request.		Required workflows are automatically offered to your add-on repository by pull request.

Gade: /* Workflows and scripts */

2022-04-13T13:47:37Z

Workflows and scripts

← Older revision		Revision as of 13:47, 13 April 2022
Line 45:		Line 45:

	= Workflows and scripts =		= Workflows and scripts =
	We offer several workflows to help integrate Weblate translations into your add-ons.		We offer several workflows to help integrate Weblate translations into your add-ons.<br/>
			Required workflows are automatically offered to your add'on repository by pull request.


Line 69:		Line 70:
	Once the pull request is merged the branch can be safely deleted.<br/>		Once the pull request is merged the branch can be safely deleted.<br/>
	Make sure branch protection is disabled for ''inc-ver'' branch and that force pushing is allowed.		Make sure branch protection is disabled for ''inc-ver'' branch and that force pushing is allowed.



	= Weblate configuration and add-ons =		= Weblate configuration and add-ons =

Gade: /* Best practices */

2022-04-13T13:42:11Z

Best practices

← Older revision		Revision as of 13:42, 13 April 2022
Line 29:		Line 29:

	= Best practices =		= Best practices =
	~~[[Translations#Submit_your_add-on_or_skin_for_translation\|Submit your add-on or skin for translation]]~~
	~~<br/><br/>~~
	* Only change the content of en_gb source language file.		* Only change the content of en_gb source language file.
	:Never change anything in other language files, as Weblate will handle syncing and maintaining of all strings for all languages.		:Never change anything in other language files, as Weblate will handle syncing and maintaining of all strings for all languages.
Line 45:		Line 43:
	:These '''should not''' be removed and are harmless.<br/>		:These '''should not''' be removed and are harmless.<br/>
	:They are kept as part of translation memory and will benefit translators in a number of ways.		:They are kept as part of translation memory and will benefit translators in a number of ways.



	= Workflows and scripts =		= Workflows and scripts =

Gade at 13:41, 13 April 2022

2022-04-13T13:41:34Z

← Older revision		Revision as of 13:41, 13 April 2022
Line 1:		Line 1:
	{{mininav\|Language portal}}		{{mininav\|Language portal}}

			= Submit your add-on or skin for translation =
			We encourage all developers with addons in the official Kodi add-on repo to submit their addon for translation at Weblate.<br/>
			<br/>
			Handling of translations for your add-on will become much more simple, as most things are automated.<br/>
			Weblate will get updated instantly whenever you add or remove a translation from your source en_gb file.<br/>
			Translations can be synced to your upstream repository whenever you wish (default is 5 days) either by pull request or direct push.<br/>
			All languages at Weblate will be kept in sync with the en_gb source file.<br/>
			<br/>
			Summary, description and disclaimer can be automatically synced between addon.xml and language files either by pull request or direct push whenever changes are made.<br/>
			<br/>
			We require the following info:
			* URL to your repo at Github/Gitlab
			* Branch
			* Would you like pull requests or direct pushes from Weblate? (Pull requests are safest, direct pushes are easiest.)
			* How often would you like pull requests/direct pushes? Default is 5 days, but it's totally up to you.
			* Do you want a version bump in addon.xml?
			<br/>
			For your main source en_gb file to get synced with Weblate, you must add this webhook to your repository for the push event:
			<syntaxhighlight lang="xml">https://kodi.weblate.cloud/hooks/github</syntaxhighlight>
			[[File:Webhook.png\|600px\|webhook for Weblate]]

			If direct pushes are wanted, you need to add Github user [https://github.com/weblate "weblate"] as collaborator.<br/>
			This user will automatically accept any collaboration within 5 minutes.<br/>
			If pull requests are the preferred method, Weblate will push to the same pull request until merged or closed.
			<br/><br/>
			[https://forum.kodi.tv/showthread.php?tid=359836 Please visit this forum post for more information.]

	= Best practices =		= Best practices =