Die Einrichtung und Anwendung unterscheidet sich je nach Betriebssystem und ist nicht explizit auf Benutzerfreundlichkeit ausgelegt, sondern richtet sich eher an Nutzer mit Programmierkenntnissenoder gewisser Frusttolleranz bei der Einrichtung neuer Software/Apps. Daher hier folgend Anleitungen für Windows und Linux. Das Skript funktioniert grundsätzlich aber auch mit macOS.

Das Skript selbst ist in Python 2.7 geschrieben, aber lauffähig von 2.6 bis mindestens 3.6 und verwendet Java für den eigentlichen Abgleich. Es sollten demnach Java das JDK und Python installiert sein.

# Eine halbwegs aktuelle [https://www.java.com/de/ Javaversion] installieren, wenn noch nicht geschehen. (Das OpenJDK macht Probleme).# Python als Befehl in Windows' Kommandozeilentool (Eingabeaufforderung; cmd) einrichten. (Optional, wir gehen hier in der Folge davon aus, dass es gemacht wurde.) Dazu in in die Systemsteuerung gehen, System, Erweiterte Systemeinstellungen, Erweitert, Umgebungsvariablen und dort bei Path ans Ende euren Pfad zum Pythonordner eintragen. Mit einem Semikolon davor, damit Windows weiß, dass dort ein neuer Pfad beginnt. <br>[[Datei:Python umgebungsvariablen.png|400px550px|Grafik zur Einrichtung der Umgebungsvariablen]]

# Dort angekommen und unter der Annahme, dass ihr dort die Dateien aus dem Archiv hinkopiert hin kopiert habt und die Umgebungsvariable erweitert, gebt ihr '''checkintegrity.py PfadzumPrüfordner > foo.txt''' ein und startet das Skript mit der Eingabetaste.<br>[[Datei:Integritaetspruefung.png|Ablauf der Integritätsprüfung]]<br>Ihr könnt natürlich auch volle Pfade der Form ''C:\Antamar\Projekt1\Quest1 '' angeben, müsst es sogar, wenn sich die Ordner nicht im gleichen Verzeichnis, wie das Script befindetSkript befinden. Hängt man das '''> name.txt''' hinten dran, wird eine Textdatei erstellt, die die Auswertung enthält, lässt man es weg, werden die Fehler direkt in der Konsole ausgegeben, wie auf dieser Grafik zu sehen. Der Name der Datei ist frei wählbar.<br>Falls ihr Schritt drei ausgelassen habt, müsstet ihr zum Starten jedesmal jedes Mal sehr viel mehr tippen, das kann dann in etwa so aussehen: '''C:\Python36\python.exe checkintegrity.py D:\Antamar\Quest1 > fehler.txt'''.<br>Und ja, natürlich könnt ihr das Skript auch ''ci.py'' nennen und dann darüber aufrufen. Kein Problem.

=== Linux (Ubuntu) ===Noch offen# Linux liefert Python direkt mit und Linuxnutzern muss in der Regel auch die Konsole nicht mehr erklärt werden, daher kann man sich hier kurz fassen. Wenn nötig, JDK installieren. (Open JDK macht Probleme)# Das ZIP-Archiv mit dem Skript und den Hilfsdateien runterladen und an einer schönen Stelle platzieren.# '''python checkintegrity.py /PfadZumPrüfordner/ > foo.txt''' in der Konsole ausführen, nachdem man zum passenden Ordner navigiert ist.# Über Ergebnis freuen oder ärgern. Selbiges findet sich entweder in der angegebenen Textdatei im Ordner in dem auch das Skript liegt oder wird direkt in der Konsole ausgegeben, wenn man ''> foo.txt'' weglässt. Auch hier kann der Name des Skripts natürlich verkürzt werden, wenn man weniger tippen will und der Name der Auswertungsdatei ist ebenso frei wählbar.

* Wenn in Links [[Store fetch|Variablen]] genutzt werden, wird fälschlicherweise ein Fehler geschmissen. Dieser kann ignoriert nicht evaluiert werden. Variablen in Links sollten künftig bei der Auswertung ignoriert oder , ob die Dateien existieren, da es sollte geschaut werdenzu aufwendig würde, welche Werte sie annehmen können, um sämtliche Dateien nach möglichen Werten für die Variable zu durchforsten und diese dann auf diese Werte zu prüfen. Dazu sollte zumindest ein Hinweis ausgegeben werden.* Bei Verwendung von Funktionen aus der [[AOQML Library|AOQML-Bibliothek]] wird angegebennicht geprüft, dass ob die Datei nicht Bib tatsächlich existiert. Das ist formal korrekt, kann aber ignoriert werden. Künftig Links nicht mehr betrachten, die [Array mit /lib/ anfangen oder die Liste der möglichen Libraries in einem Array hinterlegen, sodass hier auch auf korrekte Schreibung geprüft werden kann. Nachteil: Händisch nachzurüsten.Libkandidaten nachrüsten?]

* Hohe Laufdauer des Scripts Skripts bei sehr vielen Dateien ist normal und kein Grund zur Besorgnis. Einfach warten, es schließt irgendwann ab.Skriptoptimierung ist möglich.* Nachdem ein toter Link gefunden wurde, wird der Rest der entsprechenden Datei nicht weiter nach selbigen durchsucht.* Nach einer Meldung der Form "references missing file" folgt im Textdokument nur ein einfacher Zeilenumbruch, statt mehrerer, wie sonst überall.

== Download des Scripts Skripts ==

[[Datei:questbatch_validationQuestbatch validation.zip]] [[Kategorie:AOQML‏‎]][[Kategorie:Mitarbeit]]