executablebooks / rst2myst

Tools for converting RST files to MyST-NB files
4 stars 1 forks source link

[Discuss] A myst translator from Sphinx AST #3

Open mmcky opened 4 years ago

mmcky commented 4 years ago

An old idea was to build a sphinx translator that would build myst files to assist with migrating rst projects to myst.

The key issue with this approach is that the docutils parser is lossy and all the metadata is not easy to find and may be difficult to construct myst documents without a bit of work to re-assemble the metadata.

Would it be worth building a modified rst-parser to capture the metadata information and pass it through specifically for a myst builder/translator?