«Andante con moto». Rapidillo, ma non troppo…

Estos días he tenido que pasar más tiempo del deseable leyendo la documentación del API de Java. Estos documentos están generados mediante Javadoc, un gran invento, pero la hoja de estilo es un poco aburrida. Por eso me tomé un momentillo de descanso cerebral para darle un toque más moderno. El resultado es el siguiente:

Mi hoja de estilo CSS para Javadoc, pulsa para ampliar

Ya está disponible la primera edición del «Directorio de Museos de España». Es un proyecto en el que llevo trabajando casi un año con mi amigo José Vaamonde. El Directorio es una recopilación de datos que hemos realizado a partir de distintas fuentes públicas, muy dispersas y anticuadas, para crear una base de datos única de museos y colecciones artísticas, etnográficas y arqueológicas de todo tipo.

La base de datos está disponible (por ahora parcialmente) para su revisión, corrección y completado en http://www.directoriomuseos.com/ y se puede comprar en formato impreso a través de Lulu.

¡Hay descuentos por volumen de compras!

This is a little PHP script I've been using on my personal/home web server to generate listings of the content of the accessible folders. I've improved it over time and suddenly I got in this sharing mood and thought:

«Gee, the rest of the world should have the pleasure of running this script on their web servers with PHP enabled. They should have the opportunity to simply copy it into a directory under their DocumentRoot and point their browser to it.»

Yeah, that's what I thought. And now, a few months later, I remembered having thought that. So here it is: turdle_0.1.php. Rename it as you see fit (at least remove the .txt extension).

Like the header says:

/*
 * TURDLE is "The Ultimate Recursive Directory Lister, Enhanced"
 * it's not called ÑORDO because that doesn't make an nice acronym.
 * 
 * It lists the content of the defined directory and creates
 * links to it's content.
 * It does not show files starting with ".".
 * It does not show itself.
 * It does not validate as HTML 4.01 Strict!
 * It peruses the word "it" in it's header
 * 
 */

By the way, it's published under the GNU/GPL, too.

Hace poco me tocó añadir ciertas funcionalidades a una aplicación web que escribí hace unos seis o siete años. Además de echarme algunas risas por alguna de las «barbaridades» que me encontré al revisar los archivos, me pasé un buen rato formateándolos para poder ver bien el flujo del código y comprender qué pasaba en cada sección. Y es que hace seis años todavía no tenía un estilo de código definido.

Cuando empecé a programar en PHP venía un poco viciado de programar en C y javaScript y hacía cosas como:

1
2
3
4
5
6
7
8
9
10
11
12

function mifuncion()
{
	// Función para hacer algo
	if (condicion)
	{
		// hacer una cosa
	}
	else
	{
		// hacer otra cosa
	}
}

desperdiciando valiosas líneas, algo que aprendí a evitar cuando los archivos de código se hacen más y más grandes y solo tienes 1024 píxeles de alto en tu pantalla.

A día de hoy ese mismo código lo pondría así:

1
2
3
4
5
6
7
8

function mifuncion() {
	// Función para hacer algo
	if (condicion) {
		// hacer una cosa
	} else {
		// hacer otra cosa
	}
}

ahorrándome cuatro líneas.

Como el hombre es un animal de costumbres sigo haciendo esto porque, a pesar de que las pantallas son cada día más grandes, también los IDEs ocupan cada vez más espacio en pantalla con sus barras de herramientas, de estado y plugins de calidad de código y no sé qué mil cosas más. Y no me hagáis hablar de la manía que le ha entrado a los fabricantes por las pantalla panorámicas ;-(

Mi estilo actual de programación está fuertemente basado en las recomendaciones de Sun (ahora ya parte de Oracle), publicadas en sus «Code Conventions for the Java Programming Language» (traducido al español por javaHispano -no tengo enlace al documento original- y revisado y corregido por un servidor: Convenciones de código para el lenguaje de programación Java).

NOTA: también estoy a favor de usar tabulaciones de cuatro espacios, a pesar de que el plugin de wordpress ponga 8, y en contra de lo que defiende Jamie Zawinski en el artículo «Tabs vs Spaces» que he puesto de «Obligada lectura» en la columna de la derecha.

A partir de hoy este blog se llamará "«Andante con moto». Rapidillo, ma non troppo...". Una simple referencia a los tempos de la música clásica que, al oído del profano (como un humilde servidor), pueden sonar graciosos. Más información en la Wikipedia.