Documentation/Screenshots/pt-br

Capturas de tela para documentação
Esta página descreve como criar capturas de tela dos diálogos do LibreOffice e incluí-los na documentação / ajuda do LibreOffice. A pré-condição é ter um git clone do repositório de ajuda do LibreOffice e / ou  construir o núcleo do LibreOffice código incluindo a ajuda (  switch). Para capturas de tela em vários idiomas, crie com, onde  $ language list  é uma lista de códigos de idioma de duas ou três letras separados por espaço, por exemplo

Conceitos básicos
Cada caixa de diálogo do LibreOffice possui um ID de ajuda que o identifica exclusivamente (para que o navegador de ajuda saiba qual página de ajuda exibir quando o usuário invoca a ajuda para uma caixa de diálogo específica). O ID da ajuda geralmente se parece com isto:

ou seja, é semelhante a um caminho onde o arquivo .ui dessa caixa de diálogo é armazenado. Decidimos ter IDs de capturas de tela de diálogo (e, portanto, caminhos de arquivo onde as imagens de captura de tela são armazenadas) copie seus IDs de ajuda para evitar a manutenção de mapeamento alternativo. Dado isso, a captura de tela da caixa de diálogo acima será encontrada no seguinte caminho:

e sua versão localizada (onde  $ language_code  é um código de duas ou três letras do idioma fornecido) em:

Na árvore de origem do LibreOffice (ajuda), os arquivos com imagens de captura de tela incluídos nas páginas de ajuda (arquivos .xhp) são armazenados na seguinte pasta:

nos caminhos correspondentes aos seus IDs de captura de tela, conforme descrito acima.

Criar uma série de capturas de tela automaticamente
Para criar capturas de tela de cada caixa de diálogo do LibreOffice de uma vez, execute:

no diretório raiz de sua árvore de origem do LibreOffice. Você também pode criar capturas de tela de módulos individuais. Por exemplo, o seguinte comando cria capturas de tela de todas as caixas de diálogo do LibreOffice Calc (sc):

Após a conclusão deste comando, a captura de tela será armazenada na seguinte pasta em sua árvore de origem do LibreOffice:

nos caminhos correspondentes aos seus IDs de captura de tela, conforme descrito acima. Se você construiu o LibreOffice com suporte a múltiplos idiomas / localidades (, veja acima), esta captura de tela irá criar automaticamente capturas de tela em  'todos os idiomas'  com os quais você está construindo.

Criar capturas de tela manualmente
Para criar capturas de tela da caixa de diálogo a partir da execução do LibreOffice, você precisa ativar o modo de captura de tela (semelhante ao modo experimental) em, a chave de configuração relevante é. Quando o modo de captura de tela estiver ativo, clique com o botão direito do mouse em qualquer área de ação da caixa de diálogo (onde estão os botões " 'OK' ", " 'Cancelar' " etc.) fará com que um menu de contexto apareça:



Clique no item  'Captura de tela'  do menu de contexto para criar a captura de tela da caixa de diálogo atual. Na caixa de diálogo que aparece, você verá uma visualização da captura de tela e uma área de texto. Se você estiver satisfeito com o resultado, clique no botão  'Salvar captura de tela ...'  para armazenar a captura de tela na pasta de sua escolha, de preferência diretamente na pasta  e o caminho correspondente ao ID da captura de tela.

Explicação em vídeo
Ative a legenda em inglês:

Incluir capturas de telas nas páginas da Ajuda

 * 1) Se você criou a captura de tela com a ajuda de , copie a imagem da captura de tela da pasta   para   pasta
 * 2) Se você criou a captura de tela manualmente, a melhor abordagem é salvá-la diretamente em , respeitando o caminho do ID da captura de tela.

Agora você pode usar sua forma preferida de editar arquivos de ajuda ( manualmente ou usando extensão HelpAuthoring). Um snippet .xhp a ser incluído no arquivo de ajuda pode ter a seguinte aparência (para a caixa de diálogo da guia da área acima, caminho para a imagem da captura de tela em destaque):

Area dialog

Como alternativa, ao criar uma captura de tela manualmente, você pode copiar e colar o snippet de marcação conforme gerado na caixa de diálogo de anotação da captura de tela:



Commit das mudanças
Isso não é diferente do commit de outras alterações para o conteúdo de ajuda, o único problema é adicionar novos arquivos com capturas de tela sob o controle de versão do git: