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.

Ao fazer o login no site, se você tiver dificuldades em encontrar o seu idioma, clique em The Document Foundation - Pootle server no canto superior esquerdo da tela, você será conduzido a a página inicial da tradução onde você poderá selecionar seu idioma e/ou o projeto no qual deseja trabalhar.

Na parte superior da tela, há três listas suspensas para projetos Visão Geral, Todos os Idiomas ou Todos. A seleção de francês, por exemplo, levará você a esta página:

Project page of a selected language

Na página inicial, no canto superior direito, você pode acessar sua conta quando estiver logado.

Minha Conta

Quando você clica no seu nome de login no canto superior direito da tela, você acessa diferentes opções no menu suspenso:

  • A primeira guia exibida é o Perfil público. Esta página lhe dará as estatísticas sobre os projetos nos quais você trabalhou.
  • O próximo menu chamado Configurações é onde você configura suas preferências de tradução:
Screenshot Settings tab to configure preferences
Guia Configurações para configurar as preferências
    • escolha o número de linhas exibido na tela digitando um número no campo Número de Linhas, por padrão, é 9.
    • Idioma fonte alternativo: você pode exibir outro idioma além das fontes em inglês. Para isso, escolha um ou mais (segurando

Ctrl ao fazer uma seleção múltipla) idiomas que você deseja adicionar. Para remover um idioma selecionado, segure Ctrl enquanto clica no idioma que você deseja remover e salve suas alterações novamente.

Screenshot Display a second source language above the English one
Exibe um segundo idioma de origem acima do inglês
    • Salve suas alterações, clicando no botão Salvar.
  • As próximas abas Perfil e Senha são bastante auto-explicativas. É aqui que você gerencia seu nome, endereço de e-mail e senha.

Projetos

Esta página exibe todos os projetos enviados no repositório Pootle. Atualmente você pode ver onze projetos principais que são:

  • Localização para o produto LibreOffice master - Help
  • Localização para o produto LibreOffice master - UI
  • Localização para o produto LibreOffice 6.0 - UI
  • Localização para o produto LibreOffice 6.0 - Help
  • Localização para o produto LibreOffice 5.4 - UI
  • Localização para o produto LibreOffice 5.4 - Help
  • LibreOffice Online
  • Impress Remote (Android)
  • Website
  • Impress Remote (iOS)
  • Terminologia

Se você precisar de um projeto para ser adicionado para tradução em seu idioma, peça ao administrador Pootle por ele.

Uma maneira de acessar os arquivos para localizar é clicar no nome em azul de um dos projetos, por exemplo, LibreOffice 5.4-UI  ▸ Seu idioma. Há outras maneiras que detalhamos mais adiante nesta página.

Detalhes dos projetos

Se você entrar em um projeto, verá uma lista de todos os arquivos .po a serem traduzidos. (No topo existem alguns botões - mais sobre isso abaixo)
Cada arquivo tem uma linha que pode ser verde, verde clara ou cinza, dependendo da conclusão da tradução. O mouse mostra algumas estatísticas. Existem as colunas seguintes.

  • Nome nome dos arquivos .po.
  • Progresso uma barra de progresso, indicando o que foi feito.
  • Última atividade menciona o membro da equipe que fez as últimas traduções e o tempo em que o projeto foi atualizado.
  • Crítico o número de palavras que não foram resolvidas
  • Sugestões são as sugestões feitas por outros membros da sua equipe de idiomas. Se você tiver as permissões corretas, poderá aceitá-las ou recusá-las. Clicando no número para ir para essas palavras.
  • Incompleto o número de palavras a serem feitas. Ao clicar no número, você acessa diretamente essas palavras
  • Total o total de palavras contidas no diretório.

No lado esquerdo da barra, na parte superior, há o botão Navegar com acesso a permissões para Procurar, Traduzir, Terminologia e (permissões permitidas). Abaixo está uma barra que pode ser estendida com o '+' no lado esquerdo.
À esquerda da tela há um alça com seta dupla para baixar e enviar arquivos.

Baixar arquivos-.po

Se você selecionou um projeto específico, por exemplo libo5.4_help/, então há uma pequena alça (com seta dupla) no lado direito, que permite ocultar ou exibir um painel. Este painel contém links para fazer o download e upload de traduções off-line, dependendo dos seus direitos. A lista suspensa abaixo do link Carregar tradução permite que você envie arquivos usando o nome de outro membro da equipe.

Screenshot Panel to download or upload off line translations

Antes de prosseguir, vamos dar uma olhada em uma área muito importante, os verificadores

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.