Bitácora de Gesbit

He escrito un plugin para jQuery, de que dejo constancia en mi bitácora, con vistas a incorporarlo en Gesbit, y, bueno, eso es lo que he hecho. Aunque no me queda del todo claro, como luego explicaré.

Este plugin indicará en algunos de los campos para contraseñas en los formularios de administración de Gesbit, la "dureza" de la contraseña en cuestión, mediante una especie de "barra de progreso".

Aunque en principio escribí el plugin para Gesbit, el caso es que lo he terminado haciendo por adentrarme un poco en JavaScript y jQuery. De hecho lo he añadido a Gesbit, pero, no sé, no quisiera comenzar a añadir "chorradas".

Creo que en un momento dado puede venir bien, y, por el momento, ahí está. No sé qué tal te parecerá a ti. Puedes ver el plugin "en funcionamiento" en la bitácora de demostración de Gesbit: prueba a "cambiar tu contraseña" desde tu perfil de usuario.

He estado haciendo algunas pruebas con cierto "filtro de HTML" con vistas a usarlo en Gesbit. He escrito una entrada en mi bitácora sobre el asunto. Me ha quedado un poco farragosa y tal vez muy larga... o muy corta, pero, en fin, he pensado que podía interesarte, puesto que toca a Gesbit en buena medida.

Por fin me he decidido, y, ya está disponible "en línea" la documentación para desarrolladores de Gesbit. Se trata del manual de documentación obtenido por phpDocumentor a partir del código fuente de Gesbit, de sus comentarios.

He hecho sólo algunos cambios en el archivo de estilo, por cierto, bastante curioso, no me ha resultado nada complicado "pintarlo" todo con el "gris Gesbit". Ahora podrá mejorarse todo lo que se quiera. Pero creo que menos es nada.

Lo único que me preocupa ahora es mantener la documentación actualizada. Aunque se genera "automáticamente" (unos diez minutos tarda mi ordenador, no demasiado potente, también es verdad) lo cierto es que en según qué actualizaciones de Gesbit (¡que hago a diario varias veces!) tendría que actualizar la documentación.

O no. Probablemente no sea necesario esto último salvo para ciertos cambios, y, bueno, en todo caso, quien quiera disponer sí o sí de la última versión de la documentación, utilizando el programa susomentado, ¡podría generarla él mismo a partir del código fuente de Gesbit! Que, este sí, "siempre" será la última versión.

Ayer hice cambios en la clase "G" de Gesbit de modo que ahora los métodos que "imprimen" los últimos comentarios publicados en la bitácora, así como la "nube de etiquetas", muestren más comentarios y más etiquetas.

Concretamente el límite de comentarios predeterminado se queda ahora en diez, y en cien el límite de etiquetas que se solicitan para ser mostradas. Pensé en cambiar esto sólo en mi bitácora personal, es decir, utilizando los argumentos de los métodos susomentados.

Sin embargo opté por llevar a cabo los cambios directamente en Gesbit, por la importancia que le doy a los comentarios en la bitácora, y también a la nube de etiquetas. Sobre todo los comentarios los encuentro muy relacionados con la bitácora.

De todos modos este cambio no significa prácticamente nada en cuando al "consumo de recursos", puesto que los últimos comentarios en Gesbit no se solicitan al completo, sino sólo en parte, sólo lo necesario.

Lo mismo podría decirse de las etiquetas. No supone prácticamente diferencia entre solicitar cuarenta o cien etiquetas. Y, por supuesto, estoy hablando de cómo se hacen las cosas en el tema predeterminado en Gesbit: porque cada tema puede hacerlo como estime oportuno, o esa es la idea.

Sigo dándole vueltas al asunto de qué documentación preparar para publicar en el sitio web de Gesbit de cara a que puedan revisarla los interesados en desarrollar plugins y temas para este gestor de bitácoras.

Hay algo que no se me va de la cabeza: ¡la documentación incluida en los comentarios del código fuente de Gesbit! Esta es profusa, o, al menos esa era mi intención, y, si bien puede tener carencias (entre otras cosas está escrita en mi pobre inglés) puede ser también un buen punto de partida.

¿Por qué? Por varios motivos. En primer lugar, porque existe. No; no creas, podría no existir. En segundo lugar, porque al estar dicha documentación "escrita" en cierto lenguaje, puede ser interpretada, "parseada" y presentada automáticamente por un programa como PhpDocumentor.

No se trata de que sea un vago y quiera ahorrarme la documentación... no. Se trata de aprovechar la documentación existente. Si bien tendría incluso que plantearme algunos cambios, lo cierto es que las ventajas de "este sistema" se me hacen demasiado evidentes como para pasarlas por alto. ¿No te parece?

Está bien. Lo reconozco. ¡Estoy perdido! No sé cómo enfocar una posible documentación para desarrolladores interesados en crear "plugins" y "temas" para Gesbit. ¡¿Se te ocurre algo?! ¡Ayuda! ¡Help!

Me planteo algo así como un manual que se publicaría en el sitio web de Gesbit y que habría de contener información relativa al desarrollo de plugins y temas para este gestor de bitácoras.

Aunque procuro comentar todo el código fuente de Gesbit, y, la clase "G" (principal implicada en este caso) cuenta con sus correspondientes comentarios, no sé hasta qué punto la documentación que puede obtenerse a partir de ahí es la más idónea para el caso que nos ocupa.

Por otro lado, tampoco estoy muy convencido de que duplicar información sea lo ideal. Pero tal vez no quede más remedio. Se trataría, pues, de especificar cada uno de los métodos de la clase "G" en el supuesto manual, documentándolos de cara a posibles desarrolladores.

Y también de dar una serie de directrices, supongo, de cosas a tener en cuenta. ¡Y nos quedan los plugins! Para los que, además de la clase "G", hay que tener en cuenta otras cuestiones, como que estos han de ser "hijos" de la clase "GbPlugin", que tienen un "manejador" en la clase "GbPlugins", etc.

No sé. El sitio web de Gesbit está ahí, creo que más o menos cumple con su función, pero, en este asunto de la documentación, insisto, de cara a los desarrolladores, estoy pez. Le he dado unas cuentas vueltas y he hecho algunos intentos, pero, vanos.

¡Seguiremos en ello! Pero, si se te ocurre cualquier cosa... ¡se agradecerá otro punto de vista sobre el tema!

Tal como decía en la anterior entrada y dije en su momento en otra, el nuevo sitio web de Gesbit, ha servido, entre otras cosas para eso.

Es decir, ahora se distribuyen por separado los Idiomas, Plugins y Temas para Gesbit, dando lugar a una distribución de Gesbit "básica", que ocupa entorno a 400 KB.

Esta distribución "básica", no obstante, incluye el tema "predeterminado" en Gesbit, los idiomas español e inglés, y un plugin, a modo de "ejemplo", que acaso pronto vendrá "activado" por defecto en el getor de bitácoras.

Vamos, que se trata de una distribución de Gesbit en toda regla, lista para usar. A partir de ahí, que cada quien descarge el tema que prefiera, que haga lo propio con los plugins y también con los idiomas disponibles para Gesbit.

Creo que esto es bien para todos y por eso he llevado a cabo estos cambios.

Respondiendo a la entrada ¿Necesita Gesbit otro sitio web? y, en un momento de cierta inspiración y atrevimiento, me he decidido por "abrir" un nuevo sitio web para Gesbit, desde donde podrá descargarse este gestor de bitácoras, entre otras cosas.

¡Así que actualiza tus marcadores! Y tus suscripciones RSS a esta bitácora, puesto que ahora se encuentra en un subdominio del sitio Gesbit.com, propiamente.

Como podrás ver, el sitio web en cuestión no está terminado, y de hecho su contenido se incrementará con el tiempoo, en parte. Pero, ya enlaza con la demostración de Gesbit, con esta bitácora, y permite descargar Gesbit, entre otras cosas.

Ya he hablado en esta bitácora sobre utilizar o no un editor Wysiwyg en Gesbit. Por mí no lo haría, porque me apaño muy bien escribiendo HTML, y, estoy muy contento conque cualquier "script" del panel de administración no sobrepase los 25 KB.

Cosas como el consumo de memoria y los tiempos de carga me preocupan en Gesbit, y, un editor de los que hablo incrementaría el tamaño de los "script" considerablemente. Pero, lo cierto es que un editor así puede resultar de utilidad, y es por eso que he hecho varios intentos para integrar alguno en Gesbit.

Pero hasta ahora han sido todos intentos vanos. He probado varios editores, pero, alguno no funciona en todos los navegadores en que pruebo Gesbit, otros "interfieren" (podría arreglarse, creo) con las teclas de acceso directo, otra vez sólo en según qué navegadores. Este es demasiado complejo. Aquél lo es aún más.

No me rindo, empero. Uno de los que más me convencen es NicEdit, y he conseguido integrarlo bastante bien, pero, no en todos los navegadores en que pruebo Gesbit, como digo. Por otro lado es de complicada "localización" (traducción) y acaso habría que esperar a una nueva versión del programa, que, por otro lado, ya está anunciada.

En fin. Supongo que seguiré intentando dar con algún editor que me deje completamente satisfecho, si bien parece complicado, en vista de que he probado por lo menos una docena de ellos. Y son programas estupendos, pero, por hache o por be, como digo, no termino de adaptarlos bien en Gesbit, no terminan de convencerme.

Gracias a las pruebas que estoy haciendo con el nuevo Zend Studio for Eclipse, he podido solucionar no pocos errores en Gesbit que se me pasaban completamente por alto, debido a que no afectan demasiado al funcionamiento del sistema.

Como digo en la entrada que enlazo arriba, no se trata de errores que pudieran llegar a causar problemas: variables declaradas sin usar, etiquetas HTML sin cerrar, etc., pero, se agradece conocerlos y poder arreglarlos.

Ya sabes que aunque no publique entradas en esta bitácora, no paro de actualizar Gesbit, como puedes ver en la página desde donde puedes descargarlo. Y, te recuerdo que puedes probar Gesbit sin necesidad de descargarlo e instalarlo. Por si te interesa.