Admin am 22. Januar 2026 um 16:59 Uhr

2026-01-22T16:59:06Z

← Nächstältere Version		Version vom 22. Januar 2026, 16:59 Uhr
Zeile 125:		Zeile 125:
	=== Test page ===		=== Test page ===
	Please see [[Vorlage:FN/Test]].		Please see [[Vorlage:FN/Test]].

	~~== Änderungswünsche ==~~
	~~Bitte auf [[../../MediaWiki/Änderungen\|MediaWiki/Änderungen]] vorschlagen.~~

	[[Kategorie:Helmstedt-Wiki:Technik/Skin/Gadgets\|{{SUBPAGENAME}}]]		[[Kategorie:Helmstedt-Wiki:Technik/Skin/Gadgets\|{{SUBPAGENAME}}]]

Admin: AZ: Die Seite wurde neu angelegt: {{../../../!header |Text={{SUBPAGENAME}} |Shortcut=HW:HW/{{SUBPAGENAME}}}} Das ''Gadget'' '''{{SUBPAGENAME}}''' unterstützt paarweise innere Verlinkungen. Insbesondere die gegenseitige Verlinkung von Vorlage:FN und zugehörigem Vorlage:FNZ wird hergestellt. {{../!Aktivierung |hidden=1}} == Profil == {{MediaWikiGadgetDefinition |ID={{SUBPAGENAME}} |ResourceLoader=1 |default=1 |hidden=1…

2025-01-28T06:51:54Z

AZ: Die Seite wurde neu angelegt: {{../../../!header |Text={{SUBPAGENAME}} |Shortcut=HW:HW/{{SUBPAGENAME}}}} Das ''Gadget'' '''{{SUBPAGENAME}}''' unterstützt paarweise innere Verlinkungen. Insbesondere die gegenseitige Verlinkung von Vorlage:FN und zugehörigem Vorlage:FNZ wird hergestellt. {{../!Aktivierung |hidden=1}} == Profil == {{MediaWikiGadgetDefinition |ID={{SUBPAGENAME}} |ResourceLoader=1 |default=1 |hidden=1…

Neue Seite

{{../../../!header
|Text={{SUBPAGENAME}}
|Shortcut=HW:HW/{{SUBPAGENAME}}}}
Das ''Gadget'' '''{{SUBPAGENAME}}''' unterstützt paarweise innere Verlinkungen.

Insbesondere die gegenseitige Verlinkung von [[Vorlage:FN]] und zugehörigem [[Vorlage:FNZ]] wird hergestellt.
{{../!Aktivierung |hidden=1}}

== Profil ==
{{MediaWikiGadgetDefinition
|ID={{SUBPAGENAME}}
|ResourceLoader=1
|default=1
|hidden=1
|actions=view edit
|categories=MediaWiki:Gadget/{{SUBPAGENAME}}
|scripts={{SUBPAGENAME}}.js
}}

== Functionality ==
The purpose is to connect within a wiki page multiple groups of things that need an annotation with a corresponding remark.
* Only valid pairs shall be equipped, and the same marker may be used within different groups.
* It shall be possible to jump back from explanation to the annotation mark.
* Valid HTML is produced.
* As long the gadget was not executed there are no links nor <code>id=</code> attributes, and HTML is valid.
* Duplicated <code>id=</code> is invalid HTML and LINT error since fall 2024.

=== Example ===
There might be two tables in a page:
{| class="wikitable"
|+ French
|-
| un[[#ann-1-1|1)]]
|-
| une[[#ann-1-1|1)]]
|-
| deux[[#ann-1-2|2)]]
|-
| trois3)
|}
[[#back-1-1|1)]] French word for number <code>1</code>. 
[[#back-1-2|2)]] French word for number <code>2</code>.

{| class="wikitable"
|+ German
|-
| Eins[[#ann-2-1|1)]]
|-
| Zwei[[#ann-2-2|1)]]
|-
| Zwo[[#ann-2-2|2)]]
|}
[[#back-2-1|1)]] German word for number <code>1</code>. 
[[#back-2-2|2)]] German word for number <code>2</code>. 
3) German word for number <code>3</code>.

''Please note:''
* The same markers <code>1)</code> and <code>2)</code> are used for both tables.
* French ''trois'' marker is not linked since there is no explanation available.
* German <code>3</code> has no backlink since no item requires an explanation.

=== Syntax ===
The things to be explained need to be equipped with a ''M''arker:
<pre>
<WRAP class="reference">
<TAG data-annotationpair-m="ID">TEXT</TAG>
</WRAP>
</pre>
The ''A''nnotation or explanation is introduced by the following element:
<pre>
<WRAP class="references">
<TAG data-annotationpair-a="ID">TEXT</TAG>
<EXPLAIN class="reference-text">...</EXPLAIN>
</WRAP>
</pre>
With placeholders in capital letters:
<div style="margin-left:2em">
; ID
: The identifier, connecting one or many <code>-m</code> items with one <code>-a</code> item.
: Any URL encoded non-reserved characters may be used.
; TAG
: Any HTML element permitted in Wikitext.
: Usually <code></code> will be used, but any other may be used as well.
: A different TAG may be used for any <code>-m</code> item and the corresponding <code>-a</code> element.
; TEXT
: Any text which may be used as link text.
: This is every text without links and image transclusion, nor breaks.
: Inline markup is possible.
: To avoid confusion, the TEXT of <code>-m</code> items and the matching <code>-a</code> item will be more or less the same. However, this is no software requirement.
: Probably TEXT and ID have the same content.
; WRAP
: Arbitrary element for hosting <code>class="reference"</code> and <code>class="references"</code> simulation of ''cite'' to support preview popups.
; EXPLAIN
: Arbitrary element for hosting <code style="white-space:nowrap">class="reference-text"</code> or <code style="white-space:nowrap">class="mw-reference-text"</code> to support preview popups.
</div>
Within one group the <code>-m</code> items may occur one or many times.
* If an <code>-a</code> element is repeated within the same group, only the first one is considered.

=== Grouping ===
Within a page, many groups of <code>-m</code> and <code>-a</code> elements may occur, which do not interfere.
* They might begin with
** either the <code>-m</code> annotated things, followed by corresponding <code>-a</code> explanations (“legend” mode, below), or
** the <code>-a</code> annotation may precede the <code>-m</code> items (“caption” mode, on top).
Every second switch between <code>-m</code> and <code>-a</code> or <code>-a</code> and <code>-m</code> repectively will create a limitation.
* The first detected element decides upon the rhythm.
* A single (unpaired) block remaining will be ignored.
Grouping is administrated by the gadget.

=== Effect ===
Each pair of corresponding items will be linked with
<pre>
<a href="#annotationpair-1-ID-0" id="annotationpair-1-ID-1"><TAG>TEXT</TAG></a>
</pre>
and
<pre>
<a href="#" id="annotationpair-1-ID-0"><TAG>TEXT</TAG></a>
</pre>
* The first <code>-1-</code> indicates the group number.
* A terminating <code>-1</code> identifies multiple markers of same ID, and <code>-0</code> is the annotation.
* Further attributes within <code><TAG></code> will remain, but <code style="white-space:nowrap">data-annotationpair-*="ID"</code> are removed.
* The backlink <code>href="#"</code> goes nowhere, but is superposed by event listener returning to individual marker.
* The marker <code>href="#annotationpair-1-ID-0"</code> is equipped with an event listener memorizing the most recent click.
* If backlink <code>href="#"</code> properties are matching the most recent click, the individual item will be the target, otherwise the <code>-1</code> marker of first mentioned item.

=== Test page ===
Please see [[Vorlage:FN/Test]].

== Änderungswünsche ==
Bitte auf [[../../MediaWiki/Änderungen|MediaWiki/Änderungen]] vorschlagen.

[[Kategorie:Helmstedt-Wiki:Technik/Skin/Gadgets|{{SUBPAGENAME}}]]

Helmstedt-Wiki:Technik/Skin/Gadgets/annotationPair - Versionsgeschichte

Admin am 22. Januar 2026 um 16:59 Uhr