[Docs] Replace recommonmark with MyST parser

We used recommonmark so that we can use markdown in sphinx but it is
buggy and now so switch to better supported MyST-parser.

* Fixed incorrect heading warnings in markdown.
* Added sphinx toctree to markdown using directive as required by MyST.
* Upgraded Sphinx to 4.3

Ref: https://myst-parser.readthedocs.io
This commit is contained in:
Calum Lind 2021-12-12 15:29:41 +00:00
commit 24aa48187e
15 changed files with 80 additions and 55 deletions

View file

@ -4,7 +4,11 @@ A collection of guides for specific issues or to cover more detail than the tuto
## Web JSON-RPC
- [Connect to JSON-RPC using curl](curl-jsonrpc.md)
```{toctree}
:titlesonly:
Connect to JSON-RPC using curl <curl-jsonrpc>
```
## Plugins
@ -12,4 +16,8 @@ A collection of guides for specific issues or to cover more detail than the tuto
- [Create a plugin](create-plugin.md)
-->
- [Update 1.3 plugin for 2.0](update-1.3-plugin.md)
```{toctree}
:titlesonly:
Update 1.3 plugin for 2.0 <update-1.3-plugin>
```