Incluyo DOC

README.md

@@ -0,0 +1,98 @@
+# 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)