The doc is not clear

Question

The doc is not clear

Closed this issue 3 months ago · 15 comments

Hello I want to translate to spanish but I don't understand how to config the folder inside the project, it says:

what you need is to copy the translations folder content into Oqtane.Client project more specifically into Resources folder

But there is no "Resources" folder in Oqtane.Client. There is one in Oqtane.Server and is empty, is that the one? The problem is that because a default language is not installed, I cannot use it as an example either.

Answer 1 · 2021-03-29T15:47:59.000Z

Thanks @elgransan, you are right we are working to improve the instructions, but I don't have suitable time to update them

But there is no "Resources" folder in Oqtane.Client.

You are right, I will try to push a PR to make this work. For now you can create a Resources folder, then your could try a Portuguese language, coz it's the only one pushed, I'm struggling to add an Arabic language too

Thanks

Answer 2 · 2021-03-29T17:16:53.000Z

The PR is created oqtane/oqtane.framework#1202

Answer 3 · 2021-03-29T17:19:35.000Z

Sorry, I created the "Resource" folder in client project but I' getting an error:

The satellite assemblies folder named 'Español (es-ES)' is not found.

This class is looking for the translation folder in "bin" folder of server project, but is not being copied. I think I'm missing something.

Answer 4 · 2021-03-29T17:24:25.000Z

The satellite assemblies folder named 'Español (es-ES)' is not found.

The name is mentioned just for organizing the resources in the repo, please add its content directly into Resources folder

Answer 5 · 2021-03-29T17:59:58.000Z

But If I want the software to be multi-language?

Answer 6 · 2021-03-29T19:12:50.000Z

Same thing, the suffix of the RESX files should be different such Index.fr. resx, Index.ar.resx

Answer 7 · 2021-03-29T19:13:44.000Z

Sorry, I understood, I could do it, thank you

Answer 8 · 2021-03-29T19:20:05.000Z

One last question, can I user generic language "es" instead of "es-ES" or "es-MX" or another? I tried that way and works but I don't know if could fail in some point

Answer 9 · 2021-03-29T19:55:33.000Z

Yes you could, but in case you want to use a specific culture you should use es-ES or es-MX

I tried that way and works but I don't know if could fail in some point

You should add es to supported cultures in appsettings.json

Answer 10 · 2021-03-30T14:46:38.000Z

@elgransan I added an Arabic resources for Oqtane Framework also I update Oqtane.ResxExtractor now can easily generate your culture specific resources by run the oqtane-extractor -c={Culture} command

Hope this help you to generate Spanish resources ;)

Answer 11 · 2021-03-30T16:43:56.000Z

Excelent, I uploaded the spanish language support. I saw in some resource files strange translations, feels like a bug (maybe on the ResxExtractor?):

Answer 12 · 2021-03-30T20:20:11.000Z

Ya, I already recognize some issues in 3 files if I'm not wrong, hope to fix them in both Oqtane Framework & Oqtane.ResxExtractor

Answer 13 · 2021-03-30T20:23:52.000Z

BTW @elgransan could please help us to improve the docs, what's good & what's bad, which we will try to improve it

Answer 14 · 2021-03-30T22:19:10.000Z

Yes, tomorrow I'll take a look on that

Answer 15 · 2024-06-13T11:47:00.000Z

No further action