fr   gb


Arbor
Le script Arbor > Mode d'emploi > Créer une arborescence > Edition de l'arborescence

Edition de l'arborescence

Ouvrez votre fichier de données (dans le cas où les données sont dans un fichier séparé) dans un éditeur de texte.

up1. Composez les lignes

Dans ce fichier, éditez la section 'datamenu'. Celle-ci contient la liste des lignes de l'arborescence.

Utilisez la syntaxe suivante :

'datamenu' => array(

"Ligne Racine",

"+Ligne 1",

"++Ligne 1a",

"++Ligne 1b",

"+++Ligne 1ba",

"+Ligne 2",

"++Ligne 2a",

"+Ligne 3",

)

Nb : cette section 'datamenu' est la seule qui soit obligatoire dans ce fichier.

up2. Règles de syntaxe

* Chaque ligne de l'arborescence est entre guillemets (simples ou doubles) et terminée par une virgule.

* Le bloc de lignes est inclus dans 'datamenu' => array( ............................................ )

* Le nombre de "+" (caractère "plus") représente la profondeur d'indentation de la ligne. Espaces interdits entre les guillemets et les plus.

* Les entités (&xxx;) et les balises html sont interprétées dans les libellés (utile pour les gras et italique ponctuels, en sus de la feuille de style).

* Attention à ne pas ajouter machinalement un ";" après la parenthèse finale de ce bloc !

(o) Caractères interdits dans un libellé de ligne :

+ (plus)
| (barre verticale)
^ (circonflexe isolé)
# (dièse)

... car ces symboles ont un sens précis pour Arbor.

up3. Marquage des éléments essentiels

Vous pouvez indiquer à Arbor les éléments de votre arborescence que vous considérez comme essentiels, c'est-à-dire les éléments les plus importants ou ceux que le visiteur recherchera le plus souvent.

Pour cela, placez le caractère "!" au début du libellé de ces lignes. Arbor n'affichera pas ce caractère dans le document.

Le "!" doit être placé, le cas échéant, après les "+". Le panachage des niveaux d'indentation ne pose aucun problème.

Exemple :

'datamenu' => array(

"!Accueil de mon site", // Ligne importante

"+Rien que du blabla",

"+!Téléchargement", // Ligne importante

"+Toujours plus d'info",

"++Encore du blabla",

"++!Et voilà du lourd", // Ligne importante

)

Arbor se basera sur ce marquage pour rédiger une "barre des essentiels" (si vous utilisez ce mode d'affichage).

up4. Validité de l'arborescence

L'indentation doit être cohérente, c.à.d. qu'une ligne-fille doit avoir un et seulement un niveau de plus que sa ligne-mère. Sinon, Arbor affichera un message d'alerte dans le document, indiquant le numéro de la ligne incohérente dans l'arborescence.

La première ligne de l'arborescence doit être une ligne racine (donc notée sans "+"). Sinon, Arbor affichera un message d'alerte.

Il est possible d'avoir plusieurs lignes racines dans une même arborescence. Leur nombre est illimité. Les lignes racines sont les seules à être affichées à la première ouverture de l'arborescence.

Les lignes vides et les indentations avant les guillemets sont autorisées et facultatives, elles ne sont pas prises en compte mais améliorent la lisibilité du fichier-source. Rappel : l'indentation effective du menu est régie par les "+" et non par l'indentation dans le fichier de données.

 

 > Editer les liens de menu

 

 

Arbor Home

 

Home Accueil

Contact Chercher

Contact Contact

Site Plan Plan du site

Page top Haut de page

Valid XHTML 1.0 Strict