Fix anchor tags in docs pages about ocfweb HOT 7 CLOSED

There doesn't seem to be a good syntax for adding anchors in any Markdown flavor :\

The closest is PHP Markdown Extra: https://michelf.ca/projects/php-markdown/extra/#spe-attr

Does this look like a reasonable syntax? Basically doing...

### 4.1.1.1 Date of Elections Meeting    {amended_321_1990}

alternatively something like this (in its own paragraph):

[[!anchor "amended_321_1990"]]

(similar to the meta syntax we adopted from ikiwiki)

from ocfweb.

So you have to extend the markdown parser to support this or...?

from ocfweb.

@nattofriends yes. or enable HTML, which I'd rather not just for this... (plus we can potentially export our constitution from markdown -> PDF or something if we want)

there seems to be no standard Markdown syntax for this :\

We already assign ids to headers like #h5_412-special-general-meetings but these are automatic based on the header name and might be easy to accidentally break, hence the desire for manually-named anchors.

from ocfweb.

Looks like a Mistune lexer would work well for this usage case, since we are essentially just adding a single rule so that anchor tags can be added. We are already using some in the markdown.py file, so you probably all knew this already. 😛

from ocfweb.

Yeah, mistune is pretty easy to extend. I was hoping we could at least find a commonly-used Markdown syntax rather than inventing our own again though, even if we have to extend mistune to support it :(

from ocfweb.

from ocfweb.

done in 4d27dda

from ocfweb.