inkscape tutorials translation to "Persian" language

Hi,

Thanks for these new translations!

I'm afraid that translating directly the SVG files is not the standard procedure. I suggest that you refer to the translating tutorial wiki page (http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#Tutorial_Translation) and use the appropriate PO files instead (they can be edited with a text editor or poedit, available on Mac, Win and Linux). Since you have already done lots of work, it should not take too long to copy-paste to the PO files (but be careful with special characters!)
The advantages of POs are that we can automatically update them when something change in the original file, and that it allows us to generate all the needed SVG and HTML (for the website) versions of the tutorials.
I've created new (but blank...) po files for Farsi here:
http://inkscape.svn.sourceforge.net/viewvc/inkscape/doc-docbook/trunk/

The translated SVGs also need a UI translation file (another PO file, dedicated to the UI) so that we can link them in the help menu. I'll create it a bit later.

> There was some out-date content in the Tutorial, which I updated
> (as far as I could) and I noticed about the related version.

Could you please leave a comment in Bug #440194 so that we know which part you thing must be updated?
Thanks!

Thank you jazzy, that's my pleasure.

I'll try to create those files also. I hope it be as easy as you mentioned here :)

And about out-dated stuff, I'm talking about the "Tips and Tricks" especially, I don't remember anything elsewhere at the moment:

 in "Clipping or Masking a Bitmap", in lines:
"...In Inkscape Preferences (Misc tab), you can set the option of always importing bitmaps as pattern-filled rectangles."
there is not such option nor in 0.46 or 0.47 version (I don't know from which version it's gone).

 in "Transparency, gradients, and PostScript export",
"... make sure it's in the “pick visible color without alpha” mode; click on that same object. ..."
As far as I remember there was no any text button in control bar for Dropper in 0.46, but that's not matter now. in 0.47 there's two text trigger buttons ("Pick" and "Assign"). in order to reach the objective, user should release the "Pick" button (disable it). the text between the quotations ("pick visible color without alpha") doesn't seems to be match according to the tooltip.

And there was something wrong in the "Entering Unicode values" which seems to be fixed in this 0.47 version.

hey guys, sorry I've been busy. I just finished chapter 1 (Basic tutorial) but this .po solution is a little tricky for right-to-left language and I'm not sure about the result. here is what I've made:

[direct link]
http://dark-sun303.persiangig.com/officialInk-Tutorial/fa.mo
http://dark-sun303.persiangig.com/officialInk-Tutorial/fa.po

[mirror]
http://www.4shared.com/file/198491661/e4d34dbf/fa_online.html
http://www.4shared.com/file/198491676/63ace95d/fa_online.html

please let me know if they're OK, so I can keep going to next chapters.

Thanks for your po file!

I've tried to use it to automatically create the basic SVG tutorial, but unfortunately our converter is not well optimized for right to left languages... I'm currently working on it, but I still have some difficulties to resolve some critical issues (texts are now aligned correctly, but not titles, and oblique is not rendered as expected). I've also noticed some inverted tags (keycap, firstitem...) in the po file. The text is right to left, but the tags need to be written as if the text were left to right... Don't worry about it, I'll fix it directly.

Thus I suggest that you don't convert the other tutorials until I've fixed the converter.
If I don't manage to fix it before 0.48 is launched, I'll use your hand made SVG files instead.

Do you plan to translate the Inkscape UI too?

You know I guessed there might be some problem cause of right-to-left feature of Persian language, but It seems to be a good idea to improve the converter ;)
In my manual translation I simple set oblique (italic) style of text(s) to regular, because it's an issue which is related to unicode fonts and I don't think it could be resolved easily.
About inverted tags (keycap, firstitem...) you're right. That's why I didn't know how that converter would work, so I used both right-to-left tags and left-to-right tags. I know that sounds crazy! thank you for fixing it, that's nice of you.

I hope this right-to-left issue could be solved before 0.48, Unfortunately I don't know anything about the converter to help you out. I know Java, so if that could be useful I'll be happy to cooperate in resolving process.

Translating UI? hmmmm.. I don't know, I'm afraid because of right-to-left issue all the Inkscape UI would need to be written from scratch! LOL :D
seriously I've been thinking about it, no result so far! at least people whom I know prefer the English UI of applications. do you think it's a good idea?

Hi,

I've committed your handmade SVG files and they will be available in 0.48. I'm still working on the PO and XSLT stuff, but I'm not sure it'll be ready in time.

I've also created a new Farsi UI translation file in order to link the tutorials to the help menu.
This fa.po file can be downloaded here:
http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head%3A/po/

Except the tutorials links, nothing is translated and the current Farsi UI is in English.
I don't know how it renders with left to right languages (Inkscape already has an Arabic translation, but I don't understand it...). If you have time, test with some easy strings first (menu entries?).

