DocumentaçãoAEM GuidesDocumentação do AEM Guides

[Guia herdado - Mais informações]{class="badge informative" title="Guia herdado"}

Criar mapas com base em modelos personalizados id225VF0808MP

Last update: Tue Jul 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

Você pode criar modelos de mapa personalizados e usá-los para criar mapas DITA juntamente com os modelos de tópico e de mapa referenciados no modelo de mapa

Você pode consultar outros modelos de mapa e modelos de tópico do modelo de mapa personalizado. Os modelos de mapa referenciados podem se referir a vários modelos de mapa, modelos de tópico, tópicos, mapas, imagens, vídeos e outros ativos. O modelo de mapa personalizado pode ajudá-lo a replicar com facilidade os modelos de mapa e toda a estrutura de pastas indicada. Esses modelos personalizados são especialmente úteis para criar e recriar vários mapas que têm estruturas e referências recursivas.

NOTE
Os modelos de tópico não são criados recursivamente. Somente os modelos de tópico que estão diretamente dentro do modelo de mapa são gerados e qualquer modelo de tópico dentro de um modelo de tópico é simplesmente referenciado diretamente no pai.

Criar modelos personalizados

O AEM Guides permite criar mapas e tópicos personalizados a partir da pasta dita-templates. Você pode usar esses modelos personalizados para criar seu mapa e tópico. Você também pode compartilhar esses modelos com seus autores, que podem usá-los para criar seus arquivos. Usando esses modelos, você pode permitir que os autores mantenham cópias separadas de determinados recursos que estão dentro da pasta de modelos.

NOTE
Quaisquer recursos que só devem ser referenciados e mantidos em devem ser mantidos fora da pasta de templates.

Você pode criar modelos de mapa e tópico das seguintes maneiras:

  1. Painel Modelos do painel esquerdo
  2. Modelos na interface do Assets
  3. Menu Opções

Modelos na interface do Assets templates-assets-ui

Modelo de tópico

Execute as seguintes etapas para criar um modelo de tópico:

  1. Na interface do usuário do Assets, navegue até a pasta dita-templates.

    {width="800"}

  2. Clique na pasta tópicos para abri-la.Clique em Criar > Modelo DITA.

  3. Na página Blueprint, selecione Tópico e clique em Avançar.

  4. Na página Propriedades, especifique o modelo de tópico Título.

  5. Especifique o arquivo Nome

    note note
    NOTE
    O nome do arquivo deve ter a extensão .dita.

  6. (Opcional) Adicione uma descrição.

  7. Clique em Criar. A mensagem de criação do modelo de tópico é exibida. Em seguida, você pode abrir o modelo de tópico e editá-lo.

Modelo de mapa

Execute as seguintes etapas para criar um modelo de mapa:

  1. Na interface do usuário do Assets, navegue até a pasta dita-templates.

  2. Clique na pasta maps para abri-la.

  3. Clique em Criar > Modelo DITA.

    {width="300"}

  4. Na página Blueprint, selecione Mapa e clique em Avançar.

  5. Na página Propriedades, especifique o modelo de mapa Título.

  6. Especifique o arquivo Nome.

    note note
    NOTE
    O nome do arquivo deve ter a extensão .ditamap.

  7. (Opcional) Adicione uma descrição.Clique em Criar. A mensagem de criação do modelo de mapa é exibida. Em seguida, é possível abrir o modelo de mapa e editá-lo. É possível adicionar as referências para os modelos de tópico, modelos de mapa e também outros ativos no modelo de mapa.

Para criar um mapa ou modelo de tópico, execute as seguintes etapas:

  1. Selecione a pasta Mapa ou Tópico na pasta de modelos atual. Por exemplo, pasta dita-templates.

  2. No menu Opções, selecione Criar Modelo de Mapa ou Criar Modelo de Tópico.

    A caixa de diálogo Criar Novo Modelo de Mapa ou Criar Novo Modelo de Tópico é aberta.

  3. Insira o título e o nome do novo template.

  4. Escolha o tipo de modelo que deseja criar na lista suspensa Modelo.

A mensagem de criação do modelo de mapa é exibida. Você pode adicionar o modelo ao seu perfil global ou de nível de pasta. O novo modelo aparece no tópico ou no processo de criação de mapa e você pode criar mapas ou tópicos usando-o.

O administrador também pode criar uma pasta e configurá-la para ser a pasta na qual você pode criar e salvar os modelos.

Com base em sua configuração, saiba como configurar o caminho de pasta do modelo DITA personalizado:

Cloud Services
Saiba como configurar o caminho de pasta de modelo DITA personalizado no Guia de Instalação e Configuração do Cloud Service.
Software local
Saiba como configurar o caminho de pasta de modelo DITA personalizado no Guia de Instalação e Configuração no Local.

Transmita o título definido nos modelos

Se quiser passar o título do tópico ou mapa usado dentro do modelo para os mapas DITA criados usando esse modelo, use chaves ao redor do título.

Exemplo

<pubtitle>
   <mainpubtitle outputclass="booktitle">
   {title}
   </mainpubtitle>
   <subtitle>Subtitle</subtitle>
</pubtitle>

The resultant DITA map with title "Rootmap1" will look like as follows:
<pubtitle>
   <mainpubtitle outputclass="booktitle">Rootmap1
   </mainpubtitle>
   <subtitle>Subtitle</subtitle>
</pubtitle>
NOTE
Somente a primeira ocorrência de chaves será substituída pelo título.

Se você não usar chaves ao redor do título, somente o primeiro elemento será escolhido, o aninhamento do título não será escolhido do modelo e terá a seguinte aparência:

<pubtitle> Rootmap1 </pubtitle>
NOTE
Também é possível usar as chaves ao redor do texto para transmitir sua estrutura aninhada dos modelos personalizados para seus mapas DITA.

Exemplo

<title>
    <sub>
        <b>{title}</b>
    </sub>
</title>

Usar o modelo de mapa para criar novos mapas

NOTE
O modelo de mapa deve ser configurado e disponibilizado para criação pelo administrador. Para obter mais detalhes, consulte a seção Configurar modelos de criação na seção Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service.

Execute as seguintes etapas para criar um mapa usando o modelo de mapa personalizado:

  1. Na Interface do usuário do Assets, navegue até a pasta onde deseja criar o mapa.

  2. Clique em Criar > Mapa DITA.

  3. Na página Blueprint, selecione o modelo de mapa que deseja usar e clique em Próximo. Por exemplo, se você criou um modelo de mapa "modelo de teste", selecione-o.

  4. Na página Propriedades, especifique o mapa Título.

  5. Especifique o arquivo Nome.

    note note
    NOTE
    O nome do arquivo deve ter a extensão .ditamap.

  6. Clique em Criar. A mensagem de mapa criado é exibida.

O mapa gera todos os ativos que são referenciados dentro da pasta de modelo. Alguns tipos de ativos referenciados em um mapa podem ser os seguintes:

  • Se o mapa contiver a referência a um modelo de tópico, uma cópia dele será criada dentro da pasta, na mesma hierarquia que na pasta de tópicos da pasta dita-templates.

  • Se o mapa contiver a referência a um modelo de mapa, uma cópia dele será criada dentro da pasta, na mesma hierarquia que na pasta de mapas da pasta dita-templates.

  • Se o mapa contiver a referência genérica a um tópico ou mapa fora da pasta dita-templates/topics ou dita-templates/maps, o mesmo será mencionado apenas, e nenhuma cópia será criada.

    note note
    NOTE
    dita-templates/topics e dita-templates/maps são os caminhos padrão nos Guias e são configuráveis.

    Se houver uma definição de chave de modelo de tópico no modelo de mapa, uma nova chave (portanto, novo tópico) será criada e referenciada no mapa.

  • Se outro mapa ou tópico for criado no mesmo nível na pasta, os nomes dos ativos recém-criados serão anexados com 0,1,2 e assim por diante. Você pode optar por abrir o mapa para edição ou salvar o arquivo de mapa no repositório.

Tópico pai: ​ Trabalhar com o Editor de Mapa

recommendation-more-help