gpac / wiki

GPAC's wiki, the entrypoint to MP4Box and GPAC documentation.
https://wiki.gpac.io
GNU Lesser General Public License v2.1
0 stars 3 forks source link

fix formatting of the dasher filter page #2

Closed rbouqueau closed 2 months ago

rbouqueau commented 5 months ago

https://wiki.gpac.io/Filters/dasher/

It explicitely displays a star ('*'). It also seems that some list items are in italic while some others aren't.

image

nlsdvl commented 3 months ago

@rbouqueau I confirm this behavior is not specific to the dasher page.

The problem with lists is mostly due to new lines not being rendered as hard breaks. As a result, rendering of the list is not triggered, and asterisks are understood as italic/em by the mardown parser.

This doesn't render a list as expected:

lorem ipsum:
* item1
* item2
* item3

while this does:

lorem ipsum:

* item1
* item2
* item3

There's an extension to python markdown that offers this behavior: nl2br. I gave it a try without luck so far. While is not listed by materials for mkdocs as a supported extension.

Looking for an explanation and a solution on the parser/renderer :

There is also another issue with lists in the documentation, nested lists: Often there will be nested lists, for instance here

And it seems these aren't rendered as nested, neither on the new wiki, nor on the old one. In that case the markdown content needs to be fixed.