Conhecer os recursos do Editor da Web

Esta seção aborda os vários recursos disponíveis no Editor da Web. Podemos dividir o Editor da Web nas seguintes seções ou áreas:

• Barra de ferramentas principal
• Barra de ferramentas secundária
• Painel esquerdo
• Área de edição de conteúdo
• Painel direito

As subseções a seguir abordam em detalhes as várias seções do Editor da Web.

Barra de ferramentas principal

A barra de ferramentas principal está na parte superior da interface do Editor da Web e fornece recursos no nível do arquivo e vários modos de criação disponíveis no Editor da Web. Os recursos disponíveis na barra de ferramentas superior são explicados da seguinte maneira:

Salvar tudo -

Salva as alterações feitas em todos os tópicos abertos. Se você tiver vários tópicos abertos no Editor da Web, clicar em Salvar tudo ou usar as teclas de atalho Crtl+S salvará todos os documentos com um único clique. Não é necessário salvar cada documento individualmente.

Salvar Como Nova Versão -

Salva as alterações feitas no tópico e também cria uma nova versão do tópico. Se você estiver trabalhando em um tópico recém-criado, as informações da versão serão mostradas como nenhuma.

O número da versão é alterado com cada nova versão criada para o tópico ou arquivo de mapa.

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

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

Quando você escolhe a 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ê verá esses rótulos em uma lista suspensa. Você pode escolher um rótulo na lista de rótulos disponíveis e salvar seu documento.

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 caminho do arquivo e o número da versão.

Desfazer e Refazer - /

Desfazer ou refazer a última ação.

Excluir Elemento -

Exclui o elemento atualmente selecionado ou o elemento no qual o cursor está posicionado.

Localizar e Substituir -

O recurso Localizar e substituir está disponível nos modos de exibição Autor e Source. 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 (ou selecione) 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 clique no botão Substituir ou Substituir tudo.

Na visualização do Source, Localizar e substituir é extremamente útil para pesquisar 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.

Configurações do Editor -

As Configurações do editor estão disponíveis somente para usuários administrativos. Usando as preferências, um administrador pode definir as seguintes configurações:

• Geral: as configurações Gerais permitem que você configure o dicionário a ser usado com o Editor da Web. Esta guia contém três seções: Verificação ortográfica, Condição e Criação.

  

  • Verificação ortográfica: há duas opções — Verificação ortográfica do AEM e Verificação ortográfica do navegador. Por padrão, o editor usa o recurso Verificação ortográfica do navegador, no qual a verificação ortográfica é executada usando o dicionário interno do navegador. Você pode alternar para Verificação ortográfica do AEM para usar o dicionário AEM, que também pode ser personalizado para adicionar sua lista de palavras personalizadas. Para obter mais informações sobre como personalizar o dicionário AEM, consulte a seção Personalizar o dicionário padrão do AEM em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

  • Condição

    • Realçar Texto Condicional na Exibição do Autor: selecione essa opção para realçar o texto condicional na exibição do autor. O conteúdo condicional é realçado usando a cor definida para a condição.

    • Validar com Atributos de Condição: selecione essa opção para permitir a validação dos valores definidos para os atributos. Isso impede que você adicione qualquer valor incorreto.

    • Mostrar a Chave com o Título no Painel de Esquema de Assunto: selecione essa opção para mostrar as chaves junto com os títulos no esquema de assunto. Se você não selecionar essa opção, somente os títulos serão exibidos. Por exemplo, aqui as chaves "os", "audience" e "other" também são mostradas junto com títulos.

      

    • Mostrar Esquema de Assunto no Painel de Condições: selecione essa opção para ver um esquema de assunto no painel de condições. Se você desmarcar essa opção, as condições definidas serão mostradas no painel Condições.

  • Criação

    • Habilitar Substituir Tudo: selecione esta opção para ver o ícone Substituir Tudo no painel Localizar e Substituir.

  • Citações
    Alterar o estilo das citações. Escolha o estilo da citação no menu suspenso que deseja usar em seu projeto. Para obter mais detalhes, consulte Alterar estilos de citação.

Painéis: essa configuração controla os painéis mostrados no painel esquerdo do editor. Você pode alternar o botão para mostrar ou ocultar o painel desejado.

• Lista de Elementos: como administrador, você pode controlar a lista de elementos que um autor pode inserir usando o pop-up Inserir Elemento e também definir o nome para exibição do elemento. A configuração Lista de elementos permite especificar o nome do elemento de acordo com as especificações DITA e um rótulo que você deseja usar em vez do nome do elemento definido por DITA:

  

Na captura de tela acima, o elemento b recebeu um rótulo Negrito, codeblock recebeu um rótulo de Bloco de Código junto com alguns outros elementos. Se você selecionar a opção Usar somente acima dos elementos, então somente os elementos válidos (no ponto de inserção atual) desta lista serão mostrados na janela pop-up Inserir elemento.

Na captura de tela a seguir, apenas 3 dos 4 elementos configurados da captura de tela anterior são mostrados no contexto atual:

• Lista de Atributos: assim como a Lista de Elementos, você pode controlar a lista de atributos e seus nomes de exibição a serem exibidos na lista de atributos de um elemento. Na captura de tela a seguir, apenas 3 atributos foram configurados para serem mostrados na lista de atributos de um elemento:

  

  Com essa configuração, ao tentar adicionar um atributo a um elemento, você verá apenas a lista de atributos configurados na lista.

  

• Perfil do Publish: contém os Perfis do Publish que podem ser usados para publicar a saída da Base de Dados de Conhecimento. Você pode criar um novo perfil para uma base de dados de conhecimento de destino. Por exemplo, Salesforce ou ServiceNow.

  • Criar um perfil do Salesforce Publish

    Pré-requisitos

    • Crie um aplicativo conectado para o Salesforce. Para obter mais detalhes, consulte Habilitar configurações do OAuth para integração com a API.

    • Ao configurar o aplicativo conectado, verifique o seguinte:

      • Especifique o retorno de chamada.

        URL: http://<server name>:<port>/bin/dxml/thirdparty/callback/salesforce

      • Selecione os seguintes escopos do OAuth:

        • Acesso total (total)
        • Selecione Gerenciar dados do usuário por meio das APIs (api)

  Depois que o aplicativo é configurado, o Salesforce fornece uma Chave do consumidor e Segredo do consumidor.

  Eles podem ser usados para criar o Perfil do Salesforce Publish.

  • Para criar um Perfil do Salesforce Publish, selecione a Base de Conhecimento Salesforce na lista suspensa Tipo de servidor. Insira um Nome de perfil. No URL do Site, insira o site do consumidor que você usaria para publicar a saída e, em seguida, adicionar a Chave do consumidor e o Segredo do consumidor fornecidos pelo site do consumidor do Salesforce. Em seguida, Validar e Salvar o perfil recém-criado.

    
    OBSERVAÇÃO

    Para configurar um proxy para o Salesforce no Experience Manager Guides, use Configuração de proxy de componentes HTTP do Apache no AEM. Saiba como configurar proxy para o Verificador de links AEM.

  • Criar um Perfil do ServiceNow Publish

    Pré-requisitos

    Configure o servidor ServiceNow para fazer upload dos ativos.

    • Conecte-se ao servidor ServiceNow.

    • Navegue até Propriedades do Sistema > Segurança.

    • Desmarque a seguinte opção:

      Esta propriedade deve ser definida para ativar a verificação de tipo MIME para carregamentos (Todas as versões Eureka e superiores). Ativa (true) ou desativa (false) a validação do tipo MIME para os anexos de arquivo. Extensões de arquivo configuradas via glide.attachment.extensions serão verificadas em busca de tipo MIME durante o carregamento.

    • Clique em Salvar.

    Depois de configurar o aplicativo, crie o Perfil do Publish ServiceNow.

  • Para criar um Perfil Publish, selecione a Base de Dados de Conhecimento ServiceNow na lista suspensa Tipo de Servidor. Insira um perfil Nome. Na URL do ServiceNow, insira o site do consumidor que você usaria para publicar a saída e, em seguida, adicione o Nome de Usuário e a Senha fornecidos pelo site do consumidor do ServiceNow. Em seguida, Validar e Salvar o perfil recém-criado.

    

  Depois de validar, você pode selecionar o Perfil do Publish nas predefinições de saída de um Mapa DITA e usá-lo para gerar a saída para o servidor do Salesforce ou do ServiceNow escolhido.

  Saiba mais sobre a predefinição de saída da Base de Dados de Conhecimento.

• Validação: esta guia contém opções para configurar as Validações de Esquema no editor da Web. Você pode ativar os seguintes recursos:

  • Executar verificação de validação antes de salvar o arquivo: selecione essa opção para executar validações de Esquematron usando os arquivos de Esquematron selecionados antes de qualquer operação de salvamento. Você pode adicionar um arquivo do Schematron clicando no ícone +. Os arquivos do Schematron selecionados são listados.

    OBSERVAÇÃO

    O(s) arquivo(s) de esquema selecionado(s) persistirá(ão) no perfil de pasta selecionado.

    

Isso impede que os usuários salvem qualquer arquivo que quebre uma regra definida no(s) arquivo(s) selecionado(s) do Schematron. Se esta opção não estiver selecionada, o arquivo não será validado antes de salvar as alterações.

• Permitir que todos os usuários adicionem arquivos de esquematron no painel de validação: selecione essa opção para permitir que os usuários adicionem qualquer arquivo de Esquematron no painel Validação do Editor da Web. Isso permite que os usuários adicionem arquivos do Schematron e, em seguida, validem os tópicos em relação ao arquivo Schematron. Se esta opção não estiver selecionada, o botão Adicionar arquivo do esquema não estará disponível para os usuários no Painel de validação do Editor da Web.

• Atributos de Exibição: assim como a Lista de Atributos, você pode controlar a lista de atributos a serem exibidos na lista de atributos de um elemento. Por padrão, quatro Atributos de Exibição — público-alvo, plataforma, produto e propriedades foram configurados para serem mostrados na lista de atributos de um elemento. Você também pode adicionar um atributo de exibição usando o ícone Adicionar na parte superior. Você também pode excluir qualquer um dos atributos de exibição usando o ícone Excluir.

  Os atributos definidos para um elemento são exibidos na exibição Layout e Estrutura de Tópicos.

  

• Tradução: esta guia contém as opções para criar grupos de idiomas, propagar os rótulos de origem para a versão de destino e limpar o projeto de tradução.
  

  • Grupos de Idiomas: como administrador, você pode criar um grupo de idiomas e usá-los como um conjunto para traduzir o conteúdo.
    Execute as seguintes etapas para criar um novo grupo de idiomas:

    1. Selecione o ícone Adicionar .
    2. Informe o nome do grupo de idiomas. Cada idioma deve ter um nome exclusivo. Você pode exibir um erro se o campo de nome estiver vazio ou se o nome não for exclusivo.
    3. Selecione os idiomas na lista suspensa. Você pode selecionar vários idiomas.

    Digite os primeiros caracteres do idioma ou o código do idioma para filtrar os idiomas desejados. Por exemplo, digite 'en' para filtrar todos os idiomas que contêm 'en' no início de seu nome ou código.

    1. Selecione Concluído para adicionar os idiomas selecionados ao grupo. Os idiomas são exibidos. Quando você adicionar três ou mais idiomas, Mostrar mais será exibido. Você pode selecionar Mostrar mais para exibir todos os idiomas presentes no grupo.

       DICA

       Alternar Mostrar mais para Mostrar menos e exibir apenas alguns idiomas.

    2. Passe o mouse sobre os idiomas em um grupo para editar o ou excluir os grupos de idiomas .

    3. Salve as configurações do Editor.

       OBSERVAÇÃO

       Como usuário, você pode exibir os grupos de idiomas configurados para o perfil da pasta.

  • Propagar rótulos de versão de origem para a versão de destino: selecione esta opção para passar o rótulo da versão do arquivo de origem para o arquivo traduzido. Por padrão, está desativado.

  • Limpeza do projeto de tradução após a conclusão: selecione essa opção para configurar os projetos de tradução a serem desabilitados ou excluídos automaticamente após a tradução. Por padrão, Nenhum está selecionado, portanto, o projeto existe após a tradução.

    Você pode desativar os projetos de tradução se desejar usá-los posteriormente. A exclusão de um projeto exclui permanentemente todos os arquivos e pastas presentes no projeto.

