<oXygen/> User Guide

Ouvrir, sauver et fermer des documents

Comme la plupart des application d'édition, oXygen vous permet d'ouvrir des document existants, de sauver vos modifications et de les fermer comme requis.

Ouvrir des documents

Les documents peuvent être ouverts en utilisant :

  • Fichier-> Ouvrir (Ctrl+O) : Affiche le dialogue Ouvrir utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers.

  • Fichier->Réouvrir: Affiche une liste des fichiers document récemment ouverts. Sélectionner un fichier à ouvrir.

  • Ouvrir: Ouvre le fichier sélectionné dans la vue du projet.

En plus Oxygen support l'ouverture directe de fichiers depuis l'invite de la commande. Utiliser la syntaxe de commande suivante : sh ./oxygen.sh FichieràOuvrir.xml

Quand l'éditeur d'arbre est lancé, oXygen va afficher le document de la fenêtre principale.

Ouvrir et Sauver des documents distants via FTP/WebDAV

Oxygen supporte l'édition de fichiers distants, en utilisant les protocoles FTP et WebDAV. Les fichiers distants ouverts peuvent être édités exactement comme les fichiers locaux. Ils peuvent être ajoutés au projet, et peuvent faire l'objet de transformations XSL et FO.

Figure 4.5. Ouvrir le dialogue URL

Ouvrir le dialogue URL
[Note]Note

L'accès WebDAV est implémenté en utilisant le paquet Slide de la Apache Software Foundation. Cette partie est expérimentale et doit être utilisée avec précaution. La partie FTP utilise un accès passif aux serveurs FTP. Vérifiez que le serveur auquel vous essayez de vous connecter supporte les connexions passives.

Pour ouvrir des fichiers distants, choisissez "Fichier/Ouvrir URL" depuis le menu principal. Le dialogue affiché comprend trois parties.

[Note]Note

If you have set a proxy server to be used by Oxygen, make sure it supports the WebDAV protocol. If it does not, make sure you uncheck the "Use proxy server" from the Options/Preferences/Proxy Configuration pane, otherwise you will not be able to connect to a WebDAV server.

  • La première est une boîte combo éditable, dans laquelle peut être directement spécifiée l'URL où ouvrir ou sauver.

    Exemple 4.1. Les URLs qui peuvent être directement ouvertes

    Vous pouvez taper ici une URL comme http://some.site/test.xml, au cas où le fichier est accessible via un protocole HTTP normal, ou ftp://anonymous@some.site/home/test.xml si le fichier est accessible via un FTP en anonyme.

    Cette boîte combo affiche aussi la sélection actuelle quand l'utilisateur change la sélection dans l'arbre de navigation.

  • La deuxième partie contrôle les justificatifs d'accès. Si vous souhaitez chercher un fichier sur un serveur, vous devez spécifier l'utilisateur et le mot de passe. Cette information est liée à l'URL affichée dans la boîte combo "URL du fichier", et utilisée dans ouvrir/enregistrer le fichier. Si la case "Enregistrer" est sélectionnée, alors l'utilisateur et le mot de passe sont sauvés entre les sessions d'édition. Le mot de passe est encrypté par clé dans le fichier option.

    [Note]Note

    Votre mot de passe est bien protégé. Au cas où le fichier options est déplacé sur une autre installation, une autre machiine, le mot de passe deviendra illisible, car l'encryptage est dépendant de l'utilisateur et de la machine. Ceci est aussi vrai si vous ajoutez des URL ayant un utilisateur et un mot de passe à votre projet.

  • La troisième partie contient le combo serveur et la case "Autoconnecter". Dans le combo serveur il peut être spécifié le protocole (HTTP ou FTP), le nom ou l'IP du serveur et, en cas de WebDAV, le chemin du répertoire WebDAV.

    Exemple 4.2. Les URL de serveur

    Lors de l'accès à un serveur FTP, vous devez uniquement spécifier le protocole et l'hôte, comme : ftp://server.com, ftp://ftp.apache.org, ou si vous utilisez un port non-standard : ftp://server.com:7800/ etc.

    Lors de l'accès à un serveur WebDAV, en plus du protocole et de l'hôte, le répertoire du repository WebDAV doit être indiqué.

    [Important]Important

    Assurez-vous que le répertoire du repository se termine par un slash "/".

    Ex : http://devel:9090/webdav/

    En appuyant sur le bouton "Naviguer" le listing du répertoire sera affiché dans le bellow du composant. Quand "Autoconnecter" est sélectionné, à chaque fois que le dialogue est affiché, l'action de navigation sera exécutée.

  • La dernière partie consiste en une vue en arbre des documents entreposés sur le serveur. Vous pouvez naviguer dans les répertoires, et faire plusieurs sélections. En outre, vous pouvez utiliser "Renommer", "Effacer", et "Nouveau dossier" pour gérer le dépôt de fichiers.

