Guia do Usuário do Pootle

From The Document Foundation Wiki
Jump to: navigation, search

(Página com tradução em andamento... Ajude-nos a completar esta tradução.)


Esta página detalha as diferentes seções exibidas na interface do usuário do Pootle e como usá-las. A Página de entrada do Pootle apresenta informações sobre como obter uma conta ou acessar seu projeto de tradução. Você pode usar o Pootle seja online ou como repositório de suas traduções e usar por exemplo, o Virtaal ou OmegaT, como ferramenta de tradução offline.

Na home page, na parte superior direita, você pode acessar detalhes da sua conta quando o login ja for feito e também os projetos carregados no Pootle a serem traduzidos.

Minha Conta

When you click on your login name on the upper right of the screen, you access different options:

  • The first tab displayed is the Dashboard. This page will give you the statistics about the projects you have worked on.
  • The next tab called Settings is where you configure your translation preferences:
Screenshot Settings tab to configure preferences
Settings tab to configure preferences
    • choose the number of lines displayed on the screen by entering a number in the Number of Rows field, by default it is 9.
    • Interface Language is where you choose the language of the Pootle interface. If you do not choose a language, English will be the default language.
    • Alternative Source Languages: you can display another language aside the English sources. For this, choose one or more (by holding Ctrl while doing a multiple selection) languages that you want to add. To remove a selected language, hold Ctrl while clicking on the language you want to remove and save your changes again.
Screenshot Display a second source language above the English one
Display a second source language above the English one
    • Save your changes by clicking on the Save button.
  • The next tabs Profile and Password are rather self explaining. This is where you manage your name, e-mail address and password.

Projetos

This page displays all the projects uploaded on the Pootle repository. Currently you can see four main projects which are:

  • Localization for the 4.0.x product (UI and Help files)
  • Localization for the 4.1.x product (UI and Help files)
  • Terminology
  • Website which contains the translation of the LibreOffice website templates in your language if your team runs a translated website.

If you need a project to be added for translation in your language, ask the Pootle administrator for it.

One way to access the files to localize is to click on the green name of one of the projects, for example LibreOffice 4.1-UI ▸ Your Language. There are other ways that we detail later on this page.

Visão geral

This tab is the most important for localization. This is where you manage your files and your strings. The upper left part displays information on the overall project translation, such as the number of words, and the percentage of localized files is also shown by a green progress bar.

The list of directories and files are listed below in a tree view. The directories may contain other directories, but contain all the .po files to be translated. In front of the name of the directories, there are four columns:

  • Progress is a progress bar that indicates the level of localization.
  • Total is the total of words contained in the directory.
  • Need translation is the number of words in the directory that needs to be localized. By clicking on this number you directly access the words, and only those, that need to be translated in this directory.
  • Suggestions is the suggestions made by other members of your language team. If you have the correct permissions, you are able to accept or refuse those suggestions by clicking directly on the number displayed in this column.

Now, we have a look to a very important area of this page, the Expand details link. There you will find a set of checks to perform on the files. Some are mandatory and will break the build or your localization, if they are marked as failed and are not corrected.

Screenshot Expand details
Link to display checks

When you click on the link, you have the number of failing checks indicating them, depending on the errors present in the files. The most important and mandatory to correct are displayed in red, the others, which are more quality checks are displayed in green.

Screenshot of failing checks
Failing checks and their number displayed

In the screenshot above, you see the different categories of checks that contain failures:

  • Critical: you have to correct those failing checks because they can corrupt the build or the user interface of LibreOffice. Pootle sometimes reports false positive depending on your language, but please check anyway that there is no real positive in your translation.
  • Functional: will affect the user experience, so this is also an important part where you have to correct your translation.
  • Cosmetic: well, they are cosmetic but they will improve the general quality of your translation, so when you have time, please take a look at them too.