• Metadados: você pode controlar os metadados de versão do tópico e seus valores a serem exibidos na caixa de diálogo Histórico de Versão. No caminho dos metadados, especifique a localização dos nós dos quais deseja selecionar os metadados. Também é possível definir um nome personalizado para os metadados como o rótulo. As propriedades padrão são Título, Estado do documento e Tags.

  Os metadados podem ser escolhidos de qualquer propriedade no nó /jcr:content do ativo, de modo que você possa adicionar o caminho da propriedade como o caminho de Metadados.

  Um erro é exibido se o caminho de metadados estiver em branco. Se você deixar o rótulo em branco, o último elemento será escolhido como o rótulo.

  

  Configure os metadados da caixa de diálogo Histórico de Versões.

  Você também pode definir a ordem em que essas tags de metadados são exibidas. Para alterar a ordem padrão dessas tags, selecione as barras pontilhadas para arrastar e soltar as tags no local desejado.
  Os rótulos de metadados aparecem na mesma sequência no Histórico de Versões do Editor da Web.

Preferências do usuário -

As preferências do usuário estão disponíveis para todos os autores. Usando as preferências, um autor pode definir as seguintes configurações:

• Geral: a guia Geral permite definir as seguintes configurações:

  

  • Perfis de Pasta: o Perfil de Pasta controla várias configurações relacionadas a atributos condicionais, modelos de criação, predefinições de saída e configurações do Editor da Web. O Perfil global é exibido por padrão. Além disso, se o administrador tiver configurado perfis de pastas no sistema, esses perfis de pastas também serão mostrados na lista Perfis de pastas.

    As configurações do Editor da Web que um administrador pode definir no perfil da pasta incluem: personalização da interface do usuário, incluindo ícones da barra de ferramentas, layout do Editor da Web, trechos e mapa raiz. Para obter mais detalhes, consulte Configurar perfis globais ou de nível de pasta em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

    OBSERVAÇÃO

    O nome do Perfil de pasta atual é exibido como um rótulo para o ícone de Preferências do usuário na barra de ferramentas principal.

  • Caminho base: por padrão, ao acessar o repositório AEM pelo Editor da Web, você verá ativos do local /content/dam. Sua pasta de trabalho provavelmente seria algumas pastas dentro da pasta /content/dam/. Você levaria alguns cliques para acessar a pasta de trabalho todas as vezes. Você pode definir o Caminho base para sua pasta de trabalho e a Visualização do repositório, em seguida, mostra o conteúdo desse local antecipadamente. Isso reduz o tempo de acesso à pasta de trabalho. Além disso, quando você insere qualquer referência ou arquivo de mídia no tópico, o local de navegação do arquivo começa com a pasta definida no Caminho base.

  • Selecionar mapa de raiz: selecione um arquivo de mapa DITA para resolver referências de chave ou entradas de glossário. O mapa raiz selecionado tem a precedência mais alta para resolver referências principais. Para obter mais detalhes, consulte Resolver referências de chave.

    OBSERVAÇÃO

    Se não quiser usar nenhum mapa raiz, verifique se o campo Selecionar mapa raiz está em branco.

• Aparência: selecione os temas para o aplicativo Editor da Web e a exibição de origem da área de edição de conteúdo.

  

  • Exibir arquivos por: selecione a maneira padrão de exibir os arquivos no Editor da Web. Você pode exibir a lista de arquivos por títulos ou nomes de arquivo dos vários painéis na exibição Autor.

    OBSERVAÇÃO

    Por padrão, os arquivos são exibidos por título no Editor da Web.

  • Tema do aplicativo: você pode escolher entre os temas Light ou Dark para o aplicativo. No caso do tema Claro, as barras de ferramentas e os painéis usam um plano de fundo cinza-claro. No caso do tema Escuro, as barras de ferramentas e os painéis usam um plano de fundo preto. Selecione Usar tema do dispositivo para permitir que o Experience Manager Guides selecione os temas claro e escuro com base no tema do seu dispositivo. Em todos os temas, a área de edição de conteúdo é mostrada em fundo branco na exibição Autor.

  • Tema de exibição do Source: - Você pode escolher entre os temas Light ou Dark para a área de edição de conteúdo no modo de exibição de origem. No caso do tema Claro, a área de edição de conteúdo usa um plano de fundo de cor cinza-claro para a exibição de origem, enquanto no caso do tema Escuro, usa um plano de fundo de cor preta. Selecione Usar tema do dispositivo para permitir que o Experience Manager Guides selecione os temas claro e escuro com base no tema do seu dispositivo.

  • Sempre localizar arquivos no repositório: selecione esta opção para mostrar o local de um arquivo no repositório ao editá-lo no Editor da Web.

  • Mostrar indicador de espaço sem quebra no modo de autor: selecione esta opção para mostrar um indicador dos espaços sem quebra ao editá-lo no Editor da Web. Está ativado por padrão.

Modos de Autor, Source e Visualização

Para obter detalhes sobre os vários modos de criação e exibição de documentos, consulte modos de exibição do Editor da Web.

Barra de ferramentas secundária

A barra de ferramentas secundária é exibida quando você abre um tópico para edição no Editor da Web. Os recursos disponíveis na barra de ferramentas secundária são explicados da seguinte maneira:

Inserir 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 o pop-up Inserir Elemento. Por exemplo, se você está editando um parágrafo e, na janela pop-up Inserir 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:

• Elementos válidos no local atual: a lista exibe os elementos que você pode inserir no próprio local do cursor atual.

• Elementos válidos fora do local atual: a lista exibe os elementos que você pode inserir depois de qualquer um dos pais do elemento atual na hierarquia de elementos.

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.

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, clique no elemento p (destacado na captura de tela) na navegação estrutural dos elementos e clique no ícone Inserir elemento ou pressione Alt+Enter para abrir a janela pop-up 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.

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 o 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.

Inserir Parágrafo -

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

Inserir/Remover Lista Numerada -

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

Inserir/Remover 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 clicar nesse ícone, o item será convertido em um parágrafo normal.

Inserir Tabela -

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

Você pode especificar o número de linhas e colunas necessárias na tabela. Para manter a primeira linha como 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 que uma tabela é inserida, você pode modificar a tabela usando o menu de contexto.

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

• Inserir células, linhas ou colunas

• Mesclar células nas direções direita e abaixo

• Dividir células horizontalmente ou verticalmente

• Excluir células, linhas ou colunas

• Criar um trecho da tabela

• Gerar IDs

Você também pode definir atributos em várias células, linha inteira ou coluna de uma tabela. Por exemplo, para alinhar a célula da tabela, arraste e selecione a célula necessária. No painel Propriedades de conteúdo (à direita), a propriedade Type é alterada para Várias entradas.

1. Na seção Atributos, clique em +Adicionar.
2. Selecione o atributo @valign na lista suspensa Atributo.
3. Na lista suspensa de valores, selecione o alinhamento de texto desejado que deseja aplicar às células selecionadas da tabela.
4. Clique em Adicionar.

Inserir Imagem -

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

Você pode adicionar título de imagem/Figura e texto alternativo para a imagem na caixa de diálogo Inserir imagem.

Você pode pesquisar o arquivo de imagem desejado inserindo o nome do arquivo na barra Tipo a Pesquisar na parte superior e também 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 e clique em 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. Clique em um arquivo de imagem e faça 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, também é possível optar por não manter a proporção do arquivo de imagem clicando no ícone de cadeado (de Manter proporção) 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 o caminho, editar um mapa de imagem, criar um trecho ou gerar IDs para o elemento selecionado.

Inserir multimídia -

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

• Arquivo de áudio
• Arquivo de vídeo
• YouTube
• Vimeo

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 clique em 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 clique no ícone de procura para iniciar a visualização de repositório. Selecione o arquivo de áudio ou vídeo do repositório e clique em 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. Você pode reproduzir o arquivo de vídeo para visualizá-lo.

Inserir 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.

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

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

• Inserir Elemento: mostra uma lista de elementos válidos que você pode inserir no contexto fornecido.
• Copiar UUUID: copia a UUID da referência inserida.
• Copiar Caminho: copia o caminho completo da referência inserida.
• Criar trecho: cria um trecho reutilizável a partir da referência inserida.
• Gerar IDs: gera uma ID exclusiva para a referência inserida.

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.

Se o administrador tiver habilitado a opção UUIDs no XMLEditorConfig, você verá 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 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.

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.

Inserir 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. Consulte Resolver referências de chave. Ao clicar no ícone Inserir conteúdo reutilizável, você obtém a caixa de diálogo Reutilizar conteúdo:

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 clicar em 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 ver 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. Consulte Configurar links baseados em UUID no as a Cloud Service Instalar e configurar o Adobe Experience Manager Guides.

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.

Inserir Caracteres Especiais -

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

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 clicar no caractere desejado que deseja inserir. O Nome e o Código hexadecimal do caractere especial selecionado são exibidos abaixo da lista. Clique em Inserir para inserir o caractere selecionado no documento.

Inserir Palavra-chave -

Inserir palavra-chave definida no mapa DITA. Clique no ícone Inserir palavra-chave para abrir a caixa de diálogo Referência de chave.

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 clique em 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:

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

Inserir trecho -

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, consulte a descrição do recurso Trecho na seção Painel Esquerdo.

Ao clicar no ícone Inserir trecho, você verá o catálogo Inserir trecho. 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.

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:

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 clique no ícone Inserir/Editar mapa de imagem para abrir a caixa de diálogo Inserir mapa de imagem.

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:

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 clicando em Concluído.

Check-out/Check-in - /

Faz check-out ou check-in do arquivo atual. Ao fazer check-out de um arquivo, o usuário obtém acesso exclusivo de gravação ao arquivo. Quando o check-in do arquivo é feito, as alterações são salvas na versão atual do arquivo.

Se você estiver na Exibição de mapa e expandir o mapa principal, poderá fazer check-out de 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 Fazer check-out para obter o bloqueio em todos os arquivos do mapa.

A dica de ferramenta para Check-in/Check-out é determinada pela propriedade title no arquivo ui_config.json.

Para obter mais detalhes, consulte Configurar o título para os ícones de check-in e check-out no Guia de Instalação e Configuração no Local.

Alternar Modo de Exibição de Marcas -

Tags são dicas visuais que indicam os limites de um elemento. Um limite de elemento marca o início e o fim de um elemento. Em seguida, você pode usar esses limites como uma dica visual para colocar o ponto de inserção ou selecionar o texto dentro de um limite. Se quiser inserir outro elemento antes ou depois de um elemento no documento, você pode colocar o ponto de inserção antes ou depois do limite de abertura ou fechamento do elemento.

A captura de tela a seguir mostra um documento com a Exibição de tags em:

As seguintes operações podem ser executadas em um documento com a Exibição de tags em:

• Selecionar um elemento: clique na marca de abertura ou de fechamento de um elemento para selecionar seu conteúdo.

• Expandir ou recolher marcas: clique no sinal + ou - em uma marca para expandi-la ou recolhê-la.

• Usar o menu de contexto: o menu de contexto fornece opções para recortar, copiar ou colar o elemento selecionado. Também é possível inserir um elemento antes ou depois do elemento selecionado. As outras opções permitem Gerar ID ou abrir o painel Propriedades do elemento selecionado.

• Arrastar e soltar elementos: selecione a marca de um elemento e arraste-a e solte-a facilmente no seu documento. Se o local de destino for um local válido onde o elemento é permitido, o elemento será colocado no local de destino.

Habilitar/Desabilitar o Controle de Alterações

Você pode controlar todas as atualizações feitas em um documento ativando o modo Controlar alterações. Depois de ativar o controle de alterações, todas as inserções e exclusões são capturadas no documento. Todo o conteúdo excluído é realçado usando Tachado e todas as inserções são realçadas em texto de cor verde. Além disso, você também obtém as barras de alteração na borda da página de tópico. Novamente, uma barra vermelha é exibida para o conteúdo excluído e uma barra verde é exibida para o conteúdo adicionado. Caso haja adição e exclusão na mesma linha, as barras verde e vermelha são exibidas.

A captura de tela a seguir destaca o conteúdo excluído e inserido junto com as barras de alteração:

Um caso de uso típico para rastrear alterações em um documento pode ser para fazer revisão por pares. Você pode ativar o controle de alterações e compartilhar seu documento para revisão, o revisor faz as alterações com o controle de alterações ATIVADO. Ao receber o documento, você deve ter um mecanismo para visualizar as atualizações sugeridas, juntamente com uma maneira conveniente de aceitar ou rejeitar alterações.