Si vous souhaitez accéder à un dépôt WebDAV repository via un réseau peu sûr, Oxygen vous permet de charger et sauver les documents par le protocole HTTPS (si le serveur supporte ce protocole), ainsi tout échange de données avec le serveur WebDAV est encodé.

Quand un dépôt WebDAV est accéder pour la première fois via HTTPS, le serveur hébergeant le dépôt va présenter un certificat de sécurité à Oxygen comme partie du protocole HTTPS, sans intervention de l'utilisateur. Oxygen va utiliser ce certificat pour décoder tout flux de données reçu du serveur. Afin de réussir l'authentification, vous devriez vous assurer que le certificat de sécurité du serveur hébergeant le dépôt peut être lu par Oxygen. Ceci signifie que Oxygen peut trouver le certificat dans le trousseau de clés du Java Runtime Environment dans lequel il fonctionne. Vous savez que le certificat du serveur n'est pas dans le trousseau de clé du JRE si vous recevez l'erreur "No trusted certificate found" en essayant d'accéder au dépôt WebDAV :

Figure 4.6. Le certificat du serveur n'est pas disponible

Le certificat du serveur n'est pas disponible

Vous pouvez ajouter un certificat au trousseau de clés en l'exportant vers un fichier local en utilisant n'importe quel navigateur web (par ex. Internet Explorer) supportant HTTPS puis en important ce fichier dans le JRE en utilisant l'exécutable keytool livré avec le JRE. Les étapes sont les suivantes en utilisant Internet Explorer (si vous utilisez un autre navigateur, la procédure est similaire) :

Procédure 4.2. Importer un certificat de serveur HTTPS

  1. Exporter le certificat vers un fichier local

    1. Pointez votre navigateur compatible HTTPS vers l'URL du dépôt. Si c'est votre première visite sur le dépôt, un message d'alerte de sécurité expliquant que le certificat de sécurité présenté par le serveur n'est pas fiable sera affiché.

      Figure 4.7. Security alert - untrusted certificate

      Security alert - untrusted certificate
    2. Presser le bouton "Voir le certificat".

    3. Sélectionner l'onglet "Détails".

    4. Presser le bouton "Copier vers le fichier ...". Cela va lancer l'assistant d'export de certificat sous Windows

    5. Suivre les indications de l'assistant pour sauver le certificat dans un fichier local, par ex. server.cer.

  2. Importer le fichier local dans le JRE de Oxygen

    1. Ouvrir une console en mode textuel.

    2. Aller dans le sous-répertoire lib/security du répertoire du JRE, c.-à-d. le répertoire où est installé le JRE sur lequel s'appuie Oxygen, par ex. sous Windows C:\Program Files\Java\j2re1.4.2\lib\security

    3. Lancer la commande suivante :..\..\bin\keytool.exe -import -trustcacerts -file local-file.cer -keystore cacertslocal-file.cer est le fichier contenant le certificat du serveur, créé à l'étape précédante. Keytool nécessite un mot de passe avant d'ajouter un certificat au trousseau de clés du JRE. Le mot de passe par défaut est "changeit". Si le mot de passe par défaut a été changé par une personne, alors elle seule peut faire l'importation. Pour contourner ce problème, vous pouvez effacer le fichier cacerts, re-taper la commande et entrer comme mot de passe n'importe quelle combinaison d'au moins 6 caractères. Cela va régler le mot de passe pour les opérations futures avec le trousseau de clés.

  3. Relancer Oxygen

Sauver des documents

Il y a trois méthodes de sauvegarde :

  • Fichier-> Enregistrer (Ctrl+S) : Sauve le document actuel. Si le document n'a pas de fichier, affiche le dialogue "Enregistrer sous".

  • Fichier->Tout enregistrer: Sauve tous les documents ouverts. Si un document n'a pas de fichier, affiche le dialogue "Enregistrer sous".

  • Fichier->Enregistrer sous: Affiche le dialogue Enregistrer sous, utilisé pour nommer et sauver un document ouvert dans un fichier ; ou sauver un fichier existant avec un nouveau nom.

Fermer des documents

Pour fermer des documents, utiliser les méthodes suivantes :

  • Fichier-> Fermer (Ctrl+W) : Ferme uniquement l'onglet sélectionné. Tous les autres onglets restent.

  • Fichier->Tout Fermer: Ferme tous les documents ouverts. Si un document est modifié ou n'a pas de fichier, une invitation à sauver, ne pas sauver, ou annuler l'opération est affiché.

  • Fermer: Affiché lors d'un clic-droit sur un onglet. Ferme l'onglet sélectionné.

  • Fermer les autres fichiers : Affiché lors d'un clic-droit sur un onglet. Ferme tous les fichiers en dehors de l'onglet sélectionné.

  • Fermer tous les Onglets: Ferme tous les onglets ouverts à l'intérieur du panneau.