Convertir cada intertítulo en un ancla

All contributions published for previous SPIP versions

Este pequeño filtro permite marcar con un identificador “id” único a cada intertítulo, para permitir vinculos del tipo pagina.html#ancla que llevan a una parte específica del propio texto.

A menudo es práctico poder señalar un URL de tipo pagina.html#ancla que posiciona la página en el lugar que está marcado como “ancla”. Aquí vamos a emular este comportamiento con un pequeño filtro de SPIP rápido y nada caro que convierte cada intertítulo en un ancla.

Definir los intertítulos

Ante todo debemos redefinir los intertítulos con <h2> (titulos de nivel 2). En mes_fonctions.php3 agregamos:

$GLOBALS['debut_intertitre'] = "\n<h2>";
$GLOBALS['fin_intertitre'] = "</h2>\n";

Método: recorrer la página

Vamos ahora a recorrer el contenido de #TEXTE, y cada vez que encontraremos un h2, lo completaremos con un identificador id único.

El código

Dentro de mes_fonctions.php3, incluir el código adjunto:

/*
 *   +----------------------------------+
 *    Nomnre del Filtro :    crear anclas
 *   +----------------------------------+
 *    Fecha : 27 julio 2005
 *    Autores :
 *		Stéphane Deschamps http://www.spip-contrib.net/auteur.php3?id_auteur=327
 *		Yann Ducrocq http://www.spip-contrib.net/auteur.php3?id_auteur=1833
 *
 *  Traducido por Martin Gaitan: http://www.nqnwebs.com.ar
 *
 *   +-------------------------------------+
 *    Funcio del filtro :
 *    este filtro genera un ancla unica para cada intertitulo
 *   +-------------------------------------+ 
 * 
 *   el filtro se aplica sobre #TEXTE
 *   [(#TEXTE|crear_anclas)] 
 * 
 */ 

// declaracio de un contador global
$cId = 0;


function crear_anclas($str)  {
	// expresion regular a testear
	$regH2 = "/<h2[^>]*>(.*?)<\/h2>/i";
	// funcion de reemplazo
	$str = preg_replace_callback($regH2,'replaceH2',$str);
	//devuelve la cadena resultante
	return $str;
}

function replaceH2($matches) {
	// recupera el contador global
	global $cId;
	// incrementa el contador global para mantener un ID unico
	$cId++;
	// devuelve la cadena de reemplazo
	return '<h2 id="ancla' . $cId . '">' . $matches[1] . '</h2>';
}

Aplicación

Este filtro se aplica sobre la baliza #TEXTE de la siguiente forma (#TEXTE. Por supuesto, se puede combinar con otros filtros.

Conclusión y evolución posible

Una vez aplicado el filtro, se podrá hacer referencia desde los vínculos a #ancla1 para el primer intertítulo, #ancla2 para el segundo, etc.

Atención, sin embargo, en algunos viejos navegadores, como versiones antiguas de Internet Explorer por ejemplo, los vínculos hacia el id no funcionan siempre idealmente,

En tal caso, si quiere asegurar la compatibilidad, puede reemplazar

'<h2 id="ancla' . $cId . '">' por '<h2><a name="ancla' . $cId . ' id="ancla' . $cId . '"></a>'

(sí, se hizo adrede poner un name y un id, pero esto sería demasiado largo de explicar en este artículo).

Entre las ideas de evolución posibles, podrán por ejemplo basarse en un script en Javascript que genere automáticamente el sumario del artículo , como el TOC script de Peter-Paul Koch.


traducido por Martín Gaitán

Discussion

No discussion

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom