Aminadav / webpage-screenshot

Entire page Screenshot extension for Google Chrome. I'm developing open source extension for Google Chrome. All extension are free for use. Let's make Chrome great again!
https://www.1ce.org
ISC License
493 stars 520 forks source link

README - Proposal for translation-friendly writing -- updated installation-steps #35

Closed leahparsuidualc-zz closed 8 years ago

leahparsuidualc-zz commented 8 years ago

I have added a README---DEDE.md which is a ( where gramatically possible word by word translation ) to german, which might be an invitation for those that like to translate | localize.

I tried to convert the original README into a writing-structure that allows machine-translation to (hopefully) deliver understandable sentences. Translation by hand | mouth should be relatively easy that way, as the original content is split up in shortened parts, which can be translated on their own.

I tried to use a wording that is unique by sequence, but generic enough to have counterparts in the main spoken and written languages.

If you like what you see, i will go on to translate into german.

But then it would be necessary to know how the translated files should be named and organized so they are manageable by the originators.

If there is no interest in translated content i will translate for my own use ( and those who like to use it too) into a l10n|localization-DEDE-branch ); if there is a problem license-wise please inform me in forefront.

Thanks for your interest.

claudiusraphael

Aminadav commented 8 years ago

I think it can be asesome. you should add the explanation and instructions to the readme files, not just here in the pull request. After than I can merge it.

leahparsuidualc-zz commented 8 years ago

@AminaG would you be so kind, to give an example for where (explicit location) and how (which formatting) you like to have the explanations|comments|translations.

Because, as soon as i start i will go on with as much as possible in one session.

Also it might be motivating for others | potential participants to know which guidelines are given for constructive work towards 'Open Screenshot'.

Btw.: Thanks for the fast response!

Aminadav commented 8 years ago

The translation itself you put in _locale folder, in the message.json file

Read more: https://developer.chrome.com/extensions/i18n

Here you see example how to use it in the package.json: https://github.com/AminaG/OpenScreenshot/blob/master/chrome-extensions/manifest.json#L2

We adding translation by using tr attibutes:

https://github.com/AminaG/OpenScreenshot/blob/master/chrome-extensions/popup.html#L31

This is the translation function: https://github.com/AminaG/OpenScreenshot/blob/master/chrome-extensions/js/translate.js

It's search for elements contain tr attribute and search for the matching translation in the manifest.json

leahparsuidualc-zz commented 8 years ago

Thank you very much; I'll go into it.

leahparsuidualc-zz commented 8 years ago

TARGET: Issue #36

ORIGIN: @AminaG --- #35 | Pull-Request-Comments

I did, so far, got it (i think):

My yet-unwritten attempt was: To ADD what is MISSING;

Let me give an example and explain why i thought, that the described before, would be great for your project;

because for whatever reason|use-case, e.g.:

EXAM: The resulting call could be a set:

l10n={ 'messages':'dede' ,'hoverhelp':'dech' ,'helptext':'enus' ,'controls':'deat' ,'readme':'dede' ,'licensing':'enus' };

I hope you get what i am aiming|asking for.

So, the question is just:

WHERE should the original readme (in enus) be mirrored|linked, so that a translation can be hold in the same storage for optional access (sorted for developers|translators into one folder-by-origfilename+locale; for direct editing | usable by the extension itself to blend the content in naturally, by allowing specific l10n-setting.

WHY?

Because ... you already have a bunch of stuff translated and i did not want to reinvent the wheel, but help make the extension complete, because:

Also, i couldn't ignore the fact:

I think it would be very nice to spend the opportunity to deliver a FULL extension, just because you already did it, the only little things that are missing are the described parts ( which are for sure the main fractions in terms of file-size, but the ignorable in terms of coding complexity ).

I hope you do not feel upset, but instead encouraged by my explanation.

I just think Open Screenshot would be the PERFECT FUNDAMENTAL EXAMPLE OF A FULLY FUNCTIONAL SCREENSHOT EXTENSION FOR BROWSERS ( ... ;) yeahyeah i know its just for chrome, ahem ;) ... )

By the way, you obviously have defnitely absolutely NO PROBLEM to answer one that asks for details about your project; so you MIGHT BE ABLE to give the WHOLE EXPERIENCE a shot.

Okay, please tell me one last time what your thoughts are, i hope i gave enough details and examples what my thoughts have been. If not, or if you wish to dicuss this no further, just let me know, i won't take it in anyway as an offense, just speak open and freely.

NOTE: The CAPITALIZED WORDS are not a CRYOUT, but in sense of letter-by-letter-readable, so one can see the dimension and opportunities behind.

:)

Thanks for your interest. (btw.: Yes i COULD code that myself; No, i do not want to. And if you ask what my talents are, i name you one: having feelings when looking at structures leading to thoughts showing pathes of developments which themselve lead to final solutions ... Some call it Authism ;) )

As you may have noticed already, this is not just a further asking in the original pull request, but opened as a new issue, so others can add there own thoughts to it. As i already told, if there is no interest from your side its totally accepted, no offense taken, but at least: let it exist as an issue ( means: do not close, please ). One day, one might want to get into it, and even if not it contains some trackbacks and sidelinks, that will push your rankings in terms of better being found, for those that are in need of 'Open Screenshot'.n](https://developer.chrome.com/extensions/i18n)