Regards.

All right, I guess something isn't OK about the "fa.po" file. I get this error while trying to save it with "Poedit":
msgfmt: found 2 fatal errors
and in the details it says:

/home/ali/download/fa.po:7: invalid nplurals value
msgfmt: found 2 fatal errors

i don't know anything about xml stuff but it seems this line:

msgstr ""

in this block:

msgid ""
msgstr ""
"Project-Id-Version: inkscape\n"
"Report-Msgid-Bugs-To: <email address hidden>\n"
"POT-Creation-Date: 2010-01-24 14:52+0100\n"
"PO-Revision-Date: 2010-02-04 11:48+0330\n"
"Last-Translator: Ali Ghanavatian <email address hidden>\n"
"Language-Team: Farsi <email address hidden>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"

caused the error. am i right?

Sorry, I forgot to change the default parameters...
A new version is now available (bzr rev. 9047).

Please check the new values (I'm not sure they apply to your language). You can change it directly in the poedit catalog parameters.

Thanks!

OMG! I was just one step behind you! get 1 jazzy.
see where I was:
http://www.poedit.net/trac/ticket/293
[result: nothing!]
and then:
http://www.gnu.org/software/hello/manual/gettext/Plural-forms.html ::
The nplurals value must be a decimal number which specifies how many different plural forms exist for this language...
you may guess my next step, comparing
"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"
with another translated po file.
result: TADA!
:)

well, here is my first shot on UI, but it's still alive :)
I translated some complex lines to see if they came out fine.
hey jazzy, Is there any way that I can see my translated UI or it needs inkscape to be compiled from source?
I've got Inkscape 0.47 installed from deb on Linux Mint (Helena) and definitely she's hot!

> Is there any way that I can see my translated UI

Yes:
1. Generate a fa.mo with poedit (with the default parameters, it is done each time you save your po file).
2. Rename it inkscape.mo.
3. Copy it to the LC_MESSAGES folder of your language. On Ubuntu, the path is /usr/share/locale-langpack/fr/LC_MESSAGES, and it's probably very similar on Debian.
4. Launch Inkscape and change the language preferences (File>Inkscape preferences>Interface).
5. Restart Inkscape.

Translation committed in revision 9048.
Looks good. Congrats!

thanks man, couldn't make it without your help.
do you when 0.48 version will be released?
I'm a little nervous about it. wondering can we catch it on GUI translation or not?
I really want it to be published, but I'm a little busy these days. you know I'm working on a commerce site trying to make a little money from an online store (and who knows? maybe a lot of money!) this is a temptable situation but I know I can go through it.

damn! seems I'm Frodo in Lord of the Rings! LOL
you don't talk much bro, I guess you're too busy too.
alright. I should get back to business now.
c u then, take care :)

Hi Ali,

I've committed your last translation in bzr, revision 9057.

Farsi is now included in the development branch, and thus it will also be included in the final 0.48 version.
Don't worry if it's not 100% done. It's nice you help us add this language, so take your time. Inkscape is really big and has lots of strings (more than 5200!) and nobody expects you to finish tomorrow :).
Try to finish the menus and most visible UI elements first so that the translated UI looks consistent.

Note that Inkscape translators have a dedicated list here: https://lists.sourceforge.net/lists/listinfo/inkscape-translator
Don't hesitate to use it if you have any question regarding translations.

> you don't talk much bro, I guess you're too busy too.

Yes. My family, my work and Inkscape eat all my time!
Sometimes my messages are short (particularly commit notifications...), but it doesn't mean I don't want to talk or don't respect you. It's just that I try to help as many people as possible in a short amount of time.

Good luck with your business!

Regards.

>... Farsi is now included in the development branch...
wow! It's amazing. I always thought development is just dedicated to programmers, now I think I'm a developer too. OMG this is awesome :)
And actually it means to me that I should do my job with more care to achieve best results.

> It's nice you help us add this language, so take your time. Inkscape is really big and has lots of strings (more than 5200!) and nobody expects you to finish tomorrow :).
oh Carlos, it's my pleasure to be a part of this amazing team. I'll try to focus on quality. B-)

> Try to finish the menus and most visible UI elements first so that the translated UI looks consistent...
alright, I got the key now.

> Yes. My family, my work and Inkscape eat all my time!...
that's my dream about the future. Iranian's dream! ;)

here's another progress.

Translation committed in revision 9074.
Thanks!

more progress, objective:> GUI menus
unfortunately it seems there is kind of bug in Persian font or gui menu items. some letters like:
ر ز ژ س ش پـ
and some more letters, can't be shown with underline. but the shortcut works pretty good.
I simply ignored this issue, but it can be a pain for final user

last standing menu is : filters

Translation committed in revision 9097.
Thanks!

