[Top] | [Table des matières] | [Index] | [ ? ] |
1. Introduction | ||
2. Installation | ||
3. Paramètrages | ||
4. Menus | ||
5. Bégaiement | ||
6. Templates | ||
7. Bugs, Aide | ||
Index | ||
Index des parametres | ||
Index des fonctions | ||
Index des touches de Stuttering | ||
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Smarty Mode est un mode permettant de simplifier l'écriture de template Smarty : coloration syntaxique, aide à l'écriture (templates), navigation à travers les fichiers sources...
Fonctionnalités (nouvelles fonctionnalités en gras) :
Ce manuel décrit Smarty Mode version 0.0.1.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
2.1 Pré-recquis | ||
2.2 Télécharger | ||
2.3 Installation/Mise à jour | ||
2.4 Invoquer le Smarty-Mode | ||
Installation | ||
---|---|---|
2.3.1 Installation | ||
2.3.2 Mise à jour |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Smarty Mode est un mode majeur de XEmacs qui nécessite les logiciels/packages suivants :
Avant de continuer vous devez donc vous assurer d'avoir tout ces packages installés.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Deux adresse internet à votre disposition pour télécharger Smarty Mode :
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
2.3.1 Installation | ||
2.3.2 Mise à jour |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Pour installer Smarty Mode vous devez choisir un répertoire d'installation (par exemple `/usr/local/share/lisp' ou `c:\lisp'). L'installateur doit avoir les droits d'écriture sur ce répertoire.
Avec votre logiciel de décompression favoris, décompressez l'archive dans le répertoire d'installation.
Exemple :
cd /usr/local/share/lisp tar zxvf smarty-0.0.1.tar.gz |
Vous devez maintenant avoir un répertoire `smarty' dans le répertoire d'installation. Ce répertoire doit contenir 2 fichiers `smarty-mode.el' et `smarty-mode.elc' ainsi qu'un répertoire `docs' contenant la documentation.
Vous devez maintenant configurer XEmacs. Ouvrez votre fichier d'initialisation `init.el' (ouvrez directement le fichier ou démarrez XEmacs puis choisissez le menu Options puis Edit Init File). Ajoutez les lignes suivantes (le répertoire d'installation dans le cas ci-dessous est `/usr/local/share/lisp') :
(setq load-path (append (list "/usr/local/share/lisp/") load-path)) (autoload 'smarty-mode "smarty-mode" "Smarty Mode" t) |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
La mise à jour est simple. Vous devez décompresser l'archive dans le répertoire d'installation afin d'effacer l'ancienne version.
Exemple :
cd /usr/local/share/lisp rm -rf smarty tar zxvf smarty-0.0.1.tar.gz |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Vous avez deux possibilités pour invoquer le Smarty Mode.
M-x smarty-mode
(setq auto-mode-alist (append '(("\\.tpl$" . smarty-mode)) auto-mode-alist)) |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Ce chapitre décrit les différents paramètres et fonctions que vous pouvez modifier pour personnaliser Smarty Mode. Pour cela, ouvrez un fichier Smarty puis cliquez sur le menu Smarty et choisissez Options puis Browse Options....
3.1 Paramètres | ||
3.2 Fonctions | ||
Paramètres | ||
---|---|---|
3.1.1 Mode | ||
3.1.2 Menu | ||
3.1.3 Template | ||
3.1.4 Divers | ||
Fonctions | ||
3.2.1 Mode |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
3.1.1 Mode | ||
3.1.2 Menu | ||
3.1.3 Template | ||
3.1.4 Divers |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Smarty Mode contient 2 modes permettant de faciliter l'écriture de tempaltes Smarty. Vous pouvez activer/désactiver chacun des modes séparément.
Type : bool
Valeur par défaut : `t'
Description : Si `t'; active la génération automatique des
templates. Si `nil'; les générateur de templates peuvent toujours être invoqués en utilisant
les raccourcis clavier et le menu. L'activation de ce mode est indiquée par "/e" après le nom
du mode et peut être modifié en utilisant `smarty-electric-mode'.
Type : bool
Valeur par défaut : `t'
Description : Si `t'; active le "bégaiement". L'activation de ce
mode est indiquée par "/s" après le nom du mode et peut être modifié en utilisant
`smarty-stutter-mode'.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Smarty Mode contient aussi 1 menu que vous pouvez activer/désactiver. Le menu Sources est spécifique à chaques fichiers Smarty ouverts.
Type : bool
Valeur par défaut : `t'
Description : Si `t'; le menu Sources est activé. Ce menu contient
la liste des fichiers Smarty contenus dans le répertoire courant. Le menu Sources scanne le répertoire
à l'ouverture du fichier.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
3.1.3.1 En-tête |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Type : chaîne de caractères
Valeur par défaut : `""
'
Description : L'en-tête à insérer dans le fichier. Si la chaîne est un fichier existant c'est le contenu du
fichier qui sera inséré sinon ce sera la chaîne.
Pour ajouter une ligne tapez C-j.
Les mots
clés suivants sont supportés :
<filename> : remplacé par le nom du fichier.
<author> : remplacé
par le nom de l'utilisateur et son adresse email.
<login> : remplacé par `user-login-name'.
<company> : remplacé par le contenu de `smarty-company-name'.
<date> : remplacé par
la date courante.
<year> : remplacé par l'année courante.
<copyright> : remplacé par le contenu
de `smarty-copyright-string'.
<cursor> : la position finale du curseur.
Type : chaîne de caractères
Valeur par défaut : `""'
Description : La fin du fichier à insérer.
Voir `smarty-file-header' pour la syntaxe.
Type : chaîne de caractères
Valeur par défaut : `""'
Description : Nom de la société.
Type : chaîne de caractères
Valeur par défaut : `""'
Description : Copyright à insérer.
Type : chaîne de caractères
Valeur par défaut : `"%Y-%m-%d"'
Description : Format de la date.
Type : chaîne de caractères
Valeur par défaut : `""'
Description : Préfixe de la date de dernière modification.
Type : bool
Valeur par défaut : `nil'
Description : Si `t'; lorsque le buffer est
sauvegardé; la date de dernière modification est mise à jour.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Type : string
Valeur par défaut : `""'
Description : Délimiteur gauche d'échapement des templates
Smarty.
Type : string
Valeur par défaut : `""'
Description : Délimiteur droit d'échapement des templates
Smarty.
Type : bool
Valeur par défaut : `t'
Description : Si `t'; la touche TAB permet d'indenter de
compléter et d'insérer des tabulations. Si `nil'; la touche TAB permet d'indenter uniquement.
Type : bool
Valeur par défaut : `t'
Description : Si `t'; active la completion
dans le minibuffer.
Type : bool
Valeur par défaut : `nil'
Description : Si `t'; la completion
est senssible à la casse des mots.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
3.2.1 Mode |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Options -> Mode -> Electric Mode
Raccourci clavier : C-c C-m C-e
Description : Cette fonction permet de d'activer/désactiver le mode de génération
automatique de template.
Menu : Smarty -> Options -> Mode -> Stutter Mode
Raccourci clavier : C-c C-m C-s
Description : Cette fonction permet de d'activer/désactiver le mode "bégaiement".
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Il y a 2 menus : Smarty et Sources. Ces menus sont accessibles depuis la barre de menu et depuis le clic droit. Ce chapitre décrit chacun des menus.
4.1 Smarty | ||
4.2 Sources |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
C'est le menu principal de Smarty Mode. Il permet un accès aux principales fonctionnalités de Smarty Mode : Templates (voir Templates) et Options (voir Paramètrages).
Ce menu contient aussi 3 fonctions détaillées dans le paragraphe suivant.
4.1.1 Fonctions |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Show Messages
Raccourci clavier : C-c M-m
Description : Cette fonction ouvre le buffer *Messages* pour afficher les messages d'erreur.
Menu : Smarty -> Smarty Mode Documentation
Raccourci clavier : C-c C-h
Description : Cette fonction ouvre le buffer *Help* et affiche la docuement de Smarty Mode (en anglais).
Menu : Smarty -> Version
Raccourci clavier : C-c C-v
Description : Cette fonction affiche dans le minibuffer la version actuelle et la date de Smarty Mode.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Le menu Sources affiche les fichiers Smarty du répertoire courant. Si vous ajoutez ou détruisez un fichier dans le répertoire courant, vous devez rafraîchir le menu.
4.2.1 Paramètres | ||
4.2.2 Fonctions |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Type : bool
Valeur par défaut : `t'
Description : Si `t'; le menu Sources est activé. Ce menu contient
la liste des fichiers Smarty contenus dans le répertoire courant. Le menu Sources scanne le répertoire
à l'ouverture du fichier.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Sources -> *Rescan*
Raccourci clavier : C-c C-s C-u
Description : Cette fonction is utilisée pour rafraîchir le menu Sources.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Le mode "Bégaiement" est un mode qui affecte un fonction à une touche du clavier. Par exemple, quand vous utilisez la touche ENTER, la fonction associée va créer une nouvelle ligne et l'indenter.
5.1 Paramètres | ||
5.2 Fonctions |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Type : bool
Valeur par défaut : `t'
Description : Si `t'; active le "bégaiement". L'activation de ce
mode est indiquée par "/s" après le nom du mode et peut être modifié en utilisant
`smarty-stutter-mode'.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Si dans un commentaire, indente le commentaire et ajoute une nouvelle ligne si besoin. Dans les autres cas, ajoute un espace.
Si le caractère précédent est `(', les `((' vont être remplacées par `['.
Si le caractère précédent est `[', les `[(' vont être remplacées par `{'.
Dans les autres cas, ajoute `('.
Si le caractère précédent est `)', the `))' vont être remplacées par `]'.
Si le caractère précédent est `]', the `])' vont être remplacées par `}'.
Dans les autres cas, ajoute `)'.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Dans le Smarty Mode, les fonctions Smarty (comme if, foreach) sont prédéfinies dans des fonctions appelées "Templates".
Chaque template peut être invoqué par le nom de la fonction ou en utilisant la touche SPACE après le nom de la fonction Smarty dans le buffer (Note, utiliser M-SPACE désactive le template).
Un template peut être annulé en utilisant C-g ou en laissant vide le prompt (dans le minibuffer).
6.1 Paramètres | ||
6.2 Fonctions |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Type : bool
Valeur par défaut : `t'
Description : Si `t'; active la génération automatique des
templates. Si `nil'; les générateur de templates peuvent toujours être invoqués en utilisant
les raccourcis clavier et le menu. L'activation de ce mode est indiquée par "/e" après le nom
du mode et peut être modifié en utilisant `smarty-electric-mode'.
Pour une description complète des paramètres des templates, voir Template
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
6.2.1 Fonctions natives | ||
6.2.2 Fonctions utilisateur | ||
6.2.3 Modificateurs de variable | ||
6.2.4 Fonctions Non-Smarty |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Templates -> Build-in Functions -> capture
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> config_load
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> else
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> elseif
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> foreach
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> foreachelse
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> if
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> include
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> include_php
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> insert
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> ldelim
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> literal
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> php
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> rdelim
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> section
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> sectionelse
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Build-in Functions -> strip
Raccourci clavier : aucun
Description :
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Templates -> Custom Functions -> assign
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> counter
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> cycle
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> debug
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> eval
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> fetch
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_checkboxes
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_image
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_options
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_radios
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_select_date
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_select_time
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> html_table
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> mailto
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> math
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> popup
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> popup_init
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Custom Functions -> textformat
Raccourci clavier : aucun
Description :
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Templates -> Variable Modifiers -> capitalize
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> cat
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> count_characters
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> count_paragraphs
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> count_sentences
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> count_words
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> date_format
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> default
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> escape
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> indent
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> lower
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> nl2br
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> regex_replace
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> replace
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> spacify
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> string_format
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> strip
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> strip_tags
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> truncate
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> upper
Raccourci clavier : aucun
Description :
Menu : Smarty -> Templates -> Variable Modifiers -> wordwrap
Raccourci clavier : aucun
Description :
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Menu : Smarty -> Templates -> Insert Header
Raccourci clavier : aucun
Description : Cette fonction est utilisée pour insérer une en-tête dans le buffer.
Menu : Smarty -> Templates -> Insert Footer
Raccourci clavier : aucun
Description : Cette fonction est utilisée pour insérer un pied de page dans le buffer.
Menu : Smarty -> Templates -> Insert Date
Raccourci clavier : aucun
Description : Cette fonction est utilisée pour insérer la date dans le buffer.
Menu : Smarty -> Templates -> Modify Date
Raccourci clavier : aucun
Description : Cette fonction est utilisée pour modifier la date de dernière modification dans le buffer.
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Aller à: | A B D E F M P T |
---|
Aller à: | A B D E F M P T |
---|
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Aller à: | S |
---|
Aller à: | S |
---|
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Aller à: | S |
---|
Aller à: | S |
---|
[ < ] | [ > ] | [ << ] | [Plus haut] | [ >> ] | [Top] | [Table des matières] | [Index] | [ ? ] |
Aller à: | (
)
S |
---|
Entrée d'index | Section | |
---|---|---|
| ||
( | ||
( | 5.2 Fonctions | |
| ||
) | ||
) | 5.2 Fonctions | |
| ||
S | ||
SPACE | 5.2 Fonctions | |
|
Aller à: | (
)
S |
---|
[Top] | [Table des matières] | [Index] | [ ? ] |
[Top] | [Table des matières] | [Index] | [ ? ] |
[Top] | [Table des matières] | [Index] | [ ? ] |
Ce document a été généré par Vincent DEBOUT le 12 Novembre 2006 en utilisant texi2html 1.76.
Les boutons de navigation ont la signification suivante :
Bouton | Nom | Aller à | Depuis 1.2.3 aller à |
---|---|---|---|
[ < ] | Back | section précédente dans l'ordre de lecture | 1.2.2 |
[ > ] | Forward | section suivante dans l'ordre de lecture | 1.2.4 |
[ << ] | FastBack | début de ce chapitre ou chapitre précédent | 1 |
[Plus haut] | Up | section supérieure | 1.2 |
[ >> ] | FastForward | chapitre suivant | 2 |
[Top] | Top | couverture (top) du document | |
[Table des matières] | Contents | table des matières | |
[Index] | Index | index | |
[ ? ] | About | à propos (page d'aide) |
Dans cet exemple on est à Sous section un-deux-trois dans un document dont la structure est :
Ce document a été généré par Vincent DEBOUT le 12 Novembre 2006 en utilisant texi2html 1.76.