Saída de PDF do Publish
Com o AEM Guides, você pode gerar PDF de tópicos individuais ou um arquivo de mapa inteiro. Você pode publicar seu conteúdo em um formato PDF usando um dos três métodos abaixo:
- DITA-OT
Use esse método para gerar uma saída de PDF para um mapa no painel de mapa. É possível definir as propriedades de publicação antes de gerar o PDF, criando uma predefinição de saída para o mapa que está aberto no painel de mapa. Para criar ou editar uma predefinição de saída, consulte a seção Noções básicas sobre as predefinições de saída no Guia do Usuário do AEM Guides as a Cloud Service.
Para obter mais informações sobre como gerar um PDF usando o método DITA-OT, consulte Gerar PDF usando DITA-OT.
- FrameMaker Publishing Server (FMPS)
Use esse método para gerar uma saída de PDF não apenas do conteúdo DITA, mas também de documentos do FrameMaker (.book e .fm) disponíveis no repositório do AEM. O PDF pode ser criado configurando uma predefinição de saída e publicado usando o FrameMaker Publishing Server (FMPS). Você pode projetar e configurar a aparência da sua saída para PDF e outros formatos e armazenar o mesmo em um arquivo de configuração (.sts). Esse arquivo de configuração é então usado pelo FMPS para gerar saída para um mapa DITA ou arquivo .book. Para criar ou editar uma predefinição de saída, consulte a seção Noções básicas sobre as predefinições de saída no Guia do Usuário do AEM Guides as a Cloud Service.
Para obter mais informações sobre como configurar o FMPS, consulte Gerar saída de documentos do FrameMaker.
- Publicação de PDF nativo
Use este método para gerar uma saída de PDF repleta de recursos com base nos padrões W3C CSS3 e CSS de mídia paginada. Com a publicação em PDF nativo, você pode usar modelos para definir o layout e o estilo do conteúdo e aplicar várias configurações para ajustar o PDF. Além disso, você pode modificar e criar seus próprios modelos com o editor de modelos.
Para obter mais informações sobre a publicação de PDF nativo, consulte Usando a publicação de PDF nativo.
Uso da publicação de PDF nativo native-pdf-publishing
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 seu documento PDF, garantindo consistência e usabilidade. O recurso de publicação PDF nativo usa esses padrões para gerar um PDF.
Com a publicação em PDF nativo, você pode usar modelos predefinidos para garantir a 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 de PDF, incorporar fontes e muito mais.
A geração de um PDF usando a publicação de PDF nativo 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 de PDF para controlar as configurações de PDF. Depois de criar uma predefinição de saída PDF, você pode gerar o PDF.
Para obter mais informações, consulte Gerar uma saída de PDF.
Criar uma predefinição de saída de PDF create-output-preset
A primeira etapa na geração de uma saída de PDF é criar uma predefinição de saída de PDF, que é uma coleção de propriedades de publicação atribuídas a um mapa. Você pode criar uma predefinição de saída para qualquer mapa que esteja aberto no painel Exibição de mapa ou configurar uma predefinição existente para gerar rapidamente um PDF para o mesmo mapa.
Na predefinição de saída PDF, é possível selecionar um modelo, aplicar condições, definir restrições para controlar como um usuário interage com seu PDF, definir configurações avançadas como compactação, conformidade e muito mais.
Para criar ou configurar uma predefinição de saída de PDF:
-
Na guia Saída, clique em Predefinições na barra lateral esquerda.
O painel Predefinição é aberto.
-
No painel Predefinições de saída, siga um destes procedimentos:
- Clique duas vezes em uma predefinição de saída de PDF predefinida para visualizá-la.
- Clique no ícone + contra Predefinições para adicionar uma nova predefinição de saída de Tipo: PDF
-
Para definir as configurações de uma predefinição de PDF existente:
- Clique no ícone Opções
Você pode usar as seguintes configurações nas guias Geral, Metadados, Layout, Segurança e Avançado para configurar uma predefinição de saída de PDF:
- Clique no ícone Opções
Geral
Use para especificar configurações básicas de saída, como caminho de saída, nome do arquivo de PDF e muito mais.
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.Você também pode usar as seguintes variáveis prontas para uso para definir o Arquivo 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}.Para conteúdo condicional, escolha entre as opções abaixo para gerar uma saída de 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 Digital Selecione um arquivo DITAVAL para gerar conteúdo condicional. Para selecionar, clique em Predefinição de condição e localize o 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.
Use as seguintes opções para criar um PDF que mostre as diferenças no conteúdo entre duas versões usando as 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 aparece no 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.
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 direitos autorais e outros campos de dados para a saída de 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.
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 XMP de amostra daqui.
Como alternativa, você pode gerar um arquivo XMP usando o Adobe Acrobat.
- Clique em Arquivo > Propriedades no Acrobat.
- Em Descrição, clique em Metadados Adicionais.
- No painel esquerdo, selecione Avançado.
- Clique em Salvar.
O arquivo XMP é salvo no dispositivo.
-
Forneça nomes e valores de metadados
- Adicione um nome selecionando no menu suspenso ou adicione um metadado personalizado digitando diretamente no campo de nome.
- Insira o valor dos metadados e clique no í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
Layout
Use para definir layouts de página e especificar opções de exibição de página para saída de PDF, como Exibição de página e definir níveis de Zoom.
Você também pode selecionar Procurar Modelo
Use a Exibição de página para a exibição de página que mostra como o PDF é exibido quando é aberto. 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 de 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.
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 de 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
Protect seu PDF adicionando restrições para abrir e ler o arquivo. Use as opções abaixo para evitar acesso não autorizado.
Selecione para restringir como os usuários podem interagir com o seu 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 o 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 no PDF.
- Modificações de conteúdo Selecione para permitir que um usuário altere o conteúdo no PDF.
- Cópia de conteúdo para acessibilidade Selecione para permitir que os leitores de tela leiam e naveguem no conteúdo no 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.
Avançado
Use as opções a seguir para especificar configurações avançadas para mesclar PDF, usar compactação, selecionar padrão de conformidade e muito mais.
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.
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
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 de 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.Gerar uma saída de PDF generate-pdf-output
Depois de configurar a predefinição de saída, você pode gerar a saída a partir do painel Predefinições, usando o recurso Gerar predefinição.
-
Na guia Autor, selecione a Exibição Repositório.
Isso abre o painel Repositório. -
No painel Repositório, abra o arquivo de mapa DITA em Exibição de Mapa.
-
Na guia Saída, clique em Predefinições para exibir o painel Predefinição.
Para criar ou configurar uma predefinição de saída, consulte Criar uma predefinição de saída PDF. -
Para salvar suas configurações, clique no ícone Salvar tudo
-
Clique no ícone Gerar predefinição
No painel Predefinições de saída, é possível exibir uma barra de progresso ao lado da predefinição de saída selecionada. -
Quando a geração de saída estiver concluída, clique em Exibir Saída
Uma caixa de diálogo Êxito está visível no canto inferior direito da tela.
Se uma saída não for bem-sucedida, a mensagem de erro abaixo será exibida.
Para exibir o log de erros, clique em Ignorar, passe o mouse sobre a guia de predefinição selecionada e clique em
Baixar arquivos temporários depois de gerar a saída de PDF nativa
Se você selecionar a opção Baixar arquivos temporários nas Configurações avançadas, também será possível baixar os arquivos de HTML provisórios criados durante a geração da saída de PDF nativo. Depois de gerar a saída, você pode baixar os arquivos temporários usando o ícone Baixar arquivos temporários
Usar variáveis de idioma
O AEM Guides também oferece suporte para variáveis de idioma. Selecionar Variáveis de Idioma
Suporte para documentos do Markdown
A Experience Manager Guides também fornece suporte para seus documentos do Markdown. Arquivos Markdown são fáceis de criar e também
O fornece várias opções de formatação. Saiba como criar documentos do Markdown no Editor da Web.
Você pode adicionar os tópicos do Markdown ao mapa DITA e gerar a saída de PDF usando as predefinições de saída de PDF nativo. Saiba como configurar ou criar uma predefinição de saída de PDF.