= Benutzungsanleitung - NV_MASTER Abgleich Makro =
'''(mapper_macro_2.x.py)'''

== 1. Was das Makro macht ==
Dieses Makro hilft dir dabei, Begriffe in der Auswertungstabelle zu vereinheitlichen.
Es vergleicht automatisch die Inhalte aus der Spalte „Objektbeschreibung“ mit einer
Normvokabular-Referenzdatei namens „NV_MASTER.ods“.
So findest du heraus, welche Begriffe schon genormt sind, wo es passende Vorschläge gibt
und wo etwas gar nicht erkannt wurde.
Das Makro markiert in der Auswertungstabelle jede Zeile unter „Objektbeschreibung“
farbig:

* <span style="color:green;">Grün</span>: Alles passt, alle Begriffe gefunden
* <span style="color:yellow;">Gelb</span>: Einige Begriffe wurden erkannt, andere nicht
* <span style="color:red;">Rot</span>: Kein einziger Begriff erkannt

Beispiel:

{| class="wikitable"
|+ Tabelle 1
|-
! Objektbeschreibung !! Norm_Treffer !! Norm_Vorschlag !! Kein_Treffer
|-
| (leer) || || || 
|}

Die Spalten „Norm_Treffer“, „Norm_Vorschlag“ und „Kein_Treffer“ legt das Makro
automatisch an, wenn sie fehlen.

! Tipps zur Nutzung !
* Wenn du die NV_MASTER-Datei änderst, starte das Makro neu – es liest sie bei
jedem Lauf neu ein.
* Erstelle ein Backup der Auswertungstabelle, bevor du das Makro ausführst.
* Schaue ab und zu in die Logdatei, um zu prüfen, ob alles korrekt läuft.
* Wenn ein Begriff rot markiert wird, aber deiner Meinung nach sinnvoll und zutreffend
für das beschriebene Objekt ist, schreibe den Begriff auf und sprich mit deinen
Vorgesetzten ab, ob er in das Normvokabular aufgenommen werden sollte.

== 2. Wo die Dateien des Makros liegen müssen ==
'''Unter Linux:'''
<pre>
/home/&lt;dein-benutzername&gt;/.config/libreoffice/4/user/Scripts/python/Vokabular_Abgleich_Makro/
</pre>

'''Unter Windows:'''
<pre>
C:\Users\<dein-benutzername>\AppData\Roaming\LibreOffice\4\user\Scripts\python\Vokabular_Abgleich_Makro\
</pre>

In diesem Ordner müssen liegen:  
* mapper_macro_2.x.py (das Makro)  
* NV_MASTER.ods (die Referenzdatei)  
* optional: mapper_macro_2.x.log (wird automatisch erstellt)

== 3. Wie du das Makro startest ==
# Öffne deine Calc-Datei mit den Begriffen
# Gehe im Menü auf Extras → Makros → Makros ausführen...
# Wähle: Meine Makros → mapper_macro_2.x.py → run_mapper_macro
# Klicke auf Ausführen

Das Makro startet sofort. Je nach Tabellenumfang dauert der Abgleich ein paar Sekunden bis Minuten.  
Wenn nichts passiert, liegt ein Fehler vor. In diesem Fall schaue in die .log-Datei, die das Makro bei jedem Durchlauf erstellt. Sie liegt im selben Ordner wie das Makro.

== 4. Wie du das Ergebnis liest ==
Nach dem Lauf schreibt das Makro die Treffer und Vorschläge direkt in deine Tabelle und markiert sie:

{| class="wikitable"
|+ Tabelle 2
|-
! Objektbeschreibung !! Norm_Treffer !! Norm_Vorschlag !! Kein_Treffer
|-
| Harfe, Noten, Bäume, Geldbeutel, Landschaft, Gewässer || Harfe (2.1) | Noten (3.4) | Landschaft (7.2) Gewässer (9.1) || Baum || Geldbeutel
|}

Farben:  
* 🟩 <span style="color:green;">Grün</span>: Alle Begriffe wurden direkt erkannt → Perfekt!  
* 🟨 <span style="color:yellow;">Gelb</span>: Einige Begriffe wurden erkannt, aber andere nur teilweise oder gar nicht → Vorschläge unter der Spalte „Norm_Vorschlag“ prüfen  
* 🟥 <span style="color:red;">Rot</span>: Kein Begriff wurde gefunden → Objektbeschreibung anpassen, ggf. neue Begriffe in das Normvokabular aufnehmen

== 5. Wo das Protokoll liegt (Logdatei) ==
Das Makro schreibt alles, was passiert, in eine Logdatei:

'''Linux:''' /home/<dein-benutzername>/.config/libreoffice/4/user/Scripts/python/Vokabular_Abgleich_Makro/mapper_macro_2.x.log  
'''Windows:''' C:\Users\<dein-benutzername>\AppData\Roaming\LibreOffice\4\user\Scripts\python\Vokabular_Abgleich_Makro\mapper_macro_2.x.log  

Dort siehst du:  
* wann das Makro gestartet wurde  
* wie viele Zeilen verarbeitet wurden  
* und ob Fehler aufgetreten sind

{| class="wikitable"
|+ Tabelle 3
|-
! Problem !! Ursache !! Lösung
|-
| Das Makro taucht nicht auf || Falscher Speicherort || Prüfe, ob das Skript wirklich im Ordner Scripts/python liegt
|-
| Fehlermeldung „Module not found“ || Python-Bibliotheken fehlen || Installiere pandas, odfpy, spacy, rapidfuzz
|-
| NV_MASTER wird nicht gelesen || Datei fehlt oder ist kaputt || Prüfe Name und Speicherort
|-
| LibreOffice stürzt ab || Sehr große Datei oder fehlerhafte NV_MASTER || Teste mit kleinerer Datei oder neuem NV_MASTER
|}

== 6. Was das Makro benötigt, um einwandfrei zu laufen ==
Alle folgenden Pakete sind für das Makro notwendig, egal ob LibreOffice oder Excel:

{| class="wikitable"
|+ Tabelle 4
|-
! Paket !! Zweck
|-
| pandas || Einlesen der Referenzdatei (NV_MASTER.ods)
|-
| odfpy || Ermöglicht Lesen von .ods-Dateien (für pandas.read_excel(..., engine="odf"))
|-
| spacy || Lemmatisierung (optional, aber empfohlen)
|-
| rapidfuzz || Schnelles Fuzzy-Matching (Alternativ zu difflib)
|-
| openpyxl || Wird benötigt, falls .xlsx genutzt wird
|-
| python-dateutil || Wird automatisch von pandas gebraucht
|}