Évolution sur les conversions HTML/Markdown
Une évolution pouvant impacter l'affichage des description longues sur les sites synchronisés aura lieu le 28 octobre prochain.
Qui est concerné?
Les sites reprenant via l'API OpenAgenda les variantes HTML de la description longue (en utilisant l'option longDescriptionFormat documentée ici)
Nature de l'évolution
Sur OpenAgenda, les description longues sont enregistrées au format Markdown: l'évolution concerne la manière dont les retours à la ligne sont convertis vers le format HTML.
Actuellement, un retour à la ligne saisi dans le formulaire OpenAgenda marque la séparation entre le paragraphe en cours et le suivant soit deux balises <p> successives sur la variante HTML.
Mais en pratique, nous constatons régulièrement l'usage de deux retours à la ligne successifs pour mieux marquer une séparation entre deux sections de textes ce qui a pour conséquence l'apparition de paragraphes vides dans la variante HTML de la description.
L'évolution propose de prendre en compte cette pratique et d'utiliser une balise <br> pour les retours à la ligne simples et de ne marquer la séparation entre deux paragraphes que par les retours à la ligne doubles.
Impact
Il est à priori minime, l'affichage de balises <br> étant généralement géré par défaut. Il sera utile de vérifier le bon espacement entre paragraphes une fois que les balises <p> vides auront été remplacées par des paragraphes simples incluant des <br>.
Qui est concerné?
Les sites reprenant via l'API OpenAgenda les variantes HTML de la description longue (en utilisant l'option longDescriptionFormat documentée ici)
Nature de l'évolution
Sur OpenAgenda, les description longues sont enregistrées au format Markdown: l'évolution concerne la manière dont les retours à la ligne sont convertis vers le format HTML.
Actuellement, un retour à la ligne saisi dans le formulaire OpenAgenda marque la séparation entre le paragraphe en cours et le suivant soit deux balises <p> successives sur la variante HTML.
Mais en pratique, nous constatons régulièrement l'usage de deux retours à la ligne successifs pour mieux marquer une séparation entre deux sections de textes ce qui a pour conséquence l'apparition de paragraphes vides dans la variante HTML de la description.
L'évolution propose de prendre en compte cette pratique et d'utiliser une balise <br> pour les retours à la ligne simples et de ne marquer la séparation entre deux paragraphes que par les retours à la ligne doubles.
Impact
Il est à priori minime, l'affichage de balises <br> étant généralement géré par défaut. Il sera utile de vérifier le bon espacement entre paragraphes une fois que les balises <p> vides auront été remplacées par des paragraphes simples incluant des <br>.
Mis à jour le : 11/10/2024
Merci !