+101
−80
+1
−1
Chargement en cours
Possibilité d'étendre l'aide en ligne.
Le script d'aide en ligne est à présent capable de fusionner plusieurs sources d'informations, et de les présenter de manière unifié dans la fenêtre à 2 frames qui s'ouvre lorsqu'on clique sur les icones de point d'interrogation des pages de l'espace privé. L'interface est assez contrainte, car le format de référence est celui fourni par [http://www.spip.net/aide/fr-aide.html cette page de spipnet]. En voici les principes. La globale {{{help_server}}} est à présent non plus l'URL d'un répertoire d'aide, mais un tableau de telles URL (la compatibilité est assurée néanmoins). Lorsque de l'aide est demandée dans une langue L, SPIP va récupérer toutes les pages nommées L{{{-aide.html}}} existant aux URL indiquées par cette globale, et fusionner les informations. Par défaut, ce tableau global a pour seul élément {{{http://www.spip.net/aide}}}, ce qui permet de retomber sur le comportement habituel, mais à présent il peut être complété par d'autres éléments dans le fichier {{{mes_options.php}}}. Une page d'aide est structurée par la présence de balises h1, h2 et h3, indiquant le début de sections, sous-sections et sous-sous-sections (la fin est la prochaine balise h1|2|3, et il est supposé qu'aucun titre n'apparaît 2 fois, dans toute la structure). La fusion consiste à repérer si la page à fusionner à des titres de ((sous-)sous-)sections identiques à ceux déjà rencontrées dans les pages précédentes. Si un tel titre est trouvé, ce qui le suit dans la page à fusionner est ajouté à la fin de ce qui avait été trouvé sous ce nom auparavant. Si ce n'est pas le cas, on considère que c'est une section nouvelle qu'on ajoute alors à la fin. Voici par exemple comment décrire les raccourcis supplémentaires de spipnet. Dans mes_options.php, on met une URL spécifique, ici je choisis le répertoire des squelettes du site: {{{ $GLOBALS['help_server'][] = $GLOBALS['meta']['adresse_site'] . '/squelettes/; }}} Dans le répertoire de squelettes, je crée le fichier {{{fr-aide.html}}} ainsi rédigé: {{{ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr" dir="ltr"> <head><link rel='stylesheet' href='http://www.spip.net/prive/spip_admin.css' type='text/css' /></head> <body> <h2>raccourcis/Les raccourcis typographiques</h2> <h3 class="spip">Les raccourcis de www.spip.net</h3> <p> Les raccourcis <tt>[->spipN]</tt> fournissent un lien vers l'article de référence décrivant la version N de SPIP. Ce lien tient compte de la langue utilisée au moment où le raccourci apparaît, de sorte que si l'article de référence a été traduit dans cette langue, c'est cette traduction qui servira de lien, et non l'article de référence qui n'est en fait que le lien par défaut. </p> </body></html> }}} et paf, dans la fenêtre habituelle d'aide, l'entrée de sous-menu {{Les raccourcis typographiques}} fournit le texte de spipnet complété par le texte entre les balises P ci-dessus.