Help

!DIDEROT JMB version 0.13 (30/08/2019)

Traduction et amélioration par Rick Murray

DIDEROT :

Desktop Integrated Development Environment Risc Os Tool

(C'est aussi le nom d'un écrivain, philosophe Français qui a joué un rôle important pour l'encyclopédie pendant la période des Lumières )

Abstract:

Présentation de projet DDE sous forme arborescente dan sle sytle RISC OS.

Utilisation du module de Rick Griffin TreeView (v0.23).

Le programme sert à regrouper les fichiers et commandes pour construire un projet avec le DDE.

Les fichiers Make sont ceux du DDE en utilisant les Makefiles founis, pratique pour constuire en C/C++ , module, library, assembler et Basic.

Autres choses intéressantes :

Les fichiers de developpement sont regroupés dans une même fenêtre et avec la structure en arbre on a accès direct au contenu des classeurs ou sous classeurs.

Il y a des boutons pour lancer la compilation, installer l'application si le developpement concerne une application.

Pour une application, accès direct aux fichier Res et le fichier .h de ses composants.

L'application peut être exécutée et tuée. La fenêtre de developpement est remise au premier pla en cliquant dans celle-ci.

Une seule fenêtre pour les fichiers permet d'avoir plusieurs projets simultanés, pour faire des tests ou pour récupérer du code existant.

Attention ce n'est pas un filing system et l'effet du clic sur les icônes est différent, mais one peut pas détruire des fichiers avec !Diderot

Exemples d'utilisation avec le DDE: voir le fichier !DiderotEx

C/C++ : Exemples C exemples fournis avec le DDE, Rick Murray Blogs , Steve Fryatt programming in C et beaucoup d'autres tutroirau.....
Basic : Mouse Info (7th software) with a library,

Utiisation:

En double cliquant sur !Diderot , l'application s'installe sur l'iconbar, initulé "DevelopTool".

Glissez votre classeur de development sur l'iconbar DevelopTool. Le projet sera analyser et le texte sous l'icône de l'iconbar changera en fonction du nom du projet. Vous pouvez avoir plusieurs projets en même temps, car on peut exécuter !Diderot plusieurs fois simultanément

En cliquant sur l'iconbar cela ouvrira la fenêtre avec vue arborescente du classeur du projet.

Attention, le clic sur un nom de fichier (feuille de l'arbre) l'ouvre et le lance instantanément.

J'utilise StrongHelp, les fichiers textes sont bien empilés par ce programme et les facilités d'édition offertes par celui-ci sont connues (idem avec !Zap) . Si on re−clic sur un fichier de l'arbre et que celui-ci est déjà ouvert avec l'éditeur, celui-ci ramène au premier plan. (merci Risc Os)

Treeview (le module) affiche le nom du fichier sélectionné en inversé, et pour éviter de relancer la même commande, le fichier sélectionné doit être d'abord désélectionner avant de pouvoir être ré-utiliser. Pour ce faire cliquer avec adjust sur le nom du fichier ou cliquer sur une partie vierge de la fenêtre.

La fenêre du projet peut être refermée en cliquant sur l'icône de l'iconbar avec Adjust, en utilisant Select elle revient au premier plan devant les autres fenêtres ouvertes à sa place précédentes. En peut cliquer dans la fenêtre du projet pour ramèner la fenêtre au premier plan si celle-ci est pratiquement cachée. Il peut être nécessaire de cliquer deux fois si une des feuilles de l'arbre est sélectionnée.

Classeurs et sous classeurs:(feuilles de l'arbre)

En cliquant Select sur un classeur(ou la crois) l'arbre sera étendu montrant le contenu du classeur.
En cliquant avec Adjust il sera replié.
En cliquant Shift-Select sur un classeur celui sera ouvert dans une fenêtre du Filer.
En cliquant Ctrl-Select sur un classeur l'arbre sera ouvert complétement et on verra le contenu detous les classeurs et sous classeurs de cette branche
en accord Ctrl-Adjust refermera la branche jusqu'au n½ud.

Programmes et autres fichiers:

En cliquant Select sur un fichier exécutera le fichier de manière habituelle, les fichiers texte s'ouvriront dans l'éditeur, Html , Sprite, Res, Pdf... avec leur application respective.
MakeFile est un fichier texte, pour le faire exécuter , il faut cliquer sur bouton Make sur le panneau.
En cliquant Shift-Select ouvrira les fichiers dans StongEd( ex:TaskObey, Obey...)
Pour les ficiers en Basic cela crée, la variable sytem "ProjFileEdit" qui est utilisée par le fichier Obey "EditFile" contenu dans Diderot, vous pouvez modifier les paramètres à votre gré.
En cliquant Ctrl-Select sur un programme en Basic fera exécuter celui-ci dans !Graphtask ( qui doit avoir été vu par le filer ).
Cette action créée pour les programmes en Basic, la variable system "ProjBasicRun" qui est utilisée par le fichier Obey "OpenBasic" contenu dans !diderot Diderot. Jeter un oeil à ce fichier si vous voulez customiser les paramètres.

Customisation:

Voir ci-dessus, les fichiers OpenBasic, EditFile et Messages sont à l'intérieur du classeur de l'application !Diderot

Il y a aussi d'autres variables system:

Pour les programmes en Basic seulement: exemple: ProjBasic + filename.

Elles sont utilisées dans les variables ProjFileEdit and ProjBasicRun, la première dans EditFile pour ouvrir le programme en Basic dans l'éditeur , and la deuxième pour lancer le programme dans !GraphTask

On peut les visualiser en tapant *Show Proj*

Chaque projet à ses propres variables qui peuvent être utilisées par des fichiers obey.

Toolbar:

En chargeant le classeur, !Diderot recherche les fichiers mentionnés ci-dessous et crée la variable ProjDevname.

Si !Diderot trouve les fichiers les boutons en correspondance seront actifs.

Button	file name(défaut)	Action
Make:	Mk,	DDE compilation with Throwback.
Inst	MkInstall,	Compilation and appli=> !Instal
Run:		Execute application from !Install directory.
Res:	Res (territory ?)
Comp:	ResEventComps.h
Varg:	main.h
Rload:		Re-load the project directory in the treeview.
OFiler:		Open the filer directory.
KillT:		kill the task we are running / testing.( taskname in messages file)

ResEventComps.h ( toutes les constantes toolbox (RES) ) and main.h ( pour les variables globales du programme) sont des noms que j'utilise dans mes projets.

Diderot recherche les fichiers associés aux noms dans son fichier Messages. A customiser.

Développement de non-application

Pour les classeurs de développement n'utilisant pas la structure stantard, par exemple des programmes en mode console, si celui-ci contient un fichier nommé !Run le bouton Run sera activé et on peut donc tester le programme.

Contenu du fichier TaskObey !Run à créer :

Dir <Obey$Dir>

WimpSlot -min 4096k

!Runimage

La compilation fabrique un fichier !Runimage, si on lui demande dans le fichier Makefile par :

COMPONENT = !Runimage

Dans ce cas les fichiers à compiler sont déclarés par :

OBJS = name1 name2 .....

Pour ces applications en général il n'y a pas de classeur resources donc le bouton KillT ne fonctionnera pas.

Si on veut l'utiliser. il faut créer le classeur resources.uk et mettre in fichier message avec le nom de l'application

_Taskname:essai

(ne pas oublier le retour chariot aprés cette ligne!)

Note: Mk, MkInstall, Res, Resources directory est la structure standard du DDE pour le developpemnt d'applications. Diderot appelle les fichiers mais ne modifie rien.

Pane window:

Make:	appel du fichier Mk
MkCl:	appel du fichier MkClean
Inst:	installation de l'application dans <Install$Dir>
Run:	Lance l'application installée.
Res:	Ouvre le fichier Res dans !ResEdit
Comp:	Ouvre le fichier h.ResEventComps dans l'éditeur
VarG:	Ouvre lefichier des variables globales h.main
Rload:	Re charge le classeur de developpement dans le treeview affiche la racine.
OFiler:	Ouvre le classeur de developpement dans le Filer/gestionnaire de fichier.
KillT:	Tue la Task/Tâche comme dans Application tasks, le nom est pris dans messages

Le paramétrage des boutons se fait pendant le scan du projet lors du chargement dans !Diderot. Si certains fichiers sont manquant les boutons sont grisés. L'image ci-dessus est une copie écran du classeur de développement de !Diderot ouvert avec !Diderot...

A faire:

Trouver les ressources en fonction de Territory pour avoir de l'Anglais du Français et d'autres....