NOTE
Quando você pesquisa qualquer texto ou filtra qualquer arquivo, um ponto azul é exibido no ícone Filtrar pesquisa ( Ícone Filtrar pesquisa ) para indicar que estamos no painel de pesquisa e que alguns filtros foram aplicados.

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.

filtro de pesquisa rápida

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

Filtragem Avançada

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

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

caixa de diálogo de filtro 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 adicionar ícone 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 fechar ícone para fechar o filtro e retornar ao modo de exibição de árvore do repositório.

    note note
    NOTE
    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.

    {width="550"}

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

    {width="800"}

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

    {width="400"}

    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.

    {width="300"}

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

    note note
    NOTE
    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

menu de opções de um arquivo no modo de exibição de repositório

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.

    note note
    NOTE
    • 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.

    {width="800"}

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

    {width="550"}

    note note
    NOTE
    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.

    note note
    NOTE
    Se o administrador concedeu a você as permissões em uma pasta, apenas as opções Renomear ou Mover para serão exibidas.
    accordion
    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.

      note note
      NOTE
      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:

      {width="550"}

      note note
      NOTE
      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.

    note note
    NOTE
    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.

    note note
    NOTE
    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:

    {width="300"}

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.

NOTE
Como administrador, você também pode optar por exibir o nome do arquivo do mapa pai que está aberto na exibição de mapa. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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

chaves na exibição de mapa

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.

    note note
    NOTE
    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.

    note note
    NOTE
    • 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.

NOTE
Você também pode abrir e editar as propriedades dos tópicos selecionados em um mapa DITA no menu Mais Opções, na parte inferior da Exibição de Mapa.

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.

    {width="650"}

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

    {width="300"}

    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.

    {width="300"}

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

NOTE
Para obter mais detalhes sobre Gerar ID, Inserir elemento antes ou depois do elemento atual e Decodificar um elemento, consulte Outros recursos no Editor da Web.

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.

NOTE
Como administrador, você também pode optar por exibir a lista de arquivos por nomes de arquivo no Editor da Web. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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.

    {width="650"}

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

NOTE
É possível adicionar vários arquivos à lista de conteúdo reutilizável. Em seguida, você pode inserir o conteúdo desejado do painel Conteúdo reutilizável no documento.

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.

    {width="400"}

    note note
    NOTE
    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.

    {width="300"}

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

NOTE
Atualize o tópico para exibir os termos convertidos.

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.

IMPORTANT
A captura de tela a seguir é de um usuário com privilégios administrativos. Como um usuário com privilégios administrativos, você pode adicionar, editar e excluir condições. Senão, como um autor normal, você só terá a opção de aplicar condições.

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.

    code language-xml
    <?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>
    

    {width="300"}

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

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

    {width="550"}

  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.

    {width="400"}

  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.

    {width="650"}

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.

NOTE
Como subject_scheme_map_1.ditamap e subject_scheme_map_2.ditamap são referenciados um com o outro, os esquemas de assunto estão sendo resolvidos.

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.
{width="200"}
Execute as seguintes etapas para alterar o valor:

  1. Selecione um atributo na lista suspensa Atributo.
  2. Selecione Editar ícone de edição .
  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.

IMPORTANT
A captura de tela a seguir é de um usuário com privilégios administrativos. Como usuário com privilégios administrativos, você pode adicionar, editar e excluir trechos. Caso contrário, como autor normal, você só terá as opções para 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.

    {width="550"}

    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.

    {width="350"}

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.

NOTE
No menu de contexto de uma entrada de trecho, você também pode optar por Editar, Excluir, obter uma Visualização ou Inserir um 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.

NOTE
Como administrador, você também pode optar por exibir a lista de arquivos no Editor da Web. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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.

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

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.

NOTE
Como administrador, você também pode optar por exibir a lista de arquivos por nomes de arquivo no Editor da Web. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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.

    {width="300"}

  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.

      {width="300"}

      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.
    {width="800"}

    note note
    NOTE
    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.

NOTE
Como administrador, você também pode optar por exibir a lista de nomes de arquivo no Editor da Web. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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

      note note
      NOTE
      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

      note note
      NOTE
      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.

    note note
    NOTE
    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.

    note note
    NOTE
    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 id2051EB000UI

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.

NOTE
Como administrador, você também pode optar por exibir a lista de arquivos por nomes de arquivo nas guias. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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 id2051EB003YK

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

NOTE
O painel direito é redimensionável. Para redimensionar o painel, coloque o cursor no limite do painel, o cursor se transforma em uma seta de duas pontas, clique e arraste para redimensionar a largura do painel.

O painel direito fornece acesso aos seguintes recursos:

Propriedades do conteúdo - 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.

    atributos em propriedades de conteúdo {width="300"}

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

    painel de atributos com vários atributos {width="300"}

  3. Para editar o atributo, passe o mouse sobre ele e selecione Editar ícone de edição .
    editar atributos {width="300"}

  4. Para excluir o atributo, passe o mouse sobre ele e selecione Excluir ícone de exclusão .

NOTE
Mesmo que seu tópico tenha conteúdo referenciado, é possível adicionar atributos a ele usando o painel de propriedades.

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:

propriedades-arquivo

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

NOTE
Como administrador, você também pode optar por exibir a lista de arquivos por nomes de arquivo no Editor da Web. Selecione a opção Nome do arquivo da seção Exibir arquivos por em Preferências do usuário .

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.

NOTE
O recurso Alterações controladas mostra todas as atualizações que foram controladas usando o recurso Habilitar/Desabilitar Controlar alterações da barra de ferramentas principal. Para obter mais detalhes, consulte Habilitar/Desabilitar o Controle de Alterações.

Tópico pai: Trabalhar com o Editor da Web

recommendation-more-help