I have already seen that. That paging is lacking exactly the detailed information about the extensions. Scroll to the extensions section on that page. In addition to the Blackfriday options (those are documented), there are about a dozen extensions, which are not documented.
User does not know which extensions are enabled by default, what case-sensitive name to use to enable/disable.
I am working on an Emacs Org-mode package and in the process I needed to do some digging about Blackfriday extensions as the official docs do not have any info.
I dug through the following sources to finally get this.
Figuring out the case-sensitive names used by Hugo and which extensions are enabled by default – Hugo content.go.
But that was incomplete, so getting decriptions for those extensions, part 2 – blackfriday markdown.go
But even that is incomplete. So if you look at the above link to my ox-hugo.el, you will find «Needs more information», which I still need to completely understand what that extension does.
@kaushalmodi As an FYI, the config options are mentioned in more than one place in the documentation, so I created a simple readfile so we weren’t updating in multiple places. This was before .GetPage.
I am already aware of the blackfriday options. There’s a difference between blackfriday options and blackfriday extensions. The extensions need to be documented.
No, I didn’t miss it. If I don’t read a thread, I usually start with “Sorry I’m too late to this thread to read everything above, but…”
I’m sending you in the right direction in the source per @bep 's suggestion to make a PR and make changes to documentation if we are missing something. I wanted to save you the step of wondering where this documentation/content lives rather than going directly to a different markdown file. HTH
I already knew about that (link). I just felt that I don’t have enough authority to update the documentation myself as I don’t know Go. But in any case, I’ll go ahead and work on a PR. As you seen in that link, if you search for “Needs more” in your browser, there are few places I don’t know what to document as I would need to reverse engineer the blackfriday extension code to figure that out.
Well, the hugo repo version has the new option smartypantsQuotesNBSP documented while the hugoDocs repo version does not. Should I still provide hugoDocs PR?
Or is hugoDocs only for released hugo versions, while the docs/ dir in hugo updates to the master?
“That (link)” isn’t the link I gave you. We moved to a GitHub org a couple months ago and broke out the docs and theme as separate repos. But yes, the docs are still part of the download of the single binary.
This was another reason why I was hoping to save you some time by pointing you directly to that quasi-data/readfile for all things BF in the docs if you wanted to kindly help us improve the documentation