The Failing checks displayed may vary depending on the existent failings in your translation. To correct them, just click on the name like printf() or Invalid XML (or the number behind them) to access the concerned strings. Correct them, if needed, and once done, click Next at the bottom right of the screen until Pootle notifies you that you are over. When you have corrected all the strings contained in one category of checks, the name of this category will disappear from the list.

If you find that the failing check is a false positive of the tested string, you can override it by clicking on its label in the right area of the editor, but if the template is later updated, the string will be marked as a failing check again. This is to ensure that the new translation is tested again for any possible issues.

Área de ações

On the right of the Overview tab page, there is an Actions area which displays links to manage offline translation or to manage the directories in the repository. Depending on your permissions, you may not see all of the content of this area.

Screenshot Offline and manage areas
Offline translation and directories management
  • Translate offline
    • Download and Upload links allow you to download the set of files and upload them the same way. The download/upload will refer to the directory you are in, so pay attention of where you are in the tree. The path is always displayed at the top of the page, under the Overview name. For example, if the directory displayed is libo_ui and you click the download link, you will get the whole set of files because this is the main one. If the directory displayed is libo_ui/accessibility you will only download the files contained in the Accessibility directory. The same is true when you upload files, so make sure you are in the right directory where you want to upload your files. When you download the files, you will obtain a .zip file, but you can upload a .po file, no need to compress it. The upload link will allow you to merge your translation (and may show the merged strings as suggestions if you have chosen it) or to overwrite the file.
  • Manage (depending on your permissions on Pootle, you may not see this area)
    • Rescan project files: Pootle uses a template against which the translation is made available. When you rescan the projects, it will just check the current translation against the current template you have based your translation on.
    • Update against templates: if the template has been modified by the Pootle administrator (after some commits to the core code for example), that will update the strings you have to translate against that new one. If you were translating offline, upload your offline translation first and then update your project against the new template to get the new strings displayed for your translation.
    • Delete this folder: this allows you to delete a folder that you uploaded in error in the wrong directory for example. Be careful with this option though :-)

Pesquisa

The Search field allow you to retrieve strings or words in the current displayed directory. When you click in the field to enter the words to search for, a submenu is displayed with four checkboxes:

  • Source: you will run the search on the English strings only in the directory.
  • Target language: you will run the search on the strings in your language in the directory.
  • Comments: you will search through the comments you or others have left in the Comments section of the strings.
  • Location: you can enter the path for a specific location here.

Pressing Ctrl+⇧ Shift+S will place the focus in the Search field without displaying the submenu. Press ↵ Enter once you have typed the words you are searching for to run the search, or click on the little icon on the right of the field.

Some hints on this field:

  • you can enter several words, they will be considered as linked by a logical AND operator.
  • there is no discrimination by using either using logical OR or NOT operators.
  • the search is not case sensitive. It does not matter if you enter Options or options or opTions.
  • you can enter accelerators keys such as ~ or _ in the field, like _word or wo~rd.
  • you can not begin your search by a blank character. You will obtain no result in that case.

As you can see, this search field is pretty limited. You can find Grep commands documented on this page if you are using Linux.

Note: each string has a KeyID reference that you can use for the search. This KeyID is added as a comment on the Pootle editor, see the screenshot below, where the KeyID of the string is 9LgFW.

Screenshot KeyID in comment
Comments area containing the KeyID of the string

Tradução

The Translate tab is the third tab on the top, next to the News tab. This is where you will do your localization work, as a localizer or as reviewer or by adding suggestions. When you click on a file, the editor is displayed prompting for your translation.

This editor area, when you work on a string, can be divided in three main parts. See the screenshot below: on the left, the elements that will help you (such as path file, comments and terminology suggestions), on the middle the source string and your translation, on the right the submission button and failed checks if any.

Screenshot string area in Translate tab
String area on the Translate tab

Área esquerda

