Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
completo
src/img
3-lsd.md
3-lsd_notas.md
README.md
portada.jpg

README.md

Pecas para publicaciones digitales en modo manual

Última actualización: 12 de julio de 2017

En este módulo vamos a usar Pecas, un conjunto de herramientas para procesos editoriales.

Estas herramientas están pensadas para facilitar la publicación de libros en diversos formatos con la metodología del single source publishing (SSOP), también conocida como «edición ramificada».

Las herramientas no son un entorno de desarrollo integrado, como Sigil o InDesign. En su lugar pretenden facilitar la creación de estructuras a partir de un archivo madre para que el editor y el diseñador se concentren en su trabajo. Las herramientas son una propuesta de SSOP.

Actualmente las herramientas están enfocadas a la creación de EPUB desde la terminal.

En todo momento es posible revisar los archivos presentes en el directorio completo.

Módulos relacionados

Índice


Descargar el software necesario

Para conocer el software necesario para todos los módulos, consúltese el área de instalación.

Crear un EPUB a partir de un MD

ATENCIÓN: aquí no se utilizan todas las opciones que ofrece Pecas; véase la documentación citada en cada caso para mayor información.

0. Ir a este carpeta desde la terminal

cd arrastrar/la/carpeta/P002-Pecas

Esto es solo para asegurar que no habrá errores si se copian y pegan los comandos que vienen a continuación.

1. Archivos de Markdown

Si se realizó el módulo práctico Markdown en la edición digital, se recomienda utilizar los archivos generados (3a-lsd.md y 3a-lsd_notas.md).

Si no se hizo el módulo, se tienen que renombrar los archivos 3-lsd.md y 3-lsd_notas.md a 3a-lsd.md y 3a-lsd_notas.md para evitar errores si solo se copian los comandos.

2. Convertir a XHTML

pc-pandog -i 3a-lsd.md -o 4a-todo.xhtml

Con los archivos debidamente marcados ya es posible utilizar las herramientas de Pecas. Para generar un EPUB se necesitará un XHTML, por lo que ahora es necesario convertir el archivo madre en Markdown a XHTML desde la terminal:

  1. Escribir pc-pandog para llamar a la herramienta (arrastrar /Archivo-madre/1-Pandog/pandog.rb si se usa Windows).
  2. Indicar el archivo de entrada (input): -i 3a-lsd.md.
  3. Indicar el nombre y extensión del archivo de salida (output): -o 4a-todo.xhtml.
  4. Enter para ejecutar.

Esta herramienta utiliza el poder de Pandoc más otras características personalizadas de Pecas (como la posibilidad de estilos de párrafo), para generar el archivo XHTML.

Para mayor infomación sobre pc-pandog, véase su documentanción.

3. Crear proyecto EPUB

pc-creator -o 5a-epub-creator -c portada.jpg 

Con el archivo convertido a XHTML, ahora se necesita crear un proyecto base para EPUB. Así que desde la terminal:

  1. Escribir pc-creator para llamar a la herramienta (arrastrar /EPUB/1-Creador/creator.rb si se usa Windows).
  2. Indicar el nombre de nuestro proyecto (output): -o 5a-epub-creator.
  3. Añadir una portada al proyecto (cover); -c portada.jpg .
  4. Enter para ejecutar.

Esto creará un directorio con el nombre 5a-epub-creator y un archivo para metadatos llamado meta-data.yaml.

No es necesario modificar 5a-epub-creator; sin embargo, se recomienda añadir los metadatos al libro.

Para mayor información sobre los metadatos en el archivo YAML, véase su documentación.

Para mayor infomación sobre pc-creator, véase su documentanción.

4. Dividir XHTML

pc-divider -f 4a-todo.xhtml -d 5a-epub-creator/OPS/xhtml/ -s 5a-epub-creator/OPS/css/styles.css 

Ahora es necesario añadir el archivo XHTML al proyecto EPUB, pero en lugar de dejar todo el libro en un solo archivo, dividiremos el documento por secciones desde la terminal:

  1. Escribir pc-divider para llamar a la herramienta (arrastrar /EPUB/2-Divisor/divider.rb si se usa Windows).
  2. Indicar el archivo a dividir (file): -f 4a-todo.xhtml.
  3. Indicar la carpeta donde se pondrán los archivos divididos (directory): -d 5a-epub-creator/OPS/xhtml/.
  4. Señalar la hoja de estilos que tendrá cada archivo: -s 5a-epub-creator/OPS/css/styles.css.
  5. Enter para ejecutar.

Esto dividirá el XHTML cada vez que se encuentre con un encabezado 1, añadiendo el archivo en la carpeta xhtml del proyecto y vinculando su hoja de estilos por defecto.

Para mayor infomación sobre pc-divider, véase su documentanción.

5. Añadir notas a los archivos divididos

pc-notes -f 3a-lsd_notas.md -d 5a-epub-creator/OPS/xhtml/ -s 5a-epub-creator/OPS/css/styles.css 

Al proyecto solo falta añadir las notas en cada uno de los archivos divididos, así que en la terminal:

  1. Escribir pc-divider para llamar a la herramienta (arrastrar /EPUB/3-Notas/notes.rb si se usa Windows).
  2. Indicar el archivo que tiene las notas (file): -f 3a-lsd_notas.md.
  3. Indicar el directorio que contienen los archivos con las marcas de las notas (directory): -d 5a-epub-creator/OPS/xhtml/.
  4. Señalar la hoja de estilos que tendrá cada archivo: -s 5a-epub-creator/OPS/css/styles.css.
  5. Enter para ejecutar.

Esto añadirá las notas en sintaxis HTML, numeradas automáticamente y junto con una referencia cruzada al nuevo archivo que tiene el contenido de las notas.

Para mayor infomación sobre pc-notes, véase su documentanción.

6. Recrear el proyecto EPUB

pc-recreator -d 5a-epub-creator/

Ahora ya se tiene todo lo necesario para el EPUB. Por lo que desde la terminal:

  1. Escribir pc-recreator para llamar a la herramienta (arrastrar /EPUB/6-Recreador/recreator.rb si se usa Windows).
  2. Indicar el directorio del proyecto (directory): -d 5a-epub-creator/.
  3. Enter para ejecutar.

Con esto se tiene un EPUB en versión 3.0.1. Pero antes de leerlo, hay que verificarlo…

Para mayor infomación sobre pc-recreator, véase su documentanción.

7. Verificar EPUB

epubcheck 4 5a-epub-creator.epub

La verificación se realiza con EpubCheck, el validador oficial para EPUB y desde la terminal:

Para Mac y Linux

  1. Escribir epubcheck para llamar a la herramienta.
  2. Indicar la versión de EpubCheck a utilizar: 4.
  3. Indicar el EPUB a verificar: 5a-epub-creator.epub.
  4. Enter para ejecutar.

Para Windows

  1. Escribir java -jar para indicarle a la terminal el tipo de aplicación de EpubCheck.
  2. arrastrar /EPUB/EpubCheck/4-0-2/epubcheck.jar para llamar a la herramienta.
  3. Arrastrar el EPUB a verificar: 5a-epub-creator.epub.
  4. Enter para ejecutar.

En ambos casos tiene que mencionar que el EPUB no tiene errores, si sucede lo contrario, verifíquese el formato puesto en el archivo de Markdown.

Existe una versión gráfica y online de EpubCheck: validator.idpf.org.

EpubCheck es una aplicación java desarrollado por la IDPF (International Digital Publishing Forum), la comunidad encargada de mantener el formato EPUB y que desde enero de 2017 forma parte del W3 (World Wide Web Consortium), la metacomunidad que vela por los estándares web.

8. ¡Listo!

Hemos creado un EPUB verificado y listo para la lectura.

Debido a que se continúa con el mantenimiento de pc-changer, en el modo manual no se convirtió el EPUB a la versión 3.0.0, la única aceptada entre varios distribuidores como iTunes, Amazon o Google Play. Solo en el modo automático es posible crearlos.

El EPUB generado es posible convertirlo a formato MOBI, para Kindle, si se utiliza la herramienta oficial de conversión: kindlegen.

¿Quieres probar el mismo ejercicio de modo automático? Consulta el módulo «Pecas para publicaciones digitales en modo automático».

Recursos