Pour incorporer un script, passez par le menu "Incorporer|Scripts de rubrique..." ou Insérer un script (CTRL+Q)

Fig. 232 Insertion d'un script

Le plus simple est encore de les intégrer à la palette de composants

  • Sélectionnez votre script dans la liste des scripts disponibles
  • Editez les paramètres à utiliser
  • Validez en cliquant sur le bouton Insérer un script


Si vous désirez créer ou éditer un script cliquez sur le bouton

Un composant (script) qui ne créé pas de contenu dans le corps de votre rubrique, qui par exemple modifie juste un style CSS , peut-être placé dans une zone spéciale (Insérer hors contenu), l'avantage est que cela clarifie l'édition des rubriques.

Pour indiquer qu'un script possède cette particularité vous devez insérer #NO-SOURCE dans sa zone de description, pour cela vous devez être en mode édition de script

Pour afficher cette zone allez dans le menu Options|Afficher composants ne produisants pas de contenu

Fig. 233 Palette des composants ne produisants pas de contenu

Les composants placés sur l'onglet Projet seront exécutés pour toutes les rubriques de votre projet alors que ceux de l'onglet Rubrique seront spécifiques à la rubrique.

Pour éditer, déplacer ou supprimer un composant de cette zone, cliquez dessus et validez votre choix, vous disposez d'une fonction historique qui vous permet de revenir à un état antérieur.

En standard les composants BodyColor BodyColor, BackgroundDegrade, BodyID, BackgroundStrip, FixedWidth3dBorder, Meta-Dublin-core et SmoothScroll peuvent y être placés.



 

Fig. 234 Editeur de scripts de rubrique

L'onglet "Bibliothèques de scripts" vous donne accès à l'ensemble des scripts disponibles sur votre machine, vous pouvez copier des portions de code, double clic pour copier l'ensemble du code, ou ouvrir un script en double cliquant sur son nom.

L'onglet Source est l'éditeur proprement dit, il se découpe en 3 sections

Barre d'icônes


Nouveau script Nouveau script
Ouvrir un script Ouvrir un script
Sauver Sauver le script
Insérer Insérer le script

Vous avez à votre disposition 3 assistants :

: vous permet d'obtenir le code d'un objet Help&Web

: Insertion d'une condition, l'icone en forme de page, sélectionne le nom d'une rubrique.

Couleur : Place dans le presse-papiers une couleur sous forme de chaîne

Commandes

Sur la gauche vous avez accès à la liste des fonctions disponibles, double-cliquez sur une pour insérer le code dans votre script

Fig. 235 Liste des foncions des scripts

Script

Le panneau du script édité est composé de 4 parties :

Fig. 236 Script en cours d'édition

1. Descriptif du script (une mini aide)

C'est aussi là que vous insérez des commandes spéciales:

#NO-SOURCE : indique que le composant ne crée pas de contenu dans le corps de votre page, il peut donc être placé dans une zone spéciale

#prop=SELTEXT : permet d'initialiser une propriété du composant avec le texte sélectionné dans l'éditeur de rubrique au moment de l'insertion du composant.

Un exemple sera plus parlant, tapez du texte dans la zone d'édition d'une rubrique, puis sélectionnez-le, le dialogue suivant s'affiche :

Fig. 237 Assistant zone édition


Cliquez alors sur un composant, au hasard qui permet d'afficher du texte en dégradé comme ceci vous verrez alors sa propriété Text remplie avec votre sélection, si vous ouvrez le script dans l'éditeur de script vous pourrez voir la commande #text=SELTEXT dans la zone de description.

Fig. 238 Commande #prop=SELTEXT

#STATIC : indique que le composant doit être exécuté dès l'insertion, il va produire directement le code dans la zone d'édition et ne sera plus exécuté par la suite.

Exemple d'un tel composant : tag-html permet d'insérer des balises HTML dans votre code, sélectionnez du texte dans la zone d'édition, puis allez sur l'onglet Html dans l'assistant qui s'affiche et cliquez sur

2. éditeur de code

3. gestionnaire de paramètres

Ajouter un paramètre Ajouter un paramètre

Fig. 239 Ajouter un paramètre

Les paramètres peuvent avoir comme type :

  • Texte
  • Liste
  • Fonte
  • Image
  • CSS
  • Couleur
  • Rubrique
  • Macro
  • signet
  • Document partagé
  • Code Source
  • Unité
  • Script
  • Base de donnée
  • gabarit
  • File

Chacun ayant un éditeur associé pour vous faciliter la tache

Fig. 240 Editeur de propriété de type string

Supprimer le paramètre Supprimer le paramètre

Aperçu du script Aperçu du script

En faisant un clic droit dans le code source vous pourrez insérer la commande de récupération du paramètre sélectionné, il s'agit en l'occurence de la fonction GetParam.

4. aperçu

Sommaire