EA4GXR  Fernando  (Celemin)  Febrero 2023 ©  
e-mail: ea4gxr@gmail.com
Versión v1.0

Si estás leyendo esto:
Acabas de instalar el software para la generación de diplomas de actividades de radio.
Se habrá creado una carpeta en el directorio donde se ha descomprimido el zip: genDiplomasPS

Este script se debería ejecutar sin problemas en windows 10 64 bits y superiores.
En Windows 7 por defecto no funciona. Hay que actualizar a powerShell 5.1 y
además eliminar del script todos los acentos y símbolos "raros" ( ©, ñ, etc.)
Si además es una versión de 32 bits hay que descargarse las versiones de ImageMagick
y notepad++ portables para esta plataforma.

Esta carpeta contiene:
  - Este fichero: LEEME.txt
  - El script de powerShell "diplomas.ps1" 
  - El archivo de configuración "diplomas.xml" y una copia por si se necesita restaurarlo.
  - Una imagen de rejilla para la generación de la imagen de calibración: 
		fondoTransparenteGrid.png
  - diploma.ico para crear acceso directo.
  
  - Dos carpetas/directorios predefinidos:
		entradas/ - para dejar ahí los ficheros .ADI de datos y las plantillas de los diplomas
		salidasDiplomas/ - para generar en un subdirectorio por diploma los diplomas correspondientes
	
  Las carpetas de los programas preinstalados ImageMagick y Notepad++
	Las versiones que vienen son portables para windows de 64 bits (Windows 10, 11)
	Si se necesitara otra versión, mas abajo viene el enlace de las páginas oficiales.
	Si se instalan en otro directorio ha de modificarse diplomas.xml con la ruta correspondientes


Antes de lanzar el programa:
----------------------------
	Abrir ventana de powerShell como administrador
		Ejecutar el comando: 
			Set-ExecutionPolicy Unrestricted
		Esto hace que se puedan ejecutar scripts (ya que por defecto viene bloqueado)
	Cerramos esa consola, la abrimos de nuevo como usuario normal y ejecutamos:
			Unblock-file diplomas.ps1
	La primera vez lo ejecutamos en la linea de comandos para ver que no se producen errores:
			.\diplomas.ps1
			
			
			

Ahora que sabemos que funciona vamos a hacer que se pueda abrir dando un doble click
	encima del script diplomas.ps1
	para ello hay que asociar la extensión .ps1 a powerShell.exe.
	Boton derecho sobre diplomas.ps1 / Abrir con / Elegir otra aplicacion / y vamos a:
	(C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe) en windows 10

Crear Icono de acceso directo:
	Sobre el escritorio, boton derecho / nuevo / acceso directo. Botón examinar
	buscamos y seleccionamos: diplomas.ps1 /siguiente/finalizar
	Boton derecho /propiedades / Boton cambiar icono / seleccionar diplomas.ico
	
	
	
	
Más información en los comentarios del fichero diplomas.xml:

Script de powerShell para la generación de diplomas en actividades de radio.
Requiere como se indica más abajo la utilización de ImageMagick (programa libre)
Utiliza también notepad++ portable que se instalará tambien en el directorio del script.
Si se descarga desde el zip ya viene todo incluido.

Uso del programa:
	Editar este fichero ("diplomas.xml") teniendo cuidado de 
		respetar las etiquetas azules <>Solo escribir entre las marcas xml<>
		Este fichero ha de estar junto al ejecutable diplomas.ps1
		Asegurarse de que las rutas de los ficheros estén bien (los espacios podrían 
			dar problemas, mejor evitarlos)
	Este programa es un script de powerShell y se lanza desde este interprete de comandos.
	.\diplomas.ps1 o desde el explorador de ficheros haciendo doble click si previamente
	se ha asociado la extensión .ps1 a powerShell.exe.
	(C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe) en windows 10

	Por temas de seguridad de windows 10 antes de poder ejecutarlo hay que dar permisos:
	(Solo una vez tras la descarga)
	Primero se abre un terminal powerShell en modo administrador y se ejecuta:
		Set-ExecutionPolicy Unrestricted
	luego ya como usuario normal se hace un cd C:\users\ruta_del_script\ y se ejecuta:
		Unblock-file diplomas.ps1
	
	
Intrucciones para rellenar este fichero xml:

Usar un editor de txt, notepad++ viene por defecto.
(No valen editores tipo word)

Se necesita:
	Una imagen del diploma sin rellenar.
		Puede ser de cualquier tamaño razonable. 
		El script lo redimensiona para los diplomas de salida.
	Un fichero ADI de JavaQso con el log de la actividad.
		Rellenar el campo archivoADI con la ruta relativa a donde se
		haya copiado el script y esté fichero (diplomas.xml)
	El prefijo de los diplomas "30LRCB-2023-10-31"  compondrá el nombre como: 
		30LRCB-2023-10-31-CELEMIN-FERNANDO.jpg (o png)
	
	Un directorio para dejar ahí los diplomas que apuntaremos en
		el campo dirSalida (igual, ruta relativa .\ficherosSalida\30LRCB_2023-10-31\ por ejemplo)
	Cuando se haga una primera prueba con los datos por defecto, ajustar
		posicionQrz, posicionQra, ColorTexto, fuenteTexto y densidad (tamaño) 
		si se desea.
		Hay una guía de nombre de colores en imagemagick.org 
			https://imagemagick.org/script/color.php#color_names
		Para fuentes disponibles ejecuatr C:\....\magick.exe -list font
		o en en navegador de archivos ir a C:\Windows\Fonts bonton derecho / vista previa
		(El nombre es el que pone en el titulo pero juntando las palabras con un guión: Wide-Latin
		Desde powerShell:  explorer.exe c:\windows\fonts\
		
Espero Qué os quite un poco de trabajo.

Intrucciones instalación ImageMagick-7 si hay que hacerlo a mano por ser una
versión distinta a la que se incluye en el zip de instalación.
Descargar de:
https://imagemagick.org/script/download.php
El adecuado para el ordenador (32 /64 bits)
Se recomienda la instalacion portable:
ImageMagick-7.1.0-62-portable-Q16-x64.zip	
            Portable Win64 static at 16 bits-per-pixel component. 
			Just copy to your host and run (no installer, 
			no Windows registry entries).

Se copia en la carpeta que se quiera y se descomprime.
Luego hay que copiar la ruta del ejecutable en el campo
imageMagic del xml de este fichero.

Para el notepad++ procedimiento similar. 
https://notepad-plus-plus.org/downloads/v8.4.9/
