English

OpenCTags est un add-on pour éditeurs des codes, simples, comme Crimson Editor, EditPlus 2, UltraEdit or (nouveau) Notepad++.

NOUVEAU - OpenCTags pour Notepad++ disponible 

-

Microsoft Winsows (XP de préférence) comme système d'exploitation.

-

Un éditeur de code comme Crimson Editor, EditPlus, UltraEdit or Notepad++. Je vais l'adapter sur d'autre éditeurs quand je saurez ce que les gens préfèrent. N'importe quel éditeur qui accepte des outils externes pourra être utilisé.

-

Vous aurez besoin de Exuberant CTags pour générer le fichier tags.

Installation pour Notepad ++:

Téléchargez et installez Exuberant CTags si vous ne l'utilisez pas déjà. Il faut copier le fichier ctags.exe dans le répertoire plugins de l'installation Notepad++ (ex. C:\Program Files\Notepad++\plugins)

Vous devez telecharger et desarchiver le fichier OpenCTagsForNpp-binW32.zip dans le répertoire plugins de l'installation de Notepad++.

Vérifiez que les fichiers ctags.exe et OpenCTagsForNpp.dll sont bien dans ce répertoire plugins.

Installation pour Crimson Editor, EditPlus ou UltraEdit :

Téléchargez et installez Exuberant CTags si vous ne l'utilisez pas déjà.

Vous devez telecharger et desarchiver le fichier OpenCTags-binW32.zip où vous voulez.

Configuration pour Notepad++:

Après l'installation de OpenCTagsForNpp comme decrite plus haut, il faut juste redemarrer Notepad++. C'est tout.

Configuration pour Crimson Editor:

-

Choisisez Tools->Configure User Tools;

-

Menu Text: OpenCTags

-

Command: <<Chemin de OpenCTags>>\OpenCTags.exe

-

Argument: $(CurrWord) -e crimson -f $(FilePath) -l $(LineNum)

-

Initial dir: $(FileDir)

-

Hot key : ce que vous préférez

-

Cochez la case "Close on exit" et décochez tous les autres;

Pour faire Précédent ou Suivant, même procédure, avec ces modifications :

-

Menu Text : OpenCTags Prec. (ou Suiv)

-

Argument : -e crimson -f $(FilePath) -l $(LineNum) -a p (ou n pour Suivant)

Configuration pour EditPlus:

-

Choisisez Tools->Configure User Tools->Add Tool;

-

Menu Text: OpenCTags

-

Command: <<Chemin de OpenCTags>>\OpenCTags.exe

-

Argument: $(CurWord) -e editplus -sel $(CurSel) -f $(FilePath) -l $(CurLine)

-

Initial directory: $(FileDir)

-

Cochez la case "Close on exit" et décochez tous les autres;

Pour faire Précédent ou Suivant, même procédure, avec ces modifications :

-

Menu Text : OpenCTags Prec. (ou Suiv)

-

Argument : -e editplus -f $(FilePath) -l $(CurLine) -a p (ou n pour Suivant)

Configuration pour UltraEdit:

-

Choisisez Advanced->Tool Configuration

-

Ligne de commande : <<Chemin de OpenCTags>>\OpenCTags.exe -e uedit -sel %sel% -f %F -l %line%

-

Répertoire de travail : %P

-

Nom de l'élément de menu : OpenCTags

-

Cochez la case Vérifier si c'est un programme Windows;

Pour faire Précédent ou Suivant, même procédure, avec ces modifications :

-

Nom de l'élément de menu : OpenCTags Prec. (ou Suiv)

-

Ligne de commande : <<Chemin de OpenCTags>>\OpenCTags.exe -e uedit -f %F -l %line% -a p (ou n pour Suivant)

Utilisation d'OpenCTags avec Notepad++

Alt + SPACEBAR

pour ouvrir un la liste des mots clés qui commence avec le mot en cours.
Une fois le mot clé trouvé, vous pouvez taper :
- SPACEBAR pour naviguer à la définition du mot clé;
- ENTREE pour compléter le mot clé;
- ESC pour fermer la fenêtre.

Alt + P

pour naviguer à l'endroit où vous étiez juste avant avoir naviguer avec OpenCTags.

Alt + N

pour naviguer à la position suivante.

Alt + C

pour génerer ou ré-génerer le fichier tags. Au faite, c'est un raccourci pour le lancement de ctags.exe. Si un fichier tags n'est pas trouvé dans le répertoires parent du répertoire courant, une boîte de dialogue s'ouvre qui vous permet de choisir l'emplacement du fichier tags. Géneralement c'est la racine de votre projet. Vous pouvez annuler la géneration du fichier tags avec un click sur le bouton Cancel à coté de la barre de progression qui vient de s'ouvrir. Pendant la géneration du fichier tags, vous pouvez travailler normalement.

Utilisation d'OpenCTags avec Crimson Editor, EditPlus or UltraEdit

Si vous n'êtes pas habitués avec CTags, faite comme suit :

-

Ouvrez l'invité de commandes et allez au répertoire racine de votre projet;

-

Tapez <<Chemin d'installation de CTags>>\ctags.exe -R *

C'est tout. Cela doit créer un fichier nommé "tags" dans le répertoire racine de votre projet.

Une alternative peut être de configurer un outil (user tool) dans l'éditeur pour ctags. Pour Crimson Editor cela pourrait être comme suit :

-

Choisissez Tools->Configure User Tools;

-

Menu Text: ctags

-

Command: <<Chemin d'installation d'Exuberant CTags>>\ctags.exe

-

Argument: -R *

-

Initial dir: <<le répertoire racine de votre projet>>

-

Hot key : comme bon vous semble

-

Cochez la the case "Capture output" et décochez les autres;

Une fois que vous ouvrez un fichier dans l'éditeur, vous appuyez sur le raccourci que vous avez configuré pour OpenCTags (d'habitude Ctrl+1). Une petite fenêtre va s'ouvrir au centre de l'écran. Si vous avez sélectionné un mot dans l'éditeur ou si le curseur était sur un mot (ce qui marche seulement avec Crimson et EditPlus), ce mot apparaîtra dans la case au dessus et en dessous vous aurez la liste des mots clé qui commencent avec le mots au dessus.

Après que vous sélectionnez le mot clé qui vous intéresse, appuyez sur la touche TAB si vous voulez une complétion automatique ou sur la barre d'espace pour ouvrir le fichier qui contient la définition de ce mot clé, avec le curseur positionné exactement à l'endroit de la définition.

Si vous régénérer le fichier tags au cours de l'utilisation, OpenCTags va re-charger automatiquement ce fichier.

Licence :

Ce add-on est distribué sous the GNU General Public License (GPL)

Pour tout suggestion vous pouvez ecrire au Forum OpenCTags ou m'envoyer un e-mail Romeo JUNCU.