site icon indicating copy to clipboard operation
site copied to clipboard

RTL for docs translation

Open bluemix opened this issue 7 years ago • 9 comments

Hello dears, How can I add an Arabic translation to the docs if it doesn't supports RTL? Or can I modify the navy theme to supports RTL?

bluemix avatar Jul 30 '17 06:07 bluemix

@bluemix I do not know about navy-theme, but I think that I can customize it. If you change the theme's CSS file as follows, it may be displayed normally.

direction: rtl;
unicode-bidi: embed;
text-align: right;
float: left;
clear: right;

For example , hexo-theme-landscape can respond by editing somewhere below. https://github.com/hexojs/hexo-theme-landscape/tree/master/source/css

tea3 avatar Jul 31 '17 06:07 tea3

@bluemix I saw you have submitted two plugins, which is the recommended way to add a new feature to Hexo.

Correct me if I'm wrong, are you asking how to update the Hexo document?

NoahDragon avatar Jul 31 '17 13:07 NoahDragon

@tea3 actually I got problems with the unicode-bidi: embed; and when forcing direction: rtl;. because we have a mixed LTR (e.g., code) and RTL (e.g., explanations) texts. I've written two tag plug-ins what force the layout director for LTR or RTL. I mean it is ok to use tag plugs in the site, right? The other question is that what is the possibility of using a unicode-bidi algorithm, like this, so that the above RTL<->LTR fixes will not be needed.

bluemix avatar Jul 31 '17 14:07 bluemix

@NoahDragon thanks for the merge 😇 Ah, I am sorry, but this issue was supposed to be about the Hexo site.

I was asking If we can add the Arabic language to the Hexo site, like having an additional Arabic language in this screenshot screen shot 2017-07-31 at 17 19 30

bluemix avatar Jul 31 '17 14:07 bluemix

@bluemix There is no Arabic translation so far. Would you like to help us translate doc/api to Arabic? If so, that's would be great. 😄

Here is an under development translation for Portuguese. The Arabic translation file structure would be same as this: https://github.com/lucianobarauna/site/tree/new_translate_ptbr/source/pt-br

NoahDragon avatar Jul 31 '17 15:07 NoahDragon

@NoahDragon yes, I'd like to translate the docs to Arabic. the main problem is that the Arabic language is written from right-to-left (RTL languages) 😁 So I was discussing with @tea3 about this problem :)

bluemix avatar Jul 31 '17 15:07 bluemix

@bluemix That would be awesome. 👍

To make text direct from right to left, I think the plugin you just created would be perfect. You could add it to the package dependency and use it anywhere it needed.

NoahDragon avatar Jul 31 '17 19:07 NoahDragon

ok, I'll start the Arabic translation and I hope tings go well. thanks dears :)

bluemix avatar Aug 01 '17 10:08 bluemix

Any luck on Arabic translation?

lorezyra avatar Sep 26 '22 10:09 lorezyra