Converted all markdown files in doc dir into asciidoc format

[ciampix]

Converted all documentation files present in the docs directory from markdown format into asciidoc format for improving future maintenance.

[vercel[bot]]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/kantord/libre-lingo/7bWc9BbfdyPcr1QL83FUCm1Hg9z7
✅ Preview: Failed

[Deployment for 0d277b2 failed]

[kantord]

Hi @ciampix ! 👋

Thanks. I created a pull request in your fork with some updates: https://github.com/ciampix/LibreLingo/pull/1

This installs antora and partially fixes the file structure so that it works, however several things are broken.

You can try it by running

yarn install - to update the dependencies, since I installed some new ones yarn workspace docs start - this should start a local server of the documentation site. Careful, because it does not update automatically, so if you make changes, you need to restart the server each time.

Or you can simply run yarn workspace docs build to build the latest version of the docs site, and open it in your browsers.

This should be enough to demo what antora is capable of. Based on the antora documentation, you should be able to fix the rest of the files and navigation & structure things properly.

[ciampix]

I finally made it to enable mermaid flowchart. There is a bug in the asciidoctor-kroki library that prevents the flowchart to be click-able unless you open it (the single image) in a different browser window. Hope that they fix it soon... Now I can see to the rest of main page that is still to the default.

[kantord]

I finally made it to enable mermaid flowchart. There is a bug in the asciidoctor-kroki library that prevents the flowchart to be click-able unless you open it (the single image) in a different browser window. Hope that they fix it soon... Now I can see to the rest of main page that is still to the default.

amazing! do you have an issue to track that in asciidoctor-kroki?

btws, I think there has been new documentation merged to main since this PR was started. Will you be able re-generate the files? If not, I can figure it out for you what the exact changes were and we can add it manually

[sonarqubecloud[bot]]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[kantord]

Hi @ciampix !

do you have any news on this? Can I help you somehow now?

[ciampix]

You sadly did well 'cause I do have not enough time to follow this and it seems pretty unuseful or not that much useful anyway since md is very similar to asciidoc.