What do you think about creating localizations for Rockstor &&/|| Rockstor docs?? I thought about this talking with suman about a pull request (warning for shadow copies, adding a non panicing alert linked to Rockstor docs). Thinking about translations for at least french, german, spanish
Youāll get major points for taking up this task! I can help but canāt own or prioritize this work at the moment. I see that Phil listed a couple of pointers with more information. I think this may take a good amount of effort and would indeed be cool to achieve.
@Flyer Like @suman Iāve rather got my work cut out at the moment and need to prioritize those things that Iāve already committed to Iām afraid. I think translation / accessibility is a major feature for sure but given that in the WebUI it will require every user facing string to be abstracted by the chosen mechanism thatās going to be a big task. I put in a suggestion or two in the other thread as a way of trying to contribute what I could, but bar android development where thereās a ready made system in place from the start Iāve just had no other experience with it.
I see the main initial difficulty being the choice of system, ie string/doc abstraction, which obviously has to be accessible both to the technologies Rockstor uses, ie in the WebUI and in docs (.rst) and the commit / dev systems in place ie github and jenkins in order that changes be integrated / tracked and testable. That system also has to be accessible to non technical translators ie a web page anyone can go to that states the changes made since the last translation in a particular language and the % coverage to date in each language. This all must ideally be in an opensource offering as well given our continued attempts to stay as much on the open side as is possible.
So big job but I see the first step as choosing the best technology that conforms to our needs and open goals.
Of course as you know doubt appreciate that job is only going to get bigger as our docs and features grow so hence I would agree that this would be a great thing to get started on but just donāt think I can put any more time into it myself for a bit. Sorry. I do keep trying to nudge the docs along but we also have our work cut out there given Rockstorās fairly rapid development.
Oh and Iām shamefully monolingual (in English as it goes ).
However once we have settled on an acceptable choice of system that will never turn around in the future to bite us (ie must be opensource in my opinion and hosted by the Rockstor infrastructure) then there is always a bunch of google translate cut and paste to get the bulk of our stuff moved over so at least then translators can tidy up whatās there already.
From a quick look via wc -w find . -name '*.rst' it seems we are now > 35,000 words in docs alone.
So to summarize I completely agree that this has to be done at some point but Iām also concerned that we pick the right system for us up front first as otherwise we risk wasting many peoples time and effort.
@suman and @phillxnet
Hi guys, maybe Iāve got an idea (not for docs, but at least for rockstor core)
While thinking about Phillip talk about the great matter of choosing right way to accomplish Rockstor internationalisation, on my work i was also dealing with a huge & boring task for backup (remote external system shutdown on 6 april and i knew it only 2 days ago xD) forcing me to collect data via curls on 4-5 xml/html files of 15MB each, so i solved it with lot of bash coding and XPath!
Then, while looking my black screen logging, i thought: ok, why not to use Xpath client side on Rockstor?!?
Going to explain:
if we want a system enabling users to contribute with translations data on DB is not the right way, the only solution is a āgittableā structured file (xml file or a json file)
what do we need working on an xml/json file? an āinline editorā from Rockstor for data entry (maybe or maybe not) and some .py to insert data, and on client side, to render text??
First solution: server side checks and xml/json reading (i donāt like this)
Second solution: itās all on client side, json/xml structure is only for non english language, cosā english words act like an index + dom structure (Ex. a div with id=mytext on Xpath is //div[@id=mytext], its inner text is referenced by text() so we can write xml/json index referencing all Rockstor dom ācontainersā and contents)