enhancement
major
defect
major
minor
minor
#29699
TL-Script: htmlText(htmlSource($text), images) lässt die Bilder eines gespeicherten strukturierten Textes weg, da es die von ihm selbst geschriebenen „ref:“-Verweise nicht akzeptiert.
Problem
htmlText(html, images) (#29683, HtmlFunctions.text) speichert ein <img src="name">, das eines der angegebenen Bilder als Bildreferenz <img src="ref:name"> benennt. htmlSource(text) (HtmlFunctions.source) gibt diesen gespeicherten Quelltext unverändert zurück, einschließlich der Referenz.
Ein Skript, das einen gespeicherten Text umschreibt (dessen Quelltext liest, ihn ändert und mit denselben Bildern zurückschreibt), ruft daher
htmlText($changed, images: $attachments)
mit einer Quelle auf, deren Bildelemente src="ref:name" enthalten. text() gleicht die src-Werte nur mit den reinen Namen der angegebenen Bilder ab, sodass auf keines davon verwiesen wird: Alle Bilder werden entfernt, und die Elemente verweisen weiterhin auf ref:name-Referenzen, die der neue strukturierte Text nicht enthält. Der zurückgeschriebene Text zeigt keine Bilder an.
Beobachtet in der TL-Entwicklungs-App (Snapshot-Build 43): Der dritte Durchlauf der Trac-Synchronisierung schreibt gespeicherte Ticketbeschreibungen und Kommentare (Querverweise) über `htmlText(…, images: …)` neu. Sie muss vor dem Aufruf jedes `src="ref:` wieder in `src="` umwandeln, sonst gehen die in Durchlauf 1 synchronisierten Bilder verloren.
Erwartet
htmlText(source, images) akzeptiert ein src="ref:name" als Verweis auf den angegebenen Bildnamen genau wie src="name", sodass htmlText(htmlSource($t), images) einen gespeicherten strukturierten Text hin- und zurücksynchronisiert. (Es gibt auch keine Funktion, die die Bilder eines strukturierten Textes zurückgibt, z. B. `htmlImages($t)`; mit einer solchen könnte ein Skript eine geänderte Quelle mit den text-eigenen Bildern zurückschreiben, anstatt diese neu zusammenzustellen.)
Lösung
htmlText(source, images) akzeptiert Bildverweise: Ein <img src="ref:name"> verweist wie <img src="name"> auf das angegebene Bild „name“; das Bild bleibt erhalten, das Element behält den Verweis. Ein ref:-Verweis auf ein nicht angegebenes Bild bleibt unverändert. Die Änderung befindet sich in I18NStructuredTextUtil.linkImageSources und gilt somit auch für den Dokumentationsimport (ImportCommand).
Neue TL-Script-Funktion htmlImages(text) (HtmlFunctions.images): liefert die Bilder eines strukturierten Textes als Dictionary Name → Binärwert (leer für einen Text ohne Bilder). Damit lässt sich ein gespeicherter Text geändert zurückschreiben:
htmlText(htmlSource($text) ..., images: htmlImages($text))
Test
- test.com.top_logic.layout.wysiwyg.ui.TestHtmlFunctions, TestHtmlFunctionsScript