Translate Toolkit & Pootle pootle

pootle:adding_a_terminology_project

Fri, 13 Feb 2009 11:25:05 +0000

1189426649		current
Line 1:		Line 1:

-	Pootle can perform real-time semi-fuzzy look-up in a glossary created by the project manager. This glossary is a standard PO file with a specific name. The naming format is "<project>-terminology.po". Pootle recognises this file automatically, if it exists. In the absence of a project-specific glossary, a project will query the glossary named "pootle-terminology.po", if it exists.	+	Pootle can perform real-time semi-fuzzy look-up in a glossary created by the project manager. This glossary is a standard PO file with a specific name. The file must be called "pootle-terminology.po". Pootle recognises this file automatically, if it exists. In the absence of a project-specific glossary, a project will query all files in the project called "terminology", if it exists.

-	Ideally, the source term should be the shortest, simplest form of a word. Therefore cat, dog, house are good, but cats, dogged and housing are bad. Context indicators are allowed in the source text, in brackets after the term, but keep them short, eg (noun), (verb), etc.	+	Ideally, the source term should be the shortest, simplest form of a word. Therefore cat, dog, house are good, but cats, dogged and housing are bad. Context indicators are allowed in the source text, in brackets after the term, but keep them short, eg. (noun), (verb), etc.

-	The latest version of Pootle has the ability to insert the target term into the text. The ideal is therefore that the target term be something that you'd like the translator to be able to insert... but strictly speaking the target text can be anything, including an definition.	+	The latest version of Pootle has the ability to insert the target term into the text. The ideal is therefore that the target term be something that you'd like the translator to be able to insert... but strictly speaking the target text can be anything, including a definition.

-	If the PO file has comments, it will be displayed as a tooltip in Pootle, but the glossary format wasn't really designed for supporting glossary comments.	+	If the PO file has comments, it will be displayed as a tooltip in Pootle.

pootle:admin_account

Mon, 07 Dec 2009 12:08:46 +0000

1258543744		current
Line 16:		Line 16:

	If you want to assign site administration permissions to an already existing user, just go to the ''Users'' tab within the ''Administration'' page, check the ''Superuser status'' checkbox for the user you want to make administrator and click on ''Save Changes''. That's all!		If you want to assign site administration permissions to an already existing user, just go to the ''Users'' tab within the ''Administration'' page, check the ''Superuser status'' checkbox for the user you want to make administrator and click on ''Save Changes''. That's all!
		+
		+	===== Language administrators =====
		+	Administration rights can be delegated for all tasks within a language. This allows the language administrator to set permissions in the language, set permissions in certain projects in the language, manage files, etc.
		+
		+	To appoint a language administrator, visit the language page, and add the administration right on the "permissions" tab.

pootle:admin_guide

Mon, 28 Aug 2006 08:32:27 +0000

	current
Line 1:	Line 1:
	+	====== Pootle administration ======
	+	* [[admin_account\|Creating the administrator]]
	+	* [[permissions\|Assigning permissions]]

pootle:alternative_source_language

Fri, 25 Feb 2011 12:03:26 +0000

1282902712		current
Line 18:		Line 18:
	<code>enablealtsrc="False"</code>		<code>enablealtsrc="False"</code>
	in ''pootle.prefs''.		in ''pootle.prefs''.
		+
		+
		+	===== Matching criteria =====
		+
		+	In order to show suggestions from another language, the following is needed:
		+
		+	* The alternative languages must be visible in Pootle and added to the same project.
		+	* The string must be translated in the alternative language (not incomplete or untranslated).
		+	* The file names need to be identical (identical strings from different files are not matched).
		+	* The source text for both translations need to be identical.

pootle:apache

Thu, 05 Apr 2012 09:08:15 +0000

1327311025		current
Line 21:		Line 21:
	# point at the wsgi loader script		# point at the wsgi loader script
	WSGIScriptAlias /pootle /var/www/Pootle/wsgi.py		WSGIScriptAlias /pootle /var/www/Pootle/wsgi.py
		+
		+	# The following two optional lines enables "daemon mode" which limits
		+	# the number of processes and therefore also keeps memory use more predictable
		+	WSGIDaemonProcess pootle processes=2 threads=3 stack-size=1048576 maximum-requests=5000 inactivity-timeout=900 display-name=%{GROUP}
		+	WSGIProcessGroup pootle

	# directly serve static files like css and images, no need to go through mod_wsgi and django		# directly serve static files like css and images, no need to go through mod_wsgi and django

pootle:assigning

Tue, 17 Nov 2009 16:03:53 +0000

1230644437		current
Line 1:		Line 1:
	====== Assigning ======		====== Assigning ======
		+
		+	<note>This information is about an old Pootle version. Pootle 2.0 doesn't have assigning functionality but it may be added in the future.</note>

	When different team members want to work on the same project, Pootle allows the project administrator to assign work to different people. Different files from the same project can be assigned, or even a single file can be split between different people.		When different team members want to work on the same project, Pootle allows the project administrator to assign work to different people. Different files from the same project can be assigned, or even a single file can be split between different people.

pootle:cachdung

Sat, 05 Jan 2008 18:09:47 +0000

1205138831		current
Line 7:		Line 7:
	==== Đăng ký ====		==== Đăng ký ====

