Line numbers in code listings about swift-docc HOT 3 OPEN

@ethan-kusters that should probably also be in docc-render? I think it's relatively easy to do, too.

from swift-docc.

I'm taking a look ;) So the good news is CodeListing can show line numbers.

We just need to figure out how to best tell it to show line numbers, and what level of flexibility we want. If I read the code correctly, it looks for contentNode.showLineNumbers for contentNodes that are codeListing.

So hypothetically, we could do a few things here:

1. Add an option like @CodeListingsShowLineNumbers(true) or similar. Options are usually scoped to the current page / article, and it feels janky.
2. See if we can change how we parse the ``` code block syntax to accept something like ``` showLineNumbers, similar to https://rehype-pretty-code.netlify.app/ on a level of a specific code block. That will be more involved, likely require some hacking in swift-markdown, BUT that will allow others to use that, too.
3. Make site-wide setting and pass it in an env variable or a build flag. That's probably a crappy option because those are obscure, and it will be difficult to document.

I feel like option 2 is what's generally expected with markdown-base documentation systems.

from swift-docc.

Would this be a good second issue for me to take a look at? I'm trying to learn more about this code base and would love to have something to do while I'm waiting on feedback from my pull request.

Admittedly, I'm probably going to need some guidence with attacking this issue, but I'm eager to give it my best shot. 😀

from swift-docc.