# Generador de Portadas para Libros

Para generar una portada a incluir en documentos Markdown y que
se puedan generar documentos con **Pandoc** que lleven la imagen de la portada incluida.

## Imágenes

Las imágenes que se utilizan para la parte del medio de la portada son todas
las que encuentre en la ruta `./imagenes/`

Se comprueba si existe en la ruta de ejecución el fichero `imagen.png`.
Si no existe localiza *aleatoriamente* una de la ruta imagenes para usarla.

Si quieres preseleccionar usar, lo mejor es crear un enlace a la imagen de la
carpeta en donde tengas la imagen que quieras usar:

```
ln -sf /ruta/foto.png imagen.png
```
> Sólo se permiten imagenes en formato **PNG**

# Editar y Compilar el Código

El fichero fuente en Go (Golang) se llama `portada.go`

Tras cualquier cambio puedes generar un nuevo binario (con golang instalado) 
simplemente ejecutando:

```
go build -o portada
```

El binario/aplicación generado es: `portada`

## Ejecución y portada generada

El programa no necesita entorno gráfico para funcionar.

Simplemente inicialo desde un terminal:
```
./portada
```

Completa los datos que te pide:
```
  GENERADOR DE PORTADAS PARA LIBROS
  Título: 
  TITULO DE MI LIBRO
  SubTítulo: 
  Un libro que lo explica casi todo
  Autor: 
  Anónimo Veneciano
  Editorial: 
  LETRAS CURVAS
  Color de Portada [ N:Negro, R:Rojo, V:Verde, A:Azul, M:Amarillo ] 
  V

 Generando Portada. Espere por favor....
 Se ha generado 'portada.png
```
Tras unos segundos tendrás tu portada generada:

![Ejemplo de Portada](portada.png)

## Incluir portada en fichero Markdown para uso con Pandoc

Si usas Markdown para crear tu documentación y luego generar el Manual/Guía
resultando con Pandoc, puedes modificar tu fichero `Portada.md` para incluir 
la imagen de la portada y que quede perfecta la presentación:

```
---
title: |
    ![](portada.png)
    MANUAL PARA GENERACIÓN DE PORTADA DE LIBROS
subtitle: Ejemplo de portada generada con la aplicación realizada en Go
author: Luis Gutiérrez López
date: Marzo 2024
abstract: |
    Una forma sencilla de incluir una portada a tus publicaciones realizadas
    con Pandoc con texto sencillo realizado con Markdown y LaTeX.
    
    Totalmente personalizable tanto en imágenes, título y subtítulos, asi como
    en los colores del tema de la portada final del Libro.
---
\thispagestyle{empty}
\pagebreak

```

El truco es indicar en *title* que se trata de un párrafo (no de una línea),
para ello usamos el símbolo de *pipe* `|`
En la primera línea indicamos la imagen de la portada generada, 
y en la segunda línea escribimos el titulo de forma normal.

Cuando generemos mediante *Pandoc* el Libro/Manual/Guía el resultado final será el siguiente:

![Vista de las página con portada incrustada](dos-paginas.png)