Meeting für ioBroker Core/Dev/Admin 14.07.20 20:30

[braindead]

@apollon77 Das "checker script" ist gut, damit User diese Probleme identifizieren können. Die bessere Lösung ist es aber nicht, weil es abhängig von den Usern ist.

"strict mode" halte ich für den falschen Ansatz/Begriff, weil entweder etwas ist verboten, weil es Probleme macht oder es sollte erlaubt sein. Warum sollte etwas verboten sein und im "nicht strict mode" trotzdem möglich sein?

Trotzdem könnte man zwei Dinge unterscheiden:

1. "adapter.0.state.state.state" muss beim Erzeugen von States verhindert werden. Das passiert in der Regel nicht andauernd und hier ist Performance nicht sooo wichtig.

2. Der "strict mode" geht auf die Performance, weil er bei jedem setzen eines States überprüfen muss, ob der zu setzende State ein State ist?

Aber wahrscheinlich habe ich einfach nicht verstanden, wo das tatsächliche Problem mit einer solchen Struktur ist bzw. warum nur ein State einen Wert haben darf.

[paul53]

@braindead sagte:

warum nur ein State einen Wert haben darf.

Das ist die Definition eines ioBroker-Datenpunktes.

[paul53]

@apollon77 sagte:

Alternativ ein "checker script"

Besser die Hauptquellen der Erzeugung von Datenpunkten durch den User um die Prüfung erweitern:

• createState(id) im Javascript-Adapter
• adminObjects.js im Admin-Adapter

Den js-controller als ioBroker kernel sollte man nicht zu sehr "aufblasen".

[apollon77]

@paul53 Ehrlich: Es geht als erste Prio darum das Adapter keine busslshit dürfen ... Der JS ADapter ist da ne Sonderlocke den man ggf mit abfängt.

Aber bei den ganzen Aktionen immer "die Objekte drum herum" zu prüfen kostet einfach sehr viel Performance und das will auch keiner. Wir haben aktuell einen gewissen Datendurchsatz und der soll auch nicht weniger werden, sonst wird es wieder langsamer - vor allem dann auf schwächeren Systemen. Es muss also eine Balance gefunden werden.

Ein Skript mit denen die Entwickler (!!) (nur im Notfall die User) Ihre Adapter prüfen können und damit die Verantwortung übernehmen es korrekt zu liefern ist es. Und ja dann müsste man in den JS Adapter relevante checks einbauen

[BoehserWolf]

Bzgl. Doku:
Könnte man da nicht einen Mittelweg gehen aus @Mic Ansatz SmartControl-Adapter und github Doku? Also soviel wie möglich Hilfe in den jeweiligen Adapter in die Config Seite selbst legen (anstatt in der readme.md auf github), da dadurch das Öffnen der Hilfe auf einer externen Seite entfällt. Die Pflege der Hilfe aber trotzdem auf github belassen?
Das könnte bspw durch spezielle Tags in der readme.md erreicht werden, die der jeweilige Adapter in der Config referenziert und sich entsprechend verlinkt. Das hätte den Charme, dass beides vollständig ist und immer funktioniert. Hoffe ist verständlich was ich meine.

[Mic]

@BoehserWolf sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Bzgl. Doku:
Könnte man da nicht einen Mittelweg gehen aus @Mic Ansatz SmartControl-Adapter und github Doku?

Hi, ich konnte leider nicht bei dem Meeting teilnehmen, aber weil mich @BoehserWolf hier zur Doku zitiert :
Coole Idee!
Doku und Übersetzungen sind für mich beim frischen SmartControl-Adapter und natürlich auch bei meinen anderen beiden Adaptern ein großes Thema. Übersetzung ist aus Adapter-Entwickler-Sicht trotz Gulp extrem zeitaufwändig, und wir entwickeln doch ja alle privat, ohne Einnahmen, dafür, usw. Dafür ist mir meine Zeit echt zu schade, um mich auch noch um Übersetzungen zu kümmern, mein "Job" ist es, zu entwickeln, neue Features der User einzubauen, und Bugs zu fixen! Da habe ich einfach keine Zeit mehr für den Übersetzungskram.

