Integrate TranslateTagger functions/workflow into Special:PagePreparation of Translate Extension
Closed, ResolvedPublic2 Estimated Story Points
Actions

Assigned To

Authored By

	Aafi
	Jun 26 2026, 6:35 AM

Project Tags

Referenced Files

	F96520471: image.png
	Thu, Jul 30, 12:52 PM

	F96520433: image.png
	Thu, Jul 30, 12:52 PM

	F96520266: image.png
	Thu, Jul 30, 12:52 PM

	F90867418: Screencast+from+2026-06-28+12-22-20.webm
	Jun 28 2026, 6:56 AM

	F90553252: image.png
	Jun 26 2026, 9:51 AM

Subscribers

Description

Special:PagePreparation, findable across multilingual wikis where Translate extension is installed, has been outdated since a long. TranslateTagger tries to resolve these problems, and it would be more convenient to have the work incorporated into the MediaWiki extension itself.

Translate Extension repo: https://gerrit.wikimedia.org/g/mediawiki/extensions/Translate
Translate tagger repo: https://github.com/indictechcom/TranslateTagger

Scope

Actually enabling this on production wiki's will be reviewed/done in a separate ticket

QA Plan

This will have to be tested locally since there are further considerations before we can enable it on production
Set the configuration variable:

$wgTranslateEnableTranslateTaggerAPIIntegration = 'https://translatetagger.toolforge.org/api/convert';

Verify that markup structure matches what's displayed on https://translatetagger.toolforge.org/
Create a wiki page with various wikitext markup such as headings, links etc.
Try to mark it up via Special:PagePreparation
Compare the markup with the markup generated on https://translatetagger.toolforge.org/

Handles API failures properly
Put the incorrect URL for the translate tagger API
Make the API call
Ensure that a proper error message is displayed to the user.

Ensure that the translate tagger button is not displayed if configuration is not set
Remove the $wgTranslateEnableTranslateTaggerAPIIntegration configuration
On Special:PagePreparation ensure that the button to mark up with translate tagger is hidden.

Details

Related Changes in Gerrit:

	Subject	Author	Repo	Branch	Lines +/-
	Special:PagePreparation: Integrate Translate Tagger API	Nishthajain7	mediawiki/extensions/Translate	master	+138 -12

Customize query in gerrit

Related Objects

Mentioned In: T393170: Create Gadget to Simplify Workflow for Adding Translation Tag

Event Timeline

Aafi created this task.Jun 26 2026, 6:35 AM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJun 26 2026, 6:35 AM

Aafi added a subscriber: Gopavasanth.Jun 26 2026, 6:38 AM

The front end code for Special:PagePreparation is present in resources/js/ext.translate.special.pagepreparation.js.

Lets add a separate button to enable page preparation using translate tagger API.

Handle errors from the translate tagger API and inform users of errors, so that they can revert back to using the old page preparation logic.

Translate tagger API: https://translatetagger.toolforge.org/docs#ref-features

Aafi mentioned this in T393170: Create Gadget to Simplify Workflow for Adding Translation Tag.Jun 27 2026, 5:43 AM

NishthaJain7 claimed this task.Jun 27 2026, 9:46 AM

I have fixed this issue on https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Translate/+/1306089

Aafi added subscribers: Ameisenigel, Pols12.Jun 28 2026, 5:23 AM

abi_ moved this task from Backlog to page translation on the MediaWiki-extensions-Translate board.Jun 28 2026, 6:27 AM

Tacsipacsi subscribed.Jun 28 2026, 7:02 AM

abi_ triaged this task as Medium priority.Jul 1 2026, 1:10 PM

abi_ added a project: LPL sprints.

abi_ moved this task from Backlog to Maintenance initiatives on the LPL sprints board.

abi_ set the point value for this task to 2.

• Nikerabbit moved this task from Maintenance initiatives to Ongoing maintenance on the LPL sprints board.Jul 2 2026, 10:33 AM

• Nikerabbit added a project: Community-collaboration.Jul 8 2026, 11:43 AM

GGalofre-WMF moved this task from Ongoing maintenance to Needs refinement on the LPL sprints board.Jul 8 2026, 1:55 PM

• Nikerabbit added projects: Essential-Work, LPL Projects (Ongoing maintenance).Jul 9 2026, 9:08 AM

abi_ updated the task description. (Show Details)Jul 9 2026, 1:20 PM

abi_ updated the task description. (Show Details)Jul 9 2026, 1:23 PM

• Nikerabbit edited projects, added: LPL sprints (S1 2026 July); removed: LPL sprints.Jul 9 2026, 1:24 PM

abi_ moved this task from Ready for dev to In progress on the LPL sprints (S1 2026 July) board.Thu, Jul 16, 8:43 AM

abi_ moved this task from In progress to Pending deployment on the LPL sprints (S1 2026 July) board.Thu, Jul 16, 2:48 PM

Change #1306089 merged by jenkins-bot:

[mediawiki/extensions/Translate@master] Special:PagePreparation: Integrate Translate Tagger API

https://gerrit.wikimedia.org/r/1306089

ReleaseTaggerBot added a project: MW-1.47-notes (1.47.0-wmf.12; 2026-07-21).Thu, Jul 16, 8:00 PM

We can't test this on production wikis but I can test this on our test servers.

I pulled in the main branch, set the local configuration and tested the functionality:

$wgTranslateEnableTranslateTaggerAPIIntegration = 'https://translatetagger.toolforge.org/api/convert';

Verify that markup structure matches what's displayed on https://translatetagger.toolforge.org/

Handles API failures properly

Testing with incorrect URL:

Ensure that the translate tagger button is not displayed if configuration is not set

Removed the configuration.

abi_ updated the task description. (Show Details)Thu, Jul 30, 12:53 PM

In T430257#12171200, @abi_ wrote:

Verify that markup structure matches what's displayed on https://translatetagger.toolforge.org/

This is unrelated to the present task (it’s a bug in TranslateTagger), but I noticed it now: that load of <translate> tags shouldn’t be there; regular paragraphs can and should be included in larger <translate> blobs, and only syntax like lists needs to be wrapped one-by-one, e.g.

<translate>
'''Springfield''' is a city…

== History ==

Founded in 1885…

== Geography ==

According to the…

== Economy ==

Historically driven by…
</translate>
* <translate>McKenzie-River Regional Hospital</translate>
* <translate>Springfield School District</translate>

Handles API failures properly

Testing with incorrect URL:

This is related to the current task: shouldn’t the error box have an icon? Codex error boxes usually have icons.

Integrate TranslateTagger functions/workflow into Special:PagePreparation of Translate ExtensionClosed, ResolvedPublic2 Estimated Story PointsActions