25 de agosto de 2010 por Lucas Vieites
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
El archivo fuente lo podéis descargar aquí:
Javadoc_stylesheet_by_Lucas y para usarlo solamente hay que sustituir el archivo llamado «stylesheet.css» que está en la carpeta raíz de vuestra documentación Javadoc.
11 de febrero de 2010 por Lucas Vieites
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.
31 de octubre de 2008 por Lucas Vieites
Acabo de terminar el capítulo «Sentencias de control de flujo» de los Tutoriales de Java, con lo que queda completada la ruta «Lo básico del lenguaje».
Visitad el «Gran índice» para ver el progreso de la traducción.
4 de septiembre de 2008 por Lucas Vieites
Acabo de terminar de traducir y subir el capítulo Operadores de los Tutoriales de Java.
16 de julio de 2008 por Lucas Vieites
Hace unos días que empecé con la tarea titánica de traducir los famosos The Java Tutorials al español, impulsado por la iniciativa del proyecto javatutorials en java.net. Aunque este proyecto prefiere que se publiquen los documentos en su propio wiki, allí he creado una página con enlaces que iré actualizando con mis progresos.
Por ahora los documentos traducidos estarán aquí: Los tutoriales java en español. A los interesados les sugiero que vayan directamente al Gran Índice, en el que se indican qué secciones están traducidas y cuales todavía no.