Daher habe ich in SmartControl:

• admin/index_m.html Texte vor ein paar Tagen auf Deutsch umgestellt und die komplette Adapter-Doku dort in der Konfig integriert, siehe gif. Aus Usability-Gründen ist dadurch die Info direkt für den Anwender verfügbar und es findet kein aufwändiger Medienbruch statt. Dies hat mich persönlich bislang immer ziemlich genervt, nicht gleich in Adapter-Konfig die Optionen erklärt zu bekommen, sondern man muss da immer ziemlich rum suchen, bis man hoffentlich weiterführende Erklärungen zu Adapter-Optionen findet. Aus Anwendersicht ziemlich uncool und zeitaufwändig...
  Aus Entwicklersicht auch viel agiler und schneller: Neue Option oder was geändert in der admin/index_m.html -> man passt sofort die Doku ein paar Zeilen drüber an. Dem User ist damit auch deutlich schneller geholfen.
• In den Optionen prägnanten Link gesetzt:
  
  Please click here führt zu https://github.com/Mic-M/ioBroker.smartcontrol/blob/master/docs/translations.md

Da stelle ich das Thema auch klar, und auch dass ich null Zeit noch übrig habe, mich um dem aufwändigen Übersetzungskram zu widmen. Als Lösung schlage ich hier vor, einfach Google Translate zu nutzen, damit wird die Übersetzung an die UI bzw. Client übertragen. Man müsste noch mal besser schauen, welche guten Browser-Plugins es da noch so gibt, um lokale Websites einfach zu übersetzen. Denn dann kann man sich den Kram komplett sparen.
Man muss hier meiner Meinung nach auch berücksichtigen, wann das Konzept von ioBroker entstanden ist, nämlich wohl in 2014. Mittlerweile haben wir - jetzt in Juli 2020 - sehr starke UI/Client-Übersetzungstools für "on the fly". Das war damals noch überhaupt nicht der Fall und die Übersetzungen waren teils mega schlecht. 2020er Beispiel: https://www.deepl.com/translator - die Übersetzungen sind wahnsinnig gut! Sachen wie "0_userdata.0.status.xyz" werden natürlich immer auch noch übersetzt, unschön, aber das könnte man sich noch näher ansehen, wie man das ausschließen kann. Als Beispiel: im Bereich SEO sind ja auch Tags für HTML-Websites implementiert für Suchmaschinen, um Teile der Website von der Indexierung auszuschließen. Warum soll das nicht hier auch gehen, um Satz-Teile von der Übersetzung auszuschließen?
Alles in allem aus meiner Sicht die Zukunft, die Übersetzungs-Pflicht an den Client zu übertragen, und nicht mehr vom "Server" managen zu lassen. Grad bei Open Source Projekten, die sich nicht eine Mannschaft für Übersetzungskram leisten können...

Letztendlich:
ioBroker ist zum allergrößten Teil einfach Deutsch. Warum also die Entwickler quälen mit Übersetzung ins Chinesische oder warum müssen sie sich einen abbrechen, um Ausgangstexte in Englisch zu haben? Nicht jeder spricht gut Englisch, btw.
Und warum die deutlich > 90 % deutschsprechenden End-Anwender "quälen" mit fehlender Usability? Mir fällt da auch auf Github auf, dass man sich da gegenseitig einen abbricht, um sich in Englisch auszutauschen, obwohl die Muttersprache deutsch ist. Hab deswegen auch diesen Hinweis im SmartControl Adapter:

Mein Wunsch wäre außerdem noch eine einfache Möglichkeit für Adapter-Entwickler, mehrsprachige Log-Ausgaben zu bieten.

Danke, und ich hoffe meine Kritik kommt nicht zu heftig und wirklich konstruktiv als reiner Verbesserungsvorschlag an

[sigi234]

@Mic sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

ioBroker ist zum allergrößten Teil einfach Deutsch.

91,81 %
Das sagt Alles.

[apollon77]

Hm ... @Mic muss ehrlich sagen das ich das einerseits verstehen kann, andererseits seehr shwierig finde.

