Translate the docs to english

[ArgoZhang]

Is your feature request related to a problem? Please describe.

translate the docs to english

Describe the solution you'd like

• open json file in to ~/BootstrapBlazor.Shared/Locales
• update the docs under ~/BootstrapBlazor.Shared/Pages folder content

Additional context

• [x] Alerts
• [X] Anchors
• [x] AutoCompletes
• [x] Avatars
• [x] Badges
• [x] BarcodeReaders
• [x] Breadcrumbs
• [x] Buttons
• [x] Calendars
• [x] Cameras
• [x] Capthcas
• [x] Cards
• [x] Carousels
• [x] CheckboxLists
• [x] Checkboxs
• [x] Circles
• [x] Collapses
• [x] Coms
• [x] Consoles

[ArgoZhang]

@pomeara hi, could you join this work?

[georgeemr]

Hi, this can be perfect, I try to implement the library but it's too complicated with no English documentation. I was looking for a blazor bootstrap 4 library and as far I can found this is the most complete.

[ArgoZhang]

@georgeemr hi，thank you for replay. could you join us for the translate work?

[georgeemr]

Hi @ArgoZhang , sure, I will fork the project and do it in my free time. English is not my primary language but I will try it.

[ArgoZhang]

@georgeemr thank you for reply. translate work is a huge work. maybe we should redesign the docs system. do you have any suggestion?

[pomeara]

@ArgoZhang hey let me know when you need some English translation assistance, I am happy to help out as usual

[ArgoZhang]

@pomeara thanks. the docs need follow this

• open json file in to ~/BootstrapBlazor.Shared/Locales
• update the docs under ~/BootstrapBlazor.Shared/Pages/Samples folder content

[pomeara]

@ArgoZhang are we using .resx files for the translations, this appears to be the best practice from MS for .net apps

[ArgoZhang]

@pomeara i'm very sorry for that this project use json resource file. but it support .resx format. cause by my environment is on mac. so can't edit .resx format file. json is better

[densen2014]

Already translated:

1. BootstrapBlazor.Shared.Pages.Components.AttributeTable
2. BootstrapBlazor.Shared.Common.AttributeItem
3. BootstrapBlazor.Shared.Shared.ComponentLayout
4. BootstrapBlazor.Shared.Pages.QRCodes
5. BootstrapBlazor.Shared.Pages.Components.MethodTable
6. BootstrapBlazor.Shared.Common.EventItem
7. BootstrapBlazor.Shared.Common.MethodItem

[pomeara]

@densen2014 great stuff, @ArgoZhang I start a mini break for two weeks from tomorrow so I will have some time to help out then

[densen2014]

@pomeara Nice to meet you, i am chinese, vivo en madrid , ;->

[ArgoZhang]

@pomeara great! @densen2014 thanks for you contribution

[ahmetkocadogan]

I can help to translate to Turkish language if you like but i need an English version for that.

[ArgoZhang]

@ahmetkocadogan that's great! the English version resource is ready. you can check it out from https://github.com/dotnetcore/BootstrapBlazor/blob/main/src/BootstrapBlazor/Locales/en.json

[DominicSaladin]

@ahmetkocadogan that's great! the English version resource is ready. you can check it out from https://github.com/dotnetcore/BootstrapBlazor/blob/main/src/BootstrapBlazor/Locales/en.json

Is that the correct link? And what is that for: https://github.com/dotnetcore/BootstrapBlazor/blob/main/src/BootstrapBlazor.Shared/Locales/en.json

Do you need any help with translating at the moment?

[DominicSaladin]

@ArgoZhang Also, is there a reason why the complete code documentation is in chinese and not in english?

Is it planned to change this to english in the future?

[DominicSaladin]

@ArgoZhang Would be nice to know :)

[ArgoZhang]

@ArgoZhang Also, is there a reason why the complete code documentation is in chinese and not in english?

Is it planned to change this to english in the future?

sorry for the delayed reply. this is need help too.

[pomeara]

@ArgoZhang pull translations from here https://github.com/pomeara/BootstrapBlazor/commit/c287e5a3eec7ea0ec899bfee9dacb5256478a359

[pomeara]

@ArgoZhang please get many commits from here all for the translations

@ArgoZhang I moved it into a branch - https://github.com/pomeara/BootstrapBlazor/tree/translations

[ArgoZhang]

@pomeara it's cool. great works. thank you very much. I merged it into my repo. later will release

[pomeara]

@ArgoZhang please grab some more translations from the same branch

[ArgoZhang]

@pomeara Great! thank you very much.

BTW: delete the branch after I merged and recreating a branch is better

[pomeara]

@ArgoZhang more translations (in a new branch)

https://github.com/pomeara/BootstrapBlazor/tree/new-translations

[ArgoZhang]

@pomeara great job thank you very very much

BTW: better steps

1. delete the branch after merged
2. sync repo from https://github.com/dotnetcore/BootstrapBlazor
3. create a new branch from main branch

[pomeara]

@ArgoZhang please grab this branch also https://github.com/pomeara/BootstrapBlazor/tree/translations-2

i did the 3 steps you mentioned also

Please check you got this branch also https://github.com/pomeara/BootstrapBlazor/tree/new-translations

I think the translations are now complete - let me know if you see any thing missing

[ArgoZhang]

@pomeara Thank you very much for your work. I think maybe my expression is wrong. the branch translations-2 can't be merged into the main because of too many conflicts.

I notice that you merge the Main branch into your translations-2. it's a bad idea.

https://github.com/pomeara/BootstrapBlazor/commit/76706d78e29bc2751e66654c0b61de7c07da4790

the better step is

1. delete branch translations-2
2. create a new branch from main (sync bootstrapblazor main branch) named 'doc-trans'
3. update the docs

BTW: you can invite me. I can fix it in your repo

[pomeara]

@ArgoZhang I added you to the repo please work your magic would love to see all the translations make it into the master

[ArgoZhang]

@pomeara done! thank you for doing this work again. it's very cool.