How To Translate - Revision history

OlivierSessink at 18:15, 20 August 2025

2025-08-20T18:15:36Z

← Older revision		Revision as of 18:15, 20 August 2025
Line 1:		Line 1:
	== Translations ==		== Translations ==
	~~(this How To is based on Bluefish Manual page : [[Man 1 ch12s08]])~~
	=== 1. Introduction ===		=== 1. Introduction ===
	Bluefish has been translated into ~~more than 15~~ different languages ~~and this is only the beginning~~.		Bluefish has been translated into many different languages.

	Translation process is not a difficult task but you will need some time because there are more than one thousand strings to be translated. <br />		Translation process is not a difficult task but you will need some time because there are more than one thousand strings to be translated. <br />
Line 55:		Line 55:
	[[Image:Man1_warning.png]] You have to keep in mind that two GUI elements must not have the same shortcut key at the same level.		[[Image:Man1_warning.png]] You have to keep in mind that two GUI elements must not have the same shortcut key at the same level.

	=== 4. ~~Retriving~~ last Bluefish version===		= get the files =

			== Normal access ==

			retrieve the files from https://www.bennewitz.com/bluefish/devel/translations/ and send them by email to olivier (at) bluefish.openoffice.nl when you are finished.

			== If you have developer access: working from subversion ==

			==== Retriving last Bluefish version====
	* 1. In your working space directory (eg ~/tranlations) run: <br />		* 1. In your working space directory (eg ~/tranlations) run: <br />
	svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/		svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/
Line 63:		Line 71:
	* 4. you can now update all files.		* 4. you can now update all files.
	see also [[Sending_Patches#Notes_for_translators]]		see also [[Sending_Patches#Notes_for_translators]]
	=== 5. Sending your translation ===		==== Sending your translation ====
	see also [[Sending_Patches#Special_notes_for_translators]]		see also [[Sending_Patches#Special_notes_for_translators]]
	* 1. update your SVN copy. In Bluefish/ dirctory run:		* 1. update your SVN copy. In Bluefish/ dirctory run:

OlivierSessink at 14:59, 13 September 2024

2024-09-13T14:59:53Z

← Older revision		Revision as of 14:59, 13 September 2024
Line 14:		Line 14:
	* src/plugin_snippets/po/		* src/plugin_snippets/po/
	* src/plugin_zencoding/po/		* src/plugin_zencoding/po/
	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.~~) or Poedit.		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 (bluefish for example) or Poedit or the gnome translation 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.

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

	=== 2. PO files basics ===		=== 2. PO files basics ===

Fal7i: /* 1. Introduction */ add zencoding

2011-12-12T11:41:41Z

1. Introduction: add zencoding

← Older revision		Revision as of 11:41, 12 December 2011
Line 13:		Line 13:
	* src/plugin_infbrowser/po/		* src/plugin_infbrowser/po/
	* src/plugin_snippets/po/		* src/plugin_snippets/po/
			* src/plugin_zencoding/po/
	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.) or Poedit.		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.) or Poedit.

Fal7i at 09:54, 20 September 2009

2009-09-20T09:54:33Z

← Older revision		Revision as of 09:54, 20 September 2009
Line 1:		Line 1:
			== Translations ==
	== 8. Translations ==		(this How To is based on Bluefish Manual page : [[Man 1 ch12s08]])
			=== 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.

	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.)		Translation process is not a difficult task but you will need some time because there are more than one thousand strings to be translated. <br />
			There are seven translation directories in Bluefish development branch, one for main program and one for each plugin:
			* po/
			* src/plugin_about/po/
			* src/plugin_charmap/po/
			* src/plugin_entities/po/
			* src/plugin_htmlbar/po/
			* src/plugin_infbrowser/po/
			* src/plugin_snippets/po/
			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.) or Poedit.

	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 ===		=== 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:

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


	[[Image: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.		[[Image:Man1_warning.png]] When an entry is tagged as fuzzy (i.e. when the line begins with "<nowiki>#, fuzzy</nowiki>"), that means it is probably incorrect.

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

	[[Image:Man1_warning.png]] Remember that as long as a translation is marked "fuzzy", it will NOT actually be used!		[[Image:Man1_warning.png]] Remember that as long as a translation is marked "fuzzy", it will NOT actually be used!
Line 35:		Line 43:
	# Check that the po file ends with a blank line		# Check that the po file ends with a blank line

	=== 8.3. Shortcut keys ===		=== 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 47:		Line 55:

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

			=== 4. Retriving last Bluefish version===
			* 1. In your working space directory (eg ~/tranlations) run: <br />
			svn co https://bluefish.svn.sourceforge.net/svnroot/bluefish/trunk/bluefish/
			that create the Bluefish SVN directory
			* 2. '''cd bluefish/''' and for first installation run '''./autogen.sh'''
			* 3. run '''./configure''' and '''make'''
			* 4. you can now update all files.
			see also [[Sending_Patches#Notes_for_translators]]
			=== 5. Sending your translation ===
			see also [[Sending_Patches#Special_notes_for_translators]]
			* 1. update your SVN copy. In Bluefish/ dirctory run:
			svn update
			* 2. The following step is not necessary but it will help you finding issues, which must be fixed, before your changes can be committed to the subversion tree. It requires an installation of the gettext tools. Please change `your_lang` with your language code ;)
			find . -name your_lang.po \| xargs msgcat --use-first -o - \| msgfmt -o /dev/null --statistics -
			* 3. create the tarball:
			find . -name your_lang.po \| xargs tar -cjf your_lang.tar.bz2
			* 4. send the tarball

Fal7i: Created page with ' == 8. Translations == === 8.1. Introduction === Bluefish has been translated into more than 15 different languages and this is only the beginning. Translation process is not…'

2009-08-16T21:25:37Z

Created page with ' == 8. Translations == === 8.1. Introduction === Bluefish has been translated into more than 15 different languages and this is only the beginning. Translation process is not…'

New page

== 8. Translations ==

=== 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>'

[[Image: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.

[[Image: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>".

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

[[Image: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'''.

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