Projektseitig haben wir die weiteren Sprachen (Sehr lange gab es deutsch,englisch und Russisch) nach Absprache mit (einer damals noch etwas kleineren) Entwicklergruppe und auch User-Gruppe eingeführt um genau ioBroker aus dem "nur Deutschland" rauszubringen und auch um besser andere Smart-Home Systeme angreifen zu können! Chinesisch kam dazu als es dort losging und sich eine eigene Community gebildet hat. So ein switch dauert aber Zeit! Und fehlende Übersetzungen schrecken dann neue User aus anderen Sprachregionen ganz einfach ab! Das ist die andere Seite der Medallie

Es gibt Tools um die Übersetzungen für die Entwickler zu erleichtern bzw zu automatisieren. @ldittmar hat gulp Skripte dazu gebaut die integriert sein sollten, es gibt https://translator.iobroker.in/ für manuellere Übersetzungen.
Die Realität ist das ein User das was Du beschreibst ggf nicht akzeptiert sondern einfach den Adapter nicht nutzt ...oder Ihn fluchend nutzt weil er anders tickt als die 352 anderen Adapter

Was das Thema "usebility" und "Admin UIs besser machen" mit den Übersetzungen zu tun hat weiss ich nicht nicht, aber ja wenn es darum geht texte nicht auslagern zu müssen ... naja
Ich hatte auch vor einiger Zeit mal mit Optionen überlegt (Fragezeichen Icons mit mouse-over Erklärungen der Einstellungen), aber am Ende bin ich kein Web-Designer ... Womit wir am Ende wieder beim Adapter-Konfiguration Styleguide und so wären

GitHub ist in meinen Augen sprachlich ob Deutsch oder Englisch fast egal ... ich zwinge keinen dort englisch zu sprechen

Mehrsprachige Log Ausgaben finde ich persönlich wiederum überflüssig und sogar komplett nicht hilfreich - vor allem wenn die Logs zur Fehlersuche genutzt werden durch MICH dem Entwickler dann muss ich danach suchen können im Code ... und ich muss damit die Logik verstehen können. Mehrsprachigkeit hier hilft MIR nicht ... und da behaupte ich jetzt das 90% der User keine Logs lesen und daher

Fakt ist auch - und das macht die Thematik sehr grenzwertig - das der Adapter Checker im Repo die Übersetzungen prüft und mal mindestens neue Adapter die nicht wenigstens teilweise die Hauptsprachen unterstützen in jedem Fall nach den aktuellen Regeln nicht ins Repo kommen. Das würde auch auf Deinen Adapter zutreffen.

Bestandsadapter geniessen aktuell noch irgendwie so eine Art Vogelfreien Status, aber auch diese prüfen wir bei stable updates mit dem Repo-Checker ...

Du schaffst hier gerade einen Präzedenzfall ... und ich hätte es besser gefunden wenn Du solche Entscheidungen vorher vllt mal angesprochen hättest. Versteh mich bitte nicht falsch und ich will Dir garantiert keine Stöcke zwischen die Füsse werfen oder gar das du jetzt angepisst keine Adapter mehr baust ... aber irgendwie ist es halt ein miteinander und eine Balance ...

Ingo

[Mic]

@apollon77
Hi Ingo,

Zunächst: Ich bin absolut dafür, dass wir Internationalisierung brauchen. Ich zitiere mich mal selbst vom August 2018:

Mich persönlich nervt noch, dass ioBroker viel zu wenig bekannt im englischsprachigen Raum ist, obwohl die Community alles dafür macht (englische Hilfe, englischsprachiges Forum, GitHub so weit es geht in Englisch, etc.). Bin mir da noch nicht sicher, wie wir das weiter unterstützen können…. :roll: Aber auch das wird noch kommen. Ein Blog hilft hier schon mal sehr um in den Fokus zu kommen, und ich bin gerne auch mal bei englischsprachigen Artikeln behilflich, falls das angedacht ist.

Hier mal ein einfaches Beispiel, was ich meine:

Ich füge eine neue Tabellenspalte in den Optionen in der index_m.html ein.

<th style="width: 120px" class="header translate" data-name="offValue">'off' value</th>

Diese neue Option beschreibe ich in der index_m.html entsprechend:

<td>
State value, which is set in 'state for switching device off'. You can use <code>true</code>, <code>false</code>, numbers like <code>144</code>, or strings like <code>Turn Radio on</code>. Note: Any white spaces or quotation marks (like <code>"</code>) at the beginning or end will be disregarded.
</td>

Das dauert wohl so 2-3 Minuten als Entwickler.

Nun wäre ich eigentlich schon fertig.

Schritte die ich als Entwickler nun manuell durchführen muss:

1. admin/i18n/en/translations.json: Übersetzung für "'off' value" hinzufügen.
2. Das HTML in index_m.html für "State value, which is set ..." umformatieren, so dass es mir z.B. true oder false nicht übersetzt, die zusätzlichen HTML-Tags "code" usw. beibehält, etc. Sehr mühsam und zeitaufwändig. Und passt auch nicht von der Reihenfolge her für die einzelnen Sprachen (Satzbau, Grammatik, Zeichensetzung, etc.):

<td>
<span class="translate">State value, which is set in 'state for switching device off'. You can use </span><code>true</code>, <code>false</code>, <span class="translate">numbers like </span><code>144</code><span class="translate">, or strings like </span><code><span class="translate">Turn Radio on</span></code>. <span class="translate">Note: Any white spaces or quotation marks (like </span><code>"</code>)<span class="translate"> at the beginning or end will be disregarded.</span>
</td>

(hab das hier reingetippt jetzt, sicherlich noch Fehler im HTML, die ich jetzt noch debuggen müsste, prüfen wie es aussieht im Admin, ...)

3. admin/i18n/en/translations.json: Alle nun neuen Übersetzungen der index_m.html wieder hier mühsam manuell per Copy & Paste einfügen
4. Gulp Übersetzung ausführen. Ggf. muss ich nach erfolglosem Google Translate (zu viel in kurzer Zeit übersetzt ) auf Yandex aufweichen (mit schlechterer Übersetzungsqualität und mehr Arbeit im Nachgang für mich)
5. Deutsche Übersetzung korrigieren, weil oft schlecht übersetzt und manche Begriffe wie z.B. "State" irreführend für den Anwender übersetzt werden. Dabei muss ich mühsam die Quelle ansehen und vergleichen, auch weil Satzteile übersetzt wurden die so nicht zusammen passen, einzeln zusammen suchen, usw.
6. Ggf. zurückgehen zu Punkt 2 ( index_m.html) und diese noch mal korrigieren und 3-5 erneut durchlaufen.

---

Der zusätzliche Aufwand für dieses Beispiel geschätzt: 30 Minuten. Das steht für mich in keinem Verhältnis zu den ursprünglich 2-3 Minuten.

Wenn man sich etwas umschaut, dann liest man z.B. Folgendes auf github.com/thomas-darling/gulp-translate:

In a traditional localization workflow, localizable content is assigned unique ids and stored in a separate file. Templates that need the content can then import it by referencing its id. While this approach can work in some apps, it has significant drawbacks that often make it annoying, inefficient and error prone in larger apps.

Scheint aber immer noch eher aufwändig, habe es mir noch nicht näher angesehen. Unique Ids ist jedenfalls wirklich nicht Entwickler-freundlich wie hier beschrieben:

In many solutions, all strings that need to be translated are stored in a separate string-file, and the templates then reference those strings by id, often using client-side data binding. While this approach does work, it has significant drawbacks that make it annoying, inefficient and error prone in larger apps.

Hier klicken

The problems with fixed ids

In many solutions, all strings that need to be translated are stored in a separate string-file, and the templates then reference those strings by id, often using client-side data binding.
While this approach does work, it has significant drawbacks that make it annoying, inefficient and error prone in larger apps.

Using data binding to render every single string can have a significant impact on performance, and if the application is split into multiple bundles to reduce download size,
it may not be obvious in which string-file a given string should be added, especially if that string is referenced from multiple places.

When we need a new string, we have to somehow come up with a new unique string id, preferably consistent with the naming of the thousands of existing ids.
We then have to add it to the string-file and reference it from the template, which is less than ideal for rapid prototyping, where templates and strings are subject to change.

When we change the layout of the application over time, strings will inevitably move around, and their ids may become misleading as to where the string is actually used.
We can't easily change those ids to match the new layout, as that would undermine the whole point of having a fixed id in the first place.

When we need the same string in multiple places, keeping the translations consistent becomes complicated.
We could reference the same string from multiple places, but what should the id of that string then be?

When the same string is referenced from multiple places, and we decide to change the text in one of them, we might accidentally change it everywhere.
We could search for the id in the code, but that is easily forgotten, and now we have to come up with a new id for the string we are changing.

When a string is no longer needed, we have to remember to remove that string from the string-file.
This is easily forgotten, leading to unused strings piling up - and how do we even know that the strings are not still in use?

Storing strings separately decouples them from the templates in which they are used, which is a problem when refactoring e.g. binding expressions, markup or class names, which may be part of the string
that should be translated. Updating the strings is easily forgotten, which introduces bugs that may not be easily found.

Using fixed ids complicate branching and testing, as strings or string ids may be changed or removed on some branches but not on others.
This complicates translation management and multilingual testing, as different branches need different versions of the translations.

---

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Mehrsprachige Log Ausgaben finde ich persönlich wiederum überflüssig und sogar komplett nicht hilfreich - vor allem wenn die Logs zur Fehlersuche genutzt werden durch MICH dem Entwickler dann muss ich danach suchen können im Code ... und ich muss damit die Logik verstehen können. Mehrsprachigkeit hier hilft MIR nicht ... und da behaupte ich jetzt das 90% der User keine Logs lesen und daher

Sehr guter Punkt wegen Fehlersuche, du hast absolut recht, und da geht's mir genau so Ich dachte da auch hauptsächlich an den Endanwender wegen Info-Log-Ausgaben. Aber das lässt sich wohl auch alternativ gut bzw. besser über Adapter-Konfig lösen, in der dann der User die Ino-Log-Texte für die einzelnen Szenarien selbst hinterlegen kann.

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Fakt ist auch - und das macht die Thematik sehr grenzwertig - das der Adapter Checker im Repo die Übersetzungen prüft und mal mindestens neue Adapter die nicht wenigstens teilweise die Hauptsprachen unterstützen in jedem Fall nach den aktuellen Regeln nicht ins Repo kommen. Das würde auch auf Deinen Adapter zutreffen.

Aktuell besteht der https://adapter-check.iobroker.in/ meine "Übersetzungen" von https://github.com/Mic-M/ioBroker.smartcontrol tatsächlich wunderbar Die index_m.html wird wohl nicht näher gecheckt wird auf class:translate versus vorhandener Ids in words.js und evtueller Diskrepanzen. Aber ich weiß, was du meinst, der Adapter entspricht so sicherlich nicht dem gewünschten "Standard". Ich bin sehr gerne regelkonform, die Gründe für die Abweichung beschreibe ich auch hier

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Du schaffst hier gerade einen Präzedenzfall ... und ich hätte es besser gefunden wenn Du solche Entscheidungen vorher vllt mal angesprochen hättest.

Ich bin absolut deiner Meinung, dass mein alternatives Vorgehen eine Abstimmung erfordert und das ganze ein Miteinander ist. Sorry für das vorpreschen. Aber für meine Alpha/Beta-Version des Adapters muss(te) ich jedoch priorisieren und zügig eine Entscheidung treffen, denn sonst würde sich das wohl wochen- bzw. monatelang ziehen und ich müsste zwischenzeitlich nach dem alten, gewohnten Schema vorgehen, wofür ich einfach keine Zeit habe (siehe oben das kleine Beispiel) und den Adapter damit komplett einstampfen mangels Zeit. Hab da auch einfach keine Lust zu, sorry.

Ich bin daher auch schmerzfrei, wenn der Adapter dadurch nicht ins Latest kommt, weil ich einfach nicht die Zeit für diese Zusatztätigkeiten habe und keine Lust auf eine Sehnenscheidenentzündung wegen dem vielen manuellen Copy/Paste etc.
Mein Ziel ist es, dem Anwender einen möglichst einfach zu konfigurierenden Adapter zu bieten, das muss ich als "Adapter-Schöpfer" einfach bieten. Da Smart Control komplex (im Vergleich zu einigen andern Adaptern) in den Einstellungen ist, ist es aus meiner Sicht aus User Acceptence Gründen umso wichtiger, dass Erklärungen zu den Optionen intuitiv und direkt ohne Medienbruch verfügbar sind. Kann doch nicht sein, dass in der Konfig gefühlt nur "Hieroglyphen" sind und man nicht weiter kommt. Da verliert man schnell die Lust als Anwender, und da spreche ich selbst aus Erfahrung, deswegen will ich das unbedingt selbst besser machen.

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Versteh mich bitte nicht falsch und ich will Dir garantiert keine Stöcke zwischen die Füsse werfen oder gar das du jetzt angepisst keine Adapter mehr baust ... aber irgendwie ist es halt ein miteinander und eine Balance ...

Keine Sorge, ich werfe nicht hin Vielen Dank für deine konstruktive Antwort und Kritik. Ich bin absolut deiner Meinung, dass das ganze ein Miteinander und eine Balance ist und kann all deine Punkte sehr gut nachvollziehen.
Ich hoffe, ich konnte oben meine Beweggründe verständlicher darlegen.

Zusammengefasst ist mein Haupt-Beweggrund: in begrenzter Zeit möglichst viel dem ioBroker-Anwender als Entwickler zu bieten, und Manuelles in der Entwicklung so weit es geht zu vermeiden. Im Quellcode verwendet man ja auch Klassen, Funktionen und Eigenschaften, in Verbindung mit Schleifen etc., um wiederkehrendes zu kapseln und den Code nur einmalig schreiben zu müssen. Analog dazu sollte das auch bei den Übersetzungen sein um uns als Entwicklern möglichst manuelle Arbeit zu vermeiden bei der Entwicklung und Pflege des Adapters...

[Mic]

Test. HTML scheint defekt im letzten Beitrag von mir

[apollon77]

ja irgendwie hats das jetzt zerballert

Ich verstehe auch Deine Argumente und sind natürlich auch immer ein nerviges Thema als Entwickler, wie ich nur zu gut selbst kenne :-).
Das der Ansatz mit dem "eindeutigen IDs für lokalisierbare Inhalte" nicht perfekt ist ist denke überall bekannt ... aber eine echte Alternative gibts irgendwie auch nicht

Wäre damit nicht eine Idee ein "gulp" Dingens oder ein Skript zu schreiben was es erlaubt bestimmt "geschriebenes html" zu parsen und anzupassen?
Also sowas wie ein tag "translate" was als property die text-ID oder sowas hat und ggf. eine Notation "nicht zu übersetzende teile" zu markieren die dann auch behandelt werden. Dann kann man das initial einfach so schreiben und am Ende lässt man das Skript drüber rennen was diese Art von Sonder-Tags nimmt, in die transpation files einfügt und so ... Das text Polishing (De/en) ist denke immer mit dabei ... da kommt man nicht drum rum fürchte ich.

Lasst uns doch mal Kreativ werden wie wir dieses nervige Problem so angehen können mit dem was wir können ... Coden

Vllt kriegen wir die 30 mins so auf 10 "am Ende einer Änderung" runter

Ingo

[Jey Cee]

@ldittmar sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Nicht Open Source Abhängigkeiten im ioBroker Core -> Redis Protokoll (Jey Cee)

Object in Redis - Bluefox, Apollon77 und Foxriver haben Zugriff
SocketIO war nicht stabil und verursachte Probleme
Alles geht jetzt über Redis
Object Kommunikation wird wieder OpenSource

Seit 29.07.20 ist objects-redis Open Source unter Apache 2.0 Lizenz.

[Mic]

@apollon77

Ich konnte jetzt nur durch einen Trick hier antworten (weiter oben vor dem Fehler bei einem Beitrag auf "Antwort" klicken. Siehe Thread: https://forum.iobroker.net/topic/35464/fehler-in-forum-thread-html-markdown-problem

Wäre damit nicht eine Idee ein "gulp" Dingens oder ein Skript zu schreiben was es erlaubt bestimmt "geschriebenes html" zu parsen und anzupassen?

An gulp dachte ich auch, wollte auch schon selbst was implementieren, aber dann schnell festgestellt, dass ich zu wenig/keine Erfahrung mit gulp hab und daher aus Zeitgründen verworfen.

Also sowas wie ein tag "translate" was als property die text-ID oder sowas hat und ggf. eine Notation "nicht zu übersetzende teile" zu markieren die dann auch behandelt werden.

Ja, genau, also index_m.html per gulp.

Beispiel, so etwas sollte halt dann übersetzt werden:

<td class="translate">
	Sobald der Wert vom Datenpunkt mit diesem Wert übereinstimmt, wird der Auslöser aktiviert. 
	<br>Du kannst <code>true</code>, <code>false</code>, Nummern wie <code>144</code>, or Strings wie <code>ABCDEF</code> verwenden. 
	<br>
	<br>Ebenso kannst du die Vergleichs-Operatoren <code>></code>, <code><</code>, <code>>=</code> und <code><=</code> vor Zahlen schreiben.
	<br>Um also auszulösen, wenn z.B. die Temperatur größer als 20°C ist, trägst du <code>>20</code> ein.
	<br>
	<br>Sämtliche Leerzeichen und Anführungszeichen (wie <code>"</code>) am Anfang und Ende werden automatisch entfernt.
</td>

Ausgangstext muss dann aber in Englisch sein, wobei auch als gulp-Option in Landessprache vorstellbar wäre...

Hierbei müssen ein paar HTML-Tags ignoriert werden, z.b. <code>. Satzteile formatiert (z.B. <bold> etc.) sollen übersetzt werden.
Evtl. noch eine "translate-ignore" CSS-Klasse für manche Teile (z.B. <span class="translate-ignore">Mich ignorieren</span>

Soweit die Idee

Dann kann man das initial einfach so schreiben und am Ende lässt man das Skript drüber rennen was diese Art von Sonder-Tags nimmt, in die transpation files einfügt und so ... Das text Polishing (De/en) ist denke immer mit dabei ... da kommt man nicht drum rum fürchte ich.

Das wäre super. Und klar, deutsch/englisch Anpassungen werden immer sein. Wobei man theoretisch auch die Quellsprache per gulp Option festlegen könnte.
Nachteil wäre aber: index_m.html enthält dann deutsche Texte (oder spanische, etc.), also nicht so schön zu pflegen für andere Entwickler.

Weitere Ideen?

[Garfonso]

@Mic
Das klingt nach einer super Lösung.

[apollon77]

@Mic Ich denke für die "nicht zu übersetzenden texte" müsste man sie erkennen, durch Platzhalter ersetzen die nicht übersetzt werden und dann nach der Übersetzung zurück-einsetzen. müsste man in entsprechende "Tags" einschliessen ...(zB wie Du in "code").

Aber auch wichtig für die erkennung wäre noch ein "<div>" aussen rum.

Also etwas wie
<td class="translate">
<div translation_id="meinCoolerText">....<code>do not translate</code>...</div>
</td>

... müsste man jetzt nur noch bauen

@ldittmar Schon nach dem Urlaub was vor? ;-)))

[Garfonso]

@apollon77 said in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

<div translation_id="meinCoolerText">

Wofür brauchst du die id dann noch? Ich hatte den Ansatz von @Mic so verstanden, dass er ja gerade das mit den IDs nicht mehr will und das im Grunde alles automatisch generiert werden soll -> das könnte ja dann die IDs direkt mit generieren, damit man da nicht wieder in das Problem läuft, dass IDs nicht gepflegt werden (nicht eindeutig, ungenutzt, blah).

Oder hab ich da was falsch verstanden / übersehen?

[apollon77]

@Garfonso Naja die Idee ist ja das Mapping zu Loca-IDs und damit das "auslagern in die words.js" zu automatisieren. ich kennen aktuell noch keinen sinnvollen Weg ohne dies. Bei einfachen texten geht es auch ihne indem der Text zum KEy wird, aber sobald das komplexer wird wird das ziemlich blöd finde ich ...

[AlCalzone]

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Bei einfachen texten geht es auch ihne indem der Text zum KEy wird, aber sobald das komplexer wird wird das ziemlich blöd finde ich ...

Die Fehlermeldungen vom TypeScript-Compiler werden beispielsweise genau so generiert.

[Mic]

Hi zusammen,

• Hier noch mal der initiale Beitrag von mir zu dieser Diskussion.
• Und hier der derzeitige Aufwand für Entwickler aus meiner Sichtweise.

@AlCalzone sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

@apollon77 sagte in Online Meeting für ioBroker Core/Dev/Admin 14.07.2020 20:30:

Bei einfachen texten geht es auch ihne indem der Text zum KEy wird, aber sobald das komplexer wird wird das ziemlich blöd finde ich ...

Die Fehlermeldungen vom TypeScript-Compiler werden beispielsweise genau so generiert.

Ich kenne jetzt die Übersetzungs-Funktionalität (Stichwort word.js) noch nicht wirklich, aber ich denke, der dafür zuständige Code müsste auch angepasst werden.

Wie auch immer:
So wie ich die JavaScript-Spezifikation verstehe, darf ein Objekt-Key (also der key bei {'key':'val'} ein beliebiges String beinhalten. Somit sind also keine Grenzen gesetzt. Lasse mich da gerne korrigieren
Damit ist es also egal, wie komplex das String ist, (Browser-)Performance mal außen vor.

Jetzt kann doch ein Script folgendes machen:

index_m.html per jQuery: alle Inhalte, die translate als Klassen-Zuweisung enthalten, per Loop durchlaufen:

1. Inhalte übersetzen und Ergebnis in Variable und dann Zieldatei.
   • Für Übersetzung: vorher definierte Tags zur Übersetzung ignorieren (z.B. <code>true</true> oder Text <span="non-translate">ioBroker<span> und einzelne Teile separat übersetzen.
   • Nach Übersetzung: ignorierte Bestandteile wieder in HTML-Variable hinzufügen
2. Ergebnis ab in die words.js:
   • hier dann auch bereinigen zum Schluss, d.h. unbenutzte Einträge löschen. Geht natürlich nur, wenn global verfügbar, welche Keys gesetzt wurden.

Falls das on-the-fly nicht möglich oder aus Browser-Performance-Gründen nicht sinnvoll, könnte man auch entsprechend komplilieren und "_min.xxx" Dateien generieren lassen, wie z.B. "words_min.js"

[apollon77]

@Mic Also ja natürlich kann man den beliebigen Text in die Words packen ... Dann bräuchte man beim zurückschreiben noch eine Erkennung das ein text schon übersetzt ist damit er nicht nochmal wird - und man muss sich selbst dran halten sowas nicht nochmal zu editieren sondern die words.js ab der initialen Übersetzung zu nutzen ... sonst landet der neue text beim nächsten "übersetzungslauf ausführen" unter dem neuen text nochmal drin und es entstehen doubletten und riiiesige words.js Files Daher meine Idee es durch ne unique ID zu ersetzen ... dann sieht man das gleich. geht aber bestimt auch anders.

Die Logik mit Übersetzung und so (geht ja nicht in words.js sondern in die translation files denke ich) ist glaube im gulp drin. Am Ende passt eine neue Logik denke da am besten hin. Also im gulp das html parsen, texte finden und "bearbeiten".

Ansonsten: einzelne Teile überstzen geht nicht wiel sonst der Satzaufbau komplett zerstört wird. Also man muss wirklich die nicht zu übersetzenden Teile rausholen und durch etwas ersetzen was er nicht übersetzt, und danach den ganzen Text mit den Platzhaltern übersetzen lassen und dann wieder die platzhalter zurück-einfügen