Convertidor online gratuito de ADOC a PDF

Un destinatario, una impresora, un sistema de archivo o un flujo de trabajo de documentos puede requerir un PDF de diseño fijo en lugar del código fuente editable de AsciiDoc. Renderizar el código fuente como PDF conserva la paginación y permite visualizar el documento sin una herramienta de AsciiDoc.

Qué es el formato ADOC

ADOC es la extensión de nombre de archivo común para un documento de AsciiDoc; también se utilizan .asciidoc y .asc. Es un formato de código fuente de texto sin formato que contiene markup para encabezados, listas, enlaces, tablas, atributos, referencias de imágenes y directivas include::.

Los desarrolladores, redactores técnicos y equipos de documentación utilizan archivos ADOC con herramientas como Asciidoctor, AsciidoctorJ y Antora. Un editor de texto muestra markup de código fuente como = Document title y == Section, no el documento paginado producido mediante el renderizado.

Qué es el formato PDF

PDF es un formato de descripción de páginas que conserva el tamaño de página, la tipografía, el espaciado, las imágenes y la paginación en diferentes sistemas operativos e impresoras. Es adecuado para imprimir, compartir, archivar y crear documentos que deban visualizarse de forma uniforme en distintos dispositivos.

PDF es menos práctico de editar que ADOC. Para la documentación cuyo código fuente se controla mediante control de versiones, edite el archivo ADOC y vuelva a generar el PDF en lugar de modificar el PDF directamente.

Cómo convertir un archivo ADOC a PDF

Uso de Asciidoctor PDF

Asciidoctor PDF es el convertidor local más directo porque interpreta la sintaxis de AsciiDoc y crea un PDF sin un archivo HTML intermedio. Requiere Ruby.

1. Instale Ruby si aún no está disponible en el equipo.
2. Instale Asciidoctor PDF desde un terminal con gem install asciidoctor-pdf.
3. Abra el terminal en el directorio que contiene el archivo fuente o proporcione su ruta completa.
4. Ejecute asciidoctor-pdf document.adoc -o document.pdf.
5. Abra el resultado y compruebe los encabezados, enlaces, imágenes, tablas, bloques de código y saltos de página.

Sustituya los nombres de archivo por los nombres reales del archivo fuente y del archivo de salida. Puede proporcionar un tema de PDF personalizado con un atributo como -a pdf-theme=my-theme.yml, siempre que el archivo del tema y las fuentes a las que haga referencia estén disponibles.

Asciidoctor PDF también puede integrarse en scripts y procesos de compilación de documentación, lo que es preferible cuando los PDF deben volver a generarse de forma coherente a partir de código fuente controlado mediante control de versiones.

Uso de 101convert.com

Puede convertir el archivo gratuitamente en 101convert.com sin instalar software: cargue el archivo .adoc, elija PDF como formato de salida, inicie la conversión y descargue el resultado. Utilice Asciidoctor PDF local para documentos confidenciales o archivos que dependan de imágenes locales, includes, temas personalizados o extensiones.

Consideraciones sobre calidad y compatibilidad

• Cambiar el nombre de document.adoc a document.pdf no convierte el archivo; el código fuente de AsciiDoc debe renderizarse.
• Las rutas relativas de las imágenes y las directivas include:: deben resolverse correctamente. Los archivos que falten pueden crear áreas de imagen en blanco o contenido de include sin resolver.
• Asciidoctor PDF utiliza sus propios temas y reglas de diseño. El CSS utilizado para la salida HTML de AsciiDoc no determina la apariencia del PDF.
• Las fuentes deben estar instaladas o proporcionarse a la compilación del PDF, y deben contener los caracteres necesarios. De lo contrario, los glifos pueden sustituirse o mostrarse como cuadros de caracteres faltantes.
• Los diagramas, gráficos, el resaltado de sintaxis y los ejemplos de código generados pueden requerir extensiones adicionales de AsciiDoc, ejecutables o pasos de compilación antes de generar el PDF.
• Las tablas largas y los bloques de código pueden dividirse de forma inadecuada en los límites de página. Ajuste los anchos, la configuración del tema o los controles de salto de página, e inspeccione el PDF renderizado antes de distribuirlo.
• La salida PDF depende de la versión del convertidor, el tema, las fuentes y los recursos incluidos, por lo que diferentes entornos pueden producir una paginación ligeramente distinta.