Barra de ferramentas no editor

A barra de ferramentas aparece quando você abre um tópico ou mapa para edição no Editor. Os recursos disponíveis na barra de ferramentas são os seguintes:

Menu suspenso

A lista suspensa Menu fornece acesso às ações de edição, Localizar e substituir, Histórico de versão, Rótulo de versão, Mesclar, Criar tarefa de revisão e menu Mostrar (que inclui Rastrear alterações, Tags, Espaço não-separável).

{width="350"}

Veja a seguir a explicação detalhada desses recursos:

Editar ações

Ao editar um tópico no Editor, acesse as várias ações de edição, como Recortar ou Ctrl+X , Copiar ou Ctrl+C , Desfazer ou Ctrl+Z , Refazer ou Ctrl+Y e Excluir presentes na lista suspensa Menu.

Localizar e substituir

O recurso Localizar e substituir está disponível nos modos de exibição Autor e Source. Quando ativada, a barra de texto Localizar e Substituir aparece na parte inferior da área de edição de tópico. Você pode usar as teclas de atalho CTRL+F para invocar a barra Localizar e substituir.

Usando o ícone de configurações ( ), você pode alternar as opções de pesquisa Ignorar maiúsculas e minúsculas e Somente palavra inteira. Para executar a pesquisa que não diferencia maiúsculas de minúsculas, ative a opção Ignorar maiúsculas e minúsculas. Caso contrário, se você deseja realizar a pesquisa que diferencia maiúsculas de minúsculas, desative a opção Ignorar maiúsculas e minúsculas. Você também pode optar por pesquisar uma palavra inteira.

A pesquisa é instantânea, o que significa que à medida que você digita a frase ou palavra de pesquisa no campo Localizar, o termo é imediatamente pesquisado e selecionado no tópico. Da mesma forma, para substituir um texto em seu tópico, insira o termo de pesquisa e sua substituição nos respectivos campos e selecione o botão Substituir ou Substituir tudo.

No modo de exibição do Source, o recurso Localizar e substituir é extremamente útil para procurar um elemento ou atributo específico. Por exemplo, se você deseja substituir o valor do atributo @product, ele pode ser facilmente feito no modo de exibição Source. A visualização Autor não permite que você pesquise com base em um atributo ou elemento. No entanto, você deve ter cuidado ao usar o recurso Substituir tudo, pois ele pode substituir o código XML.

Histórico de versões

O recurso Histórico de versões no Editor permite verificar as versões disponíveis dos arquivos DITA, compará-las e reverter para qualquer versão do próprio Editor. É possível comparar o conteúdo e os metadados da versão atual (que também pode ser uma cópia de trabalho) com qualquer versão anterior do mesmo arquivo. Também é possível exibir os rótulos e comentários das versões comparadas.

Rótulos de versão

Os rótulos ajudam a identificar o estágio em que um tópico específico está no DDLC (Document Development Life Cycle). Por exemplo, ao trabalhar em um tópico, você pode definir o rótulo como "Aprovado". Depois que um tópico é publicado e disponibilizado aos clientes, é possível atribuir o rótulo "Lançado" a esse tópico.

O Experience Manager Guides permite especificar rótulos em um formato de texto livre ou usar um conjunto de rótulos predefinidos. O rótulo personalizado permitiria que qualquer autor no sistema especificasse um rótulo de acordo com sua escolha. Isso dá flexibilidade; no entanto, introduz rótulos inconsistentes no sistema. Para resolver esse problema, os administradores podem configurar um conjunto de rótulos predefinidos. Para obter mais informações sobre como configurar rótulos predefinidos, consulte Configurar e personalizar o Editor da Web de XML em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

Esses rótulos são mostrados na forma de uma lista suspensa para os autores sempre que eles precisarem especificar um rótulo. Isso garante que somente rótulos predefinidos e consistentes sejam usados no sistema.

Há diferentes métodos pelos quais você pode aplicar rótulos aos seus tópicos - painel Histórico de versões na interface do usuário do Assets, interface do usuário Linhas de Base e editor. O recurso Rótulo de versão no Editor oferece aos autores uma maneira rápida e fácil de atribuir rótulos a seus tópicos.

Mesclar

Quando você trabalha em um ambiente de vários autores, fica difícil rastrear as alterações que os outros autores fizeram em um tópico ou mapa. O recurso Mesclar oferece mais controle não apenas sobre a exibição das alterações, mas também sobre quais alterações são mantidas na versão mais recente do documento.

Criar tarefa de revisão

Você pode criar uma tarefa de revisão do tópico atual ou mapear arquivo diretamente do Editor. Abra o arquivo para o qual deseja criar a tarefa de revisão e selecione Criar tarefa de revisão na lista suspensa Menu para iniciar o processo de criação da revisão.

Mostrar menu

O menu Mostrar inclui os seguintes recursos:

Opções de inserção de conteúdo

Elemento -

Insere um elemento válido no local válido atual ou próximo. Você também pode usar o atalho de teclado Alt+Enter para abrir a caixa de diálogo Elemento. Por exemplo, ao editar um parágrafo, na caixa de diálogo Elemento, é exibida uma lista de elementos que podem ser inseridos no parágrafo. Selecione o elemento que deseja inserir. Você pode usar o teclado para percorrer a lista de elementos e pressionar Enter para inserir o elemento necessário.

Você pode exibir dois tipos de elementos válidos:

Por exemplo, se você estiver dentro do elemento <b> embutido, é possível inserir elementos como <u>, <xref>, <i> no local atual. Por outro lado, você pode inserir elementos como <table> e <topic> fora do local atual.

Você também pode digitar um caractere ou sequência de caracteres na caixa de pesquisa e pesquisar os elementos que começam com ele.

{width="300"}

Digite 't' para procurar todos os elementos válidos que comecem com 't'.

Se você estiver trabalhando dentro de um elemento de bloco como note, use o ícone Inserir elemento para inserir um novo elemento após o elemento note. Na captura de tela a seguir, um elemento de nota foi inserido no elemento p (parágrafo):

Se você pressionar Enter no elemento de nota, um novo parágrafo será criado dentro do próprio elemento de nota. Para inserir um novo elemento fora da observação, selecione o elemento p (destacado na captura de tela) na navegação estrutural dos elementos e selecione o ícone Elemento ou pressione Alt+Enter para abrir a caixa de diálogo Inserir elemento. Em seguida, selecione o elemento desejado e pressione Enter para inserir o elemento selecionado após o elemento de nota.

Você também pode adicionar um elemento entre dois elementos quando um cursor de bloco intermitente é exibido.

{width="300"}

Por exemplo, se você estiver trabalhando em um tópico DITA e o cursor de bloco estiver piscando entre a descrição curta e o corpo, é possível adicionar o elemento prolog e, em seguida, adicionar direitos autorais, autor e outros detalhes.

Outra maneira de inserir um novo elemento é usando o menu de contexto. Clique com o botão direito do mouse em qualquer lugar do documento para chamar o menu de contexto. Nesse menu, escolha Inserir Elemento para exibir a caixa de diálogo Inserir elemento e escolha o elemento que deseja inserir.

{width="300"}

Parágrafo -

Inserir elemento de parágrafo no local válido atual ou próximo.

Lista com marcadores -

Cria uma lista com marcadores no local válido atual ou próximo. Se você estiver em uma lista com marcadores e selecionar esse ícone, o item será convertido em um parágrafo normal.

Lista numerada -

Cria uma lista numerada no local válido atual ou próximo. Se você estiver em uma lista numerada e selecionar esse ícone, o item será convertido em um parágrafo normal.

Tabela -

Insere uma tabela no local válido atual ou próximo. Selecione o ícone Tabela para abrir a caixa de diálogo Inserir Tabela Simples.

{width="550"}

Você pode especificar o número de linhas e colunas necessárias na tabela. Para manter a primeira linha como o cabeçalho da tabela, selecione a opção Definir primeira linha como cabeçalho. Para adicionar um título à tabela, insira-o no campo Title.

Depois de inserir uma tabela, você pode modificá-la usando o menu de contexto.

{width="550"}

Usando o menu de contexto da tabela, você pode:

Imagem -

Insere uma imagem no local válido atual ou próximo. Selecione o ícone Imagem para abrir a caixa de diálogo Inserir imagem e, em seguida, pesquise e selecione a imagem que deseja inserir.

{width="300"}

Você pode adicionar uma imagem/Título da Figura e Texto Alternativo para a imagem na caixa de diálogo Inserir Imagem.

Usando a opção Selecionar Arquivo, você pode procurar o arquivo de imagem necessário por nome de arquivo. Você também pode filtrar os resultados da pesquisa por Caminho (para pesquisar em), Coleções, Tipo de arquivo e Tags. Depois de encontrar o arquivo de imagem necessário, selecione o arquivo e escolha Selecionar para inserir a imagem no documento. Você pode inserir vários formatos de arquivos de imagem, como .png, .svg, .gif, .jpg, .eps, .ai, .psd e muito mais.

Depois de inserir uma imagem, você pode alterar a altura, a largura, a disposição e os atributos no painel Propriedades de conteúdo. Selecione o arquivo de imagem e faça as alterações no painel Propriedades de conteúdo no painel direito.

O campo Source exibe a UUID do arquivo de imagem inserido. Você pode encontrar o caminho completo do arquivo de imagem inserido passando o ponteiro do mouse sobre o campo Source. O caminho é exibido na dica de ferramenta.

Você pode redimensionar uma imagem fornecendo o valor de Altura ou Largura para o arquivo de imagem. A proporção da imagem é mantida automaticamente. Se desejar, você também pode optar por não manter as proporções do arquivo de imagem selecionando o ícone de cadeado (de Manter Proporções) e fornecendo valores de Altura e Largura.

Você também pode especificar a configuração de Posicionamento para a imagem como Em linha ou Quebra. Caso opte por usar a opção Inserção de quebra, é possível escolher onde alinhar a imagem (esquerda, centro ou direita).

Você também pode adicionar outras propriedades para um arquivo de imagem selecionando as propriedades necessárias no campo Atributos.

Menu de contexto para arquivos de imagem ou mídia

Também é possível executar algumas operações comuns para imagens e arquivos de mídia usando o menu de contexto. Clique com o botão direito do mouse em qualquer lugar na imagem para chamar o menu de contexto.

O menu de contexto fornece opções para recortar, copiar ou colar a imagem ou mídia. Você pode inserir um elemento antes ou depois do elemento selecionado. Você também tem a opção de renomear ou decodificar um elemento. Você pode localizar a imagem ou mídia selecionada no repositório ou visualizar o arquivo na interface do usuário do Assets.

As outras opções no menu de contexto permitem copiar um caminho, editar um mapa de imagem, renomear elemento, criar um trecho ou gerar IDs para o elemento selecionado.

Inserir/Editar Mapa de Imagem

Insere um mapa de imagem na imagem selecionada. Uma imagem com áreas clicáveis que se vinculam a tópicos ou páginas da Web é chamada de mapa de imagem.

Selecione uma imagem no tópico atual e selecione o ícone Inserir/Editar mapa de imagem para abrir a caixa de diálogo Inserir mapa de imagem.

{width="650"}

Escolha a forma preferida Retangle , Circle ou Polygon para definir uma área sobre uma imagem que você deseja usar como um link. Depois de definir uma área, a caixa de diálogo Referência é exibida, onde é necessário especificar o link para conteúdo interno ou externo:

{width="650"}

Se houver sobreposição de áreas, você poderá trazer a forma para frente ou enviá-la para trás clicando no respectivo ícone na barra de ferramentas. Você também pode remover uma área selecionando-a e clicando no ícone Excluir. Clicar duas vezes em uma área abre a caixa de diálogo Referência, na qual é possível alterar o link de destino. Depois de marcar as áreas necessárias na imagem, salve as alterações selecionando Concluído.

Multimídia

Insere diferentes tipos de arquivos multimídia. Selecione o ícone suspenso Multimídia e escolha o tipo de arquivo que deseja inserir. Os formatos de multimídia compatíveis são:

Ao selecionar a opção de arquivo de Áudio ou Vídeo, você verá a exibição de repositório para procurar e selecionar o arquivo desejado. Se você escolher YouTube ou Vimeo, você obterá a caixa de diálogo Inserir multimídia. Cole o link do arquivo de vídeo no campo Link da Web e selecione Inserir para adicionar o vídeo no local válido atual ou próximo no documento.

Você poderá também adicionar o Arquivo de Áudio ou Vídeo a partir da janela Inserir Multimídia. Selecione a opção Arquivo de áudio/vídeo e, em seguida, selecione o ícone de navegação para iniciar a visualização de repositório. Selecione o arquivo de áudio ou vídeo do repositório e selecione Selecionar para adicionar o link do arquivo no campo Arquivo de Áudio/Vídeo. Caso escolha um arquivo de vídeo, uma pré-visualização do arquivo também é mostrada na área Pré-visualização. É possível reproduzir o arquivo de vídeo para visualizá-lo.

{width="650"}

Referência cruzada

Inserir referências do tipo — Referência de conteúdo, Referência de chave de conteúdo, Referência de chave, Referência de arquivo, Link da Web ou Link de email.

Selecione o ícone Selecionar Arquivo (para Referência de Conteúdo e Referência de Arquivo) ou Selecionar Mapa de Raiz (para Referência de Chave de Conteúdo e Referência de Chave) e selecione o arquivo ou conteúdo desejado para ser vinculado.

{width="650"}

Um link da referência selecionada é adicionado no documento. O menu de contexto no link fornece as opções para:

Também é possível pesquisar usando a UUID do arquivo que você deseja referenciar. Para links de Referência de Conteúdo e Chave, insira a UUID do arquivo ao qual deseja vincular e o arquivo é automaticamente pesquisado e exibido na seção Visualizar. Ao especificar a UUID do arquivo, você não precisa mencionar explicitamente a extensão de arquivo para arquivos .xml. A extensão .xml é anexada automaticamente ao UUID.

{width="650"}

Se o administrador tiver habilitado a opção UUIDs no XMLEditorConfig, você exibirá a UUID do conteúdo referenciado na propriedade Link.

Filtrar Pesquisa

Você pode procurar algum texto nos arquivos presentes no caminho selecionado do repositório do AEM. Por exemplo, é feita uma pesquisa de "geral" na captura de tela a seguir. Também é possível restringir sua pesquisa usando filtros aprimorados. Você pode procurar todos os arquivos DITA como Tópicos DITA e Mapas DITA presentes no caminho selecionado.

Você pode pesquisar arquivos não DITA como arquivos de imagem, multimídia e documentos no caminho selecionado. Também é possível pesquisar valores específicos nos atributos de elementos DITA. Você também pode procurar arquivos cujo check-out tenha sido feito pelo usuário especificado.

{width="650"}

A lista de arquivos filtrados que contém o texto pesquisado é exibida. Por exemplo, na captura de tela acima, os arquivos que contêm o texto "geral" são listados. Você também pode visualizar o conteúdo do arquivo.

Conteúdo Reutilizável -

Reutilize o conteúdo que existe em qualquer outro documento no seu projeto. Você pode inserir conteúdo vinculando diretamente ao conteúdo em um arquivo ou usando uma referência de chave, exiba Resolver referências de chave. Ao selecionar o ícone Conteúdo reutilizável, você obtém a caixa de diálogo Reutilizar conteúdo:

{width="650"}

Na caixa de diálogo Reutilizar conteúdo, selecione o arquivo DITA para referências de arquivo ou o arquivo de mapa DITA que contém as referências principais. Depois de selecionada, o tópico ou as referências de chave são mostrados na caixa de diálogo. Você pode selecionar a ID/chave do tópico que deseja inserir e selecionar Concluído para inserir o conteúdo no seu tópico.

Para inserir a Referência de conteúdo, você também pode inserir a UUID do arquivo e o conteúdo reutilizável desse arquivo é listado na seção Visualizar.

Com base na configuração para inserir links, você pode visualizar a UUID do conteúdo inserido ou o caminho relativo no painel Propriedades ou na visualização de código do Source. O link é sempre criado usando a UUID do conteúdo referenciado. Exiba Configurar links baseados em UUID em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

Você também pode incorporar o conteúdo referenciado no tópico clicando com o botão direito do mouse no conteúdo referido e escolhendo Substituir referência com conteúdo no menu de contexto.

Símbolo -

Insere caracteres especiais no tópico. Selecione o ícone de Símbolo para abrir a caixa de diálogo Inserir caractere especial.

{width="350"}

Na caixa de diálogo Inserir caractere especial, você pode procurar um caractere especial usando seu nome. Todos os caracteres especiais são armazenados em várias categorias. Use a lista suspensa Selecionar categoria e selecione uma categoria. Os caracteres especiais disponíveis na categoria selecionada são exibidos. Você pode navegar pela lista de caracteres especiais usando as teclas de seta ou selecionar o caractere desejado que deseja inserir. O Nome e o Código hexadecimal do caractere especial selecionado são exibidos abaixo da lista. Selecione Inserir para inserir o caractere selecionado no documento.

Palavra-chave -

Inserir palavra-chave definida no mapa DITA. Selecione a opção Palavra-chave para abrir a caixa de diálogo Referência-chave.

{width="550"}

As palavras-chave são listadas em ordem alfabética e você também pode pesquisar palavras-chave(s) digitando uma string de pesquisa na caixa Pesquisar. O resultado da pesquisa retornará as palavras-chave que contêm a cadeia de caracteres em ID ou Valor. As palavras-chave definidas no mapa DITA são listadas nesta caixa de diálogo. Escolha a palavra-chave que deseja inserir e selecione Inserir.

Você também pode alterar os atributos da palavra-chave inserida clicando com o botão direito do mouse na palavra-chave e selecionando a opção Atributos. A caixa de diálogo **Atributos para palavra-chave é aberta:

{width="550"}

Você pode alterar os atributos da palavra-chave ou adicionar um novo atributo à palavra-chave.

Fragmentos -

Insira um trecho no local válido atual ou seguinte. Para que esse recurso funcione, você deve ter os snippets definidos no sistema. Para obter mais informações sobre como adicionar um trecho, exiba a descrição do recurso Trecho na seção Painel esquerdo.

Ao selecionar a opção Trechos, você verá o catálogo Inserir trechos. O catálogo é sensível ao contexto, o que indica que exibirá os trechos somente se forem permitidos no local atual.

O exemplo a seguir mostra dois trechos pré-configurados - Aviso e Erro que podem ser inseridos no local atual no documento.

{width="300"}

Quando você escolhe um trecho na lista, ele é inserido no local válido atual ou próximo no documento. A captura de tela a seguir mostra o trecho de erro inserido no documento:

{width="400"}

Citações -

Crie Citações e adicione-as ao seu conteúdo. Saiba como adicionar e gerenciar citações no seu conteúdo.

Dados da consulta -

Conecte-se com sua fonte de dados e use os dados para criar conteúdo. Saiba como usar dados da sua fonte de dados.

Informações de versão e Salvar como nova versão

O recurso Informações de versão e Salvar como nova versão combina o rastreamento de versão e a gravação de conteúdo em uma única funcionalidade.

Quando você opta por salvar um tópico ou mapa usando Salvar como nova versão, a seguinte caixa de diálogo é exibida:

{width="300"}

Insira comentários e rótulos de versão para identificar as alterações e selecione Salvar para criar uma nova versão do arquivo.

Quando você escolhe a opção Salvar como nova versão, a primeira versão do tópico é criada no DAM, que também se torna a versão atualmente ativa do seu tópico. Posteriormente, se você reverter para uma versão mais antiga do tópico, essa será a versão ativa atual do tópico.

Se o administrador tiver rótulos de versão pré-configurados, você os visualizará em uma lista suspensa. Você pode escolher um rótulo na lista de rótulos disponíveis e salvar seu documento.

{width="300"}

Ao salvar um tópico, você pode adicionar um comentário especificando as alterações feitas no tópico. Este comentário é mostrado no Histórico de versão do tópico.

Se o tópico estiver sendo revisado, os revisores receberão uma notificação informando que uma versão mais recente do tópico está disponível. Eles podem acessar facilmente a última revisão do seu documento e continuar revisando a versão mais recente do seu tópico.

Ao passar o ponteiro sobre o título de um tópico, você verá o título do arquivo, o caminho do arquivo e o número da versão.

Bloquear/desbloquear

Bloqueia ou desbloqueia o arquivo atual. Bloquear um arquivo oferece acesso de gravação exclusivo ao arquivo. Isso impede que outros usuários editem o arquivo. Desbloqueie o arquivo se desejar que outras pessoas tenham acesso para edição. Quando o arquivo estiver desbloqueado, as alterações serão salvas na versão atual do arquivo.

Se você estiver na Exibição de mapa e expandir o mapa principal, será possível bloquear todos os arquivos no mapa com um único clique. Basta expandir o arquivo de mapa principal e selecionar o arquivo principal, o que resulta na seleção de todos os arquivos no mapa. Em seguida, você pode selecionar Bloquear para obter o bloqueio em todos os arquivos do mapa.

No painel Repositório, os arquivos bloqueados são exibidos com um ícone de bloqueio. Quando você passa o mouse sobre esse ícone de bloqueio, o Bloqueado por você/nome de usuário é exibido como uma dica de ferramenta.

{width="350"}

Se um arquivo for bloqueado por outro usuário, passar o mouse sobre o ícone de bloqueio no Repositório exibirá o nome do usuário que o bloqueou. Nesse caso, o arquivo abre no modo Somente leitura, com Acesso somente leitura exibido ao lado das informações da versão.

Como administrador, você também tem acesso ao recurso Forçar desbloqueio que permite desbloquear o arquivo bloqueado por outros usuários. Use este recurso para acessar os direitos de edição em um arquivo bloqueado por outros usuários.

{width="350"}