The Left area gives you some hints on the context and on the location of the file:

  • the first path is where the file is located in the tree. In our example it is File: uui/source.po, so it means in the uui directory and the file is named source.po.
  • the Context gives indication on where the string is situated in the source code and gives an indication on the nature of that string. When you are used to this, you can retrieve some context from here too.
  • the Comments here is the KeyID reference of the string in the interface. This reference is unique for each string.
  • the Terminology is a Pootle project that you can create from an existing translation. It is a simple .po file. These are displayed as suggestions for words that match the terminology when the translation exists. If you click on the suggestion label, it will insert the translated word directly in the edit field.
screenshot left area of editor
Left area of the editor, giving context and suggestions

Área central

The Central area is the editor itself where you enter your translation. If another source language is activated, it will be displayed above the English source.

  • on the very top right of this area, there is a small icon that allows you to copy the source string into the editor. You can use it when a string is a variable for example and does not differ from the source.
  • at the bottom right of the editor frame, there is a handle which allow you to enlarge or reduce the frame.
  • below the editor frame, the link Add Comment opens a field where you can enter a comment. This comment unfortunately will not be retained when the strings are uploaded to another project if you enter it from here. Once the comment is entered, click the Submit button below.
screenshot editor area
Editor area with the comment field displayed

Área direita

The Right area contains a Submit button, but you can also press Ctrl+↵ Enter to submit your translation and go to the next string.

  • the little checkbox Needs work is checked if the string is marked as fuzzy. If you need to come back to it, you can also mark it as a bookmark.
  • if you click on the Suggest link, the Submit button will change to a Suggest button and the editor will switch in Suggestions mode. The translation will appear as a suggestion that needs to be approved. You can also use Ctrl+⇧ Shift+Space to shift from one mode to the other. Strings that are entered as suggestions can be accessed directly from the tree view too.
  • Failing checks if any are displayed above the Submit button, see the screenshot below for an example.
screenshot of the right area
the submit area with Failing check displayed

Barra de status

At the bottom of the screen of this Translate tab page, a Status bar gives you several indications:

screenshot of status bar
Status Bar giving several indications and filter possibilities
  • on the left, the Search field is the same as the one previously discussed.
  • the Filter by lets you choose from a drop down list between several options: needs work, suggestions, overwritten suggestions, untranslated, etc. The screenshot above shows a filter by Checks.
  • depending on the filter you have chosen, another drop down list may be displayed. In the screenshot above, once filtered by Checks, you will be able to choose between the different Checks: Critical, Functional, Cosmetic, if any.
  • the String number that follows is the direct reference to the string in the database. This is useful if you have to discuss the string with your team as you can share its link directly.
  • the button Previous String lets you navigate to the previous string. You can also use Ctrl+ as an alternative or Ctrl+⇧ Shift+Page Up to navigate to the previous page and Ctrl+⇧ Shift+Home to navigate to the first page.
  • the next field is the page number you are on. The page count is also displayed. To navigate to another page, enter its number in the field.
  • then the Next String button allows you to navigate to the next string. You can press Ctrl+ as an alternative or Ctrl+⇧ Shift+Page Down to navigate to the next page and Ctrl+⇧ Shift+End to go to the last page.

Terminologia

The Terminology file is a .po file that you can upload and manage on Pootle. The translated words it contains will be shown as suggestions in the Translate area of the string you are working on. This file can also serve as a reference for the documentation team, translating the guides or creating new documentations.

Criação

You first have to ask the Pootle administrator to create the project on Pootle. Then you can upload an existing .po file using the Upload button on the right of the page, or extract a new terminology file from the existing localization files on Pootle using the Terminology tab page. We will discuss this last option later.

Some hints on the file creation:

  • sometimes people do not distinguish between the terms terminology and glossary.
  • when you create an entry, make it as simple as possible: object and not an object for example.
  • if you add a comment to an entry, this comment will be displayed as a tooltip in the editor.
  • you can add context information to the source term, for example view (verb) or view (noun), but don't add it to the target text (your translation), because it will be also inserted when you click on the suggestion label in the editor.
  • an entry can contain up to 30 characters.
  • when terminology is active, it is performed in real time on your translation, so be careful of the size of your terminology file, because it can affect the performance if you have too many terms.

Gerência

You can manage the file directly using the Pootle editor under the Translate tab page, by clicking on the project link and manage the terms. From here you manage the translation of the file.

There is also a Terminology tab page that allows you to display the file and add comments to the source language, as said above. This tab page also allows you to extract a new terminology file by clicking on the link You can regenerate a glossary from scratch. But you will not be able to change the translation from here. It is only possible on the Translate tab page.

  • the little i icon in front of the translation indicate some paths to files where the word is found and the number of occurrences.
  • clicking on the little callout at the right of the source field will open a comment field where you can enter information. The KeyID of the string is also entered here, so do not remove it.
  • the checkboxes on the very right of the page allow to delete string entries from the .po file.
  • you need to save your changes with the Save changes button at the bottom left of the page.
screenshot terminology entry
Terminology entry showing comment and information

Sugestões

Depending on the permissions given to team members, some of them may be able to make suggestions but are not able to translate the strings directly. We have seen above that it is possible to switch between translation mode and suggestion mode by using Ctrl+⇧ Shift+Space.

When there are any suggestions made, it will be indicated above the translation progress bar as a link: Review suggestions (xx left), where xx is the number of suggestions remaining to be reviewed. It will be also indicated in the tree view in the Suggestions column. You only have to click on one or the other number to be able to accept or refuse the suggestions.

The suggestions are displayed below the comments field, and the differences between the original string and the suggested one are highlighted in the suggestions field. To accept a suggestion, click the green check, it will replace the original string in the editor field. If you want to discard the suggestion, click the red cross, and the suggestion will be deleted.

screenshot managing suggestions
Managing suggestions

In the terminology file, it is also to vote on a suggestion by clicking the small star on the right of the suggestion area. When it is clicked the star becomes yellow and the number of votes are reported inside. To remove your vote, only click the star again.

screenshot showing votes on suggestions
Votes on suggestion

Notícias

The News tab allows members to post information about the current project or directory to the Pootle members of the project. You can send this news by e-mail too.

Some actions on the project are also reported as news, even if you do not publish them on this tab, and will appear in the News tab in the form of:

Sat 07 Sep 2013 04:21:19 PM UTC
sophie uploaded a file to LibreOffice 4.1 – UI [French] 
Before upload: 29799 of 29799 strings translated (0 fuzzy). 
After upload: 29799 of 29799 strings translated (0 fuzzy).  

This way you can monitor activities on your project, for example when the template is updated, it will also appear here.

Permissões

To see this Permissions tab, the member has to have the project, translator or administrator rights.

There are two special permissions on Pootle for Nobody and Default. The user Nobody represents any non-logged in user, and the user Default represents any logged in user.

Be careful: even as an administrator of you language, you can remove your own permissions. If it happens, kindly ask the Pootle administrator to give them back to you (we all have done it once ;-)

The different permissions are:

  • view: member will only be able to view the project, he can not perform any actions on it.
  • suggest: member will be able to enter suggestions on the project and also upload a file to the project. He will have the right to merge his uploaded file, but not to overwrite the existing file in the repository.
  • review: member will be able to accept or reject suggestions and failing checks.
  • translate: member will be able to translate and/or remove existing translations as well as upload files by merging them, but have not the right to overwrite an existing file in the repository.
  • archive: give the member the right to download a zip file from the directory
  • overwrite: give the member the right to overwrite a file when he uploads it (instead of only merging translation)
  • administrate: the member will be able to administrate his own project (not the Pootle site and not another language). He will be able to set permissions as well as download or upload files by overwriting them.

We do not use the commit permission.

To set permissions to a member, select the permission, or hold Ctrl to do a multiple selection and click the Save changes button. Ticking the check box on the right will delete the current user.