7 ms·
The author claims that RST is nice because it's extensible, but as someone who's written some Sphinx extensions, I can tell you that extending RST is not as ple
by asmeurer 2y ago
The author claims that RST is nice because it's extensible, but as someone who's written some Sphinx extensions, I can tell you that extending RST is not as pleasant of a task as the author makes it out to be. I don't really know what it's like in Markdown world, but the underlying tools (Sphinx and docutils) are very difficult to work with, and make many implicit assumptions that make certain things difficult or impossible.
- romanovcode 2y agoI think author should write HTML if they want extensibility so much. Not like RST is reading-friendly to begin with.
- ideasman42 2y agoKeep in mind you might not _only_ be exporting HTML.
- ideasman42 2y agoI've written a few Sphinx extensions ... it seemed OK to me, a bit awkward but long term - this is the kind of thing you do rarely & use often, so how nice it is to write extensions is barely an issue.