DocumentaçãoAEM GuidesDocumentação do AEM Guides

Usar a especialização personalizada do DITA-OT e do DITA id181GAJ0005Z

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

Criado para:

  • undefined
  • undefined

O DITA Open Toolkit (DITA-OT) é um conjunto de ferramentas de código aberto baseadas em Java que fornecem processamento para mapas DITA e conteúdo de tópico. O AEM Guides permite importar e usar facilmente plug-ins DITA-OT personalizados. Depois de importado, o AEM Guides pode ser configurado para usar o plug-in DITA-OT personalizado para gerar saída em qualquer formato. No momento de gerar a saída, basta selecionar a opção DITA-OT e o AEM Guides usa o plug-in DITA-OT personalizado para gerar a saída necessária.

Se você quiser processar parâmetros Ant ao publicar qualquer saída, o AEM Guides oferece uma maneira fácil de fazer isso. Você pode especificar quais parâmetros Ant você deseja usar e os mesmos serão processados pelo processo de publicação.

NOTE
O AEM Guides é fornecido com o DITA-OT versão 3.3.2. No entanto, o AEM Guides é compatível com o DITA-OT versão 1.7 e superior. Para obter a lista completa de versões DITA-OT, consulte versões DITA-OT.
TIP
Consulte as seções Configuração de perfis DITA-OT e Uso de DITA-OT personalizado no guia de práticas recomendadas para obter as práticas recomendadas sobre o uso de plug-ins DITA-OT personalizados.

Usar plug-ins personalizados do DITA-OT id181NH1020L7

Você pode usar o plug-in DITA-OT personalizado para publicação fazendo upload do plug-in DITA-OT personalizado no repositório AEM. Por padrão, o AEM Guides vem com um Perfil pré-configurado que contém as configurações dos modelos padrão a serem usados para editar e publicar conteúdo. Você pode criar perfis personalizados com modelos personalizados que serão usados ao editar documentos e plug-ins DITA-OT personalizados para publicar conteúdo.

O pacote DITA-OT padrão disponível com o AEM Guides vem com o processador Apache FOP XSL-FO, que não oferece suporte à renderização de equações MathML. Se estiver usando equações MathML em seu conteúdo, verifique se você integrou um plug-in de mecanismo de renderização MathML para Apache FOP ou usou um processador XSL-FO diferente.

Execute as seguintes etapas para fazer upload do plug-in DITA-OT personalizado no repositório AEM:

  1. Baixe o arquivo DITA-OT.zip no link compartilhado no email de boas-vindas.

  2. Extraia o conteúdo do arquivo zip em seu sistema.

  3. Use um mecanismo integrador de plug-ins DITA-OT para integrar a nova versão do DITA-OT ao plug-in DITA-OT personalizado.

  4. Crie o arquivo ZIP novamente mantendo o mesmo nome (DITA-OT.ZIP) e a estrutura de pastas.

  5. Carregue o arquivo ZIP atualizado de volta no repositório AEM.

    Verifique as seguintes verificações antes de fazer upload do arquivo ZIP:

    • Execute o integrador (para instalar o plug-in personalizado) em um sistema operacional Mac/Linux para evitar problemas com separadores de arquivos - como os sistemas operacionais Windows e Linux têm separadores de arquivos diferentes, o plug-in integrado no sistema operacional Mac/Linux é compatível com a configuração do Windows e do Linux.
    • Verifique se o arquivo DITA-OT.ZIP contém uma pasta chamada "DITA-OT" que tem todos os plug-ins e arquivos relevantes.
    • Verifique se o arquivo DITA-OT.ZIP criado é mimeType: "nt:file" (corresponde ao tipo primário de arquivo ZIP quando carregado para AEM). Use uma ferramenta WebDAV ou implantação de código para fazer upload desse arquivo ZIP para o caminho desejado no AEM. (Não use o gerenciador de pacotes AEM para implantar este arquivo ZIP, pois este ZIP não é um pacote de conteúdo AEM, mas apenas um arquivo morto.)
    note note
    NOTE
    É recomendável não substituir o pacote DITA-OT padrão. Você deve fazer upload do pacote DITA-OT personalizado que contém o plug-in /var/dxml/dita_resources/dita-ot. Também é possível fazer isso usando o pipeline do Cloud Manager. Consulte Implantação no AEM as a Cloud Service na documentação do AEM para obter mais detalhes.

  6. Você pode optar por editar o Perfil padrão, criar um novo perfil ou duplicar configurações do Perfil padrão para criar um novo perfil.

    note note
    NOTE
    Você pode atualizar o perfil Padrão, mas não pode excluí-lo. No entanto, todos os novos perfis que você criar poderão ser editados e excluídos.

  7. Configure as seguintes propriedades para usar o plug-in DITA-OT personalizado:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2
    Nome da propriedade Descrição
    Propriedades de perfil
    Nome do perfil Forneça um nome exclusivo para este perfil.
    Reutilizar saída (Opcional) Se o seu perfil for baseado em um perfil existente, selecione esta opção. Selecionar essa opção garante que o AEM Guides não extraia novamente o conteúdo do pacote DITA-OT e reutilize o pacote DITA-OT existente.
    Caminho de extração de perfil (Opcional) Especifique o caminho onde o DITA-OT é mantido no disco. Por padrão, o AEM Guides agrupa um pacote DITA-OT em seu repositório e ele é extraído no disco nesse caminho.
    OBSERVAÇÃO Você pode definir este caminho usando qualquer variável ou propriedade do sistema existente. Consulte a descrição da propriedade Variáveis de ambiente DITA-OT para obter mais informações.
    Caminho atribuído (Opcional) Especifique o caminho no repositório de conteúdo ao qual esse perfil se aplica. Você pode especificar vários locais.
    Propriedades DITA-OT
    Tempo limite do DITA-OT (Opcional) Especifique o tempo (em segundos) durante o qual o AEM Guides aguarda uma resposta do plug-in DITA-OT. Se nenhuma resposta for recebida no tempo especificado, o AEM Guides encerra a tarefa de publicação e a tarefa é sinalizada como com falha. Além disso, os logs de falha são disponibilizados no arquivo de log de geração de saída.
    Valor padrão: 300 segundos (5 minutos)
    Argumentos de PDF DITA-OT Especifique os argumentos de linha de comando que são processados pelo plug-in DITA-OT personalizado para gerar a saída de PDF. Para todos os perfis DITA-OT personalizados, especifique o seguinte argumento de linha de comando:-lib plugins/org.dita.pdf2.fop/lib/
    Argumentos AEM do DITA-OT (Opcional) Especifique os argumentos de linha de comando personalizados que são processados pelo plug-in DITA-OT personalizado para gerar a saída do site AEM.
    Caminhos da biblioteca DITA-OT (Opcional) Especifique os caminhos de biblioteca adicionais do plug-in DITA-OT.
    DITA-OT Build XML (Opcional) Especifique o caminho do script de compilação personalizado Ant fornecido com o plug-in DITA-OT personalizado. Esse caminho é relativo ao diretório DITA-OT no sistema de arquivos.
    Pasta de script DITA-OT Ant (Opcional) Especifique o caminho da pasta de script DITA-OT Ant. Esse caminho é relativo ao diretório DITA-OT no sistema de arquivos.
    Variáveis de ambiente DITA-OT (Opcional) Especifique as variáveis de ambiente a serem transmitidas para o processo DITA-OT. Por padrão, o AEM Guides adiciona quatro variáveis - ANT_OPTS, ANT_HOME, PATH e CLASSPATH.
    Você pode reutilizar qualquer uma das variáveis de ambiente do sistema existentes ou propriedades para criar novas variáveis de ambiente. Por exemplo, se você tem a variável de sistema JAVA_HOME definida no sistema e deseja definir uma nova variável de ambiente chamada JAVA_BIN que é compilada usando JAVA_HOME. Em seguida, você pode adicionar a definição de JAVA_BIN como:JAVA_BIN= ${JAVA_HOME}/bin
    Observação: também é possível usar as propriedades do sistema Java para criar variáveis de ambiente. Por exemplo, se o script de inicialização AEM definir uma propriedade do sistema Java java.io.tmpdir para um diretório temporário, você poderá usar essa propriedade para definir uma nova variável como: ${java.io.tmpdir}/fmdita/dita_ot.
    Importante: para reutilizar qualquer variável ou propriedade do sistema existente, ela deve estar entre ${}.
    Substituir saída DITA-OT Escolha se a saída DITA-OT deve ser substituída. Mantenha essa opção selecionada.
    Caminho do CEP DITA-OT do AEM Especifique o caminho completo onde o arquivo DITA-OT.zip personalizado é armazenado no repositório AEM.
    Caminho do plug-in DITA-OT Caminho do plugin personalizado. Esse plug-in é integrado automaticamente ao pacote DITA-OT principal.
    Catálogos integrados (Opcional) Caminho dos arquivos DTD e XSD catalog.xml personalizados no repositório AEM. Isso deve ser fornecido somente quando os catálogos estiverem ausentes no pacote DITA-OT. Esses catálogos são integrados automaticamente ao DITA-OT principal como um plug-in.
    Adicionar catálogo de ID do sistema (Opcional) Selecione essa opção somente se houver entradas de ID pública ausentes no catálogo ou se os arquivos DITA usarem apenas as IDs do sistema relativas ao caminho do servidor de onde são carregados.
    Caminho temporário DITA-OT Um local temporário onde os arquivos DITA são copiados para processamento. Antes de o DITA-OT processar os arquivos, eles são copiados neste local temporário. Por padrão, o local de armazenamento temporário é:
    <*AEM-Install*>/crx-quickstart/profiles/ditamaps
    Importante: não é necessário alterar o caminho padrão.
    note note
    NOTE
    O instalador do AEM Guides cria duas variáveis de ambiente que podem ser usadas para especificar o caminho dos arquivos de plug-in DITA-OT personalizados. Essas variáveis de ambiente são: DITAOT\_DIR, que contém o caminho do diretório DITA-OT no sistema de arquivos; e DITAMAP\_DIR, que contém o caminho onde o conteúdo do mapa DITA é extraído no sistema de arquivos.

  8. Clique em Concluído para salvar o perfil.

Integrar especialização de DITA id211MB0E00XA

A especialização DITA é o processo de criar novas estruturas DITA adicionando novos elementos ou removendo elementos existentes. Para criar um novo elemento DITA, você pode pegar um elemento DITA existente como base e modificá-lo de acordo com seus requisitos de criação. Basicamente, a especialização DITA permite criar modelos de informações personalizados que atendam aos requisitos de negócios, além de manter os benefícios da arquitetura DITA existente.

Você pode usar o recurso de Perfil para armazenar configurações de especialização DITA personalizadas. Essas configurações podem ser usadas no momento da criação e publicação de conteúdo DITA personalizado. O AEM Guides permite usar a ID pública e a ID do sistema em DTDs/XSDs personalizados.

NOTE
O Editor da Web do AEM Guides não é compatível com XSDs.

Execute as seguintes etapas para criar um novo perfil e configurá-lo para usar DTDs e XSDs especializados em sua AEM Guides:

  1. Crie uma pasta de especialização no computador local que contenha DTDs e XSDs especializados.

  2. Especifique os detalhes de DTD no arquivo catalog.xml que também devem ser incluídos na pasta de especialização.

    note note
    NOTE
    No caso de DITA 1.3, o local padrão para o arquivo DTD catalog.xml no repositório AEM é: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. Especifique os detalhes de XSD no arquivo catalog.xml que também devem ser incluídos na pasta de especialização.

    note note
    NOTE
    No caso de DITA 1.3, o local padrão do arquivo catalog.xml XSD no repositório AEM é: /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. Faça upload da pasta para o seguinte local:

    /var/dxml/dita_resources

  5. Clique no link do Adobe Experience Manager na parte superior e escolha Ferramentas.

  6. Selecione Guias na lista de ferramentas.

  7. Clique no bloco Perfis DITA.

  8. Você pode optar por editar o Perfil padrão, criar um novo perfil ou duplicar configurações do Perfil padrão para criar um novo perfil.

    note note
    NOTE
    Não é possível excluir o Perfil padrão. No entanto, todos os novos perfis que você criar poderão ser editados e excluídos.

  9. Nas configurações de Esquema > Catálogo, especifique o caminho dos arquivos DTD e XSD catalog.xml personalizados no repositório AEM.

  10. Selecione a opção Adicionar Catálogo de ID do Sistema.

    note note
    NOTE
    Selecione essa opção somente se houver entradas de ID pública ausentes no catálogo ou se os arquivos DITA usarem somente as IDs do sistema relativas ao caminho do arquivo local de onde são carregados.

    Para obter mais informações sobre outras propriedades na página Perfis, consulte a tabela de propriedades na Etapa 6 da seção Usar plug-ins DITA-OT personalizados.

  11. Clique em Concluído para salvar o perfil.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178