-	8-) Người dùng mới cần [[http://pootle.wordforge.org/register.html\|đăng ký]] với Pootle	+	8-) Người dùng mới cần [[http://pootle.locamotion.org/register.html\|đăng ký]] với Pootle

	Bạn sẽ nhận thư chứa mã kích hoạt: chỉ cần nhấn vào liên kết trong thư, rồi nhập mã (thủ tục này chặn việc đăng lý rác). Nếu bạn gặp khó khăn nào trong việc đăng ký, bạn viết thư cho [[Translate-pootle@lists.sourceforge.net\|hộp thư chung Pootle]] (đăng ký ở [[https://lists.sourceforge.net/lists/listinfo/translate-pootle\|trang này]]) hoặc cho tôi <clytie@riverland.net.au>.		Bạn sẽ nhận thư chứa mã kích hoạt: chỉ cần nhấn vào liên kết trong thư, rồi nhập mã (thủ tục này chặn việc đăng lý rác). Nếu bạn gặp khó khăn nào trong việc đăng ký, bạn viết thư cho [[Translate-pootle@lists.sourceforge.net\|hộp thư chung Pootle]] (đăng ký ở [[https://lists.sourceforge.net/lists/listinfo/translate-pootle\|trang này]]) hoặc cho tôi <clytie@riverland.net.au>.

pootle:cache

Mon, 06 Sep 2010 08:26:04 +0000

1283761564		current
Line 1:		Line 1:
	====== Caching System ======		====== Caching System ======
-	Pootle uses a caching system to improve performance. It is an essential part of [[optimising]] your Pootle installation. It is based on Django's caching system, and is used for various things:	+	Pootle uses a caching system to improve performance. It is an essential part of [[optimisation\|optimising]] your Pootle installation. It is based on Django's caching system, and is used for various things:

	* To serve cached (possibly slightly outdated) versions of most pages to anonymous users to reduce their impact on server performance.		* To serve cached (possibly slightly outdated) versions of most pages to anonymous users to reduce their impact on server performance.

pootle:captchas

Mon, 16 Aug 2010 13:44:48 +0000

1280389124		current
Line 5:		Line 5:

	===== Configuration =====		===== Configuration =====
		+	<note>Since Pootle 2.1 captchas are enabled by default.</note>
	Enable the setting ''USE_CAPTCHA'' in your ''localsettings.py'', and restart your server.		Enable the setting ''USE_CAPTCHA'' in your ''localsettings.py'', and restart your server.

	===== Customisation =====		===== Customisation =====
	You can customise the captchas. Have a look at the template and the code using it. (currently at ''templates/captcha.html'' and ''pootle/middleware/captcha.py'')		You can customise the captchas. Have a look at the template and the code using it. (currently at ''templates/captcha.html'' and ''pootle/middleware/captcha.py'')

pootle:characters

Wed, 28 Jul 2010 10:37:04 +0000

1180375093		current
Line 1:		Line 1:
	====== Special characters ======		====== Special characters ======

-	Pootle can display clickable characters to help people insert characters which might be difficult to type. Earlier Pootle versions only displayed the special characters. This page allows people to specify which characters might be useful for translators.	+	Pootle can display clickable characters to help people insert characters which might be difficult to type. For many languages using the Latin alphabet with diacritics, this helps a lot, especially where keyboard layouts are not always common.

-	For many languages this does not really help much, but we realise that many languages using the Latin alphabet with diacritics, this could help a lot. Well supported languages like French fall in this category, I guess that most French users probably have no input problems in general. If you think that this feature could help some members of your community on some pootle servers, you can also include your requests here.	+	This page allows people to specify which characters might be useful for translators. This does not solve the input needs for all languages, but has been a very useful help for many languages, especially in translate@thons.

-	For people using non-Latin scripts, consider if it will be useful to perhaps include things from the Latin keyboard that can't be easily typed by translators in your language.	+	For people using non-Latin scripts, consider if it will be useful to perhaps include things that can't be easily typed by translators in your language. We will probably need to limit the number of characters, but hopefully we can find a reasonable compromise that will help many people.

-	We will probably need to limit the number of characters, but hopefully we can find a reasonable compromise that will help many people.	+	If you edit this page, please ensure that you use a browser that supports UTF-8 encoding so that the existing text is kept in tact. Note that you might not be able to see all the characters on this page if you do not have the appropriate fonts installed. Please take care not to edit something inadvertently.
-		+
-	Please ensure that you use a browser that supports UTF-8 encoding so that the existing text is kept in tact. Note that you might not be able to see all the characters on this page if you do not have the appropriate fonts installed. Please take care not to edit something inadvertantly.	+

	===== See also =====		===== See also =====

pootle:cheatsheet

Fri, 29 Oct 2010 06:38:20 +0000

1288292454		current
Line 12:		Line 12:
	\| Submit and move to next translation \| Ctrl+Enter \| \|		\| Submit and move to next translation \| Ctrl+Enter \| \|
	\| Suggest and move to next translation \| Ctrl+Shift+Enter \| Ctrl+Enter //(if either Suggest or Submit button is shown at a time)// \|		\| Suggest and move to next translation \| Ctrl+Shift+Enter \| Ctrl+Enter //(if either Suggest or Submit button is shown at a time)// \|
-	\| Toggle the fuzzy flag \| \| Ctrl+Space //(Virtaal uses Alt+U, but this may have some special meaning on national keyboards)// \|	+	\| Toggle the fuzzy flag \| Ctrl+Space //(Virtaal uses Alt+U, but this may have some special meaning on national keyboards)// \| \|
	\| Toggle the suggest/submit mode \| \| Ctrl+Shift+Space \|		\| Toggle the suggest/submit mode \| \| Ctrl+Shift+Space \|
	\| Copy the contents from the original language \| \| Alt+Down \|		\| Copy the contents from the original language \| \| Alt+Down \|

pootle:checks

Tue, 07 Sep 2010 11:04:44 +0000

1258451517		current
Line 8:		Line 8:

	To understand the meaning of each test, Pootle displays the running tests on the top-right corner of the translation page with a link to the online documentation. You can also read the detailed descriptions of the [[toolkit:pofilter tests]].		To understand the meaning of each test, Pootle displays the running tests on the top-right corner of the translation page with a link to the online documentation. You can also read the detailed descriptions of the [[toolkit:pofilter tests]].
		+
		+	===== Overriding quality checks =====
		+	Since Pootle 2.1.0 it is possible to override the quality check if the translation is correct. Reviewers are able to remove the check for a certain string to indicate that the string is correctly translated. This avoids having to recheck the same checks multiple times.
		+
		+	If the translation is changed, this information is discarded to ensure that the new translation is tested again for any possible issues.

pootle:commands

Mon, 16 Apr 2012 15:46:57 +0000

1334577145		current
Line 76:		Line 76:

	Using the ''--cleanup'' command line option, languages added to projects that no longer have matching files on the filesystem will be deleted.		Using the ''--cleanup'' command line option, languages added to projects that no longer have matching files on the filesystem will be deleted.
		+
		+	=== update_from_vcs ===
		+	(Available since Pootle 2.2)
		+	This command updates the specified files from their [[version control]] system(s). It supports the parameters --directory, --project, and --language.
		+
		+	Pootle will take care to avoid version control conflicts, and will handle any conflicts on string level, just like it would if the update was done through the web front-end.
		+
		+	=== commit_to_vcs ===
		+	(Available since Pootle 2.2)
		+	This command commits the specified files to their [[version control]] system(s). It supports the parameters --directory, --project, and --language.
		+
		+	A file needs to be up to date, otherwise the commit will fail. Files can be updated inside Pootle, or using the update_from_vcs command. This is not done automatically, otherwise the merged version of the file will be committed without review without anybody knowing.

	==== Manually installing Pootle ====		==== Manually installing Pootle ====

pootle:configure_version_control_authentication

Sat, 26 Jan 2008 21:24:32 +0000

1168817037		current
Line 22:		Line 22:
	- make sure, that the //pootle// user has write access for //~/.subversion/// to store authentication tokens		- make sure, that the //pootle// user has write access for //~/.subversion/// to store authentication tokens
	- do a real //svn commit// with the uid //pootle// in order to:		- do a real //svn commit// with the uid //pootle// in order to:
-	* (possibly) import an SSL certificate	+	* (possibly) import an SSL certificate
-	* store the username and password in the subversion authentication cache (by default, the option //store-passwords// is enabled in //~/.subversion/config//)	+	* store the username and password in the subversion authentication cache (by default, the option //store-passwords// is enabled in //~/.subversion/config//)
		+	- If you start Pootle from an init script, make sure that all necessary environment variables are set. $HOME will be needed to obtain your cached authentication information, for example.

	From now on, //pootle// should use these stored access credentials when uploading commits for this repository.		From now on, //pootle// should use these stored access credentials when uploading commits for this repository.

pootle:copyright

Tue, 19 Jun 2007 12:17:13 +0000

1154433226		current
Line 1:		Line 1:
	====== Copyright ======		====== Copyright ======

-	Pootle documentation (everything which is included with Pootle software and/or is under the pootle/ namespace on the wiki) is released under the [[http://www.gnu.org/licenses/gpl.html\|GNU General Public License]] (GPL).	+	Pootle documentation (everything which is included with Pootle software or is under the pootle/ namespace on the wiki) is released under the [[http://www.gnu.org/licenses/gpl.html\|GNU General Public License]] (GPL).

pootle:cron

Mon, 16 Apr 2012 11:51:35 +0000

	current
Line 1:	Line 1:
	+	====== Running Pootle commands in cron ======
	+
	+	If you want to schedule certain actions on your Pootle server, using [[commands\|management commands]] with [[wp>cron]] might be a solution.
	+
	+	The management commands can perform certain batch commands which you might want to have executed periodically without user intervention.
	+
	+	For the full details on how to configure cron, view the Wikipedia page or your platform documentation (for example "man crontab"). Here is an example that runs the "refresh_stats" command daily at 02:00 AM:
	+
	+
	+	00 02 * * * www-data /var/www/sites/pootle/manage.py refresh_stats
	+
	+
	+	Test your command with the parameters you want from the command line. Insert it in the cron table, and ensure that it is executed as the correct user (the same as your web server) like www-data, for example. The user executing the command is specified in the sixth column. Cron might report errors through local mail, but it might also be useful to look at the logs in /var/log/cron/, for example.
	+
	+	If you are running Pootle from a virtualenv, or if you set any custom PYTHONPATH or similar, you might need to run your management command from a bash script that creates the correct environment for your command to run from. Call this script then from cron. It shouldn't be necessary to specify the settings file for Pootle - it should automatically be detected.
	+
	+
	+

pootle:database_migration

Thu, 25 Aug 2011 10:42:01 +0000

1307723309		current
Line 3:		Line 3:
	The default configuration for Pootle uses SQLite which is not really suited for production use. If you started using SQLite and want to migrate to another database system such as [[MySQL]] or PostgreSQL without recreating existing data, you can perform a database migration using the steps described on this page.		The default configuration for Pootle uses SQLite which is not really suited for production use. If you started using SQLite and want to migrate to another database system such as [[MySQL]] or PostgreSQL without recreating existing data, you can perform a database migration using the steps described on this page.

-	<note>A database migration is possible since Pootle 2.1.1 (or 2.0.6). This migration will only work with Django 1.2.</note>	+	<note>A database migration is possible since Pootle 2.1.1 (or 2.0.6). This migration will only work with Django 1.2 or later.</note>

	In summary, two [[commands\|manage.py commands]] are needed:		In summary, two [[commands\|manage.py commands]] are needed:
Line 19:		Line 19:
	- Ensure that you have at least Pootle 2.0.6 or Pootle 2.1.1		- Ensure that you have at least Pootle 2.0.6 or Pootle 2.1.1
	- Don't change the version of Pootle at any stage during this process		- Don't change the version of Pootle at any stage during this process
		+	- Ensure that you have at least Django 1.2.0
	- Read about how to run [[commands\|manage.py commands]]		- Read about how to run [[commands\|manage.py commands]]
	- Stop the Pootle server to avoid data changing while you migrate		- Stop the Pootle server to avoid data changing while you migrate
Line 27:		Line 28:
	- Restart the server; you should be running under the new database now		- Restart the server; you should be running under the new database now

-	Note that Pootle 2.1 database can be very large. Dumping and loading data will take long and require lots of RAM. If you have a 2.0 install it is better to migrate the database first and then upgrade to 2.1, since 2.0 database is relatively small.	+	Note that Pootle 2.1 database can be very large. Dumping and loading data will take long and require lots of RAM. If you have a 2.0 install it is better to migrate the database first and then upgrade to 2.1, since the 2.0 database is relatively small.

pootle:developer_guide

Tue, 04 Jan 2011 09:46:48 +0000

1260196490		current
Line 1:		Line 1:
	====== Pootle developer guide ======		====== Pootle developer guide ======
-
-	<note warning>The current trunk version of Pootle is unstable,
-	since we are in the process of porting Pootle to Django. If you are interested in helping, consult [[developers:The Great Pootle Migration]].</note>

	This is a collection of links and pages for people interested in Pootle development. People interested in development or related issues will want to join our mailing lists. Translate-devel is the development mailing list (more geared towards the toolkit) and translate-pootle is more geared towards Pootle users and Pootle related issues.		This is a collection of links and pages for people interested in Pootle development. People interested in development or related issues will want to join our mailing lists. Translate-devel is the development mailing list (more geared towards the toolkit) and translate-pootle is more geared towards Pootle users and Pootle related issues.
Line 10:		Line 7:
	* http://translate.sourceforge.net/wiki/toolkit/contributing		* http://translate.sourceforge.net/wiki/toolkit/contributing

		+	Pootle 2 is implemented using Django:
		+	* http://djangoproject.com/

	Some other useful links:		Some other useful links:
-	* [[https://sourceforge.net/svn/?group_id=91920\|SVN]] - Sourceforge instructions to check out the svn sources. Use the following URL https://translate.svn.sourceforge.net/svnroot/translate/src/trunk/ for the trunk of Pootle, the toolkit (and some other things).	+	* [[https://sourceforge.net/svn/?group_id=91920\|SVN]] - Sourceforge instructions to check out the SVN sources. Use the following URL https://translate.svn.sourceforge.net/svnroot/translate/src/trunk/ for the trunk of Pootle, the toolkit (and some other things).
-	* Obviously you need the same dependencies as for running Pootle. For that, see [[installation 1.2]] and/or the README file in the sources.	+	* Obviously you need the same dependencies as for running Pootle. For that, see [[installation]] and/or the README file in the sources.
	* For running Pootle without installing each time, see [[no install]].		* For running Pootle without installing each time, see [[no install]].
-	* For details about Pootle's unit tests, see the [[testing]] page.	+	* For details about unit tests, see the [[:developers:testing guidelines]].

-	===== Related =====	+	===== Debugging =====
		+	Check the debugging options in localsettings.py. You might also prefer running Pootle with the built-in Django server that can handle some changes without restarting:
		+	./manage.py runserver
		+
		+	Also consider disabling caching, or setting the times very low.
		+
		+	===== Creating the POT file =====
		+	If you made any customisations to templates or the strings in code, you might want to regenerate the POT file for the translation of the Pootle UI.
		+
		+	pootle/tools/createpootlepot
		+
		+
		+	===== Ancient =====
		+
		+	These are ancient, but maybe interesting things. Don't assume that any of this has any relevance to anything, not even Pootle 1.

	* [[metadata]] - Page by David about storing metadata, possibly in a database, etc.		* [[metadata]] - Page by David about storing metadata, possibly in a database, etc.
	* [[http://gintas.pov.lt/soc2006/ref/\|GSoC Docs]] - Documentation of the work by Gintas for the Google Summer of Code		* [[http://gintas.pov.lt/soc2006/ref/\|GSoC Docs]] - Documentation of the work by Gintas for the Google Summer of Code

-	===== Localisation =====

-	==== Live translation ====	+
		+	==== Localisation ====
		+
		+	=== Live translation ===

	Pootle can translate live. That is if you translate Pootle using itself your translations will be available immediately. You can translate Pootle from any running instance of Pootle that has an editable Pootle project.		Pootle can translate live. That is if you translate Pootle using itself your translations will be available immediately. You can translate Pootle from any running instance of Pootle that has an editable Pootle project.
Line 30:		Line 45:
	To actually ensure that your translations are available to all through the next Pootle release please translate on [[http://pootle.locamotion.org]]		To actually ensure that your translations are available to all through the next Pootle release please translate on [[http://pootle.locamotion.org]]

-	==== Creating POT files ====	+	=== Creating POT files ===

	This step is only needed if you need to create a new POT file through some code modifin or for releases or to identify why something remains untranslated. To create the pootle.pot file, run the following command in the Pootle installation directory:		This step is only needed if you need to create a new POT file through some code modifin or for releases or to identify why something remains untranslated. To create the pootle.pot file, run the following command in the Pootle installation directory:

pootle:django_migration

Fri, 12 Dec 2008 11:09:42 +0000

1199555889		current
Line 1:		Line 1:
	If you change this page, pleas notify me on IRC (hruske), or better yet, write your comments in mail and I'll add them here. (Zejn)		If you change this page, pleas notify me on IRC (hruske), or better yet, write your comments in mail and I'll add them here. (Zejn)
		+
		+	<note warning>The information on this page is kept for historical
		+	interest. Pootle is in the process of being ported to Django. See
		+	[[developers:The Great Pootle Migration]].</note>

	====== Django migration ======		====== Django migration ======

pootle:featurelist

Mon, 25 Oct 2010 09:47:10 +0000

1282907062		current
Line 1:		Line 1:
-	* [[upload]]	+	* [[offline translation]]
	* [[version control]]		* [[version control]]
	* [[translation templates]]		* [[translation templates]]

pootle:features

Fri, 03 Feb 2012 13:30:11 +0000

1288253545		current
Line 18:		Line 18:
	* Flexible permissions and authentication		* Flexible permissions and authentication
	* Support user authentication and/or anonymous contribution		* Support user authentication and/or anonymous contribution
-	* Support LDAP authentication	+	* Support [[LDAP]] authentication
	* Separate [[suggestions\|suggestion permission]] enables wide contribution with proper review by others (ideal for bug reporting)		* Separate [[suggestions\|suggestion permission]] enables wide contribution with proper review by others (ideal for bug reporting)
	* [[permissions\|Assign permissions]] to various translators to perform different roles		* [[permissions\|Assign permissions]] to various translators to perform different roles

pootle:formats

Wed, 28 Jul 2010 10:11:39 +0000

1280310727		current
Line 1:		Line 1:
	====== Pootle file formats ======		====== Pootle file formats ======
	Pootle supports many file formats through the powerful [[toolkit:index\|Translate Toolkit]]. The Toolkit also provides several converters for other [[toolkit:formats]] that will allow you to host a lot of translatable content on Pootle.		Pootle supports many file formats through the powerful [[toolkit:index\|Translate Toolkit]]. The Toolkit also provides several converters for other [[toolkit:formats]] that will allow you to host a lot of translatable content on Pootle.
		+
		+	===== Bilingual formats =====
		+	These formats are translation files that include the source and target language in one file.

	* [[toolkit:po\|Gettext PO]]		* [[toolkit:po\|Gettext PO]]
Line 7:		Line 10:
	* [[toolkit:TBX]] (since Pootle 2.0.3)		* [[toolkit:TBX]] (since Pootle 2.0.3)
	* [[toolkit:TMX]] (since Pootle 2.0.3)		* [[toolkit:TMX]] (since Pootle 2.0.3)
-	* [[toolkit:properties\|Java properties]] (since Pootle 2.1)	+
-	* [[toolkit:strings\|Mac OSX strings]] (since Pootle 2.1)	+	All these formats can be downloaded for offline use/or translation (for example in Virtaal). We recommend [[virtaal:index\|Virtaal]] for offline translation. They can also be downloaded in XLIFF format.
-	* [[toolkit:php\|PHP arrays]] (since Pootle 2.1)	+
-	* [[toolkit:Subtitles]] (since Pootle 2.1)	+	===== Monolingual formats =====
		+	These files contain only one language in the file. Pootle supports [[monolingual]] formats without conversion since Pootle 2.1.
		+
		+	* [[toolkit:properties\|Java properties]]
		+	* [[toolkit:strings\|Mac OSX strings]]
		+	* [[toolkit:php\|PHP arrays]]
		+	* [[toolkit:Subtitles]] in many formats
		+
		+	All the formats can be downloaded for off-line translation in XLIFF format. We recommend [[virtaal:index\|Virtaal]] for offline translation.

pootle:goals

Tue, 17 Nov 2009 16:04:50 +0000

1182581955		current
Line 1:		Line 1:
	====== Creating goals ======		====== Creating goals ======
		+
		+	<note>This information is about an old Pootle version. Pootle 2.0 doesn't have goals functionality but it may be added in the future.</note>
		+
	In a translation project in Pootle, you can create goals to organise and prioritise files. Creating goals is also necessary for [[assigning]] work to people.		In a translation project in Pootle, you can create goals to organise and prioritise files. Creating goals is also necessary for [[assigning]] work to people.

pootle:important_changes

Thu, 25 Aug 2011 10:46:37 +0000

1283941432		current
Line 11:		Line 11:

	(none yet)		(none yet)
		+
		+	===== 2.1.6 =====
		+	This is the first version that is compatible with Django 1.2.5 and Django 1.3. You also need Translate Toolkit 1.9.0 to be able to use these newer versions of Django.

	===== Pootle 2.1.1 =====		===== Pootle 2.1.1 =====

pootle:index

Wed, 25 Jan 2012 18:45:46 +0000

1327517110		current
Line 5:		Line 5:
	Pootle makes use of the powerful API of the [[toolkit:index\|Translate Toolkit]]. Together, these tools are part of our project to make translation easier and of higher quality by creating better tools and user-friendly, central information.		Pootle makes use of the powerful API of the [[toolkit:index\|Translate Toolkit]]. Together, these tools are part of our project to make translation easier and of higher quality by creating better tools and user-friendly, central information.

-	The official Pootle server is at http://pootle.locamotion.org/ and you can find more information about this specific server [[nl/pootle/official_server\|here]].	+	The official Pootle server is at http://pootle.locamotion.org/ and you can find more information about this specific server [[official_server\|here]].

	===== About Pootle =====		===== About Pootle =====

pootle:indexing

Mon, 28 Jun 2010 11:56:07 +0000

1273061085		current
Line 6:		Line 6:

	For now the current indexing engines are supported:		For now the current indexing engines are supported:
-	* [[http://xapian.org\|Xapian]] (v1.0 or higher). Note that you need at least [[http://svn.xapian.org/checkout/tags/1.0.13/xapian-bindings/NEWS\|version 1.0.13]] to run under Apache with mod_wsgi or mod_python.	+	* [[http://lucene.apache.org/\|Lucene]]: This should be the fastest, but is not packaged on many distributions, and is a bit harder to build.
-	* [[http://lucene.apache.org/\|Lucene]]	+	* [[http://xapian.org\|Xapian]] (v1.0 or higher): Note that you need at least [[http://svn.xapian.org/checkout/tags/1.0.13/xapian-bindings/NEWS\|version 1.0.13]] to run under Apache with mod_wsgi or mod_python.

	===== Usage =====		===== Usage =====
Line 21:		Line 20:

	See below for details.		See below for details.
		+
		+	==== Lucene ====
		+	* Install the [[http://pylucene.osafoundation.org/\|PyLucene]] package
		+	* for debian: follow this [[https://systemausfall.org/wikis/howto/PyLuceneOnDebian\|Howto]]
		+
	==== Xapian ====		==== Xapian ====
	* Install the [[http://xapian.org/docs/bindings/python/\|python bindings for Xapian]]		* Install the [[http://xapian.org/docs/bindings/python/\|python bindings for Xapian]]
Line 26:		Line 30:
	Xapian tools is needed for xapian-check which determines whether the version is OK to use or not.		Xapian tools is needed for xapian-check which determines whether the version is OK to use or not.

-	==== Lucene ====
-	* Install the [[http://pylucene.osafoundation.org/\|PyLucene]] package
-	* for debian: follow this [[https://systemausfall.org/wikis/howto/PyLuceneOnDebian\|Howto]]
	===== Debugging =====		===== Debugging =====
	If you want to check, which indexing engines are currently detected in your system, you can execute the self-tests of the indexing engine interface of Pootle: ''python translate/search/indexing/test_indexers.py''		If you want to check, which indexing engines are currently detected in your system, you can execute the self-tests of the indexing engine interface of Pootle: ''python translate/search/indexing/test_indexers.py''

pootle:installation

Wed, 28 Mar 2012 13:00:57 +0000

1332192238		current
Line 86:		Line 86:

	===== Installing Pootle =====		===== Installing Pootle =====
		+	Although it is almost never necessary to install Pootle as a Python package, it is possible. This might be useful for packagers of Linux distributions, for example.
		+
	To install Pootle just the run following command from within the Pootle directory		To install Pootle just the run following command from within the Pootle directory
	cd Pootle-2.1.1		cd Pootle-2.1.1

pootle:installation_1.2

Mon, 07 Dec 2009 15:29:15 +0000

1260196489		current
Line 1:		Line 1:

-	<note>This page refers to an old Pootle version. For those willing to try the latest version, please follow [[.:pootle:installation_1.3beta\|these installation instructions]].</note>	+	<note>This page refers to an old Pootle version. For those looking for the latest version, please follow [[.:pootle:installation\|these installation instructions]].</note>

	====== System requirements ======		====== System requirements ======

pootle:ldap

Fri, 03 Feb 2012 13:26:56 +0000

	current
Line 1:	Line 1:
	+	====== LDAP configuration ======

	+	The different elements of the LDAP configuration are defined in your Pootle/localsettings.py file. Although most of it is explained in the file, below is a brief example of a working configuration.
	+
	+	The mail addresses are john.doe@website.org, the ldap server is your.ldapserver.org. In this case, we need a specific user account to search on our ldap, this user/password is admin/pootle. The ldap accounts are based on the mail addresses : these are the uids. Finally, John Doe is part of the branch "employees" on the ldap.
	+
	+	''
	+	# Use the commented definition to authenticate first with an LDAP system and \\
	+	# then to fall back to Django's authentication system. \\
	+	AUTHENTICATION_BACKENDS=('pootle.auth.ldap_backend.LdapBackend', 'django.contrib.auth.backends.ModelBackend',) \\
	+	#AUTHENTICATION_BACKENDS = ('django.contrib.auth.backends.ModelBackend',) \\
	+
	+	# LDAP Setup \\
	+	# The LDAP server. Format: protocol://hostname:port \\
	+	AUTH_LDAP_SERVER = 'ldap://your.ldapserver.org:389' \\
	+	# Anonymous Credentials : if you don't have a super user, don't put cn=... \\
	+	AUTH_LDAP_ANON_DN = 'cn=admin,dc=website,dc=org' \\
	+	AUTH_LDAP_ANON_PASS = 'pootle' \\
	+	# Base DN to search \\
	+	AUTH_LDAP_BASE_DN = 'ou=employees,dc=website,dc=org' \\
	+	# What are we filtering on? %s will be the username (must be in the string) \\
	+	# In this case, we filter on mails, which are the uid. \\
	+	AUTH_LDAP_FILTER = 'uid=%s' \\
	+	# This is a mapping of Pootle field names to LDAP fields. The key is \\ # Pootle's name, the value should be your LDAP field name. If you don't use the \\ # field or don't want to automatically retrieve these fields from LDAP comment \\ # them out. The only required field is 'dn'. givenName, sn and uid are the names \\ # of the LDAP fields. \\
	+	AUTH_LDAP_FIELDS = { \\
	+	'dn': 'dn', \\
	+	'first_name':'givenName', \\
	+	'last_name':'sn', \\
	+	'email':'uid' \\
	+	} \\
	+	''

pootle:live_servers

Tue, 17 Apr 2012 11:43:33 +0000

1332776957		current
Line 239:		Line 239:
	* http://wundermaninteractive.com/		* http://wundermaninteractive.com/
	* Siemens		* Siemens
-	* [[http://www.tellows.de\|Tellows]] - is using Pootle to translate frontend content from German to [[http://www.tellows.ru\|.ru]] [[http://www.tellows.it\|.it]] [[http://www.tellows.es\|.es]] [[http://www.tellows.fr\|.fr]] [[http://www.tellows.cz\|.cz]] [[http://www.tellows.jp\|.jp]] [[http://www.tellows.pl\|.pl]] [[http://www.tellows.com\|.com]][[http://www.tellows.co.uk\|.co.uk]][[http://www.tellows.nl\|.nl]] [[http://www.tellows.at\|.at]] [[http://www.tellows.ch\|.ch]] [[http://www.tellows.se\|.se]] [[http://www.tellows.in\|.in]] [[http://www.tellows.co.nz\|.co.nz]][[http://www.tellows.se\|.se]] ... almost in notime	+	* [[http://www.tellows.de\|Tellows]] - is using Pootle to translate frontend content from German to several languages
		+	* http://arta.kz/

	===== Temporary Pootle Servers =====		===== Temporary Pootle Servers =====

pootle:locales

Sun, 05 Feb 2012 21:26:54 +0000

1289836116		current
Line 22:		Line 22:

	run the following commands		run the following commands
-	sudo grep UTF-8 /usr/share/i18n/SUPPORTED \| grep -v '^tr_' \| > /var/lib/locales/supported.d/all	+	sudo grep UTF-8 /usr/share/i18n/SUPPORTED \| grep -v '^tr_' > /var/lib/locales/supported.d/all
	sudo dpkg-reconfigure locales		sudo dpkg-reconfigure locales

pootle:locking

Thu, 11 Feb 2010 10:33:36 +0000

1148997038		current
Line 1:		Line 1:
		+	<note>
		+	This is an old page with notes about locking. Pootle 2 should address all issues mentioned here. (Some were already solved by earlier releases.)
		+	</note>
		+
	===== Locking in Pootle =====		===== Locking in Pootle =====

pootle:logstats

Tue, 17 Nov 2009 16:12:19 +0000

1185548454		current
Line 1:		Line 1:
		+
		+	<note>This information is about an old Pootle version. Pootle 2.0 supports user contribution statistics so this is not needed anymore.</note>

	Here is a script that can analise a Pootle log file and print some basic statistics about the number of contributions each user has made.		Here is a script that can analise a Pootle log file and print some basic statistics about the number of contributions each user has made.

pootle:machine_translation

Fri, 27 Aug 2010 09:52:45 +0000

1282079231		current
Line 22:		Line 22:

	===== Known issues =====		===== Known issues =====
-	* The Apertium service provides a JavaScript file that is much bigger than necessary. A Pootle developer contributed a small rewritten version to the Apertium project. Furthermore, the JavaScript file is served in a way that doesn't allow browsers to cache it locally. This causes it to be redownloaded unnecessarily. These issues have been reported to the Apertium developers, and we expect an improvement soon.	+	* <del>The Apertium service provides a JavaScript file that is much bigger than necessary.</del> A Pootle developer contributed a small rewritten version to the Apertium project. This is now fixed.
		+	* The JavaScript file is served in a way that doesn't allow browsers to cache it locally. This causes it to be redownloaded unnecessarily. These issues have been reported to the Apertium developers, and we expect an improvement soon.

pootle:metadata

Tue, 21 Jun 2011 21:59:11 +0000

1149844199		current
Line 1:		Line 1:
		+
		+	<note warning>This page is outdated, and was only ever a draft concept planning idea. Don't take anything here as being related to any released version of Pootle.</note>
		+
	====== Pootle Metadata Storage =====		====== Pootle Metadata Storage =====

pootle:migration

Thu, 25 Aug 2011 10:43:41 +0000

1283941480		current
Line 48:		Line 48:
	==== Permissions ====		==== Permissions ====

-	Since the way permissions are stored and handled has changed in Pootle 2.0, they are not imported. You will need to reset your settings manually.	+	Since the way [[permissions]] are stored and handled has changed in Pootle 2.0, they are not imported. You will need to reset your settings manually.

pootle:model_upgrade

Wed, 02 Dec 2009 12:00:34 +0000

1259673586		current
Line 1:		Line 1:
-	Users following Pootle development have to deal with model changes that require changes to database schema.	+	====== Database Schema Upgrade ======

-	Until recently we asked users to recreate their databases from scratch but that's not always possible.	+	Users following Pootle development have to deal with model changes that require changes to database schema. Until recently we asked users to recreate their databases from scratch, but that's not always possible.

-	Schema updates are not easy in Django but the [[http://code.google.com/p/django-command-extensions/\|Django Command Extensions]] provides a ''sqldiff'' ''manage.py'' command that works for many cases (seems to work fine with MySQL for the types of changes we've been doing between the various betas and RCs of Pootle 2.0.0; fails with SQLite though)	+	Schema updates are not easy in Django but the [[http://code.google.com/p/django-command-extensions/\|Django Command Extensions]] provides a ''sqldiff'' command for ''manage.py'' that works for many cases. It seems to work fine with MySQL for the types of changes we've been doing between the various betas and RCs of Pootle 2.0.0, but fails with SQLite though.

	===== Steps =====		===== Steps =====

pootle:monolingual

Fri, 22 Oct 2010 14:18:33 +0000

1287757113		current
Line 1:		Line 1:
	====== Monolingual file support ======		====== Monolingual file support ======
-	Pootle supports hosting monolingual files natively since Pootle 2.1. Monolingual files need special attention to provide translators good workflow and help them do good translations. Read more in the [[guide:monolingual\|localisation guide]].	+	Pootle supports hosting monolingual files natively since Pootle 2.1. Monolingual files need special attention in order to provide translators with good workflow and to assist to perform good translation. Read more in the [[guide:monolingual\|localisation guide]].

-	The main difference between monolingual and bilingual projects in Pootle is that for monolingual projects a translation template is not optional. Pootle cannot meaningfully import strings from monolingual files unless the original text is present.	+	The main difference between monolingual and bilingual projects in Pootle is that for monolingual projects a translation template is required. Pootle cannot meaningfully import strings from monolingual files unless the original text is present.

-	Either the source language or the special templates language must be added to the project and their files uploaded before other languages are added. Files found in either will be considered template files (in case both templates and source language exist templates will be used).	+	Either the source language or the special templates language must be added to the project and their files uploaded before other languages are added. Files found in either will be considered template files (in the case where both templates and source language exist templates will be used).

	What users will see when translating monolingual file is a matching between strings in the templates file and strings in the target language files. The matching is format specific (for example in subtitles the matching is based on timestamps, for Java properties it is based on keys, etc.)		What users will see when translating monolingual file is a matching between strings in the templates file and strings in the target language files. The matching is format specific (for example in subtitles the matching is based on timestamps, for Java properties it is based on keys, etc.)

-	While Pootle supports uploading translations in the monolingual format this should be limited to importing old translations. users who want to translate offline should download the XLIFF version (from the translate tab).	+	While Pootle supports uploading translations in the monolingual format this should be limited to importing old translations. Users who want to translate offline should download the XLIFF version (from the translate tab).

-	When tracking monolingual files with version control, if file structure changes (i.e. new strings are introduced) source files must be updated first.	+	When tracking monolingual files with version control, if the file structure changes (e.g. new strings are added) then source files must be updated first.

-	Apart from these considerations monolingual projects will feel the same as bilingual projects. All of Pootle's features are available.	+	Apart from these considerations monolingual projects will feel and behave the same as bilingual projects, all of Pootle's features are available to administrators and translators.

-	You can still use the format converters in the Translate Toolkit to host these monolingual file formats as a Gettext PO project. This has the advantage that files in version control always have the source and target strings together and you are able to integrate more external PO tools.	+	You can still use the format converters from the Translate Toolkit to host these monolingual file formats as a Gettext PO project. This has the advantage that files in version control always have the source and target strings together and you are able to integrate with external PO tools.


-	===== Supported formats =====	+	===== Supported monoligual formats =====

	Currently supported formats include:		Currently supported formats include:

pootle:mysql

Sun, 03 Oct 2010 19:22:22 +0000

1283840242		current
Line 6:		Line 6:

	mysql -u root -p		mysql -u root -p
-	> CREATE DATABASE pootle CHARACTER SET = 'utf8;	+	> CREATE DATABASE pootle CHARACTER SET = 'utf8';
	> GRANT ALL PRIVILEGES ON pootle.* TO pootle@localhost IDENTIFIED BY 'pootlepassword';		> GRANT ALL PRIVILEGES ON pootle.* TO pootle@localhost IDENTIFIED BY 'pootlepassword';
	> FLUSH PRIVILEGES;		> FLUSH PRIVILEGES;

pootle:news

Wed, 28 Oct 2009 09:17:36 +0000

	current
Line 1:	Line 1:
	+	====== News ======
	+	Since version 2, Pootle provides the ability to access useful information about your language and projects. These can be read on Pootle, or through your RSS reader.

	+	Project administrators can write notices, and Pootle will also generate entries automatically for these events:
	+
	+	* new languages
	+	* new projects
	+	* new projects added to languages
	+	* project updated from version control
	+	* project updated to templates
	+	* file committed to version control
	+	* file uploaded to project
	+	* archive uploaded to project
	+	* file reached 100%

pootle:nginx

Thu, 04 Aug 2011 13:31:03 +0000

1312457352		current
Line 81:		Line 81:

	location / {		location / {
-	proxy_pass http://127.0.0.1:8080; # Ensure you have the correct port	+	# Ensure you have the correct port and the full domain name
		+	# This address will appear in registration emails
		+	proxy_pass http://yourfulldomainna.me:8080;
	proxy_set_header X-Real-IP $remote_addr;		proxy_set_header X-Real-IP $remote_addr;
	}		}

pootle:no_install

Tue, 04 Jan 2011 09:34:07 +0000

1161332915		current
Line 3:		Line 3:

	- Check out / update the sources		- Check out / update the sources
-	- Ensure you have the depencies	+	- Ensure you have the dependencies
		+	- (Pootle 2) symlink Pootle/translate to the toolkit directory
		+
		+
		+	===== Pootle 1.2 =====
		+	(probably not necessary any more for anyone)
	- Run setuppath from the src/ directory of the source tree (this only needs to be done once for each of your local directories - look at the script setpath that is created by setuppath for this). If you change the full path where the source tree is, you need to rerun this, otherwise you won't need to rerun it.		- Run setuppath from the src/ directory of the source tree (this only needs to be done once for each of your local directories - look at the script setpath that is created by setuppath for this). If you change the full path where the source tree is, you need to rerun this, otherwise you won't need to rerun it.
	- Include or source setpath into your environment with (running it won't work). This includes the toolkit and Pootle sources in the PYTHONPATH of your current shell only and also puts most of the executables of the toolkit in your PATH.		- Include or source setpath into your environment with (running it won't work). This includes the toolkit and Pootle sources in the PYTHONPATH of your current shell only and also puts most of the executables of the toolkit in your PATH.

pootle:notifications

Thu, 29 Jul 2010 08:42:12 +0000

1280391953		current
Line 1:		Line 1:
	====== Pootle notifications ======		====== Pootle notifications ======
-	<note>New in version 2.0.</note>
-
	Since version 2.0, Pootle has RSS feeds for notifications about concrete translation projects, languages or even the whole site. Pootle's front page will show the latest events on the site.		Since version 2.0, Pootle has RSS feeds for notifications about concrete translation projects, languages or even the whole site. Pootle's front page will show the latest events on the site.

pootle:official_server

Thu, 06 Mar 2008 13:54:53 +0000

1204811693		current
Line 3:		Line 3:
	====== Pootle server ======		====== Pootle server ======

-	This page has information about our [[http://pootle.wordforge.org\|official Pootle server]]. This server is the place for translations of the Pootle interface, as well as some other projects. Please keep your translations of the Pootle interface up to date!	+	This page has information about our [[http://pootle.locamotion.org\|official Pootle server]]. This server is the place for translations of the Pootle interface, as well as some other projects. Please keep your translations of the Pootle interface up to date!

	===== Contact =====		===== Contact =====

pootle:offline_translation

Mon, 25 Oct 2010 13:08:16 +0000

pootle:optimisation

Tue, 28 Dec 2010 11:42:01 +0000

1284453649		current
Line 28:		Line 28:
	No specific settings can be recommended, since this depends heavily on your users, your files, and your hardware. However the default value for the ''MaxClient'' directive (usually 256) is almost always too high. Experiment with values between 10 and 80.		No specific settings can be recommended, since this depends heavily on your users, your files, and your hardware. However the default value for the ''MaxClient'' directive (usually 256) is almost always too high. Experiment with values between 10 and 80.

		+	===== MySQL =====
		+
		+	If using MySQL backend, for smaller installations it is suggested to go with MyISAM backend (which might result in smaller memory usage and better performance). If high concurrency is expected, InnoDB is suggested to avoid locking issues.

	===== Customising templates =====		===== Customising templates =====

pootle:pages

Mon, 16 Aug 2010 15:56:59 +0000

1281973236		current
Line 4:		Line 4:
	* [[pootle/pages/language\|Language page]]		* [[pootle/pages/language\|Language page]]
	* [[pootle/pages/project\|Project page]]		* [[pootle/pages/project\|Project page]]
-	* [[pootle/pages/translationproject\|Translation Project page]]	+	* [[pootle/pages/translationprojectadmin\|Translation project admin page]]
		+	* [[pootle/pages/translationproject\|Translation Project pages]]
	* [[pootle/pages/translate\|Translate page]]		* [[pootle/pages/translate\|Translate page]]
		+	* [[pootle/pages/terminology\|Terminology management page]]
		+	* [[pootle/pages/filesadmin\|File admin page]]
		+	* [[pootle/pages/news\|News pages]]
	* [[pootle/pages/profile\|User account page]]		* [[pootle/pages/profile\|User account page]]
		+	* [[pootle/pages/permission\|Permissions management pages]]
	* [[pootle/pages/admin\|Admin pages]]		* [[pootle/pages/admin\|Admin pages]]
	* [[pootle/pages/contact\|Contact page]]		* [[pootle/pages/contact\|Contact page]]

pootle:performance

Thu, 11 Feb 2010 10:09:12 +0000

1148680834		current
Line 1:		Line 1:
		+	<note>
		+	This page is mostly dated now that Pootle 2.0 has much better performance, although the ideas for testing are still valid. See the page on [[optimisation\|Pootle optimisation]] for ways in which to improve Pootle performance even further. Pootle 2.1 should also have even better performance.
		+	</note>
		+
		+
	===== Pootle performance =====		===== Pootle performance =====

-	This is about performance issues in Pootle, and a plan to look into them / address them...	+	This is about performance testing in Pootle, and a plan to look into them / address them.

	==== Aspects to consider ====		==== Aspects to consider ====
Line 26:		Line 31:

	==== Achieved so far ====		==== Achieved so far ====
-	* Simple benchmark program (''benchmark.py'') that mostly measures the areas above that happen on first-time launch, outputs profiler info	+	* Simple benchmark program (''benchmark.py'') that mostly measures the areas above that happen on first-time launch, outputs profiler info (might need to be updated for Pootle 2)
	* Reduced startup time to 1/4 what it was before by optimising often-used code (low-level string functions used by parsing / index analysis code, and stats helper functions were main target)		* Reduced startup time to 1/4 what it was before by optimising often-used code (low-level string functions used by parsing / index analysis code, and stats helper functions were main target)

pootle:permissions

Tue, 02 Nov 2010 07:13:19 +0000

pootle:quotes

Tue, 12 Jul 2011 16:22:46 +0000

1310486748		current
Line 20:		Line 20:
	Please first coordinate on translate-devel@lists.sourceforge.net which		Please first coordinate on translate-devel@lists.sourceforge.net which
	is, indeed, a mailing list I'd recommend you to be suscribed to if		is, indeed, a mailing list I'd recommend you to be suscribed to if
-	interested in the development of good translation tools.[[http://itshumour.blogspot.com/2009/07/funny-nursery-rhymes-remixed.html\|nursery rhymes]]	+	interested in the development of good translation tools.


Line 48:		Line 48:

	----		----
-	[[http://itshumour.blogspot.com/2010/06/twenty-hilarious-funny-quotes.html\|funny quotes]] about visiting our IRC channel:	+	[[http://asgeirf.blogspot.com/\|Asgeir Frimannsson]] about visiting our IRC channel:

	... But generally interested in what the pootle folks are doing as they are some of the smarter people in the l10n community :-)		... But generally interested in what the pootle folks are doing as they are some of the smarter people in the l10n community :-)

pootle:ready-to-run_packages

Thu, 27 Oct 2011 09:50:23 +0000

1319709003		current
Line 22:		Line 22:


-	You can find more info about BitNami Pootle Stack at [[http://wiki.bitnami.org/Applications/bitnami_Pootle_Stack\|BitNami Pootle Wiki]]	+	You can find more info about BitNami Pootle at [[http://wiki.bitnami.org/Applications/bitnami_Pootle_Stack\|BitNami Pootle Wiki]]

pootle:roles

Mon, 16 Aug 2010 20:26:06 +0000

1281973445		current
Line 1:		Line 1:
-	here we document how to use Pootle for each user role	+	Here we document how to use Pootle for each user role
	* [[pootle/role/translator\|Pootle for translators]]		* [[pootle/role/translator\|Pootle for translators]]
	* [[pootle/role/reviewer\|Pootle for reviewers]]		* [[pootle/role/reviewer\|Pootle for reviewers]]

pootle:running_under_apache

Mon, 06 Jul 2009 14:49:47 +0000

1246891359		current
Line 1:		Line 1:
-	====== Running Pootle 1.3 under Apache ======	+	Please refer to the [[pootle:apache\|Apache wiki page]].
-		+
-	Running Pootle under Apache requires [[http://www.modpython.org/\|mod_python]] or [[http://code.google.com/p/modwsgi/\|mod_wsgi]].	+
-		+
-	You need to extract Pootle in a directory accessible to the apache user.	+
-		+
-	Prepare the Pootle database as described in [[pootle/installation_1.3beta]]	+
-		+
-	make sure Apache has read access to all of Pootle's files and write access to the //dbs// and //po// subdirectories.	+
-		+
-	depending on which apache module you'll use to deploy pootle, you need to add the relevant portion to your apache's configuration	+
-		+
-	==== mod_wsgi ====	+
-	<code>	+
-	WSGIScriptAlias /pootle /var/www/Pootle/wsgi.py	+
-		+
-	Alias /pootle/html /var/www/Pootle/html	+
-	<Directory /var/www/Pootle/html>	+
-	Order deny,allow	+
-	Allow from all	+
-	</Directory>	+
-	</code>	+
-		+
-	[[http://docs.djangoproject.com/en/1.0/howto/deployment/modwsgi/\|more info]]	+
-		+
-	==== mod_python ====	+
-	<code>	+
-	<Location "/pootle">	+
-	SetHandler python-program	+
-	PythonHandler django.core.handlers.modpython	+
-	SetEnv DJANGO_SETTINGS_MODULE pootle.settings	+
-	PythonOption django.root /pootle	+
-	PythonPath "['/var/www/Pootle'] + sys.path"	+
-	PythonInterpreter pootle	+
-	PythonDebug On	+
-	</Location>	+
-		+
-	<Location "/pootle/html">	+
-	SetHandler None	+
-	</Location>	+
-		+
-	<Directory /var/www/Pootle/html>	+
-	Order deny,allow	+
-	Allow from all	+
-	</Directory>	+
-	</code>	+
-		+
-	[[http://docs.djangoproject.com/en/1.0/howto/deployment/modpython/\|more info]]	+

pootle:searching

Tue, 07 Sep 2010 11:12:36 +0000

1283857722		current
Line 1:		Line 1:
	====== Searching in Pootle ======		====== Searching in Pootle ======
-	Pootle provides a searching functionality that allows translators / reviewers to search for some text. The search box is shown next to the language/project path currently viewed. Searching can be used to find specific things you want to work on, see how issues were solved before, or to verify consistency in your translations.	+
		+	Pootle provides a searching functionality that allows translators and reviewers to search through translations for some text. The search box is shown close to the top of the page. Searching can be used to find specific things you want to work on, see how issues were solved before, or to verify consistency in your translations.

	Search results are up to date, and will reflect the current translations in Pootle.		Search results are up to date, and will reflect the current translations in Pootle.
Line 10:		Line 11:

	===== Advanced search =====		===== Advanced search =====
-	Since Pootle 1.2 the search function has been improved a little bit. Next to the search textbox, there's an arrow icon that when clicked will toggle some options for the search to be done.	+	The search function improved in Pootle 1.2. Next to the search textbox, there's an arrow icon that when clicked will toggle some options for the search to be done.

-	At this stage, the only advanced search option is searching for fields. It is possible to select to search for text in source and target texts as well as in comments and locations. Any combination of these options is accepted.\\	+	At this stage, the advanced search option allows searching in specific fields. It is possible to select to search for text in source and target texts as well as in comments and locations. Any combination of these options is accepted.
-	As a default, it will search for source and target strings. If a non-default search is performed, the search widget will slightly change its background color.	+
		+	As a default, it will search for source and target strings. If a non-default search is performed, the search widget will slightly change its background colour.

	===== Backend ====		===== Backend ====
-	The basic searching uses [[toolkit:pogrep]] which will look for the substring in the source and target text. It supports Unicode normalisation. Alternatively, a Pootle server might be installed with an [[indexing\|indexing engine]] (PyLucene or Xapian) to speed up searching. Search results can differ slightly from the normal search, based on the indexing that engine uses.\\	+	The basic searching uses [[toolkit:pogrep]] which will look for the substring in the source and target text. It supports Unicode normalisation. Alternatively, a Pootle server might be installed with an [[indexing\|indexing engine]] (PyLucene or Xapian) to speed up searching. Search results can differ slightly from the normal search, based on the indexing that engine uses.
	Some basic query in Lucene syntax is also possible. More information on [[http://lucene.apache.org/java/docs/queryparsersyntax.html\|Lucene queries]].		Some basic query in Lucene syntax is also possible. More information on [[http://lucene.apache.org/java/docs/queryparsersyntax.html\|Lucene queries]].

pootle:service_scripts

Wed, 18 Nov 2009 15:14:54 +0000

1258557294		current
Line 170:		Line 170:

	<code bash>		<code bash>
-	#!bin/bash	+	#!/bin/bash
	# /etc/init.d/pootle: start and stop the Pootle Server		# /etc/init.d/pootle: start and stop the Pootle Server
	# Pootle runs as user -pootle- via sudo		# Pootle runs as user -pootle- via sudo

pootle:site_administrator_s_guide

Wed, 05 May 2010 11:59:51 +0000

1260196490		current
Line 10:		Line 10:
	* [[Service scripts]]		* [[Service scripts]]
	* Customising the look of Pootle		* Customising the look of Pootle
		+	* [[indexing\|Enabling text indexing]] - for fast searching

	===== Trouble shooting =====		===== Trouble shooting =====

pootle:startup_options

Thu, 19 Nov 2009 11:34:51 +0000

1258469098		current
Line 1:		Line 1:
	====== PootleServer ======		====== PootleServer ======

-	<note>This information is about an old Pootle version. Since version 2.0 Pootle is recommended to be used with Apache.</note>	+	<note>This information is about an old Pootle version. Since version 2.0 Pootle is recommended to be used with [[Apache]].</note>

	PootleServer provides the translation management system called Pootle and the web-based translation editor.		PootleServer provides the translation management system called Pootle and the web-based translation editor.

pootle:statistics

Thu, 11 Feb 2010 10:44:53 +0000

1212418449		current
Line 1:		Line 1:
-	Next to each project and file link, Pootle shows the number of translated, fuzzy and untranslated strings. It also displays a graph showing the proportion of untranslated strings in red, the proportion of fuzzy strings in grey and the proportion of translated strings in green.	+	====== Translation statistics ======
		+	Pootle gives translators and project developers an easy way to see progress on the translation work. Progress is indicated by a coloured graph to easily see how much work is complete, and how much work remains. Pootle can also give detailed statistics about the progress in translation work. Statistics report on both the progress in the number of messages, and in the number of words. The number of words gives a much better impression of how much work is involved, and allows for more accurate time estimation.
		+
		+	Pootle also assists in translation quality assurance, by performing several [[checks]] on the translations which can help in review. These quality checks correspond to the [[toolkit:pofilter tests\|quality checks]] performed by pofilter from the Translate Toolkit.

pootle:style_customisation

Thu, 05 Apr 2012 14:42:44 +0000

1332411302		current
Line 1:		Line 1:
		+	<note>
		+	There is some duplication of content and ideas between this page and [[developers:pootle:customizability\|this one]]. It should be unified at some stage.
		+	</note>
		+
		+
		+
	====== Style customisation in Pootle ======		====== Style customisation in Pootle ======
	In some cases it might be desirable to customise the styling of Pootle to fit in with your other websites or other aspects of your identity. It might also be required to add a common header or footer for proper visual integration. Before you start editing the CSS of Pootle, have a look at our [[developers:styling\|styling guidelines for developers]].		In some cases it might be desirable to customise the styling of Pootle to fit in with your other websites or other aspects of your identity. It might also be required to add a common header or footer for proper visual integration. Before you start editing the CSS of Pootle, have a look at our [[developers:styling\|styling guidelines for developers]].

pootle:suggestions

Tue, 07 Sep 2010 11:01:44 +0000

1282904274		current
Line 1:		Line 1:
	====== Translation suggestions ======		====== Translation suggestions ======
	Pootle has the ability to optionally allow users to provide suggestions that need to be reviewed before they are accepted into the real translation files. Who is allowed to do what, is determined by the configuration of [[permissions]] for the project or the server.		Pootle has the ability to optionally allow users to provide suggestions that need to be reviewed before they are accepted into the real translation files. Who is allowed to do what, is determined by the configuration of [[permissions]] for the project or the server.
		+
		+	This allows for a team to form with different roles for different team members, and makes it possible to have a more explicit review step that requires suggestions to be checked before they become the real translations. This also allows the collection of different ideas for translating a single string.

	===== Viewing and making suggestions =====		===== Viewing and making suggestions =====

pootle:terminology

Fri, 09 Jun 2006 09:13:53 +0000

1149843715		current
Line 1:		Line 1:
	====== Pootle Terminology =====		====== Pootle Terminology =====

		+	The underlying toolkit [[toolkit:base classes]] define these concepts:
	* A TranslationStore is a file that stores translations (e.g. a PO file) - although it could also be used to refer to other ways of storing translations.		* A TranslationStore is a file that stores translations (e.g. a PO file) - although it could also be used to refer to other ways of storing translations.
	* A TranslationStore contains a number of TranslationUnits which contain messages		* A TranslationStore contains a number of TranslationUnits which contain messages
Line 6:		Line 7:
	* Note that monolingual formats (like .properties, OpenOffice SDF, DTD, HTML, etc.) only contain a source string.		* Note that monolingual formats (like .properties, OpenOffice SDF, DTD, HTML, etc.) only contain a source string.
	* However when handling plurals the source may actually contain different variants of a message for different plural forms (e.g. in English, the singular and plural), and the target as well (the number of variants in source and target strings are often different because different languages handle plurals differently).		* However when handling plurals the source may actually contain different variants of a message for different plural forms (e.g. in English, the singular and plural), and the target as well (the number of variants in source and target strings are often different because different languages handle plurals differently).
-	* In Pootle we have Languages, Projects, and TranslationProjects (which are a set of translation stores translating a project into a language)	+
		+	In Pootle we have:
		+	* Languages referring to the languages translated into
		+	* Projects referring to the different programs / sets of messages we translate
		+	* TranslationProjects (which are a set of translation stores translating a project into a language)

pootle:terminology_matching

Wed, 08 Sep 2010 14:15:23 +0000

1283856320		current
Line 21:		Line 21:

	Since the terminology matching is performed in real-time, you might want to keep an eye on the size of your terminology project to ensure that performance is not affected too much by having too many terms. This is highly dependent on your server abilities and the nature of what you are translating.		Since the terminology matching is performed in real-time, you might want to keep an eye on the size of your terminology project to ensure that performance is not affected too much by having too many terms. This is highly dependent on your server abilities and the nature of what you are translating.
		+
		+	===== Generating terminology =====
		+	Since Pootle 2.1, project administrators can generate a list of frequently occurring terms from the “Translate” tab in the Pootle interface, which can help to quickly standardise some frequently occurring terms. It is also possible to add extra entries. This is based on [[:toolkit:poterminology]] from the Translate Toolkit.
		+

pootle:testing

Tue, 04 Jan 2011 09:47:20 +0000

1273491755		current
Line 1:		Line 1:
	====== Testing Pootle ======		====== Testing Pootle ======

-	This page contains notes about Pootle's unit tests and how they should be used, interpreted and expanded.	+	This page contains notes about Pootle's unit tests and how they should be used, interpreted and expanded. You might also want to check [[developers:testing guidelines]].

	Pootle 2's unit tests use the Django testing framekwork, and can be executed with		Pootle 2's unit tests use the Django testing framekwork, and can be executed with

pootle:tips_from_the_trench

Wed, 18 Nov 2009 15:18:07 +0000

1213868552		current
Line 1:		Line 1:
	====== Tips from the trench ======		====== Tips from the trench ======
		+
		+	<note>These tips have been written with Pootle versions up to 1.2 in mind and things might not be the same in newer versions of Pootle.</note>

	===== Easy term searches in Opera =====		===== Easy term searches in Opera =====

pootle:tracebacks

Mon, 08 Jan 2007 09:35:53 +0000

1168244208		current
Line 6:		Line 6:
	\| [[toolkit:--errorlevel=ERRORLEVEL\|--logerrors=ERRORLEVEL]] \| level of errors to send to log: none, message, exception, traceback \|		\| [[toolkit:--errorlevel=ERRORLEVEL\|--logerrors=ERRORLEVEL]] \| level of errors to send to log: none, message, exception, traceback \|

-	If you use ''--browseerrors'' then the traceback will be sent to the web browser. This is useful if you are debugging locally, but is probably a problem if this is a live Pootle site as you might not want people to see the traceback. Using ''--logerrors'' will output the errors to the log, this is probably the best option for a live Pootle server.	+	If you use ''--browsererrors'' then the traceback will be sent to the web browser. This is useful if you are debugging locally, but is probably a problem if this is a live Pootle site as you might not want people to see the traceback. Using ''--logerrors'' will output the errors to the log, this is probably the best option for a live Pootle server.

	We suggest that you use ''--logerrors=traceback'' on a live server and add ''--browsererrors=traceback'' when debugging.		We suggest that you use ''--logerrors=traceback'' on a live server and add ''--browsererrors=traceback'' when debugging.

pootle:translation_templates

Fri, 22 Oct 2010 15:45:19 +0000

1287762319		current
Line 21:		Line 21:
	Users with admin permissions over a language can update this single language from the files tab for the translation project.		Users with admin permissions over a language can update this single language from the files tab for the translation project.

-	This should update both the files and the database retaining old translations and using fuzzy matching to match translations when source text had minor changes (in a manner similar to pot2po). Fuzzy matched strings will be marked fuzzy.	+	This will update both the files and the database retaining old translations and using fuzzy matching to match translations when the source text had minor changes (in a manner similar to pot2po). Fuzzy matched strings will be marked as fuzzy.

pootle:ui_ideas

Mon, 20 Feb 2012 11:30:06 +0000

1282038682		current
Line 95:		Line 95:

	=== Fix ===		=== Fix ===
		+
		+	* EoghanM: The standard for fixing this is to have normal paging links be 'GET' rather than 'POST'. When you successfully submit a translation, it should be a 'POST', followed by a redirect (to the normal next 'GET' url)

	* Add a Quick Link that returns you to that point		* Add a Quick Link that returns you to that point

pootle:updatetm

Tue, 19 Aug 2008 09:11:37 +0000

1219136859		current
Line 3:		Line 3:
	updatetm is a tool in the Pootle package to generate suggestions from a translation memory to aid translators. This is done by writing .tm files for Pootle to use. Pootle has the ability to show related translations in the translate page. Although related terminology can be suggested in real time from the terminology project, currently suggested translations from a translation memory have to be generated before translation to ensure that performance is not affected too severely.		updatetm is a tool in the Pootle package to generate suggestions from a translation memory to aid translators. This is done by writing .tm files for Pootle to use. Pootle has the ability to show related translations in the translate page. Although related terminology can be suggested in real time from the terminology project, currently suggested translations from a translation memory have to be generated before translation to ensure that performance is not affected too severely.

-	Whereas terminology matching look for certain keywords in the translation like "file", "network", etc. updatetm rather looks for complete translations that are similar in the translation memory. So for a translation like	+	Whereas [[terminology matching]] look for certain keywords in the translation like "file", "network", etc. updatetm rather looks for complete translations that are similar in the translation memory. So for a translation like
	"Please enter the name:"		"Please enter the name:"
	it might give suggestions like		it might give suggestions like
Line 53:		Line 53:
	The script to use is called updatetm, not updatetm.py. To run it, you have to prepend it with "python.exe" so that MS Windows knows to use Python to run it.		The script to use is called updatetm, not updatetm.py. To run it, you have to prepend it with "python.exe" so that MS Windows knows to use Python to run it.

-	===== Bugs =====	+	===== Issues =====

	* updatetm does not yet support XLIFF files		* updatetm does not yet support XLIFF files
	* The default value of --length up to version 1.1 was far too small (50)		* The default value of --length up to version 1.1 was far too small (50)
		+	* Remember that installing [[https://sourceforge.net/project/showfiles.php?group_id=91920&package_id=260161/&abmode=1\|python-levenshtein]] will speed up the TM matching substantially. It should function without it, though.

pootle:upgrade

Fri, 10 Jun 2011 17:07:42 +0000

1292223697		current
Line 6:		Line 6:
	Check the [[installation]] instructions for the newer version, and ensure that you have all the dependencies for the newer version. The package "south" is a requirement upgrading the database, for example.		Check the [[installation]] instructions for the newer version, and ensure that you have all the dependencies for the newer version. The package "south" is a requirement upgrading the database, for example.

-	If you are still using SQLite as your Pootle 2 database, you should look into doing a [[database migration]] to MySQL or Postgres for better performance. It is recommended to do this with Pootle 2.0.6 before migrating to Pootle 2.1 (the upgrade will be faster this way).	+	If you are still using SQLite as your Pootle 2 database, you should look into doing a [[database migration]] to MySQL or Postgres for better performance. It is recommended to do this with Pootle 2.0.6 before migrating to Pootle 2.1 (the upgrade will be faster this way). Don't perform a Pootle version upgrade at the same time as a database migration. Finish the database migration completely before upgrading Pootle (or the other way round).

	Always make backups of all your translation files (your whole ''podirectory''), and your settings (''localsettings.py''). With Pootle 2.1 there is a way to synchronise all translation files with the database from the [[commands\|command line]].		Always make backups of all your translation files (your whole ''podirectory''), and your settings (''localsettings.py''). With Pootle 2.1 there is a way to synchronise all translation files with the database from the [[commands\|command line]].

pootle:version_control

Thu, 26 Apr 2012 09:17:02 +0000

1335431239		current
Line 72:		Line 72:

	Possible ways of configuring non-interactive authentication are described in [[configure version control authentication]].		Possible ways of configuring non-interactive authentication are described in [[configure version control authentication]].
		+
		+	===== Adding =====
		+	(Available since Pootle 2.2)
		+
		+	When a language is initialised from templates, Pootle will check if it is inside a version control checkout/clone. If it is, it will add the new files as initialised from the templates, and commit these initial versions. The same is done when updating from templates at a later stage - if this introduced any new files, these will be added to the configured version control system.
		+
		+	A typical commit message when adding from Pootle will look something like this:
		+
		+	New files added from Labs Translation Server based on templates

	===== Feature suggestions =====		===== Feature suggestions =====
	* Provide user interface for personal authentication (e.g. password or keyfile upload) for one-time use or permanent storage (attached to this specific Pootle user)		* Provide user interface for personal authentication (e.g. password or keyfile upload) for one-time use or permanent storage (attached to this specific Pootle user)

pootle:what_s_in_a_name

Wed, 21 Nov 2007 08:10:12 +0000

1288292454		current
Line 12:		Line 12:
	\| Submit and move to next translation \| Ctrl+Enter \| \|		\| Submit and move to next translation \| Ctrl+Enter \| \|
	\| Suggest and move to next translation \| Ctrl+Shift+Enter \| Ctrl+Enter //(if either Suggest or Submit button is shown at a time)// \|		\| Suggest and move to next translation \| Ctrl+Shift+Enter \| Ctrl+Enter //(if either Suggest or Submit button is shown at a time)// \|
-	\| Toggle the fuzzy flag \| \| Ctrl+Space //(Virtaal uses Alt+U, but this may have some special meaning on national keyboards)// \|	+	\| Toggle the fuzzy flag \| Ctrl+Space //(Virtaal uses Alt+U, but this may have some special meaning on national keyboards)// \| \|
	\| Toggle the suggest/submit mode \| \| Ctrl+Shift+Space \|		\| Toggle the suggest/submit mode \| \| Ctrl+Shift+Space \|
	\| Copy the contents from the original language \| \| Alt+Down \|		\| Copy the contents from the original language \| \| Alt+Down \|

1281973236		current
Line 4:		Line 4:
	* [[pootle/pages/language\|Language page]]		* [[pootle/pages/language\|Language page]]
	* [[pootle/pages/project\|Project page]]		* [[pootle/pages/project\|Project page]]
-	* [[pootle/pages/translationproject\|Translation Project page]]	+	* [[pootle/pages/translationprojectadmin\|Translation project admin page]]
		+	* [[pootle/pages/translationproject\|Translation Project pages]]
	* [[pootle/pages/translate\|Translate page]]		* [[pootle/pages/translate\|Translate page]]
		+	* [[pootle/pages/terminology\|Terminology management page]]
		+	* [[pootle/pages/filesadmin\|File admin page]]
		+	* [[pootle/pages/news\|News pages]]
	* [[pootle/pages/profile\|User account page]]		* [[pootle/pages/profile\|User account page]]
		+	* [[pootle/pages/permission\|Permissions management pages]]
	* [[pootle/pages/admin\|Admin pages]]		* [[pootle/pages/admin\|Admin pages]]
	* [[pootle/pages/contact\|Contact page]]		* [[pootle/pages/contact\|Contact page]]

1288004840		current
Line 1:		Line 1:
	====== Offline translation ======		====== Offline translation ======

-	Pootle strength is making translation management easy, allowing large teams to collaborate while insuring quality and consistency through features like [[checks\|quality checks]] and [[terminology matching]], opening the door for casual contributions and crowd-sourcing through [[suggestions]].	+	Pootle's strength is making translation management easy, allowing large teams to collaborate while ensuring quality and consistency through [[features]] like [[checks\|quality checks]] and [[terminology matching]], opening the door for casual contributions and crowd-sourcing through [[suggestions]].

-	However experienced translators will still prefer to use a dedicated desktop translation application.	+	However experienced translators might still prefer to use a dedicated desktop translation application.

	Offline translation using whatever tool the user prefers can be integrated within Pootle's workflow easily through downloading and uploading translation files.		Offline translation using whatever tool the user prefers can be integrated within Pootle's workflow easily through downloading and uploading translation files.
Line 13:		Line 13:
	From the Translate tab in the [[pootle:pages:translationproject\|Translation Project page]] users can download files for offline translations.		From the Translate tab in the [[pootle:pages:translationproject\|Translation Project page]] users can download files for offline translations.

-	Files are available in the original format and in [[toolkit:XLIFF]] format. Bilingual formats are suitable for offline translations, but monolingual formats should be treated as just an export. if you want to translate files from a [[monolingual]] project offline it is best to download the file as XLIFF.	+	Files are available in the original format and in [[toolkit:XLIFF]] format. Bilingual formats are suitable for offline translation, but [[monolingual]] formats should be treated as just an export. If you want to translate files offline from a monolingual project, it is best to download the file as XLIFF.

	XLIFF export will include all of the information in Pootle's database (like suggestions, fuzzy, translators comment) even if the original format doesn't support representing this information.		XLIFF export will include all of the information in Pootle's database (like suggestions, fuzzy, translators comment) even if the original format doesn't support representing this information.

-	In case you want to work with multiple files at one you can download the whole translation project or the contents of a subdirectory as a zip archive.	+	In case you want to work with multiple files at once, you can download the whole translation project or the contents of a subdirectory as a ZIP archive.

	===== Uploading =====		===== Uploading =====

-	From the [[pootle:pages:translationproject\|Translation Project page]] you can upload translations to Pootle. Translations from the uploaded file will be merged with existing translations in the database, the merge process depends on the user selected merging method	+	From the [[pootle:pages:translationproject\|Translation Project page]] you can upload translations to Pootle. Translations from the uploaded file will be merged with existing translations in the database, the merge process depends on the merging method the user selects, and the [[permissions]] the user has.

	==== Merging methods ====		==== Merging methods ====
-	* Overwrite: current file is replaced with uploaded version. all current translations are lost. Structure of file may change with new strings introduced and some existing strings deleted. requires overwrite [[permission]].	+	* Merge: translations in the uploaded file are accepted for currently untranslated strings. In case of conflict between the current file and the uploaded file, the new translations are turned into suggestions. The file structure will not change, new strings will be ignored. This requires the "translate" permission.
-	* Merge: new translations in the uploaded file are accepted. in case of conflicted translations between current file and uploaded file new transations are turned into suggestions. file structure will not change, new strings will be ignored. requires translate permission.	+	* Suggest: no translation is accepted, all new translations are added as suggestions. This requires the "suggest" permission.
-	* Suggest: no translation is accepted, all new translations are added as suggestions. requires suggest permission.	+	* Overwrite: the current file is replaced with the uploaded version. All the current translations on Pootle are lost. The structure of the file may change with new strings introduced and some existing strings deleted. This requires the "overwrite" permission.

	==== Advanced uploading ====		==== Advanced uploading ====

-	Most of the time you'll be uploading files you directly downloaded from Pootle. either in the original format or as XLIFF export. Pootle will match the uploaded file with an existing file based on filename.	+	Most of the time, you'll be uploading files you directly downloaded from Pootle - either in the original format or as XLIFF export. Pootle will match the uploaded file with an existing file based on filename.

	In case a file got renamed or you want to merge translations from a different file (for example a translation compendium created by [[toolkit:pocompendium]]) use the ''upload to'' field to specify which existing file to merge with.		In case a file got renamed or you want to merge translations from a different file (for example a translation compendium created by [[toolkit:pocompendium]]) use the ''upload to'' field to specify which existing file to merge with.

-	Users with admin permissions can introduce new files by just uploading them. in that case the merge method is irrelevant.	+	Users with admin permissions can introduce new files by just uploading them. When uploading a new file, the merge method is irrelevant.

-	Users can mass upload files using a ZIP archive, Pootle expects a ZIP file similar to the one it exports. the selected merge method will apply to the content of the archive on a file by file basis.	+	Users can mass upload files using a ZIP archive. Pootle expects a ZIP file similar to the one it exports. The selected merge method will apply to the content of the archive on a file by file basis.

-	if a ZIP archive is selected the ''upload to'' can be used to specify the subdirectory to merge with.	+	If a ZIP archive is selected, the ''upload to'' field can be used to specify the subdirectory to merge with.


	==== Caveats ====		==== Caveats ====

-	users with admin permissions should be very careful when uploading ZIP archives mistakes in naming or incorrect ''upload to'' choice can lead to introduction of many spurious files.	+	Users with admin permissions should be very careful when uploading ZIP archives. Mistakes in naming or incorrect ''upload to'' choice can lead to introduction of many spurious files.

-	users with overwrite permissions should be careful when uploading ZIP archives, as all files will be overwritten including ones they may not have translated. When overwriting it is better to do it one file at a time.	+	Users with overwrite permissions should be careful when uploading ZIP archives, as all files will be overwritten including ones that they may not have translated. When overwriting, it is better to do it one file at a time.

-	Files of a different format can be uploaded, and will be converted on the fly. but the merging behavior is format specific and not always predictable. this applies to XLIFF files generated outside of Pootle. it is preferable to always use the original format or the XLIFF exported by Pootle.	+	Files of a different format can be uploaded, and will be converted on the fly, but the merging behaviour is format specific and not always predictable. This also applies to XLIFF files generated outside of Pootle. It is preferable to always use the original format or the XLIFF file exported by Pootle.
-		+
-	Monolingual files can be uploaded, merging tranlations will depend on a corresponding template file. The uploaded and the template file should have the same exact structure. If their versions diverge incorrect translations may be introduced. This is why we recommend never using monolingual files for offline translations. uploading monolingual files should be used only when initially importing existing work.	+

		+	Monolingual files can be uploaded, but this is not recommended for normal use. To merge translations, a corresponding template file is required. The uploaded file and the template file should have exactly the same structure. If their versions differ, incorrect translations may be introduced. This is why we recommend never using monolingual files for offline translations. Uploading monolingual files should be used only when initially importing existing work.

1287777211		current
Line 1:		Line 1:
	====== Pootle permissions ======		====== Pootle permissions ======
-	This page explains how to administrate permissions on your Pootle server. There are several rights which can be assigned to users or to a group of users (like all logged in users). The default site wide permissions are configured by the server administrator. This are the permissions that will be used in each project unless other permissions are configured.	+	This page explains how to administrate permissions on your Pootle server. There are several rights which can be assigned to users or to a group of users (like all logged in users). The default site wide permissions are configured by the server administrator. These are the permissions that will be used in each project unless other permissions are configured.

	===== Permissions precedence =====		===== Permissions precedence =====
Line 8:		Line 8:

	==== Special users ====		==== Special users ====
-	Pootle has two special users nobody and default used to assign permissions to more than one user at once. nobody represents any non logged in user. and default represents any logged in user.	+	Pootle has two special users "nobody" and "default" used to assign permissions to more than one user at once. The user "nobody" represents any non logged in user, and "default" represents any logged in user.

-	If a user has permissions assigned to her user account they override any default permissions even those applied to more specific objects (ie a user who has specific rights on a language will override default rights on translation projects).	+	If a user has permissions assigned to her user account they override any default permissions even those applied to more specific objects (i.e. a user who has specific rights on a language will override default rights on translation projects).

-	Server administrators can be specified on the administer users page. Server admins have full rights on all languages and projects and override all permissions.	+	Server administrators can be specified in the users page of the admin section. Server administrators have full rights on all languages and projects and override all permissions.

	===== Available permissions =====		===== Available permissions =====
-	The following permissions may be set for the server or per language project combination:	+	The following permissions may be set for the server or per language, or language-project combination:
	* view - limits access to project of language but does not limit it's visibility.		* view - limits access to project of language but does not limit it's visibility.
	* [[suggestions\|suggest]] - the right to suggest a translation for a specific unit, also implies the right to upload file using suggest only method.		* [[suggestions\|suggest]] - the right to suggest a translation for a specific unit, also implies the right to upload file using suggest only method.
	* review - the right to review the suggested translations and accept or reject them, as well as the right to reject false positive quality checks		* review - the right to review the suggested translations and accept or reject them, as well as the right to reject false positive quality checks
-	* translate - the right to supply a translation for a specific unit or to replace the existing one, also implies the right to upload file using merge method.	+	* translate - the right to supply a translation for a specific unit or to replace the existing one. This implies the right to upload files using the merge method.
	* archive - the right to download archives (ZIP files) of a project or directory.		* archive - the right to download archives (ZIP files) of a project or directory.
	* overwrite - the right to entirely overwrite a file at the time of upload (instead of the default behaviour of merging translations)		* overwrite - the right to entirely overwrite a file at the time of upload (instead of the default behaviour of merging translations)
Line 30:		Line 30:
	Users with administrative rights for languages or translation projects can access the permissions interface by clicking on the "Permissions" tab on the language or translation project index pages.		Users with administrative rights for languages or translation projects can access the permissions interface by clicking on the "Permissions" tab on the language or translation project index pages.

-	Pootle administrators will find the default permissions interface on the administration page, right under the "Permissions" tab.	+	Pootle administrators will find the default permissions interface on the administration page, at the "Permissions" tab.

	The current rights are listed as they are assigned. The user "nobody" refers to any user that is not logged in (an anonymous, unidentified user). The user "default" refers to the rights that all logged in users will have by default, unless other specific rights were assigned to them. The rest of the users are users of the Pootle server for which non-default rights were assigned.		The current rights are listed as they are assigned. The user "nobody" refers to any user that is not logged in (an anonymous, unidentified user). The user "default" refers to the rights that all logged in users will have by default, unless other specific rights were assigned to them. The rest of the users are users of the Pootle server for which non-default rights were assigned.
Line 41:		Line 41:
	To set permissions for a specific user, select the user in the dropdown list and set the specific rights for that user. This is only necessary if the user does not yet have their own set of rights defined.		To set permissions for a specific user, select the user in the dropdown list and set the specific rights for that user. This is only necessary if the user does not yet have their own set of rights defined.

-	Users who selected the language or project in their profile settings will be listed as the project or language team. followed by a list of all registered users.	+	Users who selected the language or project in their profile settings will be listed as the project or language team. After that follows a list of all registered users.
-		+

	===== Removing a user =====		===== Removing a user =====
Line 49:		Line 47:

	<note>A user with administrative rights can remove his own administrative rights.</note>		<note>A user with administrative rights can remove his own administrative rights.</note>
-

1154432675		current
Line 1:		Line 1:
	====== What's in a name? ======		====== What's in a name? ======

-	How did we arrive at such a strange name? There are of course more imnpolite ways of phrasing that question but the answer is always the same, "Yes we know that its sounds similar to that Spanish word". We followed the American tradition (with all of us being African that was of course easy, since it was nice to make sweeping assumptions about another country for a change) which is to find a word and create and acronym.	+	How did we arrive at such a strange name? There are of course more impolite ways of phrasing that question but the answer is always the same, "Yes we know that its sounds similar to that Spanish word". We followed the American tradition (with all of us being African that was of course easy, since it was nice to make sweeping assumptions about another country for a change) which is to find a word and create and acronym.

-	The word Pootle comes from this 1970's BBC TV Childrens program called [[http://www.thechestnut.com/flumps.htm\|The Flumps]]. The memories of which proved funnier then watching it 30 years later. Although the bit about Pootle keeping a secret and having to own secrets was quite funny for an Open Source coder. [[http://www.translate.org.za/blogs/david/\|David Fraser's]] wife Danielle, a British lass and thus with experience on all things British, especially BBC Childrens TV, chose the name. Pootle is the cute and fluffy baby Flump in the series so in sometimes Open Source tradition of cure and fluffy mascots, like Tux the penguin, Pootle stuck.	+	The word Pootle comes from this 1970's BBC TV Children's program called [[http://www.thechestnut.com/flumps.htm\|The Flumps]]. The memories of which proved funnier then watching it 30 years later. Although the bit about Pootle keeping a secret and having to own secrets was quite funny for an Open Source coder. [[http://www.translate.org.za/blogs/david/\|David Fraser's]] wife Danielle, a British lass and thus with experience on all things British, especially BBC Childrens TV, chose the name. Pootle is the cute and fluffy baby Flump in the series so in sometimes Open Source tradition of cure and fluffy mascots, like Tux the penguin, Pootle stuck.

-	So now that we had the name and accidently a mascot, we now needed the words for the acronym. That proved much harder. Well not really. The accronum Pootle is derived from PO-based Online Translation / Localization Engine. With a move to XLIFF we might need to create //Xlotle//.	+	So now that we had the name and accidentally a mascot, we now needed the words for the acronym. That proved much harder. Well not really. The acronym Pootle is derived from PO-based Online Translation / Localization Engine. With a move to XLIFF we might need to create //Xlotle//.

-	Pootle the character has gone through some changes. You'll notice that mst improvements and due to an improved diet now that Pootle is a true celebrety, not some kids TV series bit part player. But the core secret is that Pootle semi secretly took part in the //[[http://www.bodyforlife.com\|Body-for-Life]](tm)// program.	+	Pootle the character has gone through some changes. You'll notice that most improvements and due to an improved diet now that Pootle is a true celebrity, not some kids TV series bit part player. But the core secret is that Pootle semi secretly took part in the //[[http://www.bodyforlife.com\|Body-for-Life]](tm)// program.

	===== Pootle through the ages =====		===== Pootle through the ages =====

-	Or how I lost fat and gained mustle by getting my own Graphic Designer.	+	Or how I lost fat and gained muscle by getting my own Graphic Designer.

	Pootle when he was newly born. //Bound to be copyright the BBC but somehow can't find any copyright information.//		Pootle when he was newly born. //Bound to be copyright the BBC but somehow can't find any copyright information.//
Line 17:		Line 17:
	{{pootle:pootle-0-baby.jpg}}		{{pootle:pootle-0-baby.jpg}}

-	Pootle then realised that be might be contravening some copyright law saw he had to be handdrawn. You can see from the shaky lines that Pootle, or at least some prgorammer, respects copyright law.	+	Pootle then realised that be might be contravening some copyright law saw he had to be hand drawn. You can see from the shaky lines that Pootle, or at least some programmer, respects copyright law.

	{{pootle:pootle-1-handdrawn.jpg}}		{{pootle:pootle-1-handdrawn.jpg}}

-	A kind volunteer, who had probably dicovered some new SVG drawring tool, made us this nice version. This one guarded the gate for easy online translation for quite some time.	+	A kind volunteer, who had probably discovered some new SVG drawing tool, made us this nice version. This one guarded the gate for easy online translation for quite some time.

	{{pootle:pootle-2-smoothie.jpg}}		{{pootle:pootle-2-smoothie.jpg}}