Accueil
Club Emploi Blogs   TV   Dév. Web PHP XML Python Autres 2D-3D-Jeux Sécurité Windows Linux PC Mac
Accueil Conception Java DotNET Visual Basic  C  C++ Delphi Eclipse MS-Office SQL & SGBD Oracle  4D  Business Intelligence

Integrer l'aide javascript dans notepad++ souw windows

Par S.K. MARTIN (Spacefrog Land)
 

Ce petit article est à l'attention de tous ceux qui utilisent l'EDI notepad++ sous windows pour créer leur code javascript.
Lequel d'entre vous n'a jamais été arrété dans son élan, bloqué par un trou de mémoire sur l'utilisation exacte d'une fonction ?
Il y a bien les aides en ligne...
Je vous propose ici de voir comment lier directement un fichier d'aide à votre EDI préféré. Il suffira alors de selectionner la fonction dans le code et de taper alt+une touche F pour vous accèderez directement à la page d'aide sur la fonction.



Introdution. Prérequis

Je ne vais pas ici dissequer l'éditeur de code notepad++, mais simplement vous montrer comment interger un fichier d'aide, et en l'occurence celui de javascript.
Prérequis:

- il faut bien entendu avoir installé notepad++, vous le trouverez ici
- indispensable également le fichier d'aide au format chm, une simple recherche sur google vous permettra de choisir le vôtre. (j'ai choisi celui- )


Etape_1. le fichier CHM

Wikipédia vous fera un bien meilleur topo que moi sur ce qu'est un fichier CHM sur cette page
Pour simplifier il s'agit d'un bibliothèque d'aide.
Une fois le fichier zip téléchargé, dézippez le dans un repertoire. Par exemple créez un repertoire C:/CHM/ dans lequel vous pourrez placer d'autres fichiers chm pour d'autres langages.
Vous en avez terminé avec l'installation du fichier .chm, passons maintenant à notepad++.


Etape_2. Paramètrage de l'EDI Notepad++

Ouvrez Notepad++ et cliquez sur Execution:




Puis sur Exécuter:



Une boite de dialogue s'ouvrira :



Cette boite de dialogue permet de lancer des programmes tiers avec paramètres.
Nous allons donc utiliser cette fonctionalité de notepad++ pour lancer une instance de hh.exe, petit utilitaire de windows qui affiche les aides.
Pour ce faire il suffit de taper la ligne de commande suivante:

				hh.exe
				"c:\CHM\javascript.chm::/jsref_.$(CURRENT_WORD).html"
			
Notez le chemin vers le reprtoire CHM. SI vous avez dézippé votre fichier CHM ailleurs, modifiez le chemin en concéquence.

Penchons nous d'un peu plus près sur cette ligne de commande:
Comme vu plus haut hh.exe permet d'ouvrir le fichier chm en y adjoignant des paramètres.
Il m'a tout d'abord fallu trouver le nommage spécifique des pages dans le fichiers chm. Ces pages sont en fait des fichiers html compressés. Il suffit pour cela de doucble cliquer sur l'icone du fichier chm pour l'ouvrir et rechercher une instruction au hasard.
J'ai entré "split" dans l'onglet recherche et selectionné "methode split". Cela affiche la page d'aide sur la focntion split de javascript.
En cliquant sur la page d'aide avec le bouton droit de la souris on peut accéder aux propriétés de la page affichée:



On clique sur proriétés, ce qui affiche une fenêtre de ce type :



Où l'on voit clairement :
javascript.chm::/jsref_split.htm
Voilà donc le format d'instruction pour arriver su la page désirée. Il n'est alors pas difficile de penser que toutes les autres pages sont appelées de la même façon :
jsref_ + nom de la fonction.
Notepad++ dispose de ce que l'on appellera des variables internes qui permettent par exemple de mettre la main sur le mot selectioné dans la page: $(CURRENT_WORD)
Il n'est alors plus très compliqué de concaténer tout cela de façon à l'automatiser, ce qui nous donne la ligne de commande au dessus.
En collant la ligne de commande ainsi concaténée dans la boite de dialogue "Exécuter" de Notepad++ vous accéderez directement à la page d'aide de l'instruction selectionnée sur la page.

Nous savons dons maintenant comment ouvrir une page d'aide javascript concernant le mot selectionné de la page, voyons maintenant comment automatiser la chose de sorte à ne pas avoir à retaper cette ligne de commande à chaque fois.
Vous avez sans doute remarqué que la boite de dialogue "Exécuter" de Notepad++ comportait un bouton enregistrer. Voilà qui va nous permettre de sauvegarder cette action et lui attribuer une combinaison de touches de raccourci.
Une fois l'instruction collée dasn la zone de saisie, cliquez sur "Enregistrez".
Nommez ce raccourci par exemple "Adie Javascript"
choississez la combinaison de touches que vous souahitez lui attribuer, de préférence une combinaise disponible. J'ai choisi pour ma part ALT+F7.
Puis enregistrez votre raccourci.
Apparaitra alors dans le menu Executer votre nouveau raccourci !!!
En cas d'erreur, vous pourrez toujours supprimer ce raccourcis par le menu Paramètrage/Gestion des raccourcis => onglet Run Commands.
En cliquant avec le bouton droit de la souris sur le raccourci dans la liste, vous pourrez le modifier ou le supprimer.


Etape_3. Utilisation de l'aide Javascript. Mise en pratique

Il est temp de tester si votre installation de l'aide javascript s'est déroulée correctement
Ouvrez une page contenant du code javascript avec Notepad++, ou tapez simpelemnt une instruction javascript sur une page blanche.
Séléctionnez un mot du langauge javascript sur la page.
Il existe deux façon d'accéder à l'aide javascript sur le mot sélectionné:
- Cliquez dasn la barre de menu sur Executer/Aide Javascript.
- Taper directent votre combainaison de touches pour le raccourci (ALF+F pour moi).

Si vous avez correctement suivi les instructions, vous verrez apparaitre une fenêtre d'aide concernant le mot sélectionné.



Conclusion. Limites est mises en garde

Vous disposez maintenant d'un outil qui vous permet de trouver hors ligne une aide détaillée sur la syntaxe javascript.
Toutefois, il est a prendre en considération certaines limites à cette installation:
Les fichiers chm sont en général assez imposants, cleui proposé dans cet article est une version "pocket" allégée, il ne fait que 250 Ko. Privilégiez des versions allégées pour ne pas encombrer inutilmement votre disque (ou clef pour une installation portable).
si vous vous ne trouvez pas de version allégée, il vous est possible de faire le même type de raccourci vers une aide en ligne. Il suffit pour cela de taoer dasn la boite de dialogue executer le lien concaténé vers le site d'aide avec en paramètre le mot sélectionné. Cela vous libèrera de l'espace disque, masi vous obligear a avoir une connection internet.
On peut donc dire que l'avantage de ce système est de pouvoir bénéficier de l'aide hors ligne.

Attention tous les fichiers d'aide ne peuvent pas être interrogés directement en passant le mot selectionné en paramètre de commande. Je rencontre actuiellemetn quelque difficultés à implémenter ce système avec un fichier chm d'aide php. En effet les pages des fonctions php comprenant des underscores (par exemple file_get_contents) sont nommées avec des tirets - au lieu des underscores : function.file-get-contents.html
Il n'est donc pas possible de concaténer directeemtn la ligne de commande à partie du mot sélectionné. Je n'ai pas encore trouvé de méthode me permettrant de remplacer les underscores par des tiresty dasn la variable $(CURRENT_WORD) de la ligne de commande.
Si vous trouvez la solution, faites moi signes ! Je ne manquerais pas de compléter cet article en conséquence.



Copyright ©2009 S.K. MARTIN. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.

Vos questions techniques : forum d'entraide Accueil - Publiez vos articles, tutoriels, cours et rejoignez-nous dans l'équipe de rédaction du club d'entraide des développeurs francophones. Nous contacter - Copyright 2000..2005 www.developpez.com