Quelltext der Seite NVK und GOV Widget Muster von Christopher Ernestus

== Problembereich und Plattform ==
* [https://altes-koeln.de/index.php?title=%20Spezial%3ASuche&search=Benutzer%3AChristopher&fulltext=1 Altes Köln Wiki Benutzer:Christopher Namensraum als Entwicklungs- und Testumgebung] 
* Altes Köln Wiki ist nur Entwicklungsplattform - Beta Test nicht möglich weil dafür Familiennamen in ein Stadtwiki eingeführt würden ggf. von familien die es nicht gibt. man könnte kölner familien testen

== Usecase ==
Als Familienforscher möchte ich sehen, wo bestimmte Familiennamen verbreitet sind und historische Orte finden. Dazu soll das
System mir Namensverbreitungskarten so anzeigen, wie das zu meinen Vorgaben passt.

== Konkrete Szenarien ==
'''Als Familienforscher möchte ich''' Verbreitungskarten für Familiennamen sehen, '''sodass''' ich erkennen kann, wo dieser Name vorkommt.

=== Szenario 1: Namensverbreitungskarten ===

'''Situation:'''
* Benutzer betrachtet Seite zu Familiennamen (z.B. Ernestus)
* Beispiel: https://wiki.genealogy.net/Ernestus_(Familienname)

'''Aktion:'''
* Aufruf über Tag: <code><lastname-map size="200">Ernestus</lastname-map></code> (relativ) oder
* <code><lastname-map mode="abs" size="200">Ernestus</lastname-map></code> (absolut) oder
* <code>{{#widget:NVK-Test|Name=Schmitz}}</code>
* Service dahinter: https://nvk.genealogy.net/map
* Python-Programm erzeugt PNG: https://nvk.genealogy.net/karte/Ernestus

'''Erwartetes Ergebnis:'''
* Karte zeigt Verbreitung des Namens
====  2025-02-17 Defekt ====
https://wiki.genealogy.net/Ernestus_(Familienname)
<html>
<table>
<tr>
<th>Relativ
</th>
<th>Absolut
</th></tr>
<tr>
<td>&lt;lastname-map size="200"&gt;Ernestus&lt;/lastname-map&gt;
</td>
<td>&lt;lastname-map mode="abs" size="200"&gt;Ernestus&lt;/lastname-map&gt;
</td>
</tr>
</table>
</html>

=== Szenario 2: GOV-Integration ===

'''Situation:'''
* Benutzer sucht Informationen zu historischem Ort
* Beispiel: https://altes-koeln.de/wiki/Benutzer:Christopher/GOV-Test

'''Aktion:'''
* Aufruf über: <code>{{#widget:GOV-Test|GOVID=SCHERGJO54EJ}}</code>
* Service dahinter: https://gov.genealogy.net/item/wikihtml/SCHERGJO54EJ

'''Erwartetes Ergebnis:'''
* Anzeige der Ortsinformationen mit Karte

'''Als Familienforscher möchte ich''' historische Ortsinformationen mit Karte sehen, '''sodass''' ich den Ort im geografischen Kontext verstehe.

== Widgets ==
=== GOV ===
https://altes-koeln.de/wiki/Benutzer:Christopher/GOV-Test

<html>
<span class="mw-page-title-namespace">Benutzer</span><span class="mw-page-title-separator">:</span><span class="mw-page-title-main">Christopher/GOV-Test</span></h1>
						<!-- tagline; usually goes something like "From WikiName" primary purpose of this seems to be for printing to identify the source of the content -->
						<div id="siteSub" class="siteSub">Aus Altes Köln</div><div id="jump-to-nav" class="mw-jump jump-to-nav">Wechseln zu:<a href="#mw-navigation">Navigation</a>, <a href="#p-search">Suche</a></div>
					</div>
					<div id="bodyContent" class="bodyContent">
						<!-- body text -->

						<div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="de" dir="ltr"><div class="mw-parser-output"><h2><span id="Test:_Irgendeine_Wiki-.C3.9Cberschrift"></span><span class="mw-headline" id="Test:_Irgendeine_Wiki-Überschrift">Test: Irgendeine Wiki-Überschrift</span></h2>
<p>Hier etwas Wiki-Text vor dem eingefügten Widget.
</p>
<h2><span class="mw-headline" id="Hier_der_eigentliche_Widget-Aufruf">Hier der eigentliche Widget-Aufruf</span></h2>
<p><!--Test-Widget von Christopher zum Austesten des GOV-Aufrufes (eigentlich für das GenWiki)-->
</p><div id="widget-container"></div>

<script>
    (function () {
        const fetchURL = "https://gov.genealogy.net/item/wikihtml/SCHERGJO54EJ";
        const baseURL = "https://gov.genealogy.net";

        fetch(fetchURL)
            .then(response => {
                if (!response.ok) {
                    throw new Error(`HTTP-Fehler! Status: ${response.status}`);
                }
                return response.text();
            })
            .then(html => {
                const widgetContainer = document.getElementById('widget-container');

                // Shadow DOM erstellen
                const shadow = widgetContainer.attachShadow({ mode: 'open' });

                // Stile für das Widget im Shadow DOM hinzufügen
                const style = document.createElement('style');
                style.textContent = `
                    :host {
                        all: initial;
                        display: block;
                        max-width: 1200px;
                        margin: 20px auto;
                        padding: 0;
                        border: none;
                        background-color: #fff;
                        overflow: auto;
                        font-family: Arial, sans-serif;
                        font-size: 16px;
                    }
                    table {
                        width: 100%;
                        table-layout: auto;
                        border-collapse: collapse;
                        margin: 10px 0;
                        border: 1px solid #ccc;
                    }
                    th, td {
                        border: 1px solid #ddd;
                        padding: 10px;
                        text-align: left;
                        word-wrap: break-word;
                    }
                    th {
                        background-color: #f2f2f2;
                    }
                    td:first-child {
                        width: 1%;
                        white-space: nowrap;
                    }
                    ul {
                        padding-left: 20px;
                        margin: 10px 0;
                    }
                    object {
                        max-width: 100%;
                        height: 400px; /* Feste Höhe */
                        display: block;
                        margin: 0;
                    }
                    .map-container {
                        text-align: left;
                    }
                    a {
                        color: #007BFF;
                        text-decoration: none;
                    }
                    a:hover {
                        text-decoration: underline;
                    }
                `;

                // Geladenen HTML-Inhalt einfügen
                const content = document.createElement('div');
                content.innerHTML = html;

                // 1) Passe width und height in <object> an
                const objects = content.querySelectorAll('object[data^="https://www.genealogy.net/viewer-js/"]');
                objects.forEach(obj => {
                    obj.setAttribute('width', '400'); // Setze Breite auf 400
                    obj.setAttribute('height', '400'); // Setze Höhe auf 400
                });

                // 2) Passe <a> und <img> für den relationshipGraph an
                const imageLinks = content.querySelectorAll('a[href*="relationshipGraph"]');
                imageLinks.forEach(link => {
                    // Passe das <a>-Tag an die Base-URL an
                    const originalHref = link.getAttribute('href');
                    link.setAttribute('href', baseURL + originalHref);

                    // Passe das <img>-Tag im <a>-Tag an
                    const img = link.querySelector('img');
                    if (img) {
                        const originalSrc = img.getAttribute('src');
                        img.setAttribute('src', baseURL + originalSrc + "?full-size=1"); // Absoluten Pfad setzen
                        img.setAttribute('width', '80%'); // Breite auf 80% setzen
                    }
                });

                // 3) Füge Base-URL zu allen relativen <a> hinzu
                const allLinks = content.querySelectorAll('a[href^="/"]');
                allLinks.forEach(link => {
                    const originalHref = link.getAttribute('href');
                    link.setAttribute('href', baseURL + originalHref);
                });

                // 4) Füge Base-URL zu allen relativen <img> hinzu
                const allImages = content.querySelectorAll('img[src^="/"]');
                allImages.forEach(img => {
                    const originalSrc = img.getAttribute('src');
                    img.setAttribute('src', baseURL + originalSrc);
                });

                // Stile und Inhalte in das Shadow DOM einfügen
                shadow.appendChild(style);
                shadow.appendChild(content);
            })
            .catch(error => {
                console.error('Fehler beim Laden:', error);
                const widgetContainer = document.getElementById('widget-container');
                widgetContainer.textContent = "Fehler: Inhalte konnten nicht geladen werden.";
            });
    })();
</script>
<p></p>
<h2><span id="Test:_Eine_Wiki-.C3.9Cberschrift_nach_dem_Widget"></span><span class="mw-headline" id="Test:_Eine_Wiki-Überschrift_nach_dem_Widget">Test: Eine Wiki-Überschrift nach dem Widget</span></h2>
<p>Hier och etwas Wiki-Text nach dem eingefügten Widget.
</p>
</html>

== Testumfang ==
* Wieviele Seiten sollen getestet werden - Stichproben - 100.000? 10-20 Stück
* Testumfang 10/100/1000/1000 - > 10-20 dh. die 10-100 Kategorie
* Alle Seiten mit GOV - und Familennamenseiten mit Familiengrafen
* Familiengraf bezieht sich auf die Möglichkeit ausgehend von einem Familiennamen den Knowledge Graph aufzuspannen und entsprechende Systeme zu befragen. In Wikidata z.B. findet man "ähnliche Namen" in den CompGen e.V. Systemen findet man jedoch sehr viel detailliertere und umfangreichere Informationen mit den historischen und ortsdimensionen

== Infrastruktur ==
=== Altes Köln Wiki ===
==== Widget Extension ====
<html>
<a class="external mw-version-ext-name" href="https://www.mediawiki.org/wiki/Extension:Widgets">Widgets</a></td><td><span class="mw-version-ext-version">1.6.0</span></td><td><a href="/wiki/Spezial:Version/License/Widgets" class="mw-version-ext-license" title="Spezial:Version/License/Widgets" dir="auto">GPL-2.0-or-later</a></td><td class="mw-version-ext-description">Ermöglicht das Hinzufügen von Widgets, wobei vorhandene Widgets auf der Website <a target="_blank" rel="nofollow noreferrer noopener" class="external text" href="https://www.mediawikiwidgets.org/Main_Page">MediaWikiWidgets.org</a> veröffentlicht werden</td><td class="mw-version-ext-authors"><a target="_blank" rel="nofollow noreferrer noopener" class="external text" href="https://www.sergeychernyshev.com">Sergey Chernyshev</a>, Yaron Koren und andere</td>
</html>
=== NVK ===
https://nvk.genealogy.net/map/1890:Ernestus

[[File:NVKErnestus1870.jpg|400px]]

=== GOV ===
https://gov.genealogy.net/item/wikihtml/SCHERGJO54EJ
<html>
<table border="1" style="border:thin solid gray; border-collapse:collapse;">
  <tr>
    <td>GOV-Kennung</td>
<td><a href="/item/show/SCHERGJO54EJ">SCHERGJO54EJ</a></td>
</tr>
  <tr>
    <td>Name</td>
  <td>
    <ul>
        <li>
          
          
          
          <span>Schönberg</span>

        <span style="color:gray"></span>
          </li>
    </ul>
  </td>
  </tr>
  <tr>
    <td>Typ</td>
  <td>
    <ul>
        <li>
          <span >Hauptort</span>
          
          
          

        <span style="color:gray"></span>
          <span class="source">
            <a href="/item/show/source_1081178" title="Wohnplatzverzeichnis Schleswig-Holstein 1964">Quelle</a>
            <span><span>Seite</span> <span>110</span> <span></span></span>
            </span><span class="source">
            <a href="/item/show/source_1082104" title="Wohnplatzverzeichnis Schleswig-Holstein 1970">Quelle</a>
            <span><span>Seite</span> <span>92</span> <span></span></span>
            </span></li>
    </ul>
  </td>
  </tr>
  <tr>
    <td>Einwohner</td>
  <td>
    <ul>
        <li>
          
          
          
          <span>3483</span>

        <span style="color:gray"> (1961-06-06) </span>
          <span class="source">
            <a href="/item/show/source_1081178" title="Wohnplatzverzeichnis Schleswig-Holstein 1964">Quelle</a>
            <span><span>Seite</span> <span>110</span> <span></span></span>
            </span></li>
        <li>
          
          
          
          <span>3574</span>

        <span style="color:gray"> (1970-05-27) </span>
          <span class="source">
            <a href="/item/show/source_1082104" title="Wohnplatzverzeichnis Schleswig-Holstein 1970">Quelle</a>
            <span><span>Seite</span> <span>92</span> <span></span></span>
            </span></li>
    </ul>
  </td>
  </tr>
  <tr>
    <td>Postleitzahl</td>
  <td>
    <ul>
        <li>
          
          
          
          <span>W2306</span>

        <span style="color:gray"> (- 1993-06-30) </span>
          </li>
        <li>
          
          
          
          <span>24217</span>

        <span style="color:gray"> (1993-07-01 -) </span>
          </li>
    </ul>
  </td>
  </tr>
  <tr>
    <td>externe Kennung</td>
  <td>
    <ul>
        <li>
          
          
          
          <span>geonames:2836925</span>

        <span style="color:gray"></span>
          </li>
    </ul>
  </td>
  </tr>
<tr>
<td>Karte</td>
<td>
    <object data="https://www.genealogy.net/viewer-js/?mlat=54.3936&amp;mlon=10.3707&amp;zoom=12" width="256" height="256"></object>
  <p>TK25: <span>1628</span></p>

    <ul style="font-size:small;">
            <li><a class="external" href="https://de.bing.com/maps/?v=2&amp;q=54.3936+10.3707&amp;cp=54.3936~10.3707&amp;lvl=14&amp;dir=0&amp;sty=o&amp;encType=1">Bing</a></li>
            <li><a class="external" href="/kml/item/SCHERGJO54EJ.kml">Google Earth (KML)</a></li>
            <li><a class="external" href="https://maps.google.de/?q=54.3936+10.3707">Google Maps</a></li>
            <li><a class="external" href="https://www.mapquest.com/maps/map.adp?zoom=11&amp;latlongtype=decimal&amp;latitude=54.3936&amp;longitude=10.3707">MapQuest</a></li>
            <li><a class="external" href="https://www.openstreetmap.org/#map=12/54.3936/10.3707">OpenStreetMap</a></li>
            <li><a class="external" href="https://openstreetmap.de/karte/?zoom=12&amp;lat=54.3936&amp;lon=10.3707">OpenStreetMap.de</a></li>
            <li><a class="external" href="https://kartenforum.slub-dresden.de/?b=slub-osm&amp;c=10.3707,54.3936&amp;z=11">Virtuelles Kartenforum</a></li>
            <li><a class="external" href="https://wikimapia.org/#lang=de&amp;lat=54.3936&amp;lon=10.3707&amp;z=12">wikimapia</a></li>
    </ul>
</td>
</tr>

<tr>
  <td>Zugehörigkeit</td>
  <td><a href="/item/relationshipGraph/SCHERGJO54EJ?full-size=1"><img src="/item/relationshipGraph/SCHERGJO54EJ" /></a></td>
</tr>

  <tr>
  <td>Übergeordnete Objekte</td>
<td>
  <p><a href="/item/show/object_149289"><span >Probstei</span></a>
  <span style="color:gray"></span>
    <small>( <span style="padding-right: 0.5em;">Landschaft</span>)</small>
    
  </p>
  <p><a href="/item/show/object_1187745"><span >Schönberg (St. Ansgar)</span></a>
  <span style="color:gray"></span>
    <small>( <span style="padding-right: 0.5em;">Expositur</span><span style="padding-right: 0.5em;">Pfarrkuratie</span><span style="padding-right: 0.5em;">Pfarrei</span>)</small>
    
  </p>
  <p><a href="/item/show/object_185251"><span >Schönberg</span></a>
  <span style="color:gray"></span>
    <small>( <span style="padding-right: 0.5em;">Kirchspiel</span><span style="padding-right: 0.5em;">Kirchengemeinde</span>)</small>
    <span class="source">
      <a href="/item/show/source_149287" title="Heimatbuch des Kreises Plön">Quelle</a>
      <span></span></span><span class="source">
      <a href="/item/show/source_387809" title="Ortschafts-Verzeichnis für die Provinz Schleswig-Holstein [1890]">Quelle</a>
      <span></span></span>
  </p>
  <p><a href="/item/show/object_319886"><span >Schönberg</span></a>
  <span style="color:gray"></span>
    <small>( <span style="padding-right: 0.5em;">Gemeinde</span>)</small>
    <span class="source">
      <a href="/item/show/source_1081178" title="Wohnplatzverzeichnis Schleswig-Holstein 1964">Quelle</a>
      <span></span></span><span class="source">
      <a href="/item/show/source_387809" title="Ortschafts-Verzeichnis für die Provinz Schleswig-Holstein [1890]">Quelle</a>
      <span></span></span><span class="source">
      <a href="/item/show/source_1082104" title="Wohnplatzverzeichnis Schleswig-Holstein 1970">Quelle</a>
      <span></span></span>
  </p>
</td>
</tr>

  <tr>
    <td>Untergeordnete Objekte</td>
  <td>
    <table>
      <thead>
        <tr>
          <th>Name</th>
          <th>Typ</th>
          <th>GOV-Kennung</th>
          <th>Zeitraum</th>
      </tr>
      </thead>
      <tbody>
      <tr >
        <td><a href="/item/show/SCHERGJO54EJ"><span>Ev. Kirche/Schönberg, Schönberg</span></a></td>
        <td>
          <span style="padding-right: 0.5em;">Kirche</span>
        </td>
        <td><small>object_185252</small></td>
        <td><span></span></td>
      </tr>
      <tr >
        <td><a href="/item/show/SCHERGJO54EJ"><span>Schönberg (St. Ansgar)</span></a></td>
        <td>
          <span style="padding-right: 0.5em;">Kirche</span>
        </td>
        <td><small>object_1187746</small></td>
        <td><span></span></td>
      </tr>
      </tbody>
    </table>
  </td>
  </tr>

</table>

</html>

=== Development Server ===
* Devel Server ist sichtbar
* Der Devel Server ist öffentlich
* Robert
* Robert hat die Credentials, diese sind weder für Christoph noch für Wolfgang zur Zeit verfügbar
* Christoph und Wolfgang können die http://playground-mw.bitplan.com/ spielwiesen nutzen aber noch nicht den devel server
=== Wikis ===
{| class="wikitable"
|-
! Wiki !! Version !! URL
|-
| Produktiv GenWiki || 1.35.11 || https://wiki.genealogy.net/Spezial:Version
|-
| GenWiki 2022-05-08 || 1.14.1 || https://wiki-alt.genealogy.net/Spezial:Version  
|-
| Altes Köln || 1.39.10 || https://altes-koeln.de/wiki/Spezial:Version
|-
| Devel Server || 1.39.6 || https://wiki-devel.genealogy.net/index.php/Hauptseite
|-
| Playground || 1.39.10 || http://playground-mw.bitplan.com/Thanatos/index.php?title=Special:Version
|}

== Lösungsansätze ==
* Ersetzen durch BOT - Software / Parserextension - PHP Software
* Tag->Parser Extension - BOT mit Ersetzung ... Stück Software
* BOT und Parser sind einzeln oder kombiniert einsetzbar

== Testverfahren ==
* Ansehen - Testen lassen ... Admin Rechte
* Im ersten Schritt keine Auswirkung auf das Produktiv-genwiki des Compgen e.V. Es wird im ersten Schritt noch nicht verändet da es auf einer nicht aktuellen Mediwaiki Version 1.35.11 läuft während Altes Köln auf 1.39.10 läuft

== Beispiele für Namensverbreitungskarten (NVK) ==
* https://wiki.genealogy.net/Ernestus_(Familienname)
* Relativ: <code><lastname-map size="200">Ernestus</lastname-map></code>
* Absolut: <code><lastname-map mode="abs" size="200">Ernestus</lastname-map></code>
* Verbreitungskarte
* https://altes-koeln.de/index.php/Benutzer:Christopher/NVK1890-Test
* <code>{{#widget:NVK-Test|Name=Schmitz}}</code>
* https://altes-koeln.de/index.php?title=Widget:NVK-1890-Test
* Service dahinter NVK
* https://nvk.genealogy.net/map
* https://wiki.genealogy.net/Namensverbreitungskarte
* https://nvk.genealogy.net/karte/Ernestus - Python programm, dass eine PNG erzeugt

== Beispiele für GOV-Integration ==
* https://altes-koeln.de/wiki/Benutzer:Christopher/GOV-Test
* <code>{{#widget:GOV-Test|GOVID=SCHERGJO54EJ}}</code>
* GOV-Aufruf
* https://altes-koeln.de/index.php?title=Widget:GOV-Test
* https://gov.genealogy.net/item/wikihtml/SCHERGJO54EJ