Documenteer logo kiezen, bewaren en delen per platform #2643

New issue

Closed

opened 2026-10-28 22:42:47 +00:00 by brenno · 2 comments

brenno commented

2026-10-28 22:42:47 +00:00

Owner

Probleem

De gebruikershandleidingen beschrijven onder Een documentstijl maken het kiezen van een presentatie- en afwijkend documentlogo met een bestandskiezer alsof dit op alle platforms kan (docs/USER_GUIDE.nl.md rond 5819–5830; docs/USER_GUIDE.md overeenkomstige sectie). In de webversie ontbreken deze knoppen bewust (settings_dialog.dart en de stijl-editor). De handleidingen melden elders wel dat een geïmporteerd logo in de browser verdwijnt na herladen, maar verbinden dat niet aan het ontbreken van de logokiezer of aan de keuze van opslagformaat. Dat verklaart de melding achter #2640. De formatuitleg voor .ocideckstyle is uitgebreider en hoeft geen apart ticket.

Gewenst gedrag

Een gebruiker kan vóór het bewerken of delen begrijpen welke logo's op desktop en web gekozen kunnen worden, hoe een logo via stijlimport op web terechtkomt, wanneer het tijdelijk is en welke export de afbeeldingsbytes bewaart. De uitleg mag de afzonderlijke opslagfouten #2641 (documentlogo) en #2642 (donker logo in Markdown-project) niet als reeds werkend voorstellen.

Aanpak

Werk de Nederlandse en Engelse gebruikershandleiding gelijk op bij de stijl-editor en de sectie over een stijlprofiel delen. Beschrijf de huidige webbeperking en de bestaande .ocideckstyle-importroute met sessielevensduur. Na reparatie van #2640: vervang de beperking door de werkelijke browserroute.
Leg kort het verschil uit tussen een gewoon Markdown-project, een .ocideck-pakket en een .ocideckstyle-bestand voor de logoafbeelding, en verwijs naar de bestaande bestandsformaatsectie waar de details staan.
Controleer claims over afwijkende document- en donkere logo's tegen de gerepareerde code van #2641/#2642. Vermeld vóór die reparatie geen ongeclausuleerde garantie dat die beelden meereizen.

Acceptatiecriteria

NL en EN beschrijven dezelfde, feitelijk geteste knoppen en beperkingen voor desktop en web; de bestaande route voor een geïmporteerd webstijllogo is vindbaar vanuit de stijl-editoruitleg.
Een lezer weet welk bestand de afbeeldingsbytes bevat en dat browsergeheugen na herladen verloren kan gaan.
Voorbeelden en verwijzingen in USER_GUIDE en FILE_FORMAT spreken elkaar niet tegen; documentatievalidatie en linkcontrole blijven groen.

Gerelateerd: #2640, #2641, #2642.

## Probleem De gebruikershandleidingen beschrijven onder *Een documentstijl maken* het kiezen van een presentatie- en afwijkend documentlogo met een bestandskiezer alsof dit op alle platforms kan (`docs/USER_GUIDE.nl.md` rond 5819–5830; `docs/USER_GUIDE.md` overeenkomstige sectie). In de webversie ontbreken deze knoppen bewust (`settings_dialog.dart` en de stijl-editor). De handleidingen melden elders wel dat een geïmporteerd logo in de browser verdwijnt na herladen, maar verbinden dat niet aan het ontbreken van de logokiezer of aan de keuze van opslagformaat. Dat verklaart de melding achter #2640. De formatuitleg voor `.ocideckstyle` is uitgebreider en hoeft geen apart ticket. ## Gewenst gedrag Een gebruiker kan vóór het bewerken of delen begrijpen welke logo's op desktop en web gekozen kunnen worden, hoe een logo via stijlimport op web terechtkomt, wanneer het tijdelijk is en welke export de afbeeldingsbytes bewaart. De uitleg mag de afzonderlijke opslagfouten #2641 (documentlogo) en #2642 (donker logo in Markdown-project) niet als reeds werkend voorstellen. ## Aanpak - Werk de Nederlandse en Engelse gebruikershandleiding gelijk op bij de stijl-editor en de sectie over een stijlprofiel delen. Beschrijf de huidige webbeperking en de bestaande `.ocideckstyle`-importroute met sessielevensduur. Na reparatie van #2640: vervang de beperking door de werkelijke browserroute. - Leg kort het verschil uit tussen een gewoon Markdown-project, een `.ocideck`-pakket en een `.ocideckstyle`-bestand voor de logoafbeelding, en verwijs naar de bestaande bestandsformaatsectie waar de details staan. - Controleer claims over afwijkende document- en donkere logo's tegen de gerepareerde code van #2641/#2642. Vermeld vóór die reparatie geen ongeclausuleerde garantie dat die beelden meereizen. ## Acceptatiecriteria - NL en EN beschrijven dezelfde, feitelijk geteste knoppen en beperkingen voor desktop en web; de bestaande route voor een geïmporteerd webstijllogo is vindbaar vanuit de stijl-editoruitleg. - Een lezer weet welk bestand de afbeeldingsbytes bevat en dat browsergeheugen na herladen verloren kan gaan. - Voorbeelden en verwijzingen in USER_GUIDE en FILE_FORMAT spreken elkaar niet tegen; documentatievalidatie en linkcontrole blijven groen. Gerelateerd: #2640, #2641, #2642.

brenno added the

accepted

docs

labels

2026-10-28 22:42:47 +00:00

brenno referenced this issue

2026-10-28 22:54:14 +00:00

Pakket bevat stijlbestanden maar OciDeck opent met lokaal actief profiel #2644

brenno added the

in-progress

label

2026-10-28 23:35:16 +00:00

brenno commented

2026-10-28 23:35:16 +00:00

Author

Owner

Opgepakt. Tak: fix/logo-stijl-2640. Verwachte reikwijdte: USER_GUIDE nl+en over logo kiezen, bewaren en delen.

brenno referenced this issue from a commit

2026-10-29 01:45:36 +00:00

docs: zeg waar een stijl wel en niet mee reist (#2643 #2651)

brenno referenced this issue from a pull request that will close it,

2026-10-29 01:45:49 +00:00

fix: stijl reist mee naast de markdown (#2640) #2655

brenno closed this issue

2026-10-29 01:51:49 +00:00

brenno commented

2026-10-29 01:52:38 +00:00

Author

Owner

Geland op main in 978b199646. De handleiding beschrijft de browserroute en het verschil tussen een markdown-project, een .ocideck en een .ocideckstyle.

Geland op main in 978b199646c1c834b2bf348c30214ecce370898a. De handleiding beschrijft de browserroute en het verschil tussen een markdown-project, een .ocideck en een .ocideckstyle.