Predefinições do AEM Sites no Editor da Web
Você pode criar predefinições do AEM Sites no Editor da Web e configurá-las para gerar a saída do AEM Sites. A saída do AEM Sites é baseada no mapeamento de componentes compostos juntamente com o guides-components, facilitando a criação e o gerenciamento eficientes de conteúdo.
O Experience Manager Guides fornece modelos predefinidos para a criação de AEM Sites. Essas predefinições ajudam a garantir a consistência no layout e na estrutura do conteúdo.
- Criar home pages com base nesses modelos predefinidos.
- Você pode editar modelos de tópico e aplicar estilos de acordo com suas necessidades.
- Você também pode personalizar modelos existentes do AEM Sites.
Criar predefinições do AEM Sites
Execute as seguintes etapas para criar as predefinições do AEM Sites a partir do Editor da Web:
- No painel Repositório, abra o arquivo de mapa DITA na Exibição de mapa.
- Na guia Saída, selecione o ícone + para criar uma predefinição de saída.
- Selecione AEM Sites no menu suspenso Tipo na caixa de diálogo Nova predefinição de saída.
- Desmarque a opção Usar mapeamento de componente herdado da caixa de diálogo Nova predefinição de saída.
- Software Local: saiba mais sobre como baixar e instalar modelos do AEM Sites para Software Local.
- Cloud Service: saiba mais sobre como baixar e instalar modelos do AEM Sites para Cloud Service.
Adicionar predefinições ao perfil da pasta atual
Como administrador, o Experience Manager Guides permite criar e gerenciar predefinições de saída para os Perfis global e de pasta. Selecione a opção Adicionar ao perfil de pasta atual na caixa de diálogo Nova predefinição de saída para criar uma predefinição de saída para o perfil de pasta atual. O ícone
Predefinições do AEM Sites com base no mapeamento de componente herdado
Também é possível criar as predefinições do AEM Sites usando o mapeamento de componente herdado. Para criar as predefinições do AEM Sites com base no mapeamento de componente herdado, selecione a opção Usar mapeamento de componente herdado na caixa de diálogo Nova predefinição de saída.
Algumas opções podem diferir para as predefinições que usam o mapeamento de componente herdado.
Configurar as predefinições do AEM Sites
As configurações estão organizadas nas guias Geral, Conteúdo, Lista de tópicos e Referências entre mapas.
Geral
A guia Geral contém as seguintes configurações relacionadas à geração de saídas:
-
Usar caminho do site
-
Caminho do site
-
Site
-
Caminho do Publish
-
Modelo de página de tópico
-
Gerar nomes de página com base em
- Nome do arquivo de tópico
- Título do tópico
-
Limpar páginas geradas anteriormente
- Excluir páginas geradas anteriormente para tópicos removidos do mapa
- Exclua todas as páginas criadas por outras fontes neste caminho:
-
Fluxo de trabalho de pós-geração
Conteúdo
A guia Conteúdo contém as seguintes configurações:
-
Usar Linha de Base
-
Filtragem de condição
-
Argumentos adicionais da linha de comando DITA-OT
-
Metadados
- Propriedades do arquivo (Assets)
- Usar propriedades do mapa como fallback
Para obter detalhes, consulte configuração do AEM Sites.
Lista de Tópicos
A Lista de Tópicos exibe a lista de tópicos presentes na cópia de trabalho atual do mapa DITA. Por padrão, todos os tópicos são incluídos. Você pode selecionar tópicos específicos e gerar a saída do AEM Sites somente para eles. Por exemplo, você atualizou alguns tópicos para poder publicar somente esses tópicos, em vez de publicar o mapa DITA inteiro.
A guia Lista de Tópicos está presente nas predefinições de AEM que não são criadas com base no mapeamento herdado.
Referências entre mapas
Esta lista contém tópicos que contêm referências entre mapas com scope =”peer”. Você pode especificar o contexto de publicação para uma lista de referências de mapa cruzado com scope=”peer” para tópicos disponíveis em outros mapas DITA. Essa guia será exibida se você usar a versão do Experience Manager Guides (UUID).
Saiba como publicar tópicos vinculados.
Configuração do AEM Sites aem_sites_config
As seguintes opções estão disponíveis para a saída do AEM Sites:
Selecione Atualizar
AEMG-Docs e o Caminho do Publish como aemg-docs-en/docs/product-abc., a saída do AEM Sites será gerada no nó aemg-docs-en/docs/product-abc/ em crx/de.Título do tópico: usa o título do tópico DITA para criar os nomes de site de Experience Manager.
Digamos que você tenha publicado um mapa DITA, que contém os tópicos a.dita, b.dita e c.dita. Antes de publicar o mapa novamente, você removeu o tópico b.dita do mapa. Agora, se você selecionou essa opção, todo o conteúdo relacionado a b.dita é removido da saída do AEM Sites e somente a.dita e c.dita são publicados.
Observação: informações sobre páginas excluídas também são capturadas nos logs de geração de saída. Para obter mais informações sobre como acessar os arquivos de log, Exiba e verifique o arquivo de log.
Cuidado: ao excluir os tópicos, as páginas ficam indisponíveis no site publicado. Portanto, antes que os tópicos sejam excluídos, um aviso é exibido. Você deve confirmar a exclusão deles.
- Excluir todas as páginas criadas por outras fontes neste caminho: se você selecionar esta opção, todas as páginas publicadas neste caminho de outros mapas, tópicos individuais ou qualquer outra fonte serão excluídas. As páginas também se tornam indisponíveis no site publicado. Portanto, antes que os tópicos sejam excluídos, um aviso é exibido. Você deve confirmar a exclusão deles.
Importante: quando você está gerando saída incremental para o Site AEM, a saída é criada usando a versão atual dos arquivos e não a Linha de Base anexada.
Exibir Trabalhar com a Linha de Base para obter mais detalhes.
None: selecione essa opção se não quiser aplicar nenhuma condição à saída publicada.
Usando DITAVAL: selecione o(s) arquivo(s) DITAVal para gerar conteúdo condicional. Você pode selecionar vários arquivos DITAVal usando a caixa de diálogo Procurar ou digitando o caminho do arquivo. Use o ícone de cruz próximo ao nome do arquivo para removê-lo. Os arquivos DITAVal são avaliados na ordem especificada, de modo que as condições especificadas no primeiro arquivo têm precedência sobre as condições correspondentes especificadas em arquivos posteriores. É possível manter a ordem dos arquivos adicionando ou excluindo arquivos. Se o arquivo DITAVal for movido para algum outro local ou excluído, ele não será excluído automaticamente do painel de mapa. Você precisa atualizar o local caso os arquivos sejam movidos ou excluídos. Você pode passar o mouse sobre o nome do arquivo para visualizar o caminho no repositório AEM onde o arquivo está armazenado. Você só pode selecionar arquivos DITAVal e um erro será exibido se você selecionar qualquer outro tipo de arquivo.
Predefinição de condição: selecione uma predefinição de condição no menu suspenso para aplicar uma condição ao publicar a saída. Essa opção estará visível se você tiver adicionado uma condição para o arquivo de mapa DITA. As configurações condicionais estão disponíveis na guia Predefinições de condição do console do mapa DITA. Para saber mais sobre a predefinição de condição, exiba Usar predefinições de condição.
Propriedades de
Arquivo (Assets)
Observação: as propriedades de metadados diferenciam maiúsculas de minúsculas.
Se você tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão da Linha de Base selecionada. Se você não tiver selecionado uma Linha de Base, os valores das propriedades serão baseados na versão mais recente.
Você também pode passar os metadados para a saída usando a publicação DITA-OT. Para obter mais detalhes, Passe os metadados para a saída usando DITA-OT.
Observação: se você não tiver definido a
cq:tags na opção Propriedades, os valores de cq:tags serão escolhidos na cópia de trabalho atual, mesmo que você tenha selecionado uma Linha de Base para publicação.Usar propriedades do mapa como fallback
Somente as propriedades String, Date ou Long (único e de vários valores) podem ser passadas para as páginas do Site do AEM. Os valores de metadados de uma propriedade do tipo Cadeia de Caracteres não dão suporte a caracteres especiais (como
@, #, " ").* Esta opção deve ser usada com a opção
Properties.Depois de gerar a saída, selecione o ícone Baixar arquivos temporários
Observação: se as propriedades do arquivo forem adicionadas durante a geração, os arquivos temporários de saída também incluirão um arquivo metadata.xml contendo essas propriedades.
Gerar a saída do AEM Sites usando os templates
O Experience Manager Guides permite usar os modelos prontos para uso ou adicionar seus próprios modelos do AEM Sites.
Antes de configurar as predefinições do AEM Sites, crie uma estrutura do AEM Sites usando os modelos.
Para obter mais detalhes, consulte Baixar e instalar modelos do AEM Sites.
Execute as seguintes etapas para criar e configurar uma predefinição do AEM Sites:
-
Abra a guia Predefinições de saída do mapa DITA que deseja publicar.
-
Selecione a predefinição de saída AEM Sites.
-
(Opcional) Desmarque a opção Usar mapeamento de componente herdado para criar uma predefinição de AEM Sites não herdada.
-
Clique em Adicionar. A predefinição do AEM Sites é criada.
-
Você pode configurar o modelo de Sites pronto para uso de duas maneiras:
-
Selecione Site e escolha o caminho de publicação e os modelos de página de tópico entre as opções preenchidas:
- Selecione o site.
- Selecione Site. Por exemplo,
AEMG Docs. - As opções caminho do Publish e modelo de página de Tópico são definidas automaticamente na lista suspensa. Você também pode escolher as opções. Por exemplo,
AEMG-Docs-Site/en/docs/product1eTopic pageestão definidos respectivamente.
-
Selecione o caminho completo do site:
- Selecione a opção Usar caminho do site.
- Selecione o caminho completo do site. Por exemplo,
/content/AEMG-Docs-Site/en/docs/product1. - O ‘Modelo de página de tópico’ é automaticamente definido como
Topic Page.
-
-
Salvar as alterações feitas na predefinição.
-
Selecione a opção Gerar.
-
Gere AEM Sites para o mapa correspondente. Por exemplo,
/content/AEMG-Docs-Site/en/docs/product.note note NOTE Se você estiver publicando conteúdo em um site AEM pela primeira vez, é recomendável publicar as páginas no nível do site. Isso garante que a saída seja exibida corretamente na instância do Publish, sem interrupção de CSS.
Tópicos vinculados do Publish
O Experience Manager Guides simplifica a publicação de documentos complexos permitindo que você crie referências de tópico usando o peer @scope. Em seguida, você pode definir o contexto de publicação dessas referências a partir das predefinições do AEM Sites e, finalmente, gerar a saída dos tópicos vinculados.
Para obter mais detalhes, exiba Gerar saída de tópicos de vinculação de outros mapas.
Execute as seguintes etapas para especificar o contexto de publicação para arquivos com links cruzados:
-
Abra a guia Predefinições de saída do mapa DITA que deseja publicar.
-
Selecione a predefinição de saída AEM Sites.
Você pode exibir as guias Geral, Conteúdo, Lista de tópicos e Referências entre mapas. A guia Referências de mapa cruzado será exibida se você usar a versão do Experience Manager Guides (UUID).
Você não poderá exibir a vinculação entre mapas nos seguintes casos:
- Para as predefinições criadas antes da versão 4.6. A guia Referências cruzadas está desativada e uma dica de ferramenta, Consulte Painel de mapa é exibida.
- Para predefinições criadas no painel de mapa. Consulte A dica de ferramenta do painel de mapa é exibida.
- Para predefinições OOTB, consulte Dica de ferramenta do painel de Mapa.
- Para predefinições globais, crie uma cópia local dessa predefinição global para definir referências de mapa cruzado.
Se quiser usar predefinições do AEM Sites no Editor da Web, crie uma nova predefinição ou duplique a existente.
-
Abra a guia Referências entre mapas.
Você verá uma lista de tópicos e suas referências. Você pode especificar o contexto de publicação para uma lista de referências a tópicos disponíveis em outros mapas DITA com
scope=”peer”.Para usar o painel de referência entre mapas do Editor da Web,
<xrefs>deve ter IDs exclusivas. IDs exclusivas para<xrefs>serão geradas automaticamente ao editar/salvar o conteúdo mais antigo se a ID não estiver lá.note note NOTE A guia Referências de mapa cruzado mostra tópicos que estão vinculados usando somente o scope=”peer”. Para links comscope=”local”, não é necessário especificar o contexto de publicação.Todos os tópicos vinculados têm sua predefinição de saída e mapa mais recentes selecionados por padrão. O contexto de publicação para todos os tópicos vinculados está definido como
<Most recently generated>mapear por padrão.
-
Se quiser usar a saída publicada mais recentemente de cada arquivo dependente no mapa, selecione Usar contexto de publicação gerado mais recentemente para todos os tópicos dependentes.
Você deve publicar o mapa selecionado como o mapa principal antes de publicar o mapa contendo tópicos vinculados. Se o mapa com tópicos vinculados não for publicado, os links serão exibidos como texto normal em vez de hiperlinks na saída do AEM Sites.
Você deve selecionar o mesmo tipo de predefinição do AEM Sites para o tópico vinculado. Por exemplo, se a predefinição atual do AEM Sites usar o mapeamento de componente herdado, selecione uma predefinição AEM Sites semelhante do tópico vinculado. -
Na lista suspensa Mapa pai, selecione o arquivo de mapa com cuja saída você deseja vincular a saída do mapa atual.
Selecionar um arquivo de mapa mostra a UUID do mapa na coluna UUID do mapa principal. As Predefinições de saída associadas ao mapa escolhido são listadas na lista Predefinição do Mapa pai. Por exemplo, o Tópico 1 no Mapa A contém uma referência ao Tópico 2. O tópico 2 pode estar presente em mapas únicos ou múltiplos. Você pode selecionar o mapa principal e uma predefinição específica ou a saída publicada mais recentemente para cada link. -
Se o mesmo tópico for referido mais de uma vez em um arquivo, será possível adicionar um contexto de publicação diferente para cada instância. Isso proporciona maior flexibilidade e controle sobre o conteúdo. Por exemplo, o Tópico 3 está presente no Mapa B e no Mapa C. O Tópico 1 contém duas referências ao Tópico 3. Você pode escolher o Mapa B como o mapa principal do primeiro link e o Mapa C como principal do segundo link.
-
Na lista suspensa Predefinição do mapa principal, selecione a predefinição de saída com a qual deseja vincular a saída do mapa atual.
note note NOTE As diferentes predefinições de AEM Sites do mapa atual são exibidas na lista suspensa. Se você não selecionar uma predefinição, um ícone de aviso será exibido e a geração de saída falhará. 1. Selecione o mapa necessário e sua predefinição de saída para todos os tópicos de origem e selecione **Gerar**.
Tópico pai: Entendendo as predefinições de saída