O AEM Guides fornece o recurso Alterações controladas que contém informações sobre as atualizações feitas no documento. O recurso Alterações rastreadas fornece informações sobre quais atualizações foram feitas, quem as fez e em que momento. Usando o recurso Alterações controladas, você também pode aceitar ou rejeitar facilmente as atualizações sugeridas no documento.

Para acessar o recurso, clique no ícone Alterações controladas no painel direito.

Clicar em uma alteração seleciona o conteúdo alterado no documento. Você pode aceitar uma alteração selecionando o ícone Aceitar alteração ou rejeitá-la selecionando Rejeitar alteração.

Se quiser aceitar ou rejeitar todas as alterações com um único clique, selecione Aceitar tudo ou Rejeitar tudo.

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.

Mesclar arquivos de tópico

Para mesclar alterações em um tópico, execute as seguintes etapas:

1. Abra um tópico no Editor da Web.

2. Clique em Mesclar.

   A caixa de diálogo Mesclar é exibida.

   

3. (Opcional) Você também pode procurar e selecionar um novo arquivo em algum outro local do seu repositório.

4. Selecione uma versão do arquivo com a qual deseja comparar a versão atual do arquivo.

5. Em Opções, escolha:

   • Controlar Alterações da Versão Selecionada: esta opção mostra todas as atualizações de conteúdo na forma de controlar alterações. Você pode optar por aceitar ou rejeitar as alterações no documento, uma de cada vez, ou todas de uma só vez.

   • Reverter para a Versão Selecionada: essa opção reverte a versão atual do documento para a versão selecionada. Essa opção não oferece controle sobre qual conteúdo é aceito ou rejeitado.

6. Clique em Concluído.

7. Se você selecionou a opção Rastrear alterações a partir da versão selecionada, todas as alterações da versão selecionada serão mostradas no recurso Alterações rastreadas do painel direito.

   Você pode optar por aceitar ou rejeitar todos os comentários do painel Alterações controladas ou aceitar ou rejeitar comentários individuais.

Mesclar arquivos de mapa

Para mesclar alterações em um arquivo de mapa, execute as seguintes etapas:

1. Abra um mapa no Editor da Web.

2. Clique em Mesclar.

   A caixa de diálogo Mesclar é exibida.

   

3. (Opcional) Você também pode procurar e selecionar um novo arquivo em algum outro local do seu repositório.

4. Selecione uma versão do arquivo com a qual deseja comparar a versão atual do arquivo.

5. Em Opções, escolha:

   • Controlar Alterações da Versão Selecionada: esta opção mostra todas as atualizações de conteúdo na forma de controlar alterações. Você pode optar por aceitar ou rejeitar as alterações no documento, uma de cada vez, ou todas de uma só vez.

   • Reverter para a Versão Selecionada: essa opção reverte a versão atual do documento para a versão selecionada. Essa opção não oferece controle sobre qual conteúdo é aceito ou rejeitado.

6. Clique em Concluído.

   1. Se você selecionou a opção Rastrear alterados a partir de versão selecionada, todas as alterações da versão selecionada serão mostradas no painel Alterações rastreadas (à direita).

      Você pode optar por aceitar ou rejeitar todas as alterações do painel Alterações controladas ou aceitar ou rejeitar alterações individuais no arquivo de mapa.

Histórico de Versões -

O recurso Histórico de Versão no Editor da Web permite verificar as versões disponíveis dos arquivos DITA, compará-las e reverter para qualquer versão do próprio editor.

No histórico de versões, é 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.

Para acessar o histórico de versões e reverter para uma versão específica do seu tópico, execute as seguintes etapas:

1. Abra um tópico no Editor da Web.

2. Clique em Histórico de Versões.

   A caixa de diálogo Histórico da Versão é exibida.

   *Visualize as alterações nas diferentes versões de um tópico.*

3. Escolha uma versão do tópico que você deseja comparar ou reverter na lista suspensa Comparar com.

   OBSERVAÇÃO

   Se uma versão tiver rótulos aplicados a ela, eles também serão mostrados (entre colchetes) junto com o número da versão.

4. Habilite a opção Exibir rótulos e comentários para exibir os rótulos e comentários aplicados às versões atual e comparada.

5. Você também pode exibir as seguintes informações na caixa de diálogo Histórico da Versão:

   Guia Visualizar: o conteúdo recém-adicionado está em fonte verde e o conteúdo excluído está em fonte vermelha.

   Guia Metadata: os metadados recém-adicionados estão em fonte verde e os metadados excluídos estão em fonte vermelha.
   
   Comparar os metadados de diferentes versões no histórico de Versões.

   OBSERVAÇÃO

   O administrador do sistema pode alterar os metadados a serem mostrados na guia Metadados nas Configurações do editor.

   Você também pode exibir os detalhes de usuário e tempo da versão atual e da versão comparada.

6. Depois de escolher uma versão na lista suspensa, a opção Reverter para a versão selecionada é disponibilizada. A janela de visualização exibe as diferenças entre a versão atual e a versão selecionada do tópico.

7. Clique em Reverter para a Versão Selecionada para reverter sua cópia de trabalho com a versão selecionada do tópico.

   A caixa de diálogo Reverter versão é exibida.

   

8. (Opcional) Forneça um motivo para reverter para uma versão anterior. Você também pode criar uma nova versão da cópia de trabalho ativa do tópico.

9. Clique em Confirmar.

   Sua cópia de trabalho do arquivo foi revertida para a versão selecionada. Se você optar por criar uma nova versão da cópia de trabalho ativa no momento, uma nova versão do arquivo também será criada com todas as alterações de trabalho.

Quando você reverte para uma versão anterior, uma dica visual é mostrada, indicando que a versão em que você está trabalhando no momento não é a versão mais recente.

Gerenciamento de 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 AEM 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 da Web. O recurso Rótulo de versão no Editor da Web fornece aos autores uma maneira rápida e fácil de atribuir rótulos a seus tópicos.

Para adicionar rótulos ao seu tópico a partir do Editor da Web, execute as seguintes etapas:

1. Abra um tópico no Editor da Web.

2. Clique em Rótulo da Versão.

   A caixa de diálogo Gerenciamento de rótulo de versão é exibida.

   

   A caixa de diálogo Gerenciamento de rótulo de versão é dividida em duas partes: o painel esquerdo tem uma lista de versões disponíveis para o tópico, juntamente com a lista suspensa de rótulos (ou uma caixa de texto para inserir um rótulo) e o painel direito com uma visualização do tópico.

3. Selecione uma versão na qual você deseja aplicar rótulos.

   Quando você escolhe uma versão diferente do tópico na lista de versões, o painel de visualização exibe as alterações entre a versão atual e a versão selecionada do tópico

   OBSERVAÇÃO

   Se um rótulo já estiver aplicado em uma versão, ele será exibido ao lado do número da versão na lista suspensa e abaixo da lista Selecionar versão. Você pode remover um rótulo existente clicando no ícone (x) ao lado do rótulo.

4. Caso o administrador tenha definido uma lista de rótulos, você verá uma lista suspensa dos rótulos de onde poderá escolher os rótulos que deseja aplicar. É possível selecionar vários rótulos na lista suspensa.

   Caso contrário, será exibida uma caixa de texto, na qual você poderá inserir os rótulos que deseja adicionar ao tópico.

   OBSERVAÇÃO

   Não é possível aplicar o mesmo rótulo a várias versões de um tópico. Se tentar associar um rótulo existente, você terá a opção de removê-lo da versão existente e aplicá-lo na versão selecionada do tópico.

5. Clique em Adicionar rótulo.

6. Na mensagem de confirmação Aplicar Rótulo, selecione a opção Mover Rótulo para mover rótulos de uma versão existente para a versão selecionada. Se você não selecionar essa opção e houver rótulos atribuídos a uma versão diferente do tópico, eles não serão movidos para a versão do tópico selecionado. Esses rótulos são ignorados no processo de aplicativo de rótulo.

Criar Tarefa de Revisão -

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

Siga as instruções fornecidas nos Tópicos ou mapas de revisão para obter mais detalhes.

Painel esquerdo

O painel esquerdo é persistente. Você pode expandi-la ou recolhê-la clicando no ícone Expandir Barra Lateral (). Na exibição expandida, ele mostra os nomes dos ícones que aparecem como dicas de ferramentas na exibição recolhida.

O painel esquerdo fornece acesso aos seguintes recursos:

Favoritos -

Se você trabalhar em um conjunto de arquivos ou pastas, poderá adicioná-los à sua lista de favoritos para acessá-los rapidamente. A lista Favoritos mostra a lista de documentos adicionados e outras listas de documentos favoritos acessíveis publicamente dos outros usuários.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Para criar uma lista ou coleção de favoritos, clique no ícone + ao lado do painel Favoritos para mostrar o log de Nova coleção de dados:

Insira um título e uma descrição para a coleção favorita que você deseja criar. Se você selecionar Público, este favorito será mostrado aos outros usuários também.

Para adicionar um arquivo à sua coleção favorita, use um dos seguintes métodos:

• Navegue até o arquivo ou pasta necessário no Modo de Exibição de Repositório, clique no ícone Opções para abrir o menu de contexto e escolha Adicionar aos Favoritos. Na caixa de diálogo Adicionar a favoritos, você pode optar por adicionar o arquivo/pasta a um favorito existente ou criar um novo.

  

• Clique com o botão direito do mouse na guia de um arquivo no editor para abrir o menu de contexto. Escolha Adicionar a > Favoritos para adicionar o arquivo à sua lista de favoritos.

  

Menu de opções da coleção Favoritos
Também é possível executar muitas ações usando o menu Opções disponível para uma coleção Favoritos:

• Renomear: renomear a coleção selecionada.
• Excluir: excluir a coleção selecionada.
• Atualizar: obtenha uma lista atualizada de arquivos e pastas do repositório.
• Exibir na Interface do Usuário do Assets: mostrar o conteúdo do arquivo ou da pasta na Interface do Usuário do Assets.

Exibição do Repositório -

Ao clicar no ícone Exibição do repositório, você obtém uma lista de arquivos e pastas disponíveis no DAM. Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível exibir o título e o nome do arquivo como uma dica de ferramenta.

São carregados 75 arquivos de cada vez. Sempre que você clicar em Carregar mais… 75 arquivos serão carregados e o botão deixará de ser exibido quando todos os arquivos tiverem sido listados. Esse carregamento em lote é eficiente, e você pode acessar os arquivos mais rapidamente em comparação ao carregamento de todos os arquivos existentes em uma pasta.

Você pode navegar facilmente para o arquivo necessário no DAM e abri-lo no Editor da Web. Se você tiver o acesso necessário para editar o arquivo, poderá fazê-lo.

Você também pode clicar e reproduzir um arquivo de áudio ou vídeo no Editor da Web. Você pode alterar o volume ou
a visualização do vídeo. No menu de atalho, você também tem as opções para baixar, alterar a reprodução
velocidade ou visualizar imagem na imagem.

Selecione um mapa e pressione Enter ou clique duas vezes para abri-lo na Exibição do Mapa. Para obter mais detalhes, consulte a descrição do recurso Exibição de mapa na seção Painel esquerdo. Selecione um tópico e pressione Enter ou clique duas vezes para abri-lo na área de edição de conteúdo. Ser capaz de navegar e abrir um arquivo diretamente do Editor da Web economiza tempo e aumenta a produtividade.

Filtrar Pesquisa

O Editor da Web fornece filtros aprimorados para pesquisar texto. Você pode pesquisar e filtrar por um texto nos arquivos presentes no caminho selecionado do repositório do Adobe Experience Manager. Ele pesquisa o título, o nome do arquivo e o conteúdo nos arquivos.

Aplicar filtros para procurar os arquivos contendo o textogeneral purpose.

Selecione o ícone Filtrar Pesquisa () para abrir o pop-up Filtrar por.

Você tem as seguintes opções para filtrar os arquivos e restringir sua pesquisa no repositório do Adobe Experience Manager:

• Arquivos DITA: você pode procurar todos os tópicos DITA e mapas DITA presentes no caminho selecionado. Elas são selecionadas por padrão.
• Arquivos não DITA: você pode pesquisar por Arquivos Ditaval, Arquivos de Imagem, Multimídia, Documentos e Json no caminho selecionado.

