User:Mathglot/sandbox/Templates/Template:Translate clarify span/doc

{{Documentation subpage}}

Usage

The {{translate clarify span}} template may be used when there is translated text that needs improvement or clarification. Unlike the template {{clarify}}, this template attaches explicitly to a portion of text, for example one or more specific sentences, by surrounding the text with the template. This is especially useful for flagging multiple facts or multiple sentences as needing improved translation, and for singling out a specific unclear passage among many.

Once the translated passage is clarified, please remove this template from the surrounded text.

{{clarify span|text=Translated passage(s) needing clarification|explain=Reason for the needed clarification|orig=Passage in the original language|date=June 2024}}

The date, explain, and orig parameters are optional. The parameter names for |text=, |explain=, and |orig= can be omitted, as long as the text is in the first position, the explanation is in 2nd, and the original passage is in 3rd place. The minimal syntax is:

{{clarify span|English passage needing clarification}}

Example of usage:

... the treaty. {{translate clarify span|One of the terms|reason=terms are conditions? or intervals?}} of the treaty of Versailles led to ...

produces:

... the treaty. User:Mathglot/sandbox/Templates/Template:Translate clarify span of the treaty of Versailles led to ...

Parameters

There are four parameters to the template:

|text=

The text needing clarification. This parameter is mandatory.

|explain=

Specifics explaining the clarification that is needed. If omitted, "This passage needs to be better explained" will be used. This text is shown as a tooltip.

|orig=

Excerpt of text in the source language whose translation is unclear. Shown in the tooltip.

|date=June 2024

Adds month & year to the category, as well as helping identify how long ago the template was added. If omitted, a bot will eventually add it for you.

Categorization of articles

Adding this template to an article places the article into the hidden categories Category:All Wikipedia articles needing clarification and Category:Wikipedia articles needing clarification from June 2024.

See also

• {{Clarify span}} — detailed information on the usage of this and similar templates