JavaScool:DocLiensJvs

Où peut-on utiliser des liens jvs:// ?

Dans tous les fichier affichés dans le panneau de droite de Java's Cool, c'est-à-dire dans le fichier help.xml et dans tous les fichiers auxquels il faut référence.

Quand sont-ils utiles ?

Les liens jvs:// sont utiles lorsque l'aide propose à l'utilisateur d'ouvrir un nouveau fichier de code, par exemple un code d'exemple ou un exercice. Le lien jvs:// permet :

• D'ouvrir un fichier .jvs dans l'éditeur
• D'ouvrir simultanément une page web dans le navigateur intégré de Java's Cool

Ceci permet par exemple d'afficher l'énoncé de l'exercice dans la page, ou encore la documentation de l'exemple. La page web doit être spécifiée au format .htm mais il est préférable de la rédiger en .xml ([?page=developers&action=doc-xml spécifications des fichiers xml de Java's Cool]) : le fichier .xml sera converti en .htm lors de l'exécution de [?page=developers&action=doc-javascoolbuilder javascoolbuilder]. Cependant le lien jvs doit toujours référer à un fichier .html, même si ce dernier n'es créé que lors du passage dans javascoolbuilder.

Quelle est leur syntaxe ?

Voici un exemple de lien jvs :

<a href="jvs://openhtml:Orbiter.html:Orbiter,openjvs:orbiter.jvs">Ouvrir l'exemple</a>

Ce lien ouvre le fichier html "Orbiter.html" dans un nouvel onglet appellé "Orbiter", puis le fichier orbiter.jvs dans l'éditeur.

Le format d'un lien jvs est le suivant :

jvs://openhtml:FICHIER_HTML.HTML:NOM_DE_L_ONGLET,openjvs:FICHIER_JVS

Les deux parties séparées par une virgule sont optionnelles : on peut utiliser les liens suivants pour n'ouvrir qu'un fichier ou qu'un page web respectivement :

jvs://openhtml:FICHIER_HTML.HTML:NOM_DE_L_ONGLET
jvs://openjvs:FICHIER_JVS

Les fichier jvs et html doivent être dans le dossier de la proglet.