generadorPortadasLibro/README.md

99 lines
2.7 KiB
Markdown

# 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)