Hey, you have now translated 11% of the total messages. Very fast and good work!

> last standing menu is : filters
Hum, it's not an easy one. Don't hesitate to try each filter if you don't understand the labels and descriptions.

I'll try to take a look at the underline bug as soon as possible.
Regards.

all right, I know it's been a long time and probably you may expect a huge .po file, but unfortunately i have been busy somewhere else. but good news is that crazy "filter" menu is gone down! :)

honestly, now i got a kind of unfamiliarity with the translated gui, i don't know maybe it's because i didn't spend enough time to get familiar with it, but anyway i feel more comfortable when i work with English gui.
do you think it's OK? or something is wrong somewhere?

and one more thing, in my country (Iran) there's new year celebration called "nowruz", so I wish a good and happy year for you, your family and all inkscape developers around the world.

Happy new year to you too!

The updated translation has been committed in revision 9260.
Thanks!

And this bug has not finished yet! is it? :)
alright, i got a new fa.po file from here:
http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_48_BRANCH/files/head%3A/po/

and here's my updated gui translation.

Hi Ali,
The updated translation is available in the 0.48.x branch as of revision 9771.
Thanks!

Yo, Nicolas. here's another check point.
take care of it ;)

Update committed in the branch, revision 9775.
Status: 25% translated.
Thanks Ali!

@JazzyNico - today there was a question on #inkscape about the Persian/Farsi documentation not being available on inkscape.org. Is this due to the issues mentioned in comment #6?

<quote>
11:54| < dark-sun> who's responsible for the site?
|11:54| < dark-sun> there's a full persian transaltion of Farsi language, but there's nothing in here: http://inkscape.org/doc/index.php?lang=en
</quote>

@~suv - Yes. Apart from the Basic tuto, there's no available po file to generate the HTML automatically (and I'm not sure about the quality of Basic).

But there's also an HTML error that hides the lower part of the web page... For the Farsi section, you should see the following tutorial: http://inkscape.org/doc/basic/tutorial-basic.fa.html

I'm going to fix the HTML bug a bit later today.

HTML page fixed (SVN 22875). Should be online soon.

@JazzyNico hi, I saw that html page, it needs some modifications.
should I make .po file for other tutorials?

Hi Ali,

Happy to see you here again!

> should I make .po file for other tutorials?

Yes, of course, it would be great to have all the tutorials as po files. But could you please review the one you created for the basic tutorial first? There may still be some issues with the SVG and HTML templates that generate incorrect output files with a correct po file. If I remember correctly, we didn't manage to make it work as expected last time we tried. Is the Basic HTML file far from a correct result?

@jazzy, thank you, it's a pleasure to work with you on this bug.
converting other tutorials to .po would take a while, but i'll do it or take some people to do it.
about that html, beside those "square characters" paragraphs (as you mentioned it's a bug), there should be a little modification in the css file named "tutorial.css":

direction: rtl;
text-align: right;

these lines should be added to "p" and "h2" styles.
other stuff looks like okay so far....
 humm... except those buggy paragraphs.

I wrote a simple right to left style for the HTML Tutorial pages. just inlcude this after the main css file (tutorial-html.css), you can also use this for Arabic and Hebrew tutorial pages :)
btw, there is something wrong with the generated HTML pages. for instance the second paragraph that is about "zoom in or out", there are many kbd tags that are collapsed toghether. is it a flaw in the convertor or a mistake in translating po file?

@jazzy, hey pal, is it possible to see the convertor, maybe we can fix it together.

and the html file was OK, I was confused by a cached edition of the file. stupid firefox :)

Thanks Sasan! I'll see how we can include it automatically when generating the HTML files.

@Ali, of course you can have access to the convertor. The whole code is available in the inkscape-docs LP page: https://code.launchpad.net/~inkscape.dev/inkscape-docs/trunk
You also have information on translating the documentation on the wiki: http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#Tutorial_Translation

Regards.

Found the reason that caused the weird html output. some keycap and command tags weren't close properly in the po translation. I've attached the corrected one (this is for the basic tutorial section). please apply the changes so we can see the results and proceed with the translation :)
kind regards

I've just committed a tweak in the HTML generator (revision 466) so that Farsi is correctly set as RTL language and show in the right direction. Basic PO file also updated.

Attached is the generated HTML file. It won't show exactly as on the website (due to the linked CSS file), but it should be ok to validate.

I checked the document and it's perfectly fine. I also looked for the kbd tags and they are ok.
you can now commit the changes, thanks for all the support :)

@jazzy, good job, can we now proceed to next tutorial parts? \
how long does it take to see them on "http://inkscape.org/doc/" on persian/Farsi part?

I forgot to ask the web site admin to update the page. It's online now!

And yes, you can work on the other tutorials, I'll convert them as soon as possible.