Predefinição de saída nativa do PDF

Ao criar conteúdo, é essencial garantir que o conteúdo seja otimizado para visualização, edição e impressão. Usando padrões como o W3C CSS3 para estilos de conteúdo e padrões de mídia paginada CSS para propriedades de definição de página, como tamanho, margens, orientação, quebras de página, cabeçalhos, rodapés e numeração de página, você pode definir a exibição e o layout do documento do PDF, garantindo consistência e usabilidade. O recurso de publicação do PDF nativo usa esses padrões para gerar uma PDF.

Com a publicação nativa do PDF, você pode usar modelos predefinidos para garantir consistência no layout e na estrutura do conteúdo, aplicar folhas de estilos para alterar a aparência da saída, otimizar o PDF, definir marcas de impressora, permitir suporte a leitores de tela, definir a conformidade do PDF, incorporar fontes e muito mais.

A geração de uma PDF usando a publicação nativa do PDF tem dois aspectos:

  • Uso de modelos para aplicar o estilo ao conteúdo, definir layouts de página e várias configurações para ajustar o PDF. Os autores podem optar por usar/modificar os modelos de amostra fornecidos ou criar modelos personalizados e definir opções de configuração avançadas usadas por editores e desenvolvedores.

  • Crie ou configure uma predefinição de saída do PDF para controlar as configurações do PDF. Depois de criar uma predefinição de saída do PDF, você pode gerar a PDF.

Criar uma predefinição de saída

Execute as seguintes etapas para criar a predefinição do PDF a partir do console Mapa:

  1. Abra um arquivo de mapa DITA no Console de mapa.

    Você também pode acessar o arquivo de mapa no widget Arquivos recentes na seção Visão geral. O arquivo de mapa selecionado seria aberto no console Mapa.

  2. Na guia Predefinições de saída, selecione o ícone + para criar uma predefinição de saída.

  3. Selecione PDF na lista suspensa Tipo na caixa de diálogo Nova predefinição de saída.

  4. No campo Nome, forneça um nome para esta predefinição.

  5. No campo Gerar PDF Usando, selecione Native-PDF.

  6. Selecione a opção Adicionar ao perfil de pasta atual para criar uma predefinição de saída no perfil de pasta atual. O ícone de perfil de pasta indica uma predefinição de nível de perfil de pasta.

    Saiba mais sobre Gerenciar predefinições de saída de perfil Global e de Pasta.

  7. Selecione Adicionar.

    A predefinição do PDF é criada.

Configuração de predefinição nativa do PDF

Depois que a predefinição é criada, defina as configurações de predefinição do PDF nativo. As opções de configuração predefinidas para DITA-OT estão organizadas nas guias Geral, Metadados, Layout, Segurança, Imprimir e Avançado.

painel predefinido {width="800"}

Geral

Use para especificar configurações básicas de saída, como especificar o caminho de saída, o nome do arquivo do PDF e muito mais.

Configuração
Descrição
Caminho de saída
O caminho no repositório do AEM onde a saída do PDF está armazenada. Verifique se o caminho de saída não está localizado na pasta do projeto. O caminho de saída é definido por meio da variável ${base_output_path}, que é configurada pelo Administrador. Para configurar o Caminho de saída, exiba Configurar localização de saída básica para serviços em nuvem ou Configurar localização de saída básica para serviços no local com base no serviço que você está usando.
Você também pode usar as variáveis prontas para uso a seguir para definir o Caminho de Saída. Você pode usar uma única variável ou uma combinação de variáveis para definir essa opção.
${map_filename}: usa o nome dos arquivos de mapa DITA para criar o caminho de destino.
${map_title}: usa o título do mapa DITA para criar o caminho de destino.
${preset_name}: usa o nome da predefinição de saída para criar o caminho de destino.
${language_code}: Usa o código de idioma em que o arquivo de mapa está localizado para criar o caminho de destino.
${map_parentpath}: Usa o caminho completo do arquivo de mapa para criar o caminho de destino.
${path_after_langfolder}: Usa o caminho do arquivo de mapa após a pasta de idioma para criar o caminho de destino.
Arquivo PDF
Especifique um nome de arquivo para salvar a PDF. Por padrão, o nome de arquivo do PDF adiciona o nome do mapa DITA ao nome predefinido. Por exemplo, ditamap é 'TestMap' e o nome da predefinição é 'preset1', então o nome padrão do pdf será 'TestMap_preset1.pdf'.
Você também pode usar as variáveis prontas para uso a seguir para definir o Arquivo do PDF. Você pode usar uma única variável ou uma combinação de variáveis para definir essa opção.
${map_filename}
${map_title}
${preset_name}
${language_code}.
Aplicar Condições Usando

Para conteúdo condicional, escolha entre as opções abaixo para gerar uma saída do PDF com base nessas condições:

  • Nenhum Aplicado Selecione esta opção se não quiser aplicar nenhuma condição no mapa e no conteúdo de origem.
  • Arquivo DITAVAL Selecione um arquivo DITAVAL para gerar conteúdo condicional. Você pode selecionar vários arquivos DITAVAL usando a caixa de diálogo Procurar ou inserindo o caminho do arquivo manualmente. Para remover um arquivo selecionado, clique no ícone cruzado ao lado de seu nome. Se um arquivo inválido for selecionado, uma mensagem de erro será exibida informando Invalid DITAVAL file is seleted.

    Cada arquivo DITAVAL pode conter várias propriedades, como condições de filtragem e estilos de sinalização. A sinalização permite marcar visualmente o conteúdo usando sinalizadores de início e fim, que podem incluir imagens ou formatação de texto, como negrito ou itálico. Em caso de sobreposição de condições ou conflitos de estilo, é possível definir uma cor de plano de fundo usando as configurações de conflito de estilo. Para obter mais detalhes, consulte Usar o editor DITAVAL.
  • 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.
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. Exiba Trabalhar com Linha de Base para obter mais detalhes.
Criar PDF com Barra de Alterações entre Versões Publicadas

Use as seguintes opções para criar uma PDF mostrando as diferenças no conteúdo entre duas versões usando barras de alteração:

  • Linha de Base da Versão Anterior Escolha a versão de linha de base que você deseja comparar com a versão atual ou outra linha de base. Uma barra de alteração é exibida na PDF para indicar o conteúdo modificado. Uma barra de alteração é uma linha vertical que identifica visualmente o conteúdo novo ou revisado. A barra de alterações aparece à esquerda do conteúdo que foi inserido, alterado ou excluído.
    Observação: se você selecionar Usar Linha de Base e escolher uma linha de base para publicar, a comparação será feita entre as duas versões de linha de base selecionadas. Por exemplo, se você escolher Versão 1.3 da linha de base em Usar linha de base e Versão 1.1 em Linha de base da Versão Anterior, a comparação será feita entre a Versão 1.1 da linha de base e a Versão 1.3 da linha de base.
  • Mostrar Texto Adicionado Selecione para mostrar o texto inserido na cor verde e sublinhado. Essa opção é selecionada por padrão.
  • Mostrar texto excluído Selecione para mostrar o texto excluído em vermelho e marcado com um tachado. Essa opção é selecionada por padrão.
    Observação Você também pode personalizar o estilo da barra de alterações, o conteúdo inserido ou o conteúdo excluído usando a folha de estilos.
Fluxo de Trabalho de Pós-Geração
Selecione para mostrar uma lista suspensa que contém todos os workflows configurados no AEM. Você pode selecionar o workflow que deseja executar após a conclusão do workflow de geração do PDF.

Metadados

Os metadados são a descrição ou definição do seu conteúdo. Os metadados ajudam na gestão de conteúdo e na pesquisa de arquivos na Internet.

Use a guia Metadados para definir os campos de metadados, como nome do autor, título do documento, palavras-chave, informações de copyright e outros campos de dados para a saída do PDF. Você também pode adicionar metadados personalizados para a saída do PDF.

Estes metadados estão mapeados para os metadados na guia Descrição nas Propriedades do Documento do PDF de saída.

guia metadados {width="600"}

Nas predefinições de Saída, selecione PDF > Native-PDF > Metadata para adicionar e personalizar opções de metadados.

  • Usar metadados adicionados ao topicmeta

    Essa opção é selecionada por padrão. Você pode usar os metadados adicionados no elemento topicmeta do mapa DITA para preencher os campos de metadados da saída do PDF.

  • Fornecer arquivo XMP

    Você também pode preencher diretamente os campos de metadados importando o arquivo XMP (Plataforma de Metadados Extensível). Você pode baixar um arquivo de amostra do XMP aqui.

Download

Como alternativa, você pode gerar um arquivo XMP usando o Adobe Acrobat.

  1. Selecione Arquivo > Propriedades no Acrobat.
  2. Em Descrição, selecione Metadados Adicionais.
  3. No painel esquerdo, selecione Avançado.
  4. Selecione Salvar.

O arquivo XMP é salvo no dispositivo.

  • Forneça nomes e valores de metadados

    1. Adicione um nome selecionando no menu suspenso ou adicione um metadado personalizado digitando diretamente no campo de nome.
    2. Insira o valor dos metadados e selecione o ícone "+".
      Os metadados são adicionados à lista para o PDF.

Também é possível usar variáveis para definir os valores de metadados. Você pode usar os metadados definidos para o mapa DITA ou arquivo de mapa como variáveis. Os metadados podem ser encontrados no nó /jcr:content/metadata do mapa DITA ou do arquivo de mapa.
Quando você usa uma variável, seu valor é escolhido das propriedades dos metadados.

Para usar uma variável, você precisa defini-la no formato ${<variable>}.

Por exemplo, uma das propriedades de metadados definidas no nó /jcr:content/metadata é
dc:title. Você pode especificar ${dc:title}, e o valor do título é usado na saída final.

Você pode usar uma única variável ou uma combinação de variáveis para definir os metadados. Por exemplo, ${dc:title} ${dc:docstate}. Também é possível usar a combinação de uma variável e uma string. Por exemplo, View ${dc:title} in ${dc:language}.

Use variáveis de idioma para definir o valor localizado das propriedades de metadados. Dependendo do idioma escolhido, o valor localizado é escolhido automaticamente na saída do PDF. Por exemplo, você pode imprimir "Author" como o valor dos metadados em inglês e "Autorin" em alemão.

Formato: ${lng:<variable name>}. Por exemplo, ${lng:author-label} onde author-label é uma variável de idioma.

Focalizar ícone de informações {width="25"} próximo à opção para ver mais detalhes sobre ele.

Layout

Use para definir layouts de página e especificar opções de exibição de página para saída do PDF, como Exibição de página e definir níveis de Zoom.

Configuração
Descrição
Modelo do PDF
Os modelos do PDF fornecem uma estrutura clara para definir layouts de página, estilo do conteúdo e aplicar várias configurações à saída do PDF. Selecione nas opções suspensas do modelo PDF para escolher o modelo preferido.
Você também pode selecionar Procurar Modelo ícone procurar modelos {width="25"} para escolher um modelo. Na caixa de diálogo Selecionar modelo de PDF, você também pode visualizar a miniatura e exibir o título e a descrição do modelo selecionado.
Exibição de página

Use a Exibição de página para a exibição de página que mostra como a PDF é exibida quando aberta. Selecione nas opções suspensas Exibição da página para escolher uma exibição preferencial.

  • Padrão É exibido de acordo com a configuração padrão do visualizador do PDF no computador de um usuário.
  • Exibição de página única Exibe uma página de cada vez.
  • Rolagem de Página Única Exibe uma única página em uma coluna vertical contínua.
  • Exibição de duas páginas Exibe duas páginas espelhadas lado a lado de cada vez. .
  • Rolagem de Duas Páginas Exibe duas páginas espelhadas lado a lado com rolagem contínua.
Zoom

Selecione para redimensionar a exibição de página que mostra como o PDF é exibido quando é aberto.

  • Padrão É exibido de acordo com a configuração padrão do visualizador do PDF no computador de um usuário
  • 100% Faz com que a página apareça em seu tamanho real.
  • Ajustar página Faz com que a largura e a altura da página caibam no painel de documentos. .
  • Ajustar largura da página Faz com que a largura da página preencha a largura do painel de documentos.
  • Ajustar altura da página Faz com que a altura da página preencha a altura do painel de documentos.

Segurança

Proteja seu PDF adicionando restrições para abrir e ler o arquivo. Use as opções abaixo para evitar acesso não autorizado.

Configuração
Descrição
Definir senha para abrir o documento
Selecione para adicionar uma senha segura para exibir seu arquivo do PDF. Especifique uma senha no campo Senha do usuário. Os usuários podem abrir o PDF somente digitando a senha fornecida neste campo.
Definir as restrições de documento

Selecione para restringir como os usuários podem interagir com o PDF. Especifique uma senha no campo Senha do Proprietário para que as configurações de restrição abaixo funcionem.

  • Impressão Selecione para permitir que um usuário imprima a PDF.
  • Impressão com qualidade de rascunho Selecione para permitir que um usuário imprima o PDF em uma resolução mais baixa.
  • Cópia de conteúdo Selecione para permitir que um usuário copie conteúdo do PDF.
  • Anotações Selecione para permitir que um usuário adicione uma observação ou comentário na PDF.
  • Modificações de conteúdo Selecione para permitir que um usuário altere o conteúdo na PDF.
  • Cópia de conteúdo para acessibilidade Selecione para permitir que os leitores de tela leiam e naveguem no conteúdo do PDF.
    Assembly do documento Selecione para permitir que os usuários insiram páginas no PDF.
    Observação: os usuários precisam digitar a senha de proprietário para alterar quaisquer restrições em Arquivo > Propriedades no Adobe Acrobat.

Imprimir

NOTE
A partir da versão 5.0/2025.02.0 do Experience Manager Guides, a seção Imprimir agora faz parte da predefinição de Saída Nativa do PDF. Para os modelos existentes com configurações de impressão salvas, os dados de impressão permanecerão intactos, mas não aparecerão mais na interface do usuário nem serão aplicados durante a saída. Para continuar usando essas configurações, você deve reconfigurá-las na predefinição de Saída nativa do PDF.

Defina as configurações de produção de impressão para atribuir marcas de impressora, selecionar modelos de cores e especificar propriedades relacionadas à impressão da saída do PDF.

  • Marcas da impressora: quando você prepara um documento para produção de impressão, marcas da impressora são adicionadas aos limites da página para auxiliar no alinhamento, corte e seleção de cores adequados durante a impressão. Ao selecionar uma marca de impressora, o limite da página é estendido para acomodar a marca, que é aparada durante a impressão. Você pode optar por exibir as seguintes marcas de impressora na saída do PDF:

    • Marcas de aparagem: selecione a opção para colocar uma marca em cada canto da área de aparagem para indicar onde o papel precisa ser aparado após a impressão.
    • Marcas de sangria: selecione para colocar uma marca em cada canto da caixa de sangria para indicar a área de aparagem da imagem estendida.
    • Marcas de registro: selecione para colocar uma marca fora da área de corte para alinhar as diferentes separações em um documento colorido.
    • Barras de Cores: selecione para adicionar uma faixa de cores fora da área de aparagem para manter a consistência de cores e ajustar a densidade da tinta ao imprimir.

    Defina dimensões para as marcas de impressora selecionadas usando as opções Largura da Linha, Cor da Linha e Largura da Caixa de Sangria.

  • Tamanho da Caixa de Mídia: este é o tamanho geral da página, incluindo a área estendida ocupada pelas marcas da impressora. Use a opção suspensa para selecionar o tamanho da página para a saída do PDF ou criar seu próprio tamanho personalizado.

  • Espaço de Cores: você tem a opção de escolher espaços de cores RGB ou CMYK para imprimir seu documento PDF. Escolha RGB para exibir o PDF gerado digitalmente e o CMYK para impressão física. As cores definidas no documento são convertidas no espaço de cores escolhido.

  • Perfil ICC: aqui, você pode gerenciar a precisão de cores entre dispositivos especificando um perfil ICC. Isso garante uma renderização de cores consistente na saída impressa.

Para definir essa configuração, especifique o caminho do arquivo de perfil ICC no servidor e forneça o nome do perfil ICC para facilitar a identificação. Como alternativa, se o perfil ICC for armazenado on-line, você poderá fornecer o URL em vez do caminho do arquivo.

NOTE
Um perfil de cores ICC é necessário para a criação do PDF/A se estiver usando o espaço de cores CMYK.

Avançado

Use as opções a seguir para especificar configurações avançadas para mesclar PDFs, usar compactação, selecionar o padrão de conformidade e muito mais.

Configuração
Descrição
Criar PDF acessível (marcado)
Selecione essa opção para gerar uma PDF com tags. Um PDF marcado facilita a leitura e a navegação dos leitores de tela por conteúdo, hiperlinks, marcadores e assim por diante. Por exemplo, se uma tabela estiver marcada, o leitor de tela saberá que está lendo a tabela e não apenas linhas e texto.
Mesclar PDFs incluídos no índice
Selecione essa opção para mesclar PDFs existentes na saída, adicionando-os ao mapa DITA como um arquivo de recurso. Os PDFs serão inseridos no local representado no mapa e as páginas serão aumentadas de acordo.
Incorporar fontes usadas
Selecione esta opção ao usar fontes que podem não estar instaladas no computador do usuário final. Com essa opção selecionada, as fontes usadas são incorporadas ao PDF, garantindo que o usuário possa visualizar o PDF conforme pretendido, mesmo que as fontes não estejam instaladas em sua máquina.
Observação: uma fonte só poderá ser inserida se contiver uma configuração do fornecedor da fonte que permita sua inserção. Verifique se você tem a configuração ou licença necessária antes de incorporar uma fonte.
Usar hifenização automática
Com a hifenização automática ativada, as palavras no final das linhas são quebradas em locais gramaticalmente corretos com um hífen.
Habilitar JavaScript
Ative essa opção se tiver um código JavaScript que deseja usar para transformar dinamicamente seu conteúdo antes de gerar uma PDF.
Incorporar arquivos multimídia
Selecione esta opção para incluir qualquer conteúdo de áudio, vídeo e interativo na PDF.
Usar compactação completa para otimizar o tamanho do PDF
Selecione essa opção se desejar compactar/reduzir o tamanho de um PDF grande. Lembre-se de que compactar o PDF pode reduzir a qualidade do arquivo.
Usar compactação de imagem para otimizar o tamanho do PDF
Selecione essa opção se desejar compactar/reduzir o tamanho das imagens usadas no PDF. Lembre-se de que compactar uma imagem pode reduzir sua qualidade.
Usar resolução personalizada (pixels por polegada)
É a resolução de exibição da página em pixels por polegada. Insira um valor preferencial no campo que aparece quando esta opção é selecionada. O valor padrão é de 96 pixels por polegada. Defina um valor maior para ajustar mais conteúdo em uma polegada e vice-versa, se você definir um valor menor.
Mostrar Marca D'Água
Selecione essa opção para sobrepor uma marca d'água na saída. Você pode inserir uma nova cadeia de caracteres de texto na caixa de texto com o caractere no formato desejado.

Use texto estático ou variáveis de idioma para publicar a versão localizada da marca d'água. Dependendo do idioma escolhido, o valor localizado é escolhido automaticamente na saída do PDF. Por exemplo, você pode imprimir 'Publisher' como uma marca d'água em inglês e 'Auteure' em francês.
Formato: ${lng:<variable name>}. Por exemplo, $ {lng:publisher-label} onde publisher-label é uma variável de idioma.
Passe o cursor ícone de informações {width="25"} próximo à opção para ver mais detalhes sobre ele.
Habilitar equações do MathML
Selecione essa opção para renderizar as equações do MathML presentes no seu conteúdo. As equações serão ignoradas caso contrário, por padrão.
Criar formulário interativo do PDF
Selecione essa opção se desejar incluir campos de formulário interativos e personalizáveis do PDF para entrada aprimorada do usuário em saídas geradas do PDF.
Incluir alterações de controle
Selecione essa opção se desejar incluir alterações controladas no PDF gerado para facilitar a revisão e a comparação.
Reter arquivos temporários
Selecione essa opção se quiser manter os arquivos provisórios do HTML criados ao gerar a saída do PDF nativo. Posteriormente, você pode baixar os arquivos temporários depois de gerar a saída. Os arquivos baixados também incluem o arquivo system_config.xml, que fornece informações sobre a URL do autor, a URL local e a URL de publicação. Essas URLs são definidas nas configurações de Externalização do AEM e são refletidas no arquivo system_config.xml.
Conformidade do PDF
É o padrão para o qual você pretende salvar seu PDF para garantir sua conformidade. Selecione na lista suspensa para escolher na lista de padrões disponíveis do PDF. Para obter mais detalhes sobre os padrões compatíveis, consulte Sobre os padrões da PDF.
Propriedades do arquivo
Selecione os metadados que deseja passar para a publicação nativa do PDF. A lista suspensa lista as propriedades personalizadas e padrão. Por exemplo, dc:description, dc:language, dc:title e docstate são as propriedades padrão, enquanto você pode ter author como a propriedade personalizada. As propriedades de metadados selecionadas são passadas para o arquivo PDF gerado usando o PDF Nativo.
Essas propriedades são selecionadas do arquivo metadataList disponível em:/libs/fmdita/config/metadataList.
Este arquivo pode ser sobreposto em: /apps/fmdita/config/metadataList.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178