Upgrading docusaurus 2 to 3

The inventary of Roslyn Code Generators , https://ignatandrei.github.io/RSCG_Examples/v2/docs/List-of-RSCG , is https://docusaurus.io/ based.

In the process of re-making the documentation , I decided to upgrade from 2 to 3. I have created the new site with 3 and

1. transferred the documents

2. Modified docusarus config

Hints that I need :

1. The MDX parser is less forgiving ( e.g. invalid mdx in markdown header )

2. The plugin for local search ,  https://github.com/cmfcmf/docusaurus-search-local , do not work anymore. Found  https://github.com/praveenn77/docusaurus-lunr-search

3. If npm run build gives an error, then goto page and , usually, it says that page crashed. See Developer Tools in browser. It will indicate a line in COMPILED mdx . Go to line , see some text there and search in ORIGINAL mdx. Then search around and find the error.


Posted

in

by

Tags: