Site AEM id205BE3008SW

As seguintes opções estão disponíveis para a saída do site AEM:

É possível criar a predefinição do site AEM de duas maneiras:

No Editor da Web: no painel Repositório, abra o arquivo de mapa DITA no Modo de Exibição de Mapa e, na guia Saída, selecione o ícone + para criar uma predefinição de saída e selecione Site AEM no menu suspenso de tipo na caixa de diálogo Adicionar predefinição. No editor da Web, as configurações foram organizadas em guias Gerais e Avançadas:

Geral

A guia Geral contém as seguintes configurações:

Avançado

A guia Advanced contém as seguintes configurações:

Para obter detalhes, consulte Configuração do site AEM.

No painel de mapa

Para abrir predefinições de saída para o Site AEM, clique em um arquivo de mapa DITA na interface do usuário do Assets, clique em Predefinições de Saída e, em seguida, clique na opção de saída do Site AEM.No painel de mapa, clique em Editar na parte superior para atualizar as várias configurações e, em seguida, clique em Salvar.

Configuração do site AEM id_aem_site_config

As seguintes opções estão disponíveis para a saída do site AEM:

Opções do site do AEM

Descrição

Tipo de saída

O tipo de saída que você deseja gerar. Para gerar uma saída responsiva do site AEM, escolha a opção AEM Site.

Nome de configuração

Dê um nome descritivo para as configurações do site de AEM que você está criando. Por exemplo, você pode especificar saída de clientes internos ou saída de usuários finais.

Nome do site

Um nome de site em que a saída é armazenada no repositório AEM.

Um nó no repositório AEM é criado com o nome especificado aqui. Se você não especificar o Nome do site, o nó do site será criado com o nome do arquivo de mapa DITA.

O Nome do Site especificado aqui também é usado como o título na guia do navegador.

Você também pode usar variáveis ao definir o Nome do Site. Para obter mais detalhes sobre o uso de variáveis, consulte Usar variáveis para definir as opções Caminho de Destino, Nome do Site ou Nome do Arquivo.

Design

Selecione o modelo de design que deseja usar para gerar a saída.

Para obter detalhes sobre como usar modelos de design personalizados para gerar saída, contate o administrador de publicação.

Caminho de destino

O caminho no repositório AEM onde a saída é armazenada. Ao gerar a saída final, o Nome do site e o Caminho de destino são combinados. Por exemplo, se você especificar o Nome do Site como user-guide e o Caminho de Destino como /content/output/aem-guides, a saída final será gerada no nó /content/output/aem-guides/user-guide.

Você também pode usar variáveis ao definir o Caminho de Destino. Para obter mais detalhes sobre o uso de variáveis, consulte Usar variáveis para definir as opções Caminho de Destino, Nome do Site ou Nome do Arquivo.

Aplicar condições usando

Selecione uma das seguintes opções:

Nenhuma Aplicada: selecione esta opção se não quiser aplicar nenhuma condição na saída publicada.
Arquivo 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 ver 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, consulte Usar predefinições de condição.

Páginas de saída existentes

Selecione a opção Substituir conteúdo para substituir o conteúdo nas páginas existentes. Essa opção substitui somente o conteúdo presente nos nós de conteúdo e cabeçalho da página. Essa opção permite a publicação combinada de conteúdo. Selecionar essa opção fornece uma opção para selecionar a exclusão de páginas órfãs da saída publicada. Esta também é a opção padrão para criar a saída do site AEM.

Selecione a opção Excluir e Criar para forçar a exclusão de páginas existentes durante a publicação. Essa opção exclui o nó da página, juntamente com seu conteúdo e todas as páginas secundárias sob ele. Use essa opção se tiver alterado o modelo de design da predefinição de saída ou se desejar que qualquer página extra já presente no destino seja removida.

Excluir páginas de sites órfãos

Selecionar Substituir Conteúdo na configuração Páginas de Saída Existentes apresenta essa opção. Se você selecionar essa opção, todas as páginas órfãs serão excluídas do site do AEM publicado. Para que esse recurso seja executado com sucesso, você deve publicar o mapa DITA inteiro e não usar a publicação incremental.

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, então todo o conteúdo relacionado a b.dita é removido da saída do site AEM e apenas a.dita e c.dita são publicados.

Este recurso não remove nenhum mapa filho publicado. Por exemplo, se o mapa principal contiver um mapa secundário e você remover todo o mapa secundário, o conteúdo do mapa secundário não será excluído da saída publicada. No entanto, se você remover qualquer tópico de um mapa secundário e republicar, o conteúdo do tópico removido será excluído da saída do site.

Além disso, se houver algum conteúdo referenciado e esse conteúdo for removido antes da republicação, os dados do conteúdo referenciado não serão removidos.

Observação: informações sobre páginas órfãs 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, consulte Exibir e verificar o arquivo de log.

Baixar arquivos temporários

Selecione essa opção para baixar os arquivos temporários gerados pelo DITA-OT. O local onde o DITA-OT armazena arquivos temporários pode ser encontrado no log de geração de saída. Se ocorrerem erros durante a geração de saída pelo DITA-OT, selecione essa opção para manter os arquivos temporários. Você pode usar esses arquivos para solucionar erros de geração de saída.

Depois de gerar a saída, selecione o ícone Baixar arquivos temporários para baixar a pasta ZIP que contém os arquivos temporários.

Observação: se você selecionar algumas propriedades de arquivo e depois baixar os arquivos temporários, também obterá o arquivo metadata.xml na pasta ZIP.

Gerar PDF separado para cada tópico

Se selecionada, um PDF também será criado para cada tópico no mapa DITA. Ao escolher essa opção, uma nova opção Dividir caminho de PDF é exibida.

No campo Dividir Caminho do PDF, especifique o caminho para armazenar os PDF gerados para cada tópico.

Observação: o AEM Guides usa o plug-in DITA-OT chamado pdfx para gerar o PDF para cada tópico. Esse plug-in é fornecido com o pacote DITA-OT pronto para uso. Você pode personalizar esse plug-in para gerar PDF de acordo com seus requisitos. Se você usar um plug-in DITA-OT personalizado, certifique-se de integrar o plug-in pdfx para ter o recurso de geração de PDF no nível do tópico.

Executar Fluxo de Trabalho de Geração do Post

Ao escolher essa opção, uma nova lista suspensa Post Generation Workflow é exibida contendo todos os workflows configurados no AEM. Você deve selecionar um workflow que deseja executar após a conclusão do workflow de geração de saída.

Usar Linha de Base

Se tiver criado uma Linha de Base para o mapa DITA selecionado, selecione essa opção para especificar a versão que deseja publicar.

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.

Consulte Trabalhar com Linha de Base para obter mais detalhes.

Propriedades do arquivo

Selecione as propriedades que deseja processar como metadados. Essas propriedades são definidas na página Propriedades do mapa DITA ou do arquivo de mapa. As propriedades selecionadas na lista suspensa aparecem no campo Propriedades do arquivo. Selecione o ícone cruzado ao lado da propriedade para removê-la.

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 Se Estiver Ausente No Tópico

Se essa opção for selecionada, as propriedades definidas para o arquivo de mapa também serão copiadas para os tópicos em que essas propriedades não estão definidas. Considere os seguintes pontos ao usar esta opção:

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.

Observação adicional no site AEM

Gerar saída baseada em artigo no Editor da Web

Você pode gerar a saída do site AEM para um ou mais tópicos ou para o mapa DITA inteiro do Editor da Web. É necessário criar predefinições de saída para o mapa DITA e, em seguida, gerar facilmente a saída do site AEM para o mapa. Se você atualizou alguns tópicos no mapa, também é possível gerar a saída do site AEM somente para esses tópicos do Editor da Web. Para obter mais detalhes, consulte Publicação baseada em artigo do Editor da Web.

Gerar tópicos de vinculação de saída de outros mapas

É um cenário muito comum ter um grande conjunto de documentações espalhadas em várias pastas e mapas DITA. A publicação de conteúdo vinculado de vários lugares torna-se extremamente complexo. Por padrão, todos os links <xref> são criados com o local @scope. A publicação desses tópicos não envolve nenhum desafio, pois usa um link direto para o tópico. Caso o tópico esteja fora do mapa DITA atual, o link não mostra o conteúdo vinculado.

Outra maneira de vincular conteúdo é criar um link usando o peer @scope. Para esse conteúdo, o link é resolvido no tempo de execução ao escolher o título do arquivo e o contexto configurado para o tópico vinculado no contexto de publicação do mapa DITA. A captura de tela a seguir mostra o painel Propriedades para um link que tem o peer @scope:

Para simplificar a publicação de mapas complexos e tópicos vinculados a outros tópicos em outros mapas, o AEM Guides permite definir o contexto de publicação de cada predefinição de saída.

O contexto de publicação permite especificar qual tópico deve ser usado, de qual mapa para publicar uma saída específica. Vamos entender isso com a ajuda de um exemplo — digamos que você tenha quatro pastas: amostra a, amostra b, amostra c e amostra d. Cada pasta contém um mapa DITA — mapa DITA A, mapa DITA B, mapa DITA C e mapa DITA D. A vinculação entre mapas ocorrerá quando um tópico no mapa DITA A for vinculado a um tópico no mapa DITA B, C ou D. Na captura de tela a seguir, um tópico de conceito de amostra contém links (ou referências) para arquivos que fazem parte de outros mapas DITA.

Agora, ao definir as configurações de publicação do site AEM para o arquivo de mapa que contém esse tópico, é possível selecionar qual contexto de publicação do conteúdo vinculado será usado durante a publicação. Um contexto de publicação é uma combinação do mapa DITA e sua predefinição de saída. A predefinição de saída, por sua vez, contém uma versão específica do conteúdo e predefinições condicionais. Essa combinação completa do mapa DITA, da predefinição de saída, da versão (files) e das condições define o contexto de publicação de um mapa vinculado.

Execute as seguintes etapas para especificar o contexto de publicação para arquivos com links cruzados:

Publicação combinada

O AEM Guides oferece suporte à publicação de conteúdo DITA no site AEM existente. Por exemplo, se você tiver um site existente, poderá usar a saída do Site AEM para publicar somente o conteúdo DITA nesse site. Nesse processo, o conteúdo não DITA existente não é modificado pelo processo de publicação. Para obter mais informações sobre como configurar seu site para publicar somente conteúdo DITA, entre em contato com o administrador de publicação.

Publicação conref

Se você estiver usando conref no seu conteúdo, ele será publicado como conteúdo normal ou inserido junto com o conteúdo no tópico de origem (ou de referência). O conteúdo conref é renderizado junto com o conteúdo principal e nenhuma página de site separada é criada para o mesmo. Quando você pesquisa o conteúdo referenciado no conref, somente o tópico principal ou a página que contém o conteúdo do conref é exibido nos resultados da pesquisa.

Pesquisar uma cadeia de caracteres no conteúdo

Você pode procurar por uma string na saída do site AEM. Por padrão, é possível pesquisar a cadeia de caracteres somente nos títulos. Para pesquisar a string no conteúdo ou no corpo da saída do site AEM, entre em contato com o administrador do sistema para ativar a propriedade flattening.enabled.

Para obter mais detalhes, consulte a seção Configurar nivelamento da estrutura do nó do site AEM no guia Instalar e configurar o Adobe Experience Manager Guides.

Tópico pai: ​ Noções básicas sobre as predefinições de saída