maplibre / maputnik

An open source visual editor for the 'MapLibre Style Specification'
https://www.maplibre.org/maputnik
MIT License
2.02k stars 380 forks source link

add README-ZH.md #883

Closed jadelike-wine closed 4 months ago

jadelike-wine commented 4 months ago

add chinese readme file

HarelM commented 4 months ago

While i think this is a great addition my main concern is about maintainence. I won't be able to update the Chinese readme and I'm concerned it might drift off.

jadelike-wine commented 4 months ago

While i think this is a great addition my main concern is about maintainence. I won't be able to update the Chinese readme and I'm concerned it might drift off.

Thank you for your feedback. I understand your concern about maintenance. I would like to assure you that I am committed to regularly maintaining the Chinese documentation.

My company plans to use this GitHub project in the near future and is committed to maintaining and further developing the project. As part of our adoption process, we are committed to maintaining documentation in Chinese to ensure that it remains accurate and up-to-date.

We have a team of developers and technical writers who are proficient in both English and Chinese. We will be regularly reviewing and updating the Chinese documentation to reflect any changes to the project.

We believe that providing high-quality documentation in multiple languages is essential for a successful open source project.

We appreciate your understanding and support.

nyurik commented 4 months ago

Thx, I would love to have translated documentation, but I think the documentation is different from the Readme. Perhaps we should setup a mdbook in multiple languages?

sharkAndshark commented 4 months ago

Like the mdbook idea. I find it's difficult to introduce this tool to my ArcGIS friends. Maybe a nice book could help them.

HarelM commented 4 months ago

In maplibre-gl-js we are using mkdocs material, which works great, it also allowed embedding JavaScript if needed. From a short googling it seems like mdbook still doesn't support multi language, but I might be wrong, mkdocs does seem to support it: https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/

https://github.com/rust-lang/mdBook/issues/5

I haven't tested multiple languages support in either, and in general, both are using markdown, so hopefully we will be able to change it as needed.

nyurik commented 4 months ago

Comprehensive Rust used .po files (info) - seems interesting (they actually mentioned it in the link you gave here), but this is a JS project, so if mkdocs works well - lets do that. @jadelike-wine would you be interested in starting that translation effort / setting up a doc site / help with translation there? Thx!

sharkAndshark commented 4 months ago

I'd love to help review the translation. I think my Chinese is not bad lolll

jadelike-wine commented 4 months ago

Comprehensive Rust used .po files (info) - seems interesting (they actually mentioned it in the link you gave here), but this is a JS project, so if mkdocs works well - lets do that. @jadelike-wine would you be interested in starting that translation effort / setting up a doc site / help with translation there? Thx!

Ok, let me try to create a Mkdocs。we can do like this picture(https://squidfunk.github.io/mkdocs-material/assets/screenshots/language-selection.png)