Blog-a-Styx

Tiens tiens... Il semblerait que MS s'intéresse au développement d'un IDE light, vu qu'il est question d'embaucher quelqu'un pour un projet pouvant être décrit comme un "Emacs.net".

Affaire à suivre.

Le titre pourrait laisser penser que je ne connais pas la doc xml déjà proposée par C#, qui permet, par l'intermédiaire des balises <see /> de faire des liens vers des membres.

Non, là je souhaiterai parler d'un nouvel AddIn, HyperAddin, qui permet, dans des commentaire classiques, d'insérer des liens vers d'autres membres directement utilisables depuis Visual Studio.

La syntaxe est relativement simple, comme expliqué dans ce billet : il suffit de précéder le nom du membre recherché par le mot clé "code:".

// Comportement similaire à celui codé dans la méthode code:AutreClasse::Unlock.

Il est aussi possible de créer un lien en commentaire à l'aide d'un #, comme en html

// #exemple

//

// Pour faire un lien, il suffit d'utiliser code:#exemple

Si vous souhaitez référencer un lien nommé d'un autre fichier source, il vous faudra préfixer le nom du lien par le nom d'une classe se trouvant dans le même fichier source.

Je teste ça de suite.

Le problème des applications et de leurs fichiers ressources est que bien souvent, on souhaiterait que d'autres personnes puissent les modifier. Que ce soit pour corriger des fautes ou modifier la tournure de certaines phrases, voir tout simplement pour traduire l'application.

Comment, donc, permettre à une autre personne de travailler sur cet aspect, sans qu'il ne soit nécessaire de le former à visual studio et toutes les subtilités des fichiers de ressources ?

Je vais faire un petit topo ici des outils que j'ai découverts, étant donné que j'en ai trouvé un de plus aujourd'hui encore, et qu'il me semble être temps de les noter quelque part.

Les éditeurs ResX autonomes

Il s'agit là de simplement permettre d'éditer les fichiers de ressources sans devoir passer par Visual Studio. L'outil "de base" donc pour simplifier le travail d'édition.

• Resourcer, créé par Ludz Roeder, le créateur de Reflector. Il permet d'éditer les fichiers .resx et .resources (texte et images). Plutôt orienté développeur.
• Resx Editor, un autre outil dans la même veine, disponible en français mais ne gèrant pas les resources autres que les chaînes.
• ResEx, un outil qui semble être le plus abouti, plus particulièrement ciblé sur la traduction de resources. Il permet notamment de travailler en mode "side-by-side" entre le fichier en langue originale et la version traduite. Il ajoute des contrôles sur les chaînes formattées (contrôle la présence des {0} dans la version traduite). Celui que je conseillerai le plus à une personne n'était pas développeur.

Les outils pour Visual Studio

• ResX File Public Code Generator. Il s'agit d'un custom tool qui permet de générer des classes de ressources publiques, au contraire du custom tool de base qui ne génère que des classes internes. Il est ainsi possible d'avoir un .resx dont les ressources seront ensuite accessible depuis d'autres librairies.
• Resources Refactoring Tool. Un petit AddIn pour visual studio pour permettre d'extraire une chaîne de caractère de votre code directement dans une resource, en remplaçant les autres occurances dans votre projet par cette ressource. Pratique pour repasser derrière du code mal écrit.

Les autres outils (conversion, import/export)

• Resx To Word est un autre outil de la même société que Resx Editor (PeopleWords) qui permet de transformer un .resx en fichier word, et inversement. Je ne l'ai pas testé personnellement.
• ResX To Xls (la découverte du jour) permet, lui, d'exporter tous les fichiers ressources d'un projet dans un fichier excel. Le gros avantage est qu'il rassemble tous les fichiers .resx d'un projet dans un seul fichier excel. Il permet ensuite de mettre à jour les fichiers .resx à partir du fichier excel. A tester absolument.

Si vous connaissez d'autres outils, n'hésitez-pas à m'en faire part.

Je viens de voir passer ce site sur le blog d'améthyste, et j'y ai trouvé quelques outils sympas que je recommande à tout utilisateur de VS.

Je pense au regex visualizer par exemple, qui plaira sûrement beaucoup à vko :p 

Sinon, une astuce qui m'a beaucoup plu et que je ne connaissais pas :

Projet et solution/Général, dans le menu des options : On peut activer le pointeur dans l'explorateur de projet pour qu'il se synchronise avec le fichier ouvert dans un projet ASP (Suivre un élément actif dans l'explorateur de solution)

Aaah, mon dieu, je viens d’apprendre quelque chose que je reprochais pourtant à Visual Studio depuis des mois (Eclipse le permet), pensant même que seul ReSharper permettait de le faire : L’insertion automatique des clauses using manquantes.

J’avais déjà découvert les joies du Shift+Alt+F10 lors de l’ajout d’une interface pour faire directement s’afficher le menu proposant d’implémenter l’interface, je viens de découvrir que la même chose sur une classe dont le namespace n’est pas inclus (signalé par un petit rectangle rouge sous la dernière lettre), permettait de l’ajouter automatiquement. Et là aussi, le raccourci magique permet d’afficher le menu.

Conclusion : tapez FileStream, puis Shift+Alt+F10, puis entrée, et voilà ! votre clause using a été ajoutée.

C’était ma minute gain de productivité.

Edit : A priori Ctrl + ; marche aussi.