Fal7i at 10:42, 20 August 2009

2009-08-20T10:42:10Z

← Older revision		Revision as of 10:42, 20 August 2009
Line 9:		Line 9:
	\|next=Man 1 ch12s09		\|next=Man 1 ch12s09
	}}		}}
	== 8. ~~Translations~~ ==		== 8. Translations ==
	<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;">		<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;">
	*[[#8.1. Introduction\|8.1. Introduction]]		*[[#8.1. Introduction\|8.1. Introduction]]
Line 16:		Line 16:
	*[[# 8.4. How to contribute\| 8.4. How to contribute]]		*[[# 8.4. How to contribute\| 8.4. How to contribute]]
	</div>		</div>
	=== 8.1. ~~Introduction~~ ===		=== 8.1. Introduction ===
	Bluefish has been translated into more than 15 different languages and this is only the beginning.		Bluefish has been translated into more than 15 different languages and this is only the beginning.

Line 23:		Line 23:
	Bluefish uses po (Portable Object) files. A po file is just a plain text file that you can edit with your favorite text editor.		Bluefish uses po (Portable Object) files. A po file is just a plain text file that you can edit with your favorite text editor.

	=== 8.2. PO files basics ===		=== 8.2. PO files basics ===
	In a typical po file there are five major types of entries:		In a typical po file there are five major types of entries:

Line 49:		Line 49:
	# Check that the po file ends with a blank line		# Check that the po file ends with a blank line

	=== 8.3. ~~Shortcut~~ keys ===		=== 8.3. Shortcut keys ===
	Shortcut keys, known as hotkeys or even accelerator keys, are defined as follows (look at the underscore, please):		Shortcut keys, known as hotkeys or even accelerator keys, are defined as follows (look at the underscore, please):

Line 62:		Line 62:
	[[File:Man1_warning.png]] You have to keep in mind that two GUI elements must not have the same shortcut key at the same level.		[[File:Man1_warning.png]] You have to keep in mind that two GUI elements must not have the same shortcut key at the same level.

	=== 8.4. ~~How~~ to contribute ===		=== 8.4. How to contribute ===
	It is really easy. Just drop me a line at [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar] and I will send you your po file ready to be translated. When you have finished the translation work, just send it me back (use gzip or bzip2 if possible, please). Then I will check it and if everything is right I will add it into SVN.		It is really easy. Just drop me a line at [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar] and I will send you your po file ready to be translated. When you have finished the translation work, just send it me back (use gzip or bzip2 if possible, please). Then I will check it and if everything is right I will add it into SVN.

Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man1top |lang=en |rev=1.0.6 |Title=8. Translations |prev=Man 1 ch12s07 |Subtitle=Chapter XII. Development guidelines |next=Man 1 ch12…'

2009-08-19T14:53:18Z

Created page with '__NOTOC__ __NOEDITSECTION__ {{Man1top |lang=en |rev=1.0.6 |Title=8. Translations |prev=Man 1 ch12s07 |Subtitle=Chapter XII. Development guidelines |next=Man 1 ch12…'

New page

__NOTOC__
__NOEDITSECTION__
{{Man1top
|lang=en
|rev=1.0.6
|Title=8. Translations
|prev=Man 1 ch12s07
|Subtitle=Chapter XII. Development guidelines
|next=Man 1 ch12s09
}}
== 8. Translations ==
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;">
*[[#8.1. Introduction|8.1. Introduction]]
*[[#8.2. PO files basics| 8.2. PO files basics]]
*[[#8.3. Shortcut keys| 8.3. Shortcut keys]]
*[[# 8.4. How to contribute| 8.4. How to contribute]]
</div>
=== 8.1. Introduction ===
Bluefish has been translated into more than 15 different languages and this is only the beginning.

Translation process is not a difficult task but you will need some time because there are more than one thousand strings to be translated. The good news are you don't need to be a programmer to make Bluefish speak your language and the only tool you need is a text editor (Vim, Emacs, bluefish, etc.)

Bluefish uses po (Portable Object) files. A po file is just a plain text file that you can edit with your favorite text editor.

=== 8.2. PO files basics ===
In a typical po file there are five major types of entries:

# Those which begin with "#:" showing the places in the source code that contains the string being translated (there may be one or more) as: '<tt><nowiki>#: ../src/about.c:123</nowiki></tt>'
# Those which begin with "#," containing some flags (not always present) as: '<tt><nowiki>#, c-format</nowiki></tt>'
# Those which begin with "msgid" containing the English string being translated (it may be spanned in several lines) as: '<tt>msgid "Authentication is required for %s."</tt>'
# Those which begin with "msgstr" containing the translated string as: '<tt>msgstr "Une autorisation est requise pour accéder à %s."</tt>'
# Those which begin with "#~ " containing obsolete strings as: '<tt><nowiki>#~ msgid "Save document as"</nowiki></tt>'

[[File:Man1_warning.png]] When an entry is tagged as fuzzy (i.e. when the line begins with "<tt><nowiki>#, fuzzy</nowiki></tt>"), that means it is probably incorrect.

[[File:Man1_warning.png]] You have to make sure the translation is correct and then delete either the "<tt><nowiki>#, fuzzy</nowiki></tt>" line if this is the only flag on the line, or the "<tt>, fuzzy</tt>" part of the line if there are some other flags on the same line, like in "<tt><nowiki>#, fuzzy, c-format</nowiki></tt>".

[[File:Man1_warning.png]] Remember that as long as a translation is marked "fuzzy", it will NOT actually be used!

[[File:Man1_warning.png]] As far as obsolete strings are concerned, it is up to you to decide if you want to remove them. On one hand they can be reused in a latter version of the po file, on the other hand they make the po file bigger.

Hence, your task as a translator is to:

# Translate all empty msgstr entries
# Check all fuzzy entries, correct them if they are wrong and remove all fuzzy tags
# Optionally, remove obsolete strings
# Check that the po file ends with a blank line

=== 8.3. Shortcut keys ===
Shortcut keys, known as hotkeys or even accelerator keys, are defined as follows (look at the underscore, please):

<nowiki># src/toolbars.c:482</nowiki>
<nowiki>#: ../src/filebrowser.c:1453</nowiki>
msgid "/_Refresh"
msgstr "/_Actualizar"

It means that in the English locale the user have to press '''Alt'''+'''R''' to activate this particular GUI element. On the other hand if your locale is Spanish your shortcut key will be '''Alt'''+'''A'''.

[[File:Man1_warning.png]] You have to keep in mind that two GUI elements must not have the same shortcut key at the same level.

=== 8.4. How to contribute ===
It is really easy. Just drop me a line at [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar] and I will send you your po file ready to be translated. When you have finished the translation work, just send it me back (use gzip or bzip2 if possible, please). Then I will check it and if everything is right I will add it into SVN.

About ten days before a new release I will send a new fresh po copy to each translator to repeat this process.

All po files will be named as follows:

date-foo.po.gz (date: day-month-year)

Example:

12-12-2004.es.po.gz (for Spanish po file)

Please, remember:

* Do not rename it (I need it for tracking stuff)
* Send it me back as soon as possible in zipped format too.
* Do not mix it without any local copy you have.
* Remember they are in UTF-8 format
* Subject in my mail will be ***New Bluefish PO File !***

And at last, do not start a new translation before contacting me or contact Olivier and do not post your po file at the list, please.

If you have some doubts, do not hesitate contact me at [mailto:wecharri(at)arnet.com.ar wecharri(at)arnet.com.ar].

{{Man1bottom
|prev=Man 1 ch12s07
|up=Man 1 ch12
|next=Man 1 ch12s09
|prevname= 7. Patches
|nextname=9. Some tips
}}

Man 1 ch12s08 - Revision history

Fal7i at 10:42, 20 August 2009

Fal7i: Created page with '__NOTOC__ __NOEDITSECTION__ {{Man1top |lang=en |rev=1.0.6 |Title=8. Translations |prev=Man 1 ch12s07 |Subtitle=Chapter XII. Development guidelines |next=Man 1 ch12…'

Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man1top |lang=en |rev=1.0.6 |Title=8. Translations |prev=Man 1 ch12s07 |Subtitle=Chapter XII. Development guidelines |next=Man 1 ch12…'