Use os filtros rápidos para procurar arquivos DITA e não DITA.

Filtragem Avançada

Selecione o ícone Filtragem Avançada para exibir a caixa de diálogo filtro Avançado.

Você pode exibir as seguintes opções nas guias Geral e Avançado.

Geral

• Os resultados da pesquisa serão os seguintes: procure algum texto nos arquivos presentes no caminho selecionado do repositório do Adobe Experience Manager. O texto é pesquisado no título, nome de arquivo e conteúdo nos arquivos.

Está sincronizado com a caixa de pesquisa na janela do repositório. Por exemplo, se você digitar general purpose na caixa de pesquisa no painel do repositório, ele também aparecerá na caixa de diálogo Filtro avançado e vice-versa.

• Pesquisar em: selecione o caminho em que deseja pesquisar os arquivos presentes no repositório do Adobe Experience Manager.

• Check-out por: você pode procurar arquivos nos quais o usuário especificado fez check-out.

• Última modificação: você pode procurar arquivos que foram modificados pela última vez após uma data selecionada, mas antes de uma data selecionada.

• Modificado antes: você pode procurar arquivos que foram modificados pela última vez antes de uma data selecionada.

• Intervalo de tempo: você também pode procurar arquivos que foram modificados pela última vez nas últimas duas horas, na semana passada, no mês passado ou no ano passado.

• Marcas: você pode procurar arquivos que tenham marcas específicas aplicadas a eles. Você pode digitar a tag ou selecioná-la na lista suspensa.

Avançado

• Elementos DITA: você também pode procurar valores específicos nos atributos dos elementos DITA especificados.

  • Selecione Adicionar elemento para adicionar os elementos, atributos e valores.
  • Aplique os filtros selecionados.

• Selecione Limpar tudo para limpar todos os filtros aplicados.

• Selecione o ícone Fechar filtro para fechar o filtro e retornar ao modo de exibição de árvore do repositório.

  OBSERVAÇÃO

  O administrador do sistema também pode configurar os filtros de texto e mostrar ou ocultar outros filtros. Para obter mais detalhes, consulte a seção Configurar filtros de texto em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

  A lista de arquivos filtrados que contêm o texto pesquisado é exibida. Por exemplo, os arquivos contendo o texto general purpose estão listados na captura de tela anterior. Você pode selecionar vários arquivos da lista filtrada para arrastá-los e soltá-los em um mapa aberto para edição.

Menu Opções

Além de abrir arquivos no painel esquerdo, também é possível executar muitas ações usando o menu Opções disponível na Exibição do repositório. Você verá opções diferentes, dependendo se você escolher uma pasta, um arquivo de tópico ou um arquivo de mídia.

Opções de uma pasta

Você pode executar as seguintes ações usando o menu Opções disponível para uma pasta na Exibição do Repositório:

• Criar: criar um novo tópico DITA, mapa DITA ou uma pasta. Para obter mais detalhes, consulte o procedimento Criar tópicos do Modo de Exibição de Repositório na seção Painel Esquerdo.

• Carregar Assets: carregue um arquivo do sistema local para a pasta selecionada no repositório do Adobe Experience Manager. Você também pode arrastar e soltar arquivos do seu sistema local no tópico de trabalho atual. Isso é muito útil se você quiser inserir imagens do sistema local no tópico.

  

  É possível selecionar uma pasta na qual deseja fazer upload do arquivo, e uma visualização da imagem também é exibida. Se desejar renomear o arquivo, faça isso na caixa de texto nome do arquivo. Clique em fazer upload para concluir o processo de upload de arquivo. Se você tiver arrastado e soltado um arquivo de imagem em um tópico, o arquivo de imagem será adicionado ao artigo e também será carregado.

  Se o administrador tiver habilitado a opção UUIDs no XMLEditorConfig, você verá a UUID da imagem carregada na propriedade Source.

  

• Localizar Arquivos na Pasta: altera o foco para a pesquisa no repositório, na qual você pode inserir o termo de pesquisa. A pesquisa é realizada na pasta selecionada no repositório. Você também pode aplicar um filtro para retornar Arquivos DITA, Arquivos de imagem ou ambos.

  

  Também é possível pesquisar usando a UUID de um arquivo. Nesse caso, os resultados da pesquisa exibem o título do arquivo DITA/XML e, caso o arquivo seja um arquivo de imagem, a UUID do arquivo é exibida. No exemplo de pesquisa a seguir, a UUID de um arquivo de imagem é pesquisada e os resultados da pesquisa exibem a UUID do arquivo de imagem original e o título do tópico do arquivo ao qual essa imagem é referenciada.

  

• Recolher Tudo: Recolhe todas as pastas abertas no repositório e mostra somente as pastas de nível raiz.

  OBSERVAÇÃO

  Use o ícone > ao lado de uma pasta para expandi-la.

• Adicionar aos Favoritos: adiciona a pasta selecionada aos favoritos. Você pode optar por adicioná-lo a uma coleção de favoritos existente ou nova.

• Atualizar: obtenha uma lista atualizada de arquivos e pastas do repositório.

• Exibir na interface do usuário do Assets: mostrar o conteúdo da pasta na interface do usuário do Assets.

Opções para um arquivo

Você verá diferentes opções no menu Opções dependendo se você seleciona um arquivo de mídia ou um arquivo DITA. Algumas opções comuns disponíveis para arquivos de mídia e DITA são:

• Duplicata
• Check-out/Check-in
• Visualização
• Mover para
• Renomear
• Excluir
• Copiar
• Recolher Tudo
• Adicionar a Favoritos
• Propriedades
• Exibir na interface do usuário do Assets

As várias opções no menu Opções são explicadas abaixo:

• Editar: abrir o arquivo para edição. No caso de um arquivo .ditamap/.bookmap, ele é aberto no Editor de Mapa Avançado para edição.

• Duplicar: use esta opção para criar uma duplicata ou uma cópia do arquivo selecionado. Você também tem a opção de renomear o arquivo duplicado no prompt Duplicar ativo. Por padrão, o arquivo é criado com um sufixo (como nomedoarquivo_1.extensão). O título do arquivo permanece o mesmo do arquivo de origem, e o novo arquivo começa com a versão 1.0. Todas as referências, tags e metadados são copiados, enquanto as linhas de base não são copiadas no arquivo duplicado.

• Check-out: bloquear o arquivo selecionado para edição. Para um arquivo bloqueado, esta opção muda para Check-in.

  OBSERVAÇÃO

  • Se um arquivo for bloqueado ou submetido a check-out por um usuário, passar o ponteiro do mouse sobre o ícone de bloqueio mostrará o usuário (name) que bloqueou o arquivo.
  • Ao fazer check-in de um arquivo que tenha alterações não salvas, ele solicita que você salve as alterações. Se você não salvar as alterações, ele só fará o check-in do arquivo.

• Visualização: obtenha uma visualização rápida do arquivo (.dita, .xml, áudio, vídeo ou imagem) sem abri-lo. É possível redimensionar o painel de visualização. Se o conteúdo contiver qualquer <xref> ou <conref>, você poderá selecioná-lo para abri-lo em uma nova guia. O título do arquivo aparece na janela. Se nenhum título estiver presente, o nome do arquivo será exibido. Para fechar o painel Visualização, você pode selecionar o ícone fechar ou clicar em qualquer lugar fora do painel.

  

• Renomear: use esta opção para renomear o arquivo selecionado. Digite o nome do novo arquivo na caixa de diálogo Renomear ativo.

  • É possível renomear arquivos de qualquer tipo.
  • Não é possível alterar a extensão de um arquivo.
  • Dois arquivos não podem ter o mesmo nome. Portanto, não é possível renomear um arquivo com um nome que já existe. Um erro é exibido.

• Mover para: use esta opção para mover o arquivo selecionado para outra pasta.

  • Você pode digitar o nome da pasta de destino ou escolher Selecionar caminho para selecionar a pasta de destino.
  • É possível mover um arquivo de qualquer tipo para qualquer destino na pasta Conteúdo.
  • Dois arquivos não podem ter o mesmo nome. Portanto, não é possível mover um arquivo para uma pasta na qual já exista um arquivo com o mesmo nome.

  Se você tentar mover um arquivo para uma pasta onde existe um arquivo com o mesmo nome mas com um título diferente, a caixa de diálogo Renomear e mover arquivo é exibida e você precisa renomear o arquivo antes de movê-lo. O arquivo movido na pasta de destino tem o novo nome de arquivo.

  
  OBSERVAÇÃO

  Você também pode arrastar e soltar um arquivo em outra pasta de destino.

  Cenários de exclusão

  O AEM Guides não permite renomear ou mover um arquivo nos seguintes cenários:

  • Não é possível mover ou renomear um arquivo se ele fizer parte de um fluxo de trabalho de revisão ou tradução.

  • Se qualquer outro usuário fizer check-out do arquivo, você não poderá renomeá-lo ou movê-lo. Você não verá a opção Renomear ou Mover para do arquivo.

  OBSERVAÇÃO

  Se o administrador concedeu a você as permissões em uma pasta, apenas as opções Renomear ou Mover para serão exibidas.

  Cloud Services

  Renomear ou mover qualquer arquivo não interrompe nenhuma referência existente do ou para o arquivo, pois cada arquivo tem uma UUID exclusiva.

• Excluir: use esta opção para excluir o arquivo selecionado. Um prompt de confirmação é exibido antes de excluir o arquivo.

  • Um prompt de confirmação é exibido antes de excluir o arquivo.

  • Se o arquivo não for referenciado a partir de outro arquivo, ele será excluído e uma mensagem de sucesso será exibida.

  • Se o arquivo for submetido a check-out, não será possível excluí-lo e uma mensagem de erro será exibida.

    OBSERVAÇÃO

    Se o administrador impediu a exclusão de arquivos com check-out, apenas a mensagem de erro será exibida. Para obter mais detalhes, consulte a seção Impedir exclusão de arquivos com check-out em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

  • Se o arquivo for adicionado a uma coleção de favoritos, a caixa de diálogo Forçar Exclusão será exibida e você poderá excluí-la à força.

  • Se o arquivo for referenciado a partir de qualquer outro arquivo, a caixa de diálogo Forçar Exclusão com a mensagem de confirmação será exibida e você poderá forçar a exclusão do arquivo:

    
    OBSERVAÇÃO

    Se o administrador concedeu permissão para excluir o arquivo, a Exclusão Forçada será habilitada. Senão, Forçar Exclusão está desabilitado e será exibida uma mensagem informando que você não tem permissão para excluir os arquivos referenciados. Para obter mais detalhes, consulte a seção Impedir exclusão de arquivos referenciados em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

  • Se você excluir um tópico referenciado e tiver aberto o arquivo contendo referências para edição, ele mostrará o link corrompido para o arquivo referenciado.

  OBSERVAÇÃO

  Você também pode excluir o arquivo selecionado de forma semelhante usando a tecla Delete do teclado.

• Copiar: você pode escolher entre as seguintes opções:

  • Copiar UUUID: Copiar a UUID do arquivo selecionado para a Área de Transferência.

  • Copiar Caminho: copia o caminho completo do arquivo selecionado para a Área de Transferência.

• Recolher Tudo: Recolher todos os arquivos no repositório. Somente as pastas de nível superior no repositório são exibidas.

• Adicionar a: você pode escolher entre as seguintes opções:

  • Favoritos: adiciona o arquivo selecionado aos favoritos. Você pode optar por adicioná-lo a uma coleção de favoritos existente ou nova.

  • Conteúdo Reutilizável: adiciona o arquivo selecionado à lista Conteúdo Reutilizável no painel esquerdo.

• Propriedades: use esta opção para abrir a página de propriedades do arquivo selecionado. Essa página de propriedades também pode ser acessada na interface do usuário do Assets selecionando um arquivo e clicando no ícone Propriedades na barra de ferramentas.

• Abrir Painel de Mapa: caso o arquivo selecionado seja um mapa DITA, essa opção abrirá o painel de mapa.

• Editar no Oxygen: selecione essa opção para editar o arquivo selecionado no plug-in do conector do Oxygen. O arquivo está aberto para edição.

  OBSERVAÇÃO

  Entre em contato com a equipe de sucesso do cliente para habilitar esse recurso no ambiente. Isso não é ativado como parte do suporte pronto para uso. Para obter mais detalhes, exiba a opção Configurar a opção para editar no Oxygen na seção do Guia de Instalação e Configuração.

• Exibir na interface do usuário do Assets: use esta opção para mostrar uma visualização de um arquivo .dita/.xml na interface do usuário do Assets. No caso de um arquivo .ditamap/.bookmap, todos os arquivos de tópico no mapa são mostrados em uma única exibição unificada página por página.

• Baixar como PDF: use a opção para gerar a saída de PDF e baixá-la.

• Publish As: use a opção para publicar um tópico ou os elementos dentro de um tópico em um fragmento de conteúdo.

• Geração rápida: gera a saída para o arquivo selecionado. A saída só pode ser gerada para arquivos que fazem parte de uma predefinição de saída. Para obter mais detalhes, consulte Publicação baseada em artigo do Editor da Web.

Criar tópicos do Modo de Exibição de Repositório

Você pode optar por criar um novo tópico, mapa ou pasta usando o ícone + ao lado do painel Repositório ou no menu de contexto de uma pasta na Exibição do Repositório.

Criar um tópico

Ao optar por criar um novo tópico no menu, você obterá a seguinte caixa de diálogo:

Na caixa de diálogo Criar Novo Tópico, forneça os seguintes detalhes:

• Um modelo no qual o tópico será baseado. Por exemplo, para uma configuração pronta para uso, você pode escolher entre os modelos Em branco, Conceito, DITAVAL, Referência, Tarefa, Tópico e Solução de problemas.

  Se a pasta tiver um Perfil de pasta configurado, você verá apenas os modelos de tópico configurados no Perfil de pasta.

• Caminho no qual você deseja salvar o arquivo de tópico. Por padrão, o caminho da pasta selecionada no momento no repositório é mostrado no campo Caminho.

• Um Título para o tópico.

• (Opcional) O nome de arquivo do tópico. O nome do arquivo é sugerido automaticamente com base no tópico Título.

  Caso o administrador tenha ativado nomes de arquivo automáticos com base na configuração UUID, você não verá o campo Nome, como mostrado na seguinte captura de tela:

  

Quando você clica em Criar, o tópico é criado no caminho especificado. Além disso, o tópico é aberto no Editor da Web para edição.

Criar um mapa DITA

Ao optar por criar um novo mapa DITA, você obterá a seguinte caixa de diálogo:

Na caixa de diálogo Criar Novo Mapa, forneça os seguintes detalhes:

• Um modelo no qual o mapa será baseado. Por exemplo, para uma configuração pronta para uso, é possível escolher entre os modelos de mapa Bookmap ou DITA.

• Caminho no qual você deseja salvar o arquivo de mapa. Por padrão, o caminho da pasta selecionada no momento no repositório é mostrado no campo Caminho.

• Um Título para o mapa.

• (Opcional) O nome de arquivo do mapa. O nome do arquivo é sugerido automaticamente com base no Título do mapa.

  Caso o administrador tenha ativado nomes de arquivo automáticos com base na configuração UUID, você não verá o campo Nome.

Ao clicar em Criar, o mapa é criado e adicionado à pasta especificada no campo Caminho. Além disso, o mapa é aberto na Exibição de mapa. Você pode abrir o arquivo de mapa no Editor de mapa e adicionar tópico a ele. Para obter mais informações sobre como adicionar tópicos a um arquivo de mapa, consulte Criar um mapa.

Criar uma pasta

Ao optar por criar uma nova pasta, você verá a caixa de diálogo Criar Nova Pasta:

Insira um Título para a pasta, que é convertida automaticamente no nome da pasta. O caminho é onde você deseja salvar o arquivo de mapa. Por padrão, o caminho da pasta selecionada no momento no repositório é mostrado no campo Caminho. Ao clicar em Criar, a pasta é criada e adicionada dentro da pasta de onde a opção de criação de pasta foi executada.

Exibição do Mapa -

Ao clicar no ícone Exibição de mapa, você obtém uma lista de tópicos dentro do arquivo de mapa. Se você não tiver aberto nenhum arquivo de mapa, a Exibição de mapa aparecerá em branco. Clicar duas vezes em qualquer arquivo de mapa abre o arquivo de mapa nesta exibição. Você pode clicar duas vezes em qualquer arquivo no mapa para abri-lo no Editor da Web.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Quando você abre um mapa na exibição de mapa, o título do mapa atual é exibido no centro da barra de ferramentas principal. Se o título for muito longo, uma reticências será exibida e você também poderá passar o mouse sobre o título para ver o título completo na dica de ferramenta.

Ao definir atributos principais para o tópico ou referências de mapa, é possível visualizar o título, o ícone correspondente e a chave no painel esquerdo. A chave é exibida como keys=<key-name>.

Se você tiver direitos de edição nos arquivos de mapa, também poderá editar os arquivos. Para obter mais informações sobre como abrir e editar um tópico por meio do mapa DITA, consulte Editar tópicos por meio do mapa DITA.

Você pode executar as seguintes ações usando o menu Opções do arquivo de mapa:

• Editar: abrir o arquivo de mapa para edição no Editor de Mapa Avançado.

• Selecionar Tudo: Selecione todos os arquivos no mapa.

• Limpar Seleção: Desmarque os arquivos selecionados no mapa.

• Check-out e Bloqueio: faça check-out e obtenha um bloqueio dos arquivos selecionados no mapa.

• Cancelar Check-out e Desbloquear: desbloqueia o arquivo de mapa e o disponibiliza para edição. Isso não reverte as alterações para a versão anterior.

• Salvar como Nova Versão e Desbloquear: crie uma versão mais recente e libere o bloqueio nos arquivos selecionados no mapa.

• Visualização: abrir uma visualização do arquivo de mapa. Nesta exibição, todos os arquivos de tópico no mapa são mostrados em uma única exibição unificada página por página.

• Copiar: você pode escolher entre as seguintes opções:

  • Copiar UUUID: Copiar a UUID do arquivo de mapa para a Área de Transferência.
  • Copiar Caminho: Copiar o caminho completo do arquivo de mapa para a Área de Transferência.

• Localizar no Repositório: mostra o local do arquivo de mapa no repositório (ou DAM).

• Adicionar a: você pode escolher entre as seguintes opções:

  • Favoritos: adiciona o arquivo de mapa aos favoritos. Você pode optar por adicioná-lo a uma coleção de favoritos existente ou nova.

  • Conteúdo Reutilizável: adiciona o arquivo de mapa à lista Conteúdo Reutilizável no painel esquerdo.

• Propriedades: use esta opção para abrir a página de propriedades do arquivo de mapa. Essa página de propriedades também pode ser acessada na interface do usuário do Assets selecionando um arquivo e clicando no ícone Propriedades na barra de ferramentas.

• Abrir Painel do Mapa: abra o painel do mapa.

• Exibir na Interface do Usuário do Assets: use esta opção para mostrar uma visualização do arquivo de mapa na Interface do Usuário do Assets. Nesta exibição, todos os arquivos de tópico no mapa são mostrados em uma única exibição unificada página por página.

• Baixar Mapa: selecione esta opção para abrir a caixa de diálogo Baixar Mapa.

Na caixa de diálogo Baixar Mapa, você pode escolher as seguintes opções:

• Usar Linha de Base: selecione esta opção para obter uma lista de Linhas de Base criadas para o mapa DITA. Para baixar o arquivo de mapa e seu conteúdo com base em uma Linha de Base específica, selecione a Linha de Base na lista suspensa. Para obter mais detalhes sobre como trabalhar com Linhas de Base, exiba trabalhar com Linha de Base.

• Nivelar Hierarquia de Arquivos: selecione esta opção para salvar todos os tópicos e arquivos de mídia referenciados em uma única pasta.

  Também é possível baixar o arquivo de mapa sem selecionar nenhuma opção. Nesse caso, as últimas versões persistentes dos tópicos e arquivos de mídia referenciados são baixadas.

  Depois de clicar no botão Baixar, a solicitação de pacote de exportação de mapa é enfileirada. A caixa de diálogo Êxito será exibida se o pacote for criado com êxito. Você pode clicar no botão Download da caixa de diálogo Êxito.

  Você recebe a notificação de que o mapa está pronto para download se estiver pronto para download. Caso o download falhe, você receberá a notificação de que o download do mapa falhou.

  Você pode acessar o link de download na Caixa de entrada de notificação do AEM. Selecione a notificação de mapa gerada na Caixa de entrada para baixar o mapa no formato .zip.

  OBSERVAÇÃO

  Por padrão, os mapas baixados permanecem por cinco dias na Caixa de entrada de notificação do AEM.

• Gerar Saída: gere a saída para o arquivo de mapa selecionado. A saída só pode ser gerada para arquivos que fazem parte de uma predefinição de saída. Para obter mais detalhes, consulte Publicação baseada em artigo do Editor da Web.

• Fechar: fecha o arquivo de mapa.

A captura de tela a seguir mostra o menu Opções para um arquivo na Exibição do mapa DITA:

Você pode executar as seguintes ações usando o menu Opções:

• Editar: abrir o arquivo para edição. No caso de um arquivo .ditamap/.bookmap, ele é aberto no Editor de Mapa Avançado para edição.

• Fazer Check-out: fazer check-out do arquivo selecionado. Para um arquivo com check-out, esta opção muda para Check-in.

  OBSERVAÇÃO

  • Se um arquivo for bloqueado ou submetido a check-out por um usuário, passar o ponteiro do mouse sobre o ícone de bloqueio mostrará o usuário (name) que bloqueou o arquivo.
  • Ao fazer check-in de um arquivo, ele solicita que você salve as alterações. Se você não salvar as alterações, ele só fará o check-in do arquivo.

• Visualização: obtenha uma visualização rápida do arquivo (.dita, .xml, áudio, vídeo ou imagem) sem abri-lo. É possível redimensionar o painel de visualização. Se o conteúdo contiver qualquer <xref> ou <conref>, você poderá selecioná-lo para abri-lo em uma nova guia. O título do arquivo aparece na janela. Se nenhum título estiver presente, o nome do arquivo será exibido. Para fechar o painel Visualização, você pode selecionar o ícone fechar ou clicar em qualquer lugar fora do painel.

• Copiar: você pode escolher entre as seguintes opções:

  • Copiar UUUID: Copiar a UUID do arquivo selecionado para a Área de Transferência.
  • Copiar Caminho: copia o caminho completo do arquivo selecionado para a Área de Transferência.

• Localizar no Repositório: mostra o local do arquivo selecionado no repositório (ou DAM).

• Expandir Tudo: expandir todos os tópicos nos arquivos de mapa.

• Recolher Tudo: Recolhe todos os tópicos que fazem parte do arquivo de mapa atual.

• Adicionar a: você pode escolher entre as seguintes opções:

  • Favoritos: adiciona o arquivo selecionado aos favoritos. Você pode optar por adicioná-lo a uma coleção de favoritos existente ou nova.

  • Conteúdo Reutilizável: adiciona o arquivo selecionado à lista Conteúdo Reutilizável no painel esquerdo.

• Propriedades: use esta opção para abrir a página de propriedades do arquivo selecionado. Essa página de propriedades também pode ser acessada na interface do usuário do Assets selecionando um arquivo e clicando no ícone Propriedades na barra de ferramentas.

• Exibir na interface do usuário do Assets: use esta opção para mostrar uma visualização de um arquivo .dita/.xml na interface do usuário do Assets. No caso de um arquivo .ditamap/.bookmap, todos os arquivos de tópico no mapa são mostrados em uma única exibição unificada página por página.

• Geração rápida: gera a saída para o arquivo selecionado. A saída só pode ser gerada para arquivos que fazem parte de uma predefinição de saída. Para obter mais detalhes, consulte Publicação baseada em artigo do Editor da Web.

Modo de Exibição de Estrutura de Tópicos -

Ao clicar no ícone Exibição de Estrutura de Tópicos, você obtém a exibição hierárquica dos elementos usados no documento.

A Exibição de Estrutura de Tópicos oferece os seguintes recursos:

• Uma exibição em árvore de todos os elementos usados no documento.

• Se um elemento tiver uma ID, um atributo e um texto, você poderá vê-los junto com o elemento.

• Acesse a Exibição da estrutura de tópicos nas exibições do Autor e do Source.

• Use a lista suspensa de filtro para mostrar todos os elementos ou somente as referências corrompidas:

• Clicar em um elemento no Modo de Exibição de Estrutura de Tópicos seleciona o conteúdo do elemento no modo de exibição Autor ou Source. O modo de exibição de Estrutura de Tópicos permanece sincronizado com o modo de exibição Autor e Source. Se você fizer alterações em qualquer exibição, poderá vê-las na exibição Estrutura de Tópicos. Por exemplo, se você adicionar um parágrafo ou atualizar um elemento na exibição Autor, ele será mostrado na exibição Estrutura de tópicos.

  

• Arraste e solte elementos. Você pode substituir facilmente um elemento soltando outro elemento nele. Se você arrastar e soltar um elemento sobre outro elemento e vir uma caixa quadrada ao redor dele, isso indica que o elemento será substituído. Ele substitui o elemento no qual o elemento é solto.

  

  Se você arrastar e soltar um elemento, um retângulo tracejado indicará que o elemento pode ser colocado no local atual. Se arrastar e soltar for inválido, uma mensagem de erro será mostrada para indicar que a operação não é permitida.

  

• O menu Opções da Exibição da Estrutura de Tópicos permite executar operações genéricas, como Recortar, Copiar, Excluir, Gerar ID, Inserir elemento antes ou depois do elemento atual, Renomear ou substituir um elemento, Quebrar um elemento, Desfazer a quebra de um elemento e criar um trecho do elemento selecionado.

Opções de Modo de Exibição para o painel Modo de Exibição de Estrutura de Tópicos

Usando a lista suspensa Opções de exibição, você pode optar por ver o seguinte, se o elemento tiver:

• Mostrar ID: mostra a ID do elemento.
• Mostrar atributo: mostra o atributo junto com seu valor.
• Mostrar texto: mostra o texto. Se o texto tiver mais de 20 caracteres, uma reticências será exibida.

Se um elemento de bloco tiver seu próprio texto, ele será exibido junto com esse elemento de bloco. Se não tiver seu próprio texto, o texto do primeiro elemento secundário será exibido junto com o elemento de bloco.

Se o administrador tiver criado um perfil para atributos, você obterá esses atributos junto com seus valores configurados. Você também pode atribuir atributos de exibição configurados pelo administrador na guia Atributos de Exibição das configurações do editor. Os atributos definidos para um elemento são exibidos na exibição Layout e Estrutura de Tópicos.

Para obter mais detalhes, consulte os Atributos de Exibição na descrição do recurso Configurações do Editor, na seção Painel Esquerdo.

Recurso de pesquisa
Usando o recurso de pesquisa, você pode pesquisar um elemento por seu nome, id, texto ou valor de atributo.

A pesquisa não diferencia maiúsculas de minúsculas e corresponde exatamente à sequência de caracteres. Os resultados da pesquisa são classificados de acordo com a posição do elemento no documento.

Você pode procurar por uma string no elemento se ela estiver mostrada no painel Modo de exibição de estrutura de tópicos. Por exemplo, se a sequência "Adobe" estiver presente no texto do elemento e for mostrada no painel Modo de Exibição de Estrutura de Tópicos (como você selecionou Mostrar Texto na lista suspensa Opções de Exibição), o elemento que contém será filtrado. Mas se o texto não for mostrado no painel Modo de Exibição de Estrutura de Tópicos (já que você não selecionou Mostrar Texto na lista suspensa Opções de Exibição), o elemento que o contém não será filtrado. Da mesma forma, você encontrará a cadeia de caracteres na ID ou nos atributos se os tiver selecionado.

Conteúdo Reutilizável -

Um dos principais recursos do DITA é a capacidade de reutilizar conteúdo. O painel Conteúdo reutilizável pode armazenar seus arquivos DITA de onde você geralmente insere conteúdo reutilizável. Depois de adicionados, os arquivos DITA permanecem no painel Conteúdo reutilizável nas sessões. Isso significa que não é necessário adicionar os arquivos DITA novamente para acessá-los posteriormente.

Você pode simplesmente arrastar e soltar o conteúdo reutilizável do painel no seu tópico atual e ele é inserido de forma fácil e rápida. Você também pode obter uma visualização do conteúdo antes de inseri-lo no documento.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Para adicionar um arquivo DITA ao painel Conteúdo reutilizável, use um dos seguintes métodos:

• Clique no ícone + ao lado de Conteúdo reutilizável para abrir a caixa de diálogo Procurar arquivo. Selecione o arquivo que deseja adicionar e clique em Adicionar para concluir o processo.

  

• Na Exibição de Repositório, clique no ícone Opções do arquivo desejado e escolha Adicionar ao Conteúdo Reutilizável no menu de contexto.

• Clique com o botão direito do mouse na guia de um arquivo no editor para abrir o menu de contexto e escolha Adicionar ao conteúdo reutilizável.

Depois que o arquivo for adicionado, você poderá ver todos os elementos de conteúdo reutilizáveis do arquivo no painel Conteúdo reutilizável. O conteúdo reutilizável é exibido com as IDs e os nomes de elemento.

Ao adicionar um arquivo à lista Conteúdo reutilizável, o título do arquivo é exibido em vez da UUID do arquivo. Para verificar a UUID do arquivo, passe o mouse sobre o título do arquivo e a UUID do arquivo será exibida na dica de ferramenta.

Atualizar: verifica novamente todos os conteúdos reutilizáveis e exibe uma nova lista de conteúdos reutilizáveis.

Para inserir conteúdo do painel Conteúdo reutilizável, use um dos seguintes métodos:

• Passe o ponteiro do mouse sobre um elemento que você deseja inserir, clique no ícone Opções e escolha Inserir Conteúdo Reutilizável.

  
  OBSERVAÇÃO

  Selecione um arquivo e, em seguida, Visualizar no menu Opções para visualizar o arquivo sem abri-lo. Você também pode visualizar as referências presentes em um tópico. A ID de referência aparece na janela.

  A opção Visualizar também está disponível no menu Opções de um elemento, que fornece uma visualização rápida do elemento antes de inseri-lo.

• Arraste e solte o item de conteúdo reutilizável do painel no local desejado no documento.

Glossário -

O AEM Guides permite criar e usar facilmente os documentos do tipo glossário. Você pode criar arquivos de tópico de glossário e incluí-los em um mapa de glossário comum. Depois que esse mapa é adicionado como mapa raiz, as entradas do glossário são mostradas no painel Glossário.

Para inserir um termo do glossário, basta arrastar e soltar a entrada do painel para o local desejado no seu tópico. O menu Opções de um termo do glossário permite obter uma Visualização rápida do termo de entrada, Copiar Caminho do arquivo de termo de entrada ou localizar o arquivo de termo de entrada no repositório.

Execute as seguintes etapas para pesquisar termos de texto e substituí-los por abreviações de glossário:

1. Abra o tópico DITA ou o mapa no qual deseja pesquisar e converter o texto ou os termos.
2. Selecione o painel de glossário para exibir os termos do glossário presentes no mapa-raiz. Você pode arrastar e soltar esses termos para adicioná-los ao tópico aberto.
3. Selecione a ferramenta Ponto de acesso ( ) no painel Glossário para pesquisar e converter termos de texto específicos em abreviações de glossário vinculadas. Além disso, vice-versa, você pode usá-lo para pesquisar abreviações de glossário e convertê-las em termos de texto.

Você pode definir as seguintes configurações da ferramenta Ponto de acesso:

• Chaves do Glossário: selecione as chaves do glossário no mapa DITA que deseja usar para a pesquisa no tópico selecionado. As teclas selecionadas serão exibidas abaixo. Você pode remover uma chave selecionada clicando no ícone Remover.

• Tópicos: escolha o Tópico Atual aberto no Editor da Web, todos os Tópicos Abertos no mapa atual ou o Mapa Atual sendo editado no Editor de Mapa para pesquisar os termos.

• Filtrar Tópicos por Status: você pode optar por limitar a pesquisa a tópicos que tenham o status de documento selecionado. Os tópicos podem estar no status Rascunho, Editar, Em revisão, Aprovado, Revisado, Concluído ou em qualquer um dos estados configurados pela organização.

• Ação: você pode optar por pesquisar as chaves do glossário Manualmente para Cada Tópico ou Automaticamente para Todos os Tópicos. Se você escolher Manualmente para cada tópico, ele solicitará a confirmação antes de converter cada termo em cada tópico. Se você escolher Automaticamente para Todos os Tópicos, ele converterá automaticamente todos os termos em todos os tópicos.

• Converter: você pode converter um Texto pesquisado em termo de glossário ou Termo do glossário em texto.

• Opções: você pode selecionar entre as seguintes opções:

  • Correspondência que diferencia maiúsculas de minúsculas: procura um termo para localizar a correspondência que tem a mesma capitalização. Por exemplo, "USB" não corresponderá a "usb".
  • Converter Somente a Primeira Instância: se várias instâncias do termo pesquisado estiverem presentes em um tópico, somente a primeira instância será convertida.
  • Verificar Arquivo Antes da Conversão: o arquivo pesquisado foi submetido a check-out antes da conversão dos termos.
  • Criar uma Nova Versão Após a Conversão: uma nova versão do tópico é criada após a conclusão da conversão dos termos.

• O botão Avançar será exibido se você selecionar Manualmente para cada tópico. Clique em Avançar para converter os termos de cada tópico com base nas configurações selecionadas. Ele solicita a conversão de termos em cada tópico e passa para o próximo arquivo. Você pode optar por converter um termo ou ignorá-lo e passar para o próximo termo.

  

• O botão Converter será exibido se você selecionar a opção Automaticamente para Todos os Tópicos. Selecione Converter para converter todos os termos encontrados no documento em abreviações de glossário vinculadas.

Uma lista de Tópicos Atualizados com os termos convertidos e Tópicos com Erro é exibida. Passe o mouse sobre o ícone ( ) próximo a Tópicos com Erro para ver os detalhes do erro.

Condições -

O painel Condições exibe os atributos condicionais definidos pelo administrador no perfil global ou de nível de pasta. Você pode adicionar condições ao seu conteúdo simplesmente arrastando e soltando a condição desejada no seu conteúdo. O conteúdo condicional é realçado usando a cor definida para a condição, para facilitar a identificação.

Você também pode aplicar várias condições a um elemento arrastando e soltando várias condições em um elemento. Quando você aplica várias condições em um elemento, o painel Propriedades exibe as condições aplicadas separadas por vírgula.

No entanto, na visualização Código, as condições são separadas usando um delimitador de espaço. Ao adicionar ou editar uma condição na Visualização de código, certifique-se de que várias condições sejam separadas usando um espaço.

Para adicionar ou definir uma condição, clique no ícone + ao lado do painel Condições para abrir a caixa de diálogo Definir condição:

Na lista Atributo, selecione o atributo condicional que deseja definir, insira um valor para a condição e especifique o rótulo que é exibido no painel Condições. Você também pode definir uma cor para a condição. Essa cor é definida como a cor de fundo do conteúdo no qual a condição é aplicada

Para editar uma condição, escolha Editar no menu Opções. A caixa de diálogo Editar condição é exibida:

Especifique os detalhes da mesma forma que foram configurados ao definir uma nova condição.

Esquema do assunto -

Mapas de esquema de assunto são uma forma especializada de mapas DITA que são usados para definir assuntos taxonômicos e valores controlados. Dependendo das suas necessidades, você pode criar um mapa de esquema de assunto e referenciá-lo no arquivo de mapa raiz. O AEM Guides permite definir a hierarquia de nível aninhado das definições de assunto no esquema de assunto.

Você pode criar facilmente e usar o esquema de assunto em um mapa de esquema de assunto. Depois que esse mapa é adicionado como mapa raiz, o esquema de assunto é mostrado no painel Esquema de assunto. O painel Esquema do assunto exibe o esquema do assunto disponível de forma aninhada ou hierárquica.

O AEM Guides também oferece suporte a mapas de esquema de assunto de nível aninhado, e você pode ter vários esquemas de assunto definidos no mapa de esquema de assunto raiz.

O exemplo a seguir mostra como usar o esquema de assunto no AEM Guides.

1. Crie um arquivo de esquema do assunto em uma ferramenta de sua escolha. O código XML a seguir cria um esquema de assunto que associa valores ao atributo platform.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "subjectScheme.dtd">
   <subjectScheme id="GUID-4f942f63-9a20-4355-999f-eab7c6273270">
       <title>rw</title>
       <!-- Define new OS values that are merged with those in the unixOS scheme -->
       <subjectdef keys="os">
           <subjectdef keys="linux">    </subjectdef>
           <subjectdef keys="mswin">    </subjectdef>
           <subjectdef keys="zos">    </subjectdef>
       </subjectdef>
       <!-- Define application values -->
       <subjectdef keys="app" navtitle="Applications">
           <subjectdef keys="apacheserv">    </subjectdef>
           <subjectdef keys="mysql">    </subjectdef>
       </subjectdef>
       <!-- Define an enumeration of the platform attribute, equal to       each value in the OS subject. This makes the following values       valid for the platform attribute: linux, mswin, zos -->
       <enumerationdef>
           <attributedef name="platform">    </attributedef>
           <subjectdef keyref="os">    </subjectdef>
       </enumerationdef>
       <!-- Define an enumeration of the otherprops attribute, equal to       each value in the application subjects.       This makes the following values valid for the otherprops attribute:       apacheserv, mysql -->
       <enumerationdef>
           <attributedef name="otherprops">    </attributedef>
           <subjectdef keyref="app">    </subjectdef>
       </enumerationdef>
   </subjectScheme>
   

   

2. Salve o arquivo com a extensão a.ditamap e faça upload dele para qualquer pasta no DAM.

   OBSERVAÇÃO

   Você pode adicionar uma referência ao arquivo de esquema do assunto no mapa DITA principal.

   

3. Defina o mapa pai como o mapa raiz nas Preferências do usuário. Depois que esse mapa é adicionado como mapa raiz, o esquema de assunto é mostrado no painel Esquema de assunto.

   

4. No Editor da Web, abra o arquivo no qual deseja usar as definições do esquema de assunto.

5. Aplique o esquema de assunto ao seu conteúdo simplesmente arrastando e soltando o esquema de assunto desejado no seu conteúdo. O conteúdo é então realçado com a cor definida.

   

Manipulando definições hierárquicas de definições de assunto e enumerações

Além de lidar com as enumerações e as definições de assunto presentes no mesmo mapa, o AEM Guides também fornece o recurso para definir enumerações e definições de assunto em dois mapas separados. É possível definir uma ou mais definições de assunto em um mapa e as definições de enumeração em outro mapa e, em seguida, adicionar a referência do mapa. Por exemplo, o código XML a seguir cria definições de assunto e definições de enumeração em dois mapas separados.

As definições de assunto estão definidas em subject_scheme_map_1.ditamap

  <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
    <subjectScheme id="subject-scheme.ditamap_f0bfda58-377b-446f-bf49-e31bc87792b3">

    <title>subject_scheme_map_1</title>

    <subjectdef keys="os" navtitle="Operating system">
        <subjectdef keys="linux" navtitle="Linux">
        <subjectdef keys="redhat" navtitle="RedHat Linux">
        </subjectdef>
        <subjectdef keys="suse" navtitle="SuSE Linux">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="windows" navtitle="Windows">
        </subjectdef>
        <subjectdef keys="zos" navtitle="z/OS">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="deliveryTargetValues">
        <subjectdef keys="print">
        </subjectdef>
        <subjectdef keys="online">
        </subjectdef>
    </subjectdef>
    <subjectdef keys="mobile" navtitle="Mobile">
        <subjectdef keys="android" navtitle="Android">
        </subjectdef>
        <subjectdef keys="ios" navtitle="iOS">
    </subjectdef>
    </subjectdef>
    <subjectdef keys="cloud" navtitle="Cloud">
        <subjectdef keys="aws" navtitle="Amazon Web Services">
        </subjectdef>
        <subjectdef keys="azure" navtitle="Microsoft Azure">
        </subjectdef>
        <subjectdef keys="gcp" navtitle="Google Cloud Platform">
        </subjectdef>
    </subjectdef>
    </subjectScheme>

A definição de enumeração está presente em subject_scheme_map_2.ditamap.

    ?xml version="1.0" encoding="UTF-8"?>
        <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
        <subjectScheme id="subject-scheme.ditamap_17c433d9-0558-44d4-826e-3a3373a4c5ae">
        <title>subject_scheme_map_2</title>
        <mapref format="ditamap" href="subject_scheme_map_1.ditamap" type="subjectScheme">
        </mapref>
        <enumerationdef>
        <attributedef name="platform">
        </attributedef>
        <subjectdef keyref="mobile">
        </subjectdef>
        <subjectdef keyref="cloud">
        </subjectdef>
        </enumerationdef>
        </subjectScheme>

Aqui as definições de assunto são definidas em subject_scheme_map_1.ditamap enquanto a definição de enumeração está presente em subject_scheme_map_2.ditamap. A referência a subject_scheme_map_1.ditamap também é adicionada em subject_scheme_map_2.ditamap.

As referências de enumeração do assunto são resolvidas na seguinte ordem de prioridade:

1. Mesmo mapa
2. Mapa referenciado

As referências não serão resolvidas se a enumeração não for encontrada no mesmo mapa e no mapa referenciado.

Restringir os valores a um elemento específico

Você também pode restringir as condições a alguns elementos dentro de um tópico. Use a marca <elementdef> para definir o elemento e a marca <attributedef> para definir a condição que pode ser aplicada ao elemento. Se você não adicionar a tag <elementdef>, poderá aplicar as condições a todos os elementos.
Por exemplo, use a enumeração a seguir para restringir o atributo @platform ao elemento <shortdesc>. As outras condições são visíveis para todos os elementos.

<enumerationdef>
    <elementdef name="shortdesc">
    </elementdef>
    <attributedef name="platform">
    </attributedef>
    <subjectdef keyref="deliveryTargetValues">
    </subjectdef>
    <subjectdef keyref="os">
    </subjectdef>
  </enumerationdef>

Menu suspenso Atributos

Você também pode alterar o valor do esquema do assunto usando a lista suspensa Atributos do painel Propriedades de Conteúdo na exibição Autor.

Execute as seguintes etapas para alterar o valor:

1. Selecione um atributo na lista suspensa Atributo.
2. Selecione Editar .
3. Selecione o valor necessário na lista suspensa Valor.
4. Clique em Atualizar.

Você também pode aplicar valores a um atributo selecionando vários valores na lista suspensa.

Modo de Exibição do Source

Você também pode alterar os valores do menu suspenso do atributo na Exibição do Source. A visualização Source também impede que você adicione qualquer valor incorreto.

Exibir e aplicar o esquema de assunto do painel Condições

Você também pode exibir e aplicar o esquema de assunto do painel Condições.

Para exibir o esquema do assunto no painel Condições, o administrador do sistema deve selecionar a opção Mostrar esquema do assunto no painel Condições na guia Condição das Configurações do Editor. Para obter mais detalhes, consulte a guia Condição.

O painel Condições exibe a estrutura vertical plana das definições de assunto dentro do esquema de assunto.

Você pode adicionar condições ao seu conteúdo arrastando e soltando a condição desejada no seu conteúdo. O conteúdo condicional é realçado usando a cor definida para a condição.

Fragmentos -

Os trechos são pequenos fragmentos de conteúdo que podem ser reutilizados em vários tópicos do projeto de documentação. O painel Snippets mostra uma coleção de trechos de conteúdo que você criou. Para inserir um trecho, arraste e solte o trecho do painel no local desejado no tópico. O painel Snippets permite adicionar, editar, excluir, visualizar e inserir um trecho.

Para adicionar um trecho, use um dos seguintes métodos:

• Clique no ícone + ao lado de Trechos para abrir a caixa de diálogo Novo trecho.

  

  Na caixa de diálogo Novo trecho, forneça um título que apareça no painel Trechos, uma descrição e o código XML do conteúdo do trecho que você deseja criar. Clique em Criar para salvar e criar o trecho.

• Na área de edição de conteúdo, clique com o botão direito do mouse na navegação estrutural do elemento que você deseja usar como snippet e escolha Criar snippet no menu de contexto. A caixa de diálogo Novo trecho é exibida com o código XML do elemento selecionado preenchido no campo Conteúdo. Insira o Título e a Descrição para o trecho e clique em Criar para salvar o trecho.

• Na área de edição de conteúdo, clique com o botão direito do mouse em qualquer lugar do conteúdo que você deseja usar como um trecho e escolha Criar trecho no menu de contexto. A caixa de diálogo Novo trecho é exibida com o código XML do elemento selecionado preenchido no campo Conteúdo. Insira o Título e a Descrição para o trecho e clique em Criar para salvar o trecho.

  A captura de tela a seguir destaca a navegação estrutural e a área de conteúdo da qual você pode chamar o menu de contexto.

  

Para inserir um trecho, use um dos seguintes métodos:

• Selecione um trecho no painel Snippets e arraste-o e solte-o no local desejado no seu tópico.

• Posicione o ponto de inserção onde deseja inserir o trecho. No menu Opções do trecho necessário, escolha Inserir trecho.

Modelos -

O painel Modelos está disponível somente para administradores. Com esse painel, o e o administrador do podem criar e gerenciar facilmente modelos que podem ser usados pelos autores. Por padrão, os modelos são categorizados em Mapa e Tópico modelos de tipo.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um modelo, é possível exibir o título do arquivo e o nome do arquivo como uma dica de ferramenta.

Para criar um modelo, clique no ícone + ao lado de Modelos e escolha um modelo que deseja criar. Se você selecionar Modelo de Tópico, a caixa de diálogo Criar Novo Modelo de Tópico será exibida:

Escolha o tipo de modelo que deseja criar na lista suspensa Modelo. Forneça o Título, que aparece no painel Modelos. O Nome do modelo é sugerido automaticamente com base no título. No entanto, você pode fornecer um nome de arquivo diferente.

Depois que o modelo for criado, é necessário adicioná-lo ao perfil global ou de nível de pasta. Depois que o modelo for adicionado, os autores começarão a ver o novo modelo no processo de criação de tópico/mapa.

Usando o menu Opções em um modelo existente, você pode optar por Editar ou Duplicar. No caso de duplicação, a estrutura e o tipo do modelo (do documento) são retidos e você pode reutilizá-los para criar outro modelo a partir dele.

Revisão -

O AEM Guides fornece o recurso para exibir todas as tarefas de revisão em seus projetos. Você pode exibir todos os projetos de revisão e as tarefas de revisão ativas dentro dos projetos de revisão, dos quais você faz parte no painel Revisão. É possível abrir as tarefas de revisão para exibir os comentários dos vários revisores.

O painel de revisão exibe as tarefas de revisão. Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Como autor, você pode endereçar os comentários em um tópico usando o Editor da Web.

Para exibir os comentários de revisão nas tarefas de revisão ativas que estão presentes em seus projetos, execute as seguintes etapas:

1. Selecionar revisão no painel esquerdo. O painel Revisão é aberto. Todos os projetos de revisão e as tarefas de revisão ativas nos projetos de revisão, dos quais você faz parte, são exibidos.

   

2. Selecione um projeto de revisão e, em seguida, selecione uma tarefa de revisão na lista para abri-lo.

3. Você também pode filtrar seus projetos das seguintes maneiras:

   • Insira o termo ou texto de pesquisa que deseja localizar no título do projeto. Pressione Enter para realizar a pesquisa. Por exemplo, você pode pesquisar todos os projetos com o termo "espaço" no título.

   • Selecione para abrir o diálogo Filtro. Você pode selecionar todos ou somente projetos específicos. Os projetos selecionados estão listados no painel Revisão.

     

     A opção Tarefas iniciadas por mim está habilitada por padrão. Permite exibir somente as tarefas que você iniciou.

4. Por padrão, no projeto de revisão, você exibirá uma lista simples de tópicos que têm comentários associados a eles. Aplique os filtros necessários no painel esquerdo para filtrar os tópicos com base nos comentários de revisão presentes neles:

   • Exibir todos os tópicos: lista todos os tópicos presentes nos projetos.
   • Exibir tópicos com comentários: lista apenas os tópicos que contêm comentários de revisão.

5. Você também pode inserir o termo de pesquisa ou o texto que deseja localizar no título do tópico ou no caminho do arquivo. Os tópicos que contêm o termo no título ou no caminho do arquivo são listados.

6. Clique duas vezes em qualquer tópico para abri-lo na exibição do autor. Você pode exibir os comentários no painel Comentários.
   

   OBSERVAÇÃO

   O painel Revisão e o painel Comentários estão sempre sincronizados. No painel Comentários, os comentários são carregados com base na tarefa de revisão carregada no painel Revisão.

   Para obter mais informações sobre como tratar os comentários, exiba comentários de revisão de endereço.

Localizar e Substituir -

O ícone Localizar e substituir é encontrado na parte inferior do painel esquerdo. O painel Localizar e substituir permite procurar e substituir texto entre arquivos em um mapa ou uma pasta no repositório. É possível localizar e substituir em todos os tópicos de um mapa, bem como nos tópicos presentes nos submapas dentro do mapa.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Para executar a pesquisa global e substituir, execute as seguintes etapas:

1. Abra o painel global Localizar e Substituir.

2. Clique na lista suspensa Examinar e selecione uma das seguintes opções para realizar a pesquisa.

   • Mapa atual: para pesquisar no mapa atualmente aberto

     OBSERVAÇÃO

     Essa opção será exibida se você já tiver aberto um mapa para edição.

   • Caminho: para pesquisar no caminho selecionado

   • Selecionar mapa: para pesquisar no mapa selecionado

3. Você pode clicar na lista suspensa Opções e escolher entre as seguintes opções:

   • Fazer check-out do arquivo antes de substituir: selecione esta opção se desejar fazer check-out de um arquivo automaticamente antes de substituir o termo de pesquisa. Essa configuração é mais relevante caso o administrador tenha ativado a configuração para fazer check-out de um arquivo antes de editar. Com a configuração de backend ativada, você deve selecionar essa opção. Isso impedirá que a caixa de diálogo de check-out de arquivo solicite que você faça check-out de cada arquivo antes de fazer qualquer alteração. Se você não selecionar essa opção, um prompt será exibido antes que um arquivo seja aberto para edição.

   • Somente Palavra Inteira: selecione essa opção se desejar pesquisar toda a cadeia de caracteres de pesquisa. Por exemplo, se você inserir sobre na cadeia de caracteres de pesquisa, o resultado da pesquisa retornará todos os arquivos contendo palavras como sobre e visão geral. Se quiser restringir a pesquisa para retornar o termo exato inserido, selecione essa opção.

   • Criar Nova Versão Após Substituir: selecione essa opção se desejar criar uma nova versão do tópico no qual você opta por substituir o texto. Você também pode fornecer comentários de versão que serão adicionados com cada arquivo atualizado.

     Se você não selecionar essa opção, as alterações serão salvas na versão atual do tópico e nenhuma nova versão será criada.

   • Incluir referência indireta: selecione essa opção se desejar pesquisar a cadeia de caracteres nas referências indiretas também no mapa DITA. Por padrão, isso fica desativado para que a pesquisa seja executada somente nas referências diretas.

4. Informe o termo ou texto de pesquisa que deseja localizar.

5. Insira o texto pelo qual deseja substituir o termo de pesquisa.

6. Pressione Enter ou selecione o ícone Pesquisar ( ) para realizar a pesquisa.

7. Selecione um arquivo na lista de resultados da pesquisa. O arquivo é aberto na área de edição de conteúdo com o termo pesquisado realçado no conteúdo.

8. Abra o painel global Localizar e Substituir.

9. Clique na lista suspensa Examinar e selecione uma das seguintes opções para realizar a pesquisa.

   • Mapa atual: para pesquisar no mapa atualmente aberto

     OBSERVAÇÃO

     Essa opção será exibida se você já tiver aberto um mapa para edição.

   • Caminho: para pesquisar no caminho selecionado

   • Selecionar mapa: para pesquisar no mapa selecionado

10. Você pode clicar na lista suspensa Opções e escolher entre as seguintes opções:

    • Fazer check-out do arquivo antes de substituir: selecione esta opção se desejar fazer check-out de um arquivo automaticamente antes de substituir o termo de pesquisa. Essa configuração é mais relevante caso o administrador tenha ativado a configuração para fazer check-out de um arquivo antes de editar. Com a configuração de backend ativada, você deve selecionar essa opção. Isso impedirá que a caixa de diálogo de check-out de arquivo solicite que você faça check-out de cada arquivo antes de fazer qualquer alteração. Se você não selecionar essa opção, um prompt será exibido antes que um arquivo seja aberto para edição.

    • Somente Palavra Inteira: selecione essa opção se desejar pesquisar toda a cadeia de caracteres de pesquisa. Por exemplo, se você inserir sobre na cadeia de caracteres de pesquisa, o resultado da pesquisa retornará todos os arquivos contendo palavras como sobre e visão geral. Se quiser restringir a pesquisa para retornar o termo exato inserido, selecione essa opção.

    • Criar Nova Versão Após Substituir: selecione essa opção se desejar criar uma nova versão do tópico no qual você opta por substituir o texto. Você também pode fornecer comentários de versão que serão adicionados com cada arquivo atualizado.

      Se você não selecionar essa opção, as alterações serão salvas na versão atual do tópico e nenhuma nova versão será criada.

    • Incluir referência indireta: selecione essa opção se desejar pesquisar a cadeia de caracteres nas referências indiretas também no mapa DITA. Por padrão, isso fica desativado para que a pesquisa seja executada somente nas referências diretas.

11. Informe o termo ou texto de pesquisa que deseja localizar.

12. Insira o texto pelo qual deseja substituir o termo de pesquisa.

13. Pressione Enter ou selecione o ícone Pesquisar ( ) para realizar a pesquisa.

14. Selecione um arquivo na lista de resultados da pesquisa. O arquivo é aberto na área de edição de conteúdo com o termo pesquisado realçado no conteúdo.

15. Clique em Substituir Ocorrência Única ( ) para substituir o termo de pesquisa destacado no tópico ou clique em Próxima Correspondência ou Correspondência Anterior para ir para a próxima ocorrência ou ocorrência anterior do texto.

16. Clique em Substituir Tudo no Arquivo ( )para substituir todas as ocorrências do termo pesquisado em um único arquivo pelo termo de substituição em um único clique. Você verá uma notificação depois de substituir todas as ocorrências no arquivo selecionado.

    OBSERVAÇÃO

    Passe o mouse sobre um arquivo da lista de resultados da pesquisa para ver o ícone Substituir tudo no arquivo à direita. Você também obtém o ícone Ignorar arquivo para remover o arquivo do resultado da pesquisa. Os arquivos que você ignora são removidos da lista e o termo pesquisado não é substituído neles.

17. Clique em Substituir tudo ( ) à direita na parte superior da lista para substituir todas as ocorrências do termo pesquisado em todos os arquivos pelo termo de substituição em um único clique.

    OBSERVAÇÃO

    Para habilitar o ícone Substituir tudo, o administrador do sistema deve selecionar a opção Habilitar Substituir tudo na guia Geral das Configurações do Editor.

Somente uma operação de substituição total pode ser executada de cada vez em todo o sistema. Até que a operação esteja sendo executada, você verá o status "Substituir tudo em andamento". Você também pode abortar a operação replace all no meio ou ver o relatório de log. Se você suspender a operação, receberá uma notificação sobre ela na sua Caixa de entrada. Você receberá uma notificação de sucesso depois de substituir todas as ocorrências no arquivo selecionado.

Você também pode usar a opção Localizar no Mapa do menu Opções de um mapa para localizar e substituir texto em um mapa. Essa opção aparece para um mapa aberto no painel de repositório ou na exibição de mapa.

Área de edição de conteúdo

A área de edição de conteúdo é onde o conteúdo do tópico ou mapa é exibido. Você faz todas as edições de conteúdo nesta área. Ele fornece uma visualização WYSIWYG do conteúdo que você está editando. É possível abrir vários tópicos ao mesmo tempo, que são exibidos em suas respectivas guias.

Por padrão, é possível exibir os títulos dos arquivos nas guias. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Abaixo da guia do arquivo, você tem a navegação estrutural do elemento na localização atual do cursor. No canto superior direito da área de edição de conteúdo, o número da versão do tópico atual é exibido.

Painel direito

O painel direito é um painel persistente que contém informações sobre o documento selecionado no momento.

O painel direito fornece acesso aos seguintes recursos:

Propriedades do conteúdo -

Você pode acessar o recurso Propriedades de Conteúdo selecionando o ícone Propriedades de Conteúdo no painel direito. O painel Propriedades de Conteúdo contém informações sobre o tipo de elemento atualmente selecionado no documento e seus atributos.

Tipo: você pode exibir e selecionar as marcas da hierarquia completa para a marca atual na lista suspensa.

Atributos: o painel suspenso Atributos está disponível nos modos de exibição Layout, Autor e Source. É possível adicionar, editar ou excluir facilmente os atributos.

1. Clique em + Adicionar.

   

2. No painel suspenso Atributo, selecione o atributo na lista suspensa e especifique o valor de um atributo. Depois clique em Adicionar.

   

3. Para editar o atributo, passe o mouse sobre ele e selecione Editar .
   

4. Para excluir o atributo, passe o mouse sobre ele e selecione Excluir .

Se o administrador tiver criado um perfil para atributos, você obterá esses atributos junto com seus valores configurados. Usando o painel de propriedades de conteúdo, você pode escolher esses atributos e atribuí-los ao conteúdo relevante em seu tópico. Dessa forma, você também pode criar conteúdo condicional, que pode ser usado para criar saída condicional. Para obter mais informações sobre como gerar saída usando predefinições condicionais, consulte Usar predefinições de condição.

Propriedades do Arquivo -

Exiba as propriedades do arquivo selecionado clicando no ícone Propriedades do Arquivo no painel direito. O recurso Propriedades do arquivo está disponível em todos os quatro modos ou visualizações: Layout, Autor, Source e Visualização.

As Propriedades do arquivo têm as duas seções a seguir:

Geral

A seção Geral fornece acesso aos seguintes recursos:

• Nome: exibe o nome de arquivo do tópico selecionado. O nome do arquivo tem um hiperlink para a página de propriedades do arquivo selecionado.
• ID: exibe a ID do tópico selecionado.
• Marcas: estas são as marcas de metadados do tópico. Eles são definidos no campo tags na página propriedades. Você pode digitá-los ou selecioná-los na lista suspensa. As tags são exibidas na lista suspensa. Para excluir uma tag, selecione o ícone de cruz ao lado da tag.
• Editar mais propriedades: é possível editar mais propriedades na página de propriedades do arquivo.
• Idioma: mostra o idioma do tópico. Ele é definido no campo Language na página de propriedades.
• Criado em: Exibe a data e a hora em que o tópico foi criado.
• Retirado por: mostra o usuário que fez check-out do tópico.
• Estado do Documento: você pode selecionar e atualizar o estado do documento do tópico aberto no momento. Para obter mais detalhes, consulte Estado do Documento .

Observação: você pode copiar os valores de atributo de vários campos nas propriedades de Arquivo para a área de transferência.

Referências

A seção Referências fornece acesso aos seguintes recursos:

• Usado em: as referências Usado em listam os documentos nos quais o arquivo atual está sendo referenciado ou usado.
• Links de Saída: Os Links de Saída listam os documentos referidos no documento atual.

Por padrão, é possível visualizar os arquivos por títulos. Ao passar o mouse sobre um arquivo, é possível visualizar o título do arquivo e o caminho do arquivo como uma dica de ferramenta.

Observação: todas as referências de Entrada e Saída usadas estão vinculadas aos documentos por hiperlink. É possível abrir e editar facilmente os documentos vinculados.

Além de abrir arquivos, você também pode executar muitas ações usando o menu Opções na seção Referências. Algumas das ações que você pode executar incluem Editar, Visualizar, Copiar UUID, Copiar caminho, Adicionar a favoritos, Propriedades e Abrir painel de mapa.

Revisão -

Clicar no ícone Revisar abre o painel de revisão, no qual é possível criar uma tarefa de revisão para o documento aberto no momento.

Se você tiver criado vários projetos de revisão, é possível selecionar um no menu suspenso e acessar os comentários da revisão.

Usando o painel de revisão, você pode exibir e postar respostas aos comentários fornecidos sobre o tópico. Você pode aceitar ou rejeitar os comentários um por um.

Para obter mais informações, consulte Comentários de revisão de endereço.

Alterações Controladas -

Usando o recurso Alterações controladas do painel direito, você pode exibir as informações de todas as atualizações feitas em um documento. Você também pode procurar por atualizações específicas feitas no documento.

Tópico pai:​ Trabalhar com o Editor da Web