{"id":7519,"date":"2018-03-15T20:13:13","date_gmt":"2018-03-15T18:13:13","guid":{"rendered":"https:\/\/www.perdiendo.org\/museodemetralla\/?p=7519"},"modified":"2020-11-22T17:13:08","modified_gmt":"2020-11-22T16:13:08","slug":"crear-un-epub-con-pandoc-y-sigil","status":"publish","type":"post","link":"https:\/\/perdiendo.org\/museodemetralla\/?p=7519","title":{"rendered":"crear un epub con pandoc y sigil"},"content":{"rendered":"

Pasos previos.<\/h3>\n

Parto de archivos formateados en markdown<\/a>. Si a\u00fan no lo usas para escribir empieza ya, es un lenguaje de marcado<\/a> en un archivo de texto plano<\/a> que podr\u00e1s abrir con cualquier programa, no ser\u00e1s dependiente de uno solo. Lo b\u00e1sico es aburridamente sencillo:<\/p>\n

# t\u00edtulo principal (nombre del libro)
\n## t\u00edtulo secundario (nombre del cap\u00edtulo)
\n### t\u00edtulo terciario (partes dentro de un cap\u00edtulo)<\/p>\n

*cursiva<\/em>*
\n**negrita<\/strong>**<\/p>\n

M\u00e1s tarde pandoc traducir\u00e1 a xhtml en el epub toda esa informaci\u00f3n y el \u00edndice de tu documento ser\u00e1 result\u00f3n. T\u00fa s\u00f3lo escribes unas almohadillas y un par de asteriscos, y la magia la hace quien la tiene que hacer: el pc, dej\u00e1ndote a ti centrado simplemente en escribir.<\/p>\n

Hay m\u00e1s, por supuesto, notas, definiciones… si quieres saber m\u00e1s pulsa en el enlace<\/a> de la primera l\u00ednea de la entrada.<\/p>\n

Si te empe\u00f1as en utilizar un editor de texto tipo Word o Libreoffice, Pandoc convierte sin problema de .doc o .odf a .epub, as\u00ed que no te rindas todav\u00eda.<\/p>\n

Aunque el uso que tendremos que hacer del terminal con Pandoc tiene una complicaci\u00f3n m\u00ednima, si vas a utilizarlo directamente tendr\u00e1s que saberte mover por los archivos de tu pc con \u00e9l. Si no, te recomiendo que utilices Ghostwriter<\/a> para escribir en markdown y exportar tu archivo a .epub, aunque tendr\u00e1s que instalar igualmente Pandoc<\/a> (de eso no te libras, pero una vez instalado no volver\u00e1s a tocarlo).<\/p>\n

Exportando a epub.<\/h3>\n

Pandoc<\/a> es un conversor sin interfaz gr\u00e1fica, as\u00ed tendremos que utilizarlo en un terminal, pero que nadie pierda fuelle porque para lo que necesitamos con un par de comandos nos bastar\u00e1.<\/p>\n

Si queremos usar pandoc directamente vamos en el terminal al directorio donde tenemos el archivo y escribimos<\/p>\n

pandoc -s nombredemiarchivo.md -o nombredemiarchivo.epub\r\n<\/code><\/pre>\n
Si tu archivo es un .docx, pues eso<\/p>\n
pandoc -s nombredemiarchivo.docx -o nombredemiarchivo.epub\r\n<\/code><\/pre>\n
Y si lo has escrito en Libreoffice, pues lo mismo<\/p>\n
pandoc -s nombredemiarchivo.odf -o nombredemiarchivo.epub\r\n<\/code><\/pre>\n
-s sirve para generar un archivo aut\u00f3nomo, no una parte de otro (y creo que en el caso del epub no es necesario) y -o marca el destino, ya que podemos mezclar varios archivos de origen para generar el final. Si lo tenemos tambi\u00e9n podemos a\u00f1adir una hoja de estilo para darle formato al epub, a\u00f1adi\u00e9ndolo en el comando (si quieres olv\u00eddate de esto, pandoc genera un .css por defecto que podremos modificar en sigil)<\/p>\n
pandoc --css miestilo.css -s nombredemiarchivo1.md nombredemiarchivo2.md -o nombredemiarchivo.epub\r\n<\/code><\/pre>\n
Y con eso ya tendremos nuestro libro en formato epub. Pandoc tiene muchas m\u00e1s opciones y se puede mezclar con YAML<\/a> para los metatags y un mont\u00f3n de cosas m\u00e1s, pero creo que ser\u00e1 m\u00e1s sencillo hacerlo con Sigil.<\/p>\n
Si queremos convertirlo desde Atom<\/a> tendremos que instalar pandoc-convert<\/p>\n
\"pandoc-convert\"<\/p>\n
y una vez hecho abrir la paleta (ctrol mayus p) y escribir pandoc convert: epub<\/p>\n
\"pconvert\"<\/p>\n
Desde Ghostwriter<\/a> simplemente pulsaremos ctrol E para exportar y seleccionaremos como formato de destino .epub<\/strong>. Ghostwriter mola, sobre todo si no quieres complicarte. Escribes utilizando las almohadillas y los asteriscos y cuando terminas directamente exportas, y te olvidas del terminal.<\/p>\n
Completando con Sigil.<\/h3>\n
Instalamos Sigil<\/a>, lo abrimos y archivo \/ abrir y seleccionamos el archivo que acabamos de crear del modo que sea.<\/p>\n
En herramientas \/ \u00edndice de contenido creamos un \u00edndice autom\u00e1tico (esas almohadillas salvadoras que pusimos para marcar el t\u00edtulo del libro y los cap\u00edtulos, aunque ya estar\u00e1 hecho por defecto gracias a esas mismas almohadillas, soy un neur\u00f3tico).
\nEn herramientas \/ portada subimos la imagen de portada desde el pc.
\nEn herramientas \/ editor de metadatos introducimos los que queramos (autor, t\u00edtulo, colecci\u00f3n, idioma, etc).<\/p>\n
Si vamos a usar un archivo css, antes del paso siguiente nos aseguramos que est\u00e1 bien enlazado. En vista \/ vista de c\u00f3digo buscamos una linea parecida a:<\/p>\n
<link rel=\"stylesheet\" type=\"text\/css\" href=\"..\/Styles\/stylesheet.css\"\/>\r\n<\/code><\/pre>\n
entre las etiquetas  del encabezado. Si no est\u00e1, la incluimos (estar\u00e1, vuelve el neur\u00f3tico).<\/p>\n
Tampoco hace falta tener mucha idea de css para un libro de texto sencillo, yo suelo usar<\/p>\n
h1, h2, h3 {\r\ncolor: #333;\r\npadding-top: 25%;\r\n}\r\n\r\n#copyleft {\r\nfont-size: x-small;\r\ntext-align: center;\r\npadding-top: 25%;\r\n}\r\n<\/code><\/pre>\n
El primer p\u00e1rrafo para que el t\u00edtulo de la novela, del cap\u00edtulo y de los subcap\u00edtulos no aparezcan arriba del todo de la p\u00e1gina y para diferenciarlos en un gris oscuro, y el segundo para que el texto del copyleft aparezca m\u00e1s peque\u00f1o, centrado y tampoco arriba del todo.<\/p>\n
Las etiquetas que hemos generado en markdown con #, ## y ### se convierten en h1, h2 y h3 al convertir el documento.<\/p>\n
Entramos en las carpetas de la izquierda, Styles, stylesheet.css y lo modificamos como queramos (o lo dejamos como pandoc lo crea por defecto, al gusto).<\/p>\n
\"s-css\"<\/p>\n
Toda tu novela, antes de cortar, est\u00e1 en ese archivo ch001.xhtml<\/div>\n
Terminamos con la herramienta edici\u00f3n \/ dividir en el cursor, para que nos cree un archivo nuevo para cada cap\u00edtulo. Ponemos el cursor en el final del primer cap\u00edtulo y cortamos, y nos genera un archivo nuevo con el resto. Nos vamos al nuevo y repetimos, y as\u00ed hasta tenerlo todo dividido por cap\u00edtulos. Las p\u00e1ginas introducen (claro) un salto de p\u00e1gina autom\u00e1tico, as\u00ed que ser\u00e1 \u00fatil s\u00f3lo para cuando queramos que el texto termine en un punto y empiece en la p\u00e1gina siguiente de nuestro lector.<\/p>\n
Archivo \/ guardar y hemos terminado.<\/p>\n
Notas finales.<\/h3>\n
He intentado hacer una especie de manual para alguien que no tenga ni idea de d\u00f3nde se est\u00e1 metiendo, y siguiendo estos pasos se crea un .epub m\u00e1s que decente. Por supuesto, se est\u00e1 infrautilizando tanto markdown como pandoc y sigil, pero con esto basta y m\u00e1s adelante cada uno aprender\u00e1 lo que necesite de cada uno de ellos.<\/p>\n
A\u00fan as\u00ed, releyendo me sigue pareciendo complicado. Os aseguro que al hacerlo el proceso para crear un .epub dura cinco minutos como mucho. Lo m\u00e1s sencillo con diferencia es escribir con ghostwriter, utilizar su herramienta de exportaci\u00f3n y completar con Sigil.\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"
Pasos previos. Parto de archivos formateados en markdown. Si a\u00fan no lo usas para escribir empieza ya, es un lenguaje de marcado en un archivo de texto plano que podr\u00e1s abrir con cualquier programa, no ser\u00e1s dependiente de uno solo. Lo b\u00e1sico es aburridamente sencillo: # t\u00edtulo principal (nombre del libro) ## t\u00edtulo secundario (nombre […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[51],"tags":[],"class_list":["post-7519","post","type-post","status-publish","format-standard","hentry","category-markdown"],"_links":{"self":[{"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=\/wp\/v2\/posts\/7519","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=7519"}],"version-history":[{"count":0,"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=\/wp\/v2\/posts\/7519\/revisions"}],"wp:attachment":[{"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=7519"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=7519"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/perdiendo.org\/museodemetralla\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=7519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}