dictionary, formal updates, pick-24

Author: thomaskoslowski

src/onprem/de/devel_special_agents.asciidoc

@@ -1,7 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE Anwendungs
 // NONASCII °
-// SKIPCOMMITS 2025-09-02
 include::global_attr.adoc[]
 = Spezialagenten entwickeln
 :revdate: 2025-02-24
@@ -13,7 +12,7 @@ xref:devel_intro#[Erweiterungen für {CMK} entwickeln]
 xref:datasource_programs#[Datenquellprogramme]
 xref:wato_monitoringagents#[Monitoring-Agenten]
 xref:wato_services#[Services verstehen und konfigurieren]
-xref:cmk_commandline#[{CMK} auf der Kommandozeile]
+xref:cmk_commandline#[{CMK} auf der Befehlszeile]
 xref:mkps#[{CMK}-Erweiterungspakete (MKPs)]
 {related-end}
 
@@ -33,7 +32,7 @@ Danach beendet sich der Spezialagent.
 Dies erlaubt es Ihnen, Spezialagenten in beliebigen Programmiersprachen zu implementieren.
 Allerdings bedeuten kurz laufende Prozesse, dass _Just-in-time_-kompilierte Sprachen wie Java eher weniger geeignet sind als kompilierte Sprachen oder schnell startende interpretierte Sprachen.
 
-Die Konfiguration der gestarteten Prozesse erfolgt über Kommandozeilenparameter beim Aufruf des Spezialagenten.
+Die Konfiguration der gestarteten Prozesse erfolgt über Befehlszeilenparameter beim Aufruf des Spezialagenten.
 Hierfür bestimmen Sie, in welcher Weise GUI-Elemente wie Texteingabefelder oder Checkboxen auf bestimmte Parameter abgebildet werden.
 
 Die Code-Beispiele dieses Artikels finden Sie in unserem link:https://github.com/Checkmk/checkmk-docs/tree/2.3.0/examples/devel_special_agents[GitHub-Repository^] und den fertig gebauten Open-Meteo-Spezialagenten zudem als link:https://exchange.checkmk.com/p/ometemp[MKP in der {CMK}-Exchange^].
@@ -219,7 +218,7 @@ Wie im vorherigen Beispiel legen Sie als erstes die xref:prepare_env[benötigten
 
 Jetzt, wo echte Daten verarbeitet werden sollen, müssen Sie sich zudem einige Gedanken machen, beispielsweise zur Programmiersprache und der Vorverarbeitung.
 Unser Beispiel fragt eine öffentliche API ab und erhält JSON-Daten.
-Das könnte man in der Shell mit einem `curl`-Kommando erledigen.
+Das könnte man in der Shell mit einem `curl`-Befehl erledigen.
 Da aber {CMK} ein gut ausgestattetes Python mitbringt, liegt es nahe, dieses zu verwenden.
 
 Die nächste Entscheidung betrifft die Aufarbeitung der Daten.
@@ -232,8 +231,8 @@ Letzteres ist dann der Fall, wenn Daten so aufbereitet werden können, dass sie
 
 Unser Beispiel reicht die JSON-Antwort einfach durch.
 Das Parsen findet dann im agentenbasierten Check-Plugin statt.
-Die Übergabe von Längen- und Breitengrad erfolgt durch die Kommandozeilenargumente `--latitude` und `--longitude`.
-Um Kommandozeilenargumente besser einlesen zu können, verwenden wir die Bibliothek `argparse`.
+Die Übergabe von Längen- und Breitengrad erfolgt durch die Befehlszeilenargumente `--latitude` und `--longitude`.
+Um Befehlszeilenargumente besser einlesen zu können, verwenden wir die Bibliothek `argparse`.
 Da Open-Meteo den Längen- und Breitengrad in die URL kodiert unterstützt, genügt eine URL mit Platzhaltern.
 Probieren Sie diese URL mit _Ihrem aktuellen_ Längen- und Breitengrad ruhig einmal im Browser aus.
 
@@ -273,14 +272,14 @@ Zur Erinnerung: Dieses Skript darf keine Dateiendung haben.
 ====
 
 Die Agentensektion `ometemp` enthält schlussendlich nur das empfangene JSON-Objekt.
-Testen Sie den Spezialagenten, indem Sie ihn auf der Kommandozeile aufrufen.
+Testen Sie den Spezialagenten, indem Sie ihn auf der Befehlszeile aufrufen.
 
 [{shell}]
 ----
 {c-omd} ~/local/lib/python3/cmk_addons/plugins/ometemp/libexec/agent_ometemp --latitude 48.1305 --longitude 11.5953
 ----
 
-Ihre Ausgabe auf der Kommandozeile sollte nun in etwa so aussehen:
+Ihre Ausgabe auf der Befehlszeile sollte nun in etwa so aussehen:
 
 [{shell-raw}]
 ----
@@ -433,7 +432,7 @@ special_agent_ometemp = SpecialAgentConfig(
 
 [IMPORTANT]
 ====
-Das hier gezeigte Beispiel übergibt Passwörter im Klartext als Kommandozeilenargumente.
+Das hier gezeigte Beispiel übergibt Passwörter im Klartext als Befehlszeilenargumente.
 Ohne weitere Maßnahmen sind diese Passwörter beispielsweise aus der Prozesstabelle auslesbar.
 Sie können die Angriffsfläche minimieren, indem Sie den Eintrag in der Prozesstabelle gleich beim Programmstart ändern.
 Unter Python geht dies zum Beispiel mit dem link:https://pypi.org/project/setproctitle/[Modul `setproctitle`^].
@@ -578,7 +577,7 @@ Möglicherweise gibt es auch ein Problem in der Aufrufkonfiguration oder am eige
 Dies wird zum Beispiel sichtbar, weil beim [.guihint]#Activate changes# ein gelber Warnhinweis angezeigt wird.
 
 Überprüfen Sie dann die Datei `server_side_calls/special_agent.py` entsprechend der Angaben aus der Fehlermeldung.
-Behebt das den Fehler nicht, so können Sie wieder auf der Kommandozeile nach Fehlermeldungen suchen:
+Behebt das den Fehler nicht, so können Sie wieder auf der Befehlszeile nach Fehlermeldungen suchen:
 
 [{shell}]
 ----
@@ -627,7 +626,7 @@ In der Datei `server_side_calls/special_agent.py` wird wohl versucht, auf ein El
 === Agentenausgabe überprüfen
 
 Eine weitere Fehlerquelle kann es sein, dass Ihr Check-Plugin keine Daten ausgibt.
-Auch dies können Sie auf der Kommandozeile überprüfen: 
+Auch dies können Sie auf der Befehlszeile überprüfen: 
 
 [{shell}]
 ----

src/onprem/en/devel_special_agents.asciidoc

@@ -1,7 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE pre
 // NONASCII °
-// SKIPCOMMITS 2025-07-23
 include::global_attr.adoc[]
 = Developing special agents
 :revdate: 2025-03-10