Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace Docusaurus with Mkdocs #330

Closed
MaudSimon opened this issue Apr 3, 2024 · 7 comments
Closed

Replace Docusaurus with Mkdocs #330

MaudSimon opened this issue Apr 3, 2024 · 7 comments

Comments

@MaudSimon
Copy link
Member

Recommendation from @Chainrocker:

MkDocs-Material might be an alternative. It supports 60 languages and there's a way to run multiple languages simultaneously through a plugin.

https://squidfunk.github.io/mkdocs-material

https://squidfunk.github.io/mkdocs-material/discussions/2346

https://github.com/ultrabug/mkdocs-static-i18n

@mvaivre @nop33 when we have the bandwidth to pick up this discussion.

@Chainrocker
Copy link

Chainrocker commented Apr 23, 2024

Here is a demo of the Mkdocs version

Alephium Docs - Demo

@nop33
Copy link
Member

nop33 commented Apr 24, 2024

Hello! Thanks for the demo!

MkDocs-Material might be an alternative

What is the reason for suggesting an alternative? Is our current solution (https://docusaurus.io/) lacking something?

@Chainrocker
Copy link

Chainrocker commented Apr 24, 2024

The reason for the suggestion is that Docusaurus apparently struggles with multilingual support. That's why I proposed MkDocs-material as an alternative.

@nop33
Copy link
Member

nop33 commented Apr 24, 2024

Thanks for the reply! Hm, I am curious to know what the struggle with Docusaurus is and how MkDocs solves it!

@MaudSimon
Copy link
Member Author

MaudSimon commented Apr 24, 2024

@nop33 @Chainrocker we discussed the issue here: #209

@MaudSimon
Copy link
Member Author

@Chainrocker Does MkDocs solves the limitation of Docusaurus layed out in #209 ? How so ?

@nop33 nop33 changed the title Manage translation Replace Docusaurus with Mkdocs Jun 13, 2024
@nop33
Copy link
Member

nop33 commented Jun 20, 2024

Closing this issue since we are happy with the Docusaurus integration into our Crowdin project. Anyone who wants to help us translate the docs can do it here! https://translate.alephium.org/

@nop33 nop33 closed this as completed Jun 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants