Use proper Sybil parsers

[hynek]

Continuing from #2

So @cjw296 I think this is what you had in mind? It doesn't seem to work and % also isn't a Markdown thing, but a MyST thing if I'm not wrong (I'm trying to sound constructively helpful, not entitled, sorry if I'm failing I'm still traveling).

But I guess I can wrap the % thing in <!-- --> tho if we can make it work.

[cjw296]

MD reminds me of MySQL in that respect: a billion different slightly incompatible forks ;-)
Does GFM have a way of specifying single-line comments?
This change was requested, does it just need to be a config option?

[cjw296]

Maybe just % skip: start to cut out the noise and move it down as you get things working?

[hynek]

I tried that but it didn't work either.

[cjw296]

Did you remove the % skip: next? I found a bug where a %skip: start followed by a % skip: next disables the % skip: start. I think that nesting should raise an exception so working on that.

[hynek]

Does GFM have a way of specifying single-line comments?
This change was requested, does it just need to be a config option?

I believe everyone just uses HTML comments: https://github.github.com/gfm/#example-648 – so the answer is no.

[cjw296]

Does GFM have a way of specifying single-line comments?
This change was requested, does it just need to be a config option?

I believe everyone just uses HTML comments: https://github.github.com/gfm/#example-648 – so the answer is no.

Yay! Consistency! I guess skip and other single line comment things on MyST also need to be expressable as:
<!-- skip: next -->?

[hynek]

Does GFM have a way of specifying single-line comments?
This change was requested, does it just need to be a config option?

I believe everyone just uses HTML comments: https://github.github.com/gfm/#example-648 – so the answer is no.

Yay! Consistency! I guess skip and other single line comment things on MyST also need to be expressable as: <!-- skip: next -->?

Yeah, this would be the best. I've solved it using:

<!--
; skip: next
-->

But

<!-- skip: next -->

would obviously be much nicer.

[hynek]

Big success, thank you!

[cjw296]

@hynek - so I'm chipping away at things from the Sybil side, I'm actually hoping to "officially" support GH flavoured markdown at some point, and I'd like you ask for your review on that PR if that's okay?

In the meantime, it looks like you're actually using MyST for the docs, can I just check that this commenting pattern works properly on MyST?

% skip: next

[hynek]

What PR do you mean? This one has been merged and Sybil doesn't have a PR that looks related.

I'm using % skip: next throughout and it's working.

[cjw296]

This PR ;-)
simplistix/sybil#99