qwik icon indicating copy to clipboard operation
qwik copied to clipboard

[DOCS] docs localization ko-kr

Open Lutece opened this issue 2 years ago • 16 comments

How can the documentation be improved?

it would be appreciated, if i could translate Qwik document korean. May i start it?

Lutece avatar Sep 21 '22 11:09 Lutece

Thanks a lot @Lutece ! we'll greatly appreciate it

@adamdbradley is there a way to add more languages currently to the docs?

shairez avatar Sep 22 '22 08:09 shairez

If I can do my small part, I would also like to do the French translation.

If you look closely, it is quite easy to duplicate the mdx and md files to translate them into another language. So the routing should allow afterwards to partition each language.

The most complex point for me is that you need a tool to translate the English texts in the tsx files. qwik-speak seems to be able to answer this problem, but is it mature enough? Is it the only solution? Also a issue is currently under discussion: i18n at compile time.

@robisim74 any opinion on this ?

forresst avatar Sep 22 '22 08:09 forresst

@forresst qwik-speak is an unofficial project. I don't think it can be used for official Qwik documentation.

robisim74 avatar Sep 22 '22 10:09 robisim74

@shairez Thanks a lot! :)

Would you please let me know which repository or directory I could commence translation?

I found this one: qwik/packages/docs/ , tried to execute it but couldn't.

Please let me know how to start this proejct Thank you!

Lutece avatar Sep 23 '22 08:09 Lutece

i solve this problem. and i can start to translate this document now :) Thanks a lot~!

Lutece avatar Sep 27 '22 11:09 Lutece

@Lutece mind sharing how you solved it? (for other people who'll look for translations)

shairez avatar Sep 29 '22 17:09 shairez

@shairez I changed my mac machine m1 to intel chip. this an issue with Wasm-Pack and not supporting AppleM1 chips https://github.com/rustwasm/wasm-pack/issues/1169

Lutece avatar Oct 02 '22 12:10 Lutece

@shairez finally, i started to translate Qwik Document! and i made a korean domain (https://qwik.kr) (https://github.com/f-lab-tech/qwik.kr)

if i finish to translate, i'll notify in this comment and mention you

Lutece avatar Oct 02 '22 12:10 Lutece

Thanks a lot @Lutece ! 👏👏

I think it would be valuable to add a sub-domain / subfolder for all the translations (instead of buying a domain for each translation)

WDYT @adamdbradley ?

shairez avatar Oct 03 '22 00:10 shairez

@shairez great idea~! Let me know when i can add the translation to the subdomain

Lutece avatar Oct 03 '22 02:10 Lutece

@adamdbradley .. found this - https://crowdin.com/pricing#annual

looks free for public projects

shairez avatar Oct 03 '22 21:10 shairez

There is currently a study to manage the localization. #1594

For the future, this may be useful:

  • Russian: https://github.com/Craiqser/qwik-docs-ru. This is the documentation package of the qwik repository. Russian translation is done for both Qwik and QwikCity, @Craiqser synchronize it periodically.
  • French: https://github.com/forresst/qwik-docs-fr. This is the documentation package of the qwik repository. French translation is done for Qwik, QwikCity and Tutorial. @forresst synchronize it periodically.

forresst avatar Oct 29 '22 06:10 forresst

Translation of Traditional Chinese is on its way too! and i made a Taiwan domain (https://qwik.tw/) (https://github.com/kai890707/qwik.tw)

We hope to help the QWIK Chinese community progress together! :D

kai890707 avatar Oct 29 '22 15:10 kai890707

Sorry , I have a question about doc index page. I want to modify the component on the main page of the document, but I found that the html of the page is obtained by using the api and I can't modify it directly. Will this part be open for modification in the future?

kai890707 avatar Oct 29 '22 16:10 kai890707

I'm available to help to translate to Portuguese as well.

keuller avatar Nov 04 '22 09:11 keuller

Is anyone preparing a translation in simplified Chinese? I would like to be involved in it.

jonsam-ng avatar Dec 03 '22 06:12 jonsam-ng

Is anyone preparing a translation in simplified Chinese? I would like to be involved in it.

https://github.com/cunzaizhuyi/qwik simplified Chinese

cunzaizhuyi avatar Mar 08 '23 10:03 cunzaizhuyi

@shairez do you have any news about that?

gioboa avatar Dec 28 '23 21:12 gioboa

I close this issue b/c it's stale. If we want we can continue the discussion on Discord.

gioboa avatar Jan 24 '24 21:01 gioboa