First preliminary release published

[ilg-ul]

The first preliminary version of this plugin was published and successfully used in a real project.

For those who do not know, Docusaurus is a modern solution to build documentation sites.

Doxygen is the de-facto industry standard reference pages generator for C/C++ (and other).

The docusaurus-plugin-doxygen bridges the gap between the two, by allowing to integrate the Doxygen reference pages into Docusaurus sites.

This is possible because Doxygen also generates the output as XML files; they are parsed by the plugin and the content rendered as MDX files (a markdown format extended with React components).

The current status of this plugin is early preview, allowing you to take a look and hopefully provide some feedback.

• https://micro-os-plus.github.io/micro-test-plus-xpack/docs/api/

The project home page is:

• https://micro-os-plus.github.io/micro-test-plus-xpack/

For a comparison, the original Doxygen pages, rendered via the nice doxygen-awesome-css plugin, are:

• https://micro-os-plus.github.io/micro-test-plus-xpack/doxygen/topics.html

The Docusaurus generated files are (see the raw files):

• https://github.com/micro-os-plus/micro-test-plus-xpack/tree/xpack-development/website/docs/api

Many thanks to:

• @doxygen, @albert-github - for the Doxygen project
• @jothepro, for the doxygen-awesome-css project, used as an inspiration for the CSSs and generally for the nice look
• @tgreyuk, for the typedoc-plugin-markdown, which is a similar plugin for TypeScript

Any feedback will be highly appreciated!

[ilg-ul]

I believe I have implemented all the functionality I had planned for the initial version, including index pages.

At present, I have two projects utilising this solution:

• https://micro-os-plus.github.io/micro-test-plus-xpack/docs/api/
• https://micro-os-plus.github.io/utils-lists-xpack/docs/api/

I also have a third, larger project that I intend to update in the coming days.

@doxygen, @albert-github, do you have any thoughts on this project? I would greatly appreciate any suggestions, particularly regarding the structure of the pages, the sidebar, etc, but any other feedback will also be highly appreciated.