Bitácora de Gesbit

En Gesbit venía utilizando cierto "estándar" (lo entrecomillo porque, aunque creo que lo es, no consigo dar con información adecuada) para nombrar los archivos de lenguaje, así como para definir la correspondiente constante de configuración y determinar en qué lenguaje localizar Gesbit.

A raíz de que un conocido mío, Álvaro, que está traduciendo Gesbit al catalán, se planteó el asunto de qué código de lenguaje le correspondía a la lengua catalana, según el "estándar" que venía siguiéndose en Gesbit.

Yo pensé en "ca_CA", pero, parece que no suena del todo bien, ni tampoco es del todo correcto. Al final se quedó en "ca_ES", sabiendo que no era del todo correcto. Pero, al cabo he decidido utilizar el estándar ISO 639-2 para los códigos de lenguaje en Gesbit.

Gesbit está escrito, originalmente, en inglés, en mi pobre inglés, lo reconozco. Si no se especifica lenguaje alguno será el inglés el que se use. Sin embargo, por defecto, la distribución de Gesbit está configurada para localizar este en español.

"esp" es el código de lenguaje del español, según ISO 639-2, y es el que se usa actualmente por defecto. Y el código del catalán según el mismo estándar es "cat". Aquí ya no hay ambigüedad alguna, parece ser. En el enlace anterior se puede ver una lista completa de los códigos de lenguaje que siguen este estándar.

Quiero aprovechar para dar las gracias a Álvaro por el trabajo que se ha tomado traduciendo Gesbit al catalán. ¡Gracias Álvaro!

A cosas como esta me refería en la entrada Mejorando la clase G de Gesbit: a añadir nuevas opciones dentro de los argumentos por defecto en los métodos de dicha clase, sin que sea necesario hacer cambios en el código, salvo en el propio método al que se añade la nueva opción/argumento.

Si pasas el ratón por encima de las etiquetas que puedes ver en el lateral derecho de este sitio web, verás que, el "hint" de cada etiqueta te informa de cuántas entradas hay etiquetadas con la etiqueta en cuestión. Ha sido cuestión de añadir una nueva opción por defecto en el método "TagCloud" de la clase G:

$defaultArgs = array(
  'return' => false,
  'numbers' => true,
  'minCount' => 1,
  'maxTags' => 40,
  'before' => '<li>',
  'after' => '</li>'
);

El tema por defecto en Gesbit, que hace uso de dicho método (ya lo ves en el lateral derecho) no ha tenido que ser editado, puesto que la opción se añade entre los argumentos por defecto y además se especifica "true", es decir, que sí, que se muestren el número de entradas de cada etiqueta.

Tampoco quisiera que esto de las opciones de los argumentos fueran mil... de hecho el método "TagCloud()" es, si no me falla la memoria, y creo que no, el que más argumentos/opciones admite. Pero, en caso de que sea necesario añadir opciones, como se puede ver, resulta relativamente sencillo, y no se compromete el código existente.

Hoy ha tocado el esperado repaso en la clase G de Gesbit. El asunto era, más que nada, mejorar la forma en que se pasaban los argumentos a los métodos de esta clase, usada, básicamente, por los temas y plugins de Gesbit.

Así, en lugar de métodos como este, por ejemplo:

static public function TagCloud(
 $minCount = 1, $maxTags = 40, 
 $before = '<li>', $after = '</li>'
){
  // Cuerpo del método
}

Tenemos que ahora es menester un único argumento, un array asociativo, que puede incluir más de una "opción", por llamarlo así:

 
static public function TagCloud($args = array()){
  $defaultArgs = array(
    'return' => false,
    'minCount' => 1,
    'maxTags' => 40,
    'before' => '<li>',
    'after' => '</li>'
  );
  $args = array_merge($defaultArgs, $args);
 
  // Resto del cuerpo del método
}

Hasta hoy en Gesbit se podía partir el contenido de una entrada en dos, utilizando el "more token", de modo que, debajo del cuerpo (de la mitad del cuerpo) de las entradas se mostrara el típico enlace "Continuar leyendo...", que hay que utilizar para poder ver el resto del contenido de la entrada.

Hasta hoy, digo, esto ya funcionaba en Gesbit, pero, lo hacía parcialmente. Quiere decirse que el enlace "Continuar leyendo..." no era sino el "enlace permanente" de una entrada, de modo que al seguir el enlace se mostraba toda la entrada, efectivamente, pero, uno debía buscar dónde se había quedado leyendo.