Je viens de jouer avec #AIDER pour essayer de comprendre comment
l'utiliser, et je me pose des questions :
-* sur $GLOBALS['help_server']
-** un url_de_base(1)."ecrire/"._DIR_PLUGIN_AMOI."aide/"; me semble
barbare car non exploitable sur la partie publique
-** il semblerait utile d'avoir par défaut un chemin aide/ pour
prendre en charger les aides de toute provenance sur le site en
question (squelettes, plugins, ...)
-* la recommandation squelettes/ pour poser ses fichiers d'aide.
La recommandation de http://www.spip.net/fr_article4727.html de cibler
un répertoire squelettes/ me semble non adaptée, le fichier n'est pas
un squelette, avoir directement aide/ ou au pire squelettes/aide/
comme préconisation me semblerait plus juste.
Il n'est nul part indiqué comment ajouter une nouvelle référence dans
l'aide. #AIDER{montoto} fournit bien une page d'aide associée, mais
cela apparait mal dans la frame de gauche, le menu
En tout cas le truc me plait bien. Dommage que ce soit encore trop expérimental.
-** un url_de_base(1)."ecrire/"._DIR_PLUGIN_AMOI."aide/"; me semble
barbare car non exploitable sur la partie publique
mais non.
dans ton mon_plugin_options.php :
$GLOBALS['help_server'] = url_de_base(1).'plugins/langonet/';
qui peut trés bien cohabiter avec, dans ton config/mes_options.php
$GLOBALS['help_server'] = url_de_base(1).'squelettes/';
et les 2 seront bien exploitables sur la partie *publique*
-** il semblerait utile d'avoir par défaut un chemin aide/ pour
prendre en charger les aides de toute provenance sur le site en
question (squelettes, plugins, ...)
pourquoi pas oui...
plugins/mon_plug/aide/
plugins/auto/mon_plug/aide/
squelettes/aide/
Il n'est nul part indiqué comment ajouter une nouvelle référence dans
l'aide. #AIDER{montoto} fournit bien une page d'aide associée, mais
cela apparait mal dans la frame de gauche, le menu
oui. j'ai oublié d'ajouter ça dans l'article...
donc il te faut (pour avoir dans le menu gauche le bloc-titre verdâtre
ajouter un :
<h1>Le Titre du Bloc</h1>
exemple :
<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>
<h1>Aide Perso</h1>
<h2>mon_aide_perso/Ici de l'aide !</h2>
<h3 class="spip">Mes trucs à moi</h3>
<p style="color:red;">
Ici un paragraphe d'aide personnalisée sur tout et n'importe quoi.
</p>
<!-- fin ajout d'aide personnalisée -->
</body>
</html>
appel depuis n'importe quel page avec #AIDER{mon_aide_perso}
Euh, je ne comprends pas quelles sont les questions, ça semble plutôt des remarque.
J'ai mal lu ?
Oui ce sont plutôt des remarques dites interrogative.
-** un url_de_base(1)."ecrire/"._DIR_PLUGIN_AMOI."aide/"; me semble
barbare car non exploitable sur la partie publique
mais non.
dans ton mon_plugin_options.php :
$GLOBALS['help_server'] = url_de_base(1).'plugins/langonet/';
qui peut trés bien cohabiter avec, dans ton config/mes_options.php
$GLOBALS['help_server'] = url_de_base(1).'squelettes/';
Oui dans ce cas faut penser à ecrier les 2 formes pour l'aide en
général. Cela ne me semble pas très heureux.
chemin() et autre fonction gerent cette question de façon
transparente. Il pourrait être bon de faire de même ici.
-** il semblerait utile d'avoir par défaut un chemin aide/ pour
prendre en charger les aides de toute provenance sur le site en
question (squelettes, plugins, ...)
pourquoi pas oui...
plugins/mon_plug/aide/
plugins/auto/mon_plug/aide/
squelettes/aide/
Oui je crois bien que ce serait préférable.
Il n'est nul part indiqué comment ajouter une nouvelle référence dans
l'aide. #AIDER{montoto} fournit bien une page d'aide associée, mais
cela apparait mal dans la frame de gauche, le menu
oui. j'ai oublié d'ajouter ça dans l'article...
donc il te faut (pour avoir dans le menu gauche le bloc-titre verdâtre
ajouter un :
<h1>Le Titre du Bloc</h1>
Ok cool, le détail non devinable
Et on a des sous menus si on fait plusieurs <h1> identiques ?
dans ce cas faut penser à ecrier les 2 formes pour l'aide en
général. Cela ne me semble pas très heureux.
chemin() et autre fonction gerent cette question de façon
transparente. Il pourrait être bon de faire de même ici.
ben 2 lignes de déclaration plutôt qu'un gros plastra à coup de
dirname(__FILE__) et autre realpath(...)
Ok cool, le détail non devinable
hum...
Et on a des sous menus si on fait plusieurs<h1> identiques ?
non.
<h1>...</h1> fabrique un 'bloc' (verdâtre) du type
"Installation de SPIP" ou "Images et documents"
les entrées de bloc, c'est <h2>...</h2> du type
"Les raccourcis typographiques" ou "Principe des mots-clés"
Malheureusement, en ayant suivi à la lettre ce que tu as renseigné, cela ne fonctionne toujours pas pour moi. J'ai toujours la pop up avec le message d'erreur :
Cette partie de l'aide en n'est pas encore disponible dans cette langue..
J'ai un fichier fr-aide.html dans /squelettes/ et la ligne
$GLOBALS['help_server'][] = url_de_base(1).'squelettes/';
dans mes options.
Je tourne en local avec php 3.1
l'url retourné est: http://localhost/halal/ecrire/?exec=aide_index&aide= var_lang=fr
Dans le cache il n'est pas crée de dossier /aide/
SPIP 2.1.0[15608]
Quand je désactive la commande php dans mes_options, j'ai l'aide en ligne, si je la désactive, je ne l'ai plus. Je ne pense pas que cela vienne de mon serveur local, non?
Avec mes_options et cache vidé il n'y a rien même pas le dossier /cache/aide/ et il ne se recrée pas .
Sans mes_options il y a un dossier /cache/aide/ avec un fichier fr-aide.html qui est celui livré avec SPIP, mis pas celui du dossier /squelettes/
J'ai trouvé! Et c'est très logique .
J'avais repris mot pour mot ce qu'il a été écrit sur la doc avé les accents!! hors en utf-8 il vaut mieux éviter .. soit élément doit être bien écrit élément.
Peut-être faudrait il le préciser dans la doc, je risque de ne pas être le seul à tomber dans le panneau
