Fichier LisezMoi pour TreeLine

TreeLine requiert les programmes et librairies suivants:

En utilisant les fichiers fournis avec le programme d'installation, TreeLine doit fonctionner sur tout ordinateur utilisant le système d'exploitation Win 95, 98, NT, 2000, XP ou Vista.

Exécuter tout simplement le fichier d'installation TreeLine (treeline-x.x.x-install.exe). Cela va installer le programme et ses librairie, et optionnellement créer les associations de fichiers et les raccourcis.

Introduction

Modèles

Lorsque vous créer un nouveau fichier , la boîte de dialogue vous donne le choix des noeuds entre une seule ligne de texte ou un long texte .Le modèle "une seule ligne" ne comporte qu'un noeud titre , tandis qu'un long texte comporte un titre et de multiple champ de texte pour chaque noeud . Pour un long texte , vous pouvez aussi choisir entre un texte plein , qui garde les sauts à la ligne, et le texte de type HTML , qui permet des formatages plus complexe

Il y a encore plusieurs options spécifiques , incluant des modèle pour la gestion de contacts personnelles , une liste de livre et une liste de tâches

Example de fichiers

Divers exemples de fichiers peuvent être ouvert en utilisant la commande "Fichier->Ouvrir Exemple" . Cela inclue (par ordre de complexité croissante ) :

Vue du panneau de gauche

Vues

Commandes

La plupart des commandes du menu et des barres d'outils s'appliquent aux éléments sélectionnés dans la vue de gauche (en arborescence ) . En général, elles exécutent une opération sur les noeuds eux-mêmes ou sur les descendants de ces noeuds. Plusieurs noeuds peuvent être sélectionnés en même temps en appuyant sur "Ctrl" et "Touche-Majuscule" (Shift) tout en cliquant avec la souris. Mais quelques commandes, telles que "Fichier->Exporter" et "Fichier->Imprimer", concernent seulement le node actif, qui est celui qui est entouré d'un rectangle .

Pour ajouter une nouvelle information au document TreeLine, utiliser la commande "Editer->Ajouter Fils" pour créer un nouveau noeud. Et une combinaison des commandes d'ajout et d'insertion peut être utilisée pour les noeuds additionels. Par ailleurs, les titres de nouveaux noeuds peuvent être tapés dans le volet de droite "Liste des Titres".

Raccourcis Clavier

Il existe plusieurs touches du clavier qui peuvent être utilisées pour la navigation dans l'arbre. Les flêches vers le haut et vers le bas déplacent la sélection dans cette direction. Les flêches vers la gauche et vers la droite ouvrent et ferment le node actif. En maintenant la touche CTRL appuyée avec les flêches vers le haut et vers le bas on déplace la sélection entre les frères, sans s'arrêter aux fils. La touche CTRL avec la touche "U" déplace la sélection vers l'item parent. Les touches "Accueil", "Fin", "Page Haut" et "Page Bas" peuvent être utilisées pour se déplacer rapidement. En maintenant la touche SHIFT appuyée avec la touche "Page Haut" et "Page Bas" on fait défiler dans la vue de droite, les fils.

Toutes ces touches, ainsi que les raccourcis associés aux menus, peuvent être personnalisés via la commande "Outils->Paramètres Raccourcis claviers" L'éditeur de raccourcis possède des onglets pour les éléments du menu et ceux qui ne sont pas dans le menu . Tapez simplement la nouvelle séquence dans le champ approprié

Une autre façon de se déplacer est de taper la première lettre du titre d'un noeud visible. Une lettre majuscule déplace vers le haut, une lettre minuscule vers le bas. En appuyant à nouveau sur la même lettre on se déplace vers l'occurence suivante.

Sélection

De multiples noeuds peuvent sélectionnés en gardant enfoncé la touche CTRL ou SHIFT lors du changement de noeud . Les noeuds individuelle peuvent être ajouté our retiré de la selection tant que la touche CTRL ou SHIFT est maintenu. La sélection de tous les noeuds entre les anciens et les nouveaux noeuds actifs peuvent se repositionnés tant que la touche SHIFT est maintenu. Le noeud actif peut être changé en utilisant la souris ou en utilisant n'importe quel méthode de navigation via le clavier .

La commande "Affichage-> Sélection précédente" et "Affichage >Sélection suivante " peut être utilisé pour se positionné plus rapidement à travers l'historique des sélections dans l'arborescence

Par défaut ,la séquence de sélection n'importe pas . Néanmoins , si dans les options générales la sélection multiples est changé en "Ordre de Sélection" , les noeuds sélectionnés avec la touche CTRL maintenu seront affichés dans l'ordre de selection .

Recherche

Il existe deux manières de rechercher des nodes. Ces méthodes permettent de retrouver des nodes profondément enfouis dans la structure de l'arbre. La première est la commande "Outils->Chercher". Les mots clés peuvent être entrés dans la boîte de dialogue. Un node est trouvé quand les mots clés correspondent dans un des éléments du node. La méthodes suivante est une méthode de recherche incrémentale. Taper "/" suivi de la chaîne de caractères à chercher. La recherche va se dérouler pendant que les caractères sont entrés. La recherche incrémentale concerne seulement les titres de node. La recherche précédente peut être réitérée avec la touche "F3" et en arrière avec les touches "Touche Majuscule-F3".

Par défaut, les nodes parents sont automatiquement ouverts puis fermés quand ils sont trouvés avec les méthodes de recherche, ou bien lorsque l'on tape la première lettre du node, et avec la commande "frère suivant". Ce comportement peut être désactivé dans "Outils->Options Générales".

Menu Editer

Les commandes dans le menu "Editer" (à part annuler et rétablir) opèrent sur les nodes sélectionnés dans la vue de gauche. Les commandes couper, copier et coller peuvent aussi être considérées comme une exception à cette règle, puisqu'elles opèrent sur la vue de droite quand l'objet sélectionné s'y trouve. Et n'oubliez pas que, en général, les descendants des nodes sélectionnés sont aussi affectés par ces commandes.

Coller ajoute les nodes copiés à la fin de la liste des fils du node actif. Si plus d'un noeud est sélectionné , les copies seront ajoutées en dessous de chaque noeud sélectionné. Par ailleurs, la commande "Editer->Copier Texte du Node" renomme en fait la sélection en se basant sur le premier node qui se trouve dans le presse-papiers.

Raccourcis

Il existe plusieurs raccourcis utilisables pour éditer l'arbre. Glisser-déposer déplace ou copie des nodes qui deviennent des fils du node de destination. Cliquer sur un node permet de le renommer. Appuyer sur la touche entrée insère un nouveau node, et appuyer sur la touche "Suppr" supprime les nodes sélectionnés. Si on le souhaite, ces raccourcis peuvent être désactivés dans "Outils->Options Générales".

Vues de droite

Vérification Orthographique

Configuration des Nodes à un Type

Par défaut, un nouveau document TreeLine contient deux typesde node: "RACINE" et "DEFAUT". Le nom du type est affiché au sommet de chaque node dans le volet "Editeur de Données" de la vue de droite. La création de nouveaux types de données et la personnalisation des ces types est décrite ci-dessous. Pour configurer un node avec un type donné, utiliser le menu "Données->Configurer le Type du Node". Par ailleurs, pour configurer un ensemble de nodes fils et descendants avec un type donné, utiliser la commande "Données->Configurer le Type des Descendants". La boîte de dialogue qui s'affiche alors permet de configurer les nodes sélectionnés, leurs fils, tous les descendants, ou encore les descendants satisfaisant à une expression logique. Cette boîte de dialogue peut être laissée ouverte tout en modifiant la sélection des nodes dans l'arbre pour en ajouter d'autres par exemple.

Listes des types

La liste des types est le premier onglet de la boite de dialogue "Données ->Paramètres du types de données" . La liste des types de données peuvent être modifié par les boutons de droites . De nouveaux types peuvent être ajoutés, et les types existant peuvent être copiés , renommés ou supprimés

Configuration du type

"Configuration du type" est le deuxième onglet de la boite de dialogue "Données ->Paramètres du types de données" . Il contient une selection par défaut des types de données enfants . Si le paramètre est mis sur "[Aucun]" , les enfants par défaut auront le types soit de leurs frères soit de leurs parents

Le bouton "Modifier l'icone" permet la sélection d'une icone personnalisé pour le type de données. Le bouton "Effacé la sélection" de la boite de dialogue de l'icone peut être utilisé pour mettre la valeur de l'icone à "[Aucun]" . Ainsi aucune icones ne sera affiché pour ce type . Pour n'afficher aucune icone dans l'arborescence , vous pouvez décochez l'option "Afficher les icones dans le volets d'exploration" du menu Outils -> Options Générales ...

Liste des champs

"Liste des champs" est le troisième onglet de "Données ->Paramètres du types de données" , La liste des champs avec un type de données peut être modifié en utilisant les boutons de droites. De nouveaux champs peuvent être ajoutés , les champs existant montés et descendus dans la liste , renommés ou supprimés

Configurations des champs

Sortie

Format du Titre

Quand un noeud est renommé, le programme tente de faire correspondre le nouveau titre avec le champ correspondant pour mettre à jour les éléments qui le constitue. Si le format du titre est trop complexe, il peut ne pas avoir correctement deviné vos intentions. Des choses telles que des champs adjacents sans aucun caratère pour les séparer doivent être évitées à moins que vous n'ayez pas l'intention de renommer les titres de noeuds à partir de l'arbre.

Lorsque l'élément texte utilisé pour le titre comporte plusieurs lignes, seule la première ligne est utilisée pour le titre.

Lignes ignorées

Lorsqu'une ligne du format de données comporte un ou plusieurs champs et que tous ces champs pour un noeud donné sont vides, alors la ligne est ignorée. Aucune ligne, même vide ne sera affichée correspondant à cette ligne. Notez que cela ne s'applique pas à une ligne ne comportant aucun champ (avec du texte seul). De même, quand une ligne se termine avec la balise <br/> ou <hr/> et si la ligne est ignorée, la balise est néanmoins conservée.

Balises HTML

Les balises HTML simples peuvent être utilisées dans le format de données. Les balises courantes comprennent "<b>gras</b>", "<u>sous-ligné</u>", "retour chariot<br/>", "<hr/>trait horizontal", et diverses balises de police. Les balises complexes doivent être en général évitées. Quand l'option de fichier "Autoriser HTML dans les formats" est désactivée, les balises sont traitées comme du texte ordinaire. Pour des exemples de ces champs, voir le fichier "sample_color_items" (en utilisant la commande "Fichier->Ouvrir Exemple").

; Un retour chariot est automatiquement généré à la fin de chaque ligne, à moins que l'option de fichier "Ajouter des retour chariot après chaque ligne" ait été désactivée. De plus, l'option de fichier "Ajouter des lignes vides entre les noeuds" détermine si une ligne blanche est ajoutée entre chaque ligne. Une balise retour chariot ("<br>") peut être ajoutée à la fin du format pour obtenir le même effet, ou encore, un trait horizontal ("<hr>") peut être utilisé pour séparer les noeuds.

Exemples de formats

Références d'Autres Eléments

Les références qui ne sont pas contenu dans les noeuds peuvent être ajoutés à la sortie. En appuyant sur le bouton " Montrer les options avancés " qui est dans l'onglet "Sortie" de la boîte de dialogue rend visible les niveaux de référence pouvant être sélectionné.

Si le niveau de référence est changé en "Référence du Fichier " , les champs contenant des méta-données peuvent être ajouté à la sortie . Cela inclues le nom du fichier , le chemin d'accès , la taille , la date de la dernière modification. Ceux ci sont montré dans "{*?nom_champ*}" dans le titre et l'editeur de format de sortie. Les champs de références au divers noeuds ancêtres (parents , grands parents , etc ... ) nécessite que les types de données de la référence soit spécifié . Ces sélection détermine le nom du champ qui sont disponible , mais les données de n'importe quel type ayant un nom de champ compatible sera visualisé en sortie. Les références aux champs des noeuds parents et grand-parents sont représentées comme "{**nom_champ*}" et "{***nom_champ*}", respectivement. Il existe aussi des références générales à des champs de noeuds ancêtres, représentées comme "{*?nom_champ*}", et qui référencent les données du noeud ancêtre ayant un champ du même type.

Des références aux noeuds fils peuvent aussi être ajoutées . Cela nécessite que les types de données fils soit spécifié. Les données fils s'intègre dans la sortie parent. Les données enfants sont délimité par un caractère de séparation qui est définie comme une options de fichier . Le séparateurs par défaut est la virgule , et l'espace , mais d'autres peuvent être configurés en <br> ou n'importe quel autre.

Finalement , une référence "Nombre d'enfant" peut être ajouté. Ce champ va montrer le nombre d'enfant (champ "de niveau 1") ou d'arrière petits enfants (champ "de niveau 2") d'un noeud. Cela permet de visualiser {*#Niveau1*} dans l'editeur de format Pour des exemples de ces champs, voir le fichier "sample_other_fields" (en utilisant la commande "Fichier->Ouvrir Exemple").

Configuration Avancée

Le bouton "Montrer les options avancé" de l'onglet "configuration du type" fournit des possibilités de configuration supplémentaires. La première permet de choisir l'un des champs comme champ de référence, qui est utilisée pour les commandes organiser et aplatir par références et également pour les références de liens internes. Par défaut le champ de référence est le premier élément.

La boîte de dialogue permet aussi la configuration des balises préfixe et suffixe de frères. Ces balises peuvent le plus souvent être laissées vides, mais sont utiles pour créer des tableaux et des listes. Ces balises seront placées avant et après les groupes de frères du type approprié. Par exemple, pour créer un tableau, la balise préfixe pourrait être "<table border="1">" et le suffixe "</table>". Ensuite, le format de données pourrait être:

<tr><td>"{*Titre*}"</td><td>(c) {*Copyright*}</td></tr>

Voir également le fichier exemple "sample_table_booklist" (en utilisant la commande "Fichier->Ouvrir Exemple").

Les frères devraient généralement être du même type, ou au moins avoir les mêmes balises préfixes et suffixes.

Champ avec liens de référence

C'est l'un des champs pour chaque type désigné comme champ de liens de référence . Par défaut, c'est le premier champ de la liste . En appuyant sur le bouton "Montrer les options avancés" de l'onglet "Configuration du type" cela affiche une liste de sélection pour ce champ.

Le champ avec liens de référence est utilisé pour les liens internes , et pour organiser et applatir via la commande de référence. Le contenu de ce champ devrait généralement être unique si l'usiage de ces fonctions est prévues .

Les types dérivés et génériques

Les types de données peuvent être configuré pour hériter leurs paramètres de champs d'un type générique . Cela permet que des types avec des formattages différents de pouvoir conserver les mêmes groupes de champs . Tous changements dans un types génériques changera l'ensemble des champs héritiers . Cela ne s'applique pas au formattage d'affichage , ceux ci sont définis de manière indépendante

Il y a deux méthodes pour créer des types dérivés . La première , une option dérivé peut être sélectionné lorsqu'on copie un type de l'onglet "liste des types" de "Données ->Paramètres du types de données" , L'autre alternative ; un type générique peut être spécifié d'un type dérivé dans l'onglet "Configurations des types" si la fonction avancé est sélectionné .

Types Conditionnels

Copie de formats

Une autre méthode pour changer les formats des types de données consiste en copier les formats à partir d'un autre fichier TreeLine. Cela est réalisé par la commande "Données->Copier Types à partir du Fichier". Tous les types de données du fichier choisi sont copiés. Les types du fichier courant sont écrasés par les types du fichier copié ayant le même nom, mais les types avec un nom différent sont conservés.

Options de champ

Dans la boîte de dialogue "Paramètres du Type de Données", l'onglet "Confinguration des champs" , le bouton "Type de champ" affiche une liste de sélection qui permet de définir le format du champ. Le type de champ peut être configuré à texte, nombre, choix, combinaison, choix automatique, date, heure, booléen, URL, chemin, lien interne, lien exécutable, courrier, ou image. Un préfixe et un suffixe peuvent être entrés et s'afficheront si la donnée n'est pas vide.

Il existe aussi une configuration de la manière dont le contenu est présenté qui peut être du HTML ou qui préserve les retours chariot (ignorant ainsi le code HTML). Lorsque HTML est utilisé, les retours chariot sont ignorés et les caractères "<", ">" et "&" qui ne sont pas encodés en HTML, ne sont pas affichés. Il y a également une option générale qui rend les nouveaux éléments présentés en HTML par défaut. Pour un exemple d'utilisation de HTML, voir le fichier "sample_char_format" (en utilisant la commande "Fichier->Ouvrir Exemple").



Plusieurs des types d'éléments utilisent un format spécifique pour leur affichage. Pour obtenir la liste des caractères de format disponibles, utiliser le bouton "Aide Format". Une donnée entrée avec l'éditeur de données ne correspondant pas au format de champ est signalée par le label de l'élément affiché en caractères gras, et l'entrée est affichée comme "#####".

Le Type Texte

Le type par défaut est le type texte. Les champs de ce type sont édités avec une boîte de dialogue dans l'éditeur de données. La boîte d'édition s'élargit quand elle est réaffichée et qu'elle comporte plusieurs lignes de texte. La hauteur de cette boîte de dialogue peut aussi être configurée dans l'onglet "Configuration du champ"

Types choix, combinaison et booléen

Les types de champ " choix " et "combinaison" permettent la sélection d'objets en utilisant une boîte déroulante. Le format dans ce cas consiste en la liste des objets séparés par le caratère "/" (utiliser "//" pour obtenir le caratère "/" quand il fait partie intégrante de l'objet). Le choix est utilisé pour sélectionner un seul objet et combinaison pour sélectionner plusieurs objets. La boîte déroulante dans le cas de la combinaison autorise l'ajout et la suppression d'objets. De plus, il est possible de ne taper uniquement que la partie initiale de l'objets.

Le type booléen est identique au type choix, mais utilise les objets "Vrai/Faux", "oui/non" et "1/0".

Il existe également un type de champs "choix automatique". Comme le choix il permet la sélection dans une boîte déroulante, mais il n'est pas associé à un format. La boîte déroulante est automatiquement remplie par tous les choix ayant été faits précédemment.

Le Type Nombre

Pour le type nombre, des caratère spéciaux dans le format permettent de spécifier le format d'affichage du nombre dans l'éditeur de données. Le format utilise une chaîne de caractères faite de "#" (chiffre optionel) et "0" (chiffre requis) pour définir le format de représentation. Par exemple, pi formaté avec "#.#" est "3.1" et formaté avec "00.00" est "03.14". Quelque soit le format, les chiffres à gauche de la virgule ne sont pas tronqués, puisque cela reviendrait à afficher une valeur inexacte. Mais prenez soin d'afficher suffisamment de chiffres après la virgule (optionel ou requis) pour éviter les problèmes d'arrondis.

Le caratère radical peut être défini comme "." ou "," pour tenir compte de l'internationalisation. Pour les séparateurs de milliers, utiliser "\," ou "\.". Par exemple, un nombre élevé peut être représenté comme "#\,###\,###.##" ou "#\.###\.###,##". Utiliser le bouton "Aide Format" de la boîte de dialogue "Format de champs" pour obtenir des détails.

Contrairement à la plupart des autres formats, le type de champ "nombre" utilise aussi le format de données pour l'affichage dans l'éditeur de données. Bien sûr, toute nouvelle entrée avec un format raisonnable est correctement interprétée (mais le caratère radical doit être le bon).

Types Date et Heure

Pour les types date et heure, les caractères spéciaux du format sont remplacés par la valeur de certains champs de la donnée, un peu comme pour le type nombre. Utiliser le bouton "Aide Format" pour obtenir tous les détails.

Ces caractères sont aussi utilisés dans la boîte de dialogue "Outils->Options Générales->Formats de l'éditeur de données". Ces formats spécifient comment ces champs sont affichés dans l'éditeur de données. Généralement, les données entrées avec l'éditeur de données seront correctement interprétées quelque soit cette configuration, mais les dates doivent suivre l'ordre jour-mois-année spécifié. Notez également que l'éditeur de données ne supporte pas l'utilisation des jours de la semaine. Quand une donnée ne peut pas être correctement interprétée le label de champ est afffiché en caractères gras.

Une valeur par défaut à la création d'un nouveau noeud peut être configurée, par exemple "Maintenant".

Types Liens

Les types URL, chemin, et email sont utilisés pour créer des liens qui sont actifs dans le volet de Données. Un URL correspond à un lien sur le web (par défaut http:// à moins que cela ne soit spécifié différemment), chemin correspond au chemin pour accéder à un fichier (par défaut file:///), et email correspond à un lien email (par défaut mailto:). Quand ils sont cliqués dans le volet de Données, ces liens permettent d'ouvrir le navigateur ou le courrier à l'adresse indiquée. Quand on effectue une opération d'export, ces liens sont des liens HTML standard. Entrer tout simplement l'adresse complète (comme par exemple "www.bellz.org/treeline/index.html") dans l'éditeur de données. Sous Linux, en positionnant la variable d'environnement "BROWSER" à une valeur telle que "mozilla %s" permet de lancer le navigateur de son choix (mozilla en l'occurrence).

Il existe aussi un lien de type interne. Un lien de ce type spécifie un lien que l'on peut cliquer dans le volet de Données et qui sélectionne alors le premier noeud dont le texte de champ de référence correspond à la valeur du lien interne. Si ce champ de référence ou bien le lien interne comporte plusieurs ligness, chaque ligne est traitée comme une référence ou un lien distinct, respectivement. Quand cela est souhaité, le même champ peut servir à la fois de référence et de lien, si bien que en cliquant sur un mot clé du lien on sélectionne le noeud suivant ayant ce même mot clé dans l'élément de référence. Quand le fichier TreeLine est exporté en HTML, les liens internes correspondent aux liens HTML de pages, mais, dans les cas de références multiples, ils sélectionnent seulement le lien qui se trouve le plus haut dans la page HTML au lieu du lien suivant. Pour un exemple, voir le fichier "sample_intern_links" (en utilisant la commande "Fichier->Ouvrir Exemple").

Un champ de type lien exécutable exécute un programme externe lorsqu'il est cliqué. La commande à lancer est spécifiée par le contenu du champ. Ou alors le préfixe du champ qui peut contenir le nom du programme, pour que le contenu de champ soit utilisé comme arguments de la commande. Une option générale peut désactiver ces liens pour des raisons de sécurité.

Le champ de type image permet d'afficher une image dans le volet de Données. Entrer le chemin complet du fichier image comme texte du champ. Pour Qt2 (utilisé pour TreeLine sous Windows) le volet de données supporte uniquement les images au format GIF et PNG. Pour Qt3, les images JPEG et d'autres types d'images sont supportés. Bien sûr, lors de l'opération d'export en HTML, cette image est affichée pour autant que le navigateur Internet supporte le format de l'image.

Type d'identifiant unique (ID)

Un champ d'identifiant unique est automatiquement chargée avec des nombres uniques . Ceci est souvent utiles pour s'assurer que le champ des liens référentielles soit toujours unique

le format du champ est paramétré sur le premier nombre désiré de la série , commençant par un zéros facultatif , et des débuts facultatifs ou des des caractères mobiles . Le nmbre initial et les caractères extra sont utiles pour éviter la duplication des nombres dans les différents fichiers . Tous les noeds du types de données vont automatiquement recevoir un identifiant (ID) . Le format du champ affiche toujours le prochain nombre disponible , celui qui sera donnée au prochain nouveau noeud de ce type

Options Avancées

Le bouton "Montrer les options avancé" dans la boîte de dialogue "Paramètres du Type de Données" permet des configurations supplémentaires. Une valeur par défaut à la création peut être positionné pour le type de de champ. Tout nouveau noeud acquiert, à la création , cette valeur pour son type de champ concerné .

Les champs de type lien peuvent avoir un texte de remplacement associé à l'URL. Cela est permit en spécifiant un champ de texte alternatif

Il y a aussi une case à cocher si l'on souhaite spécifier que le champs est obligatoire. Les champs obligatoire sont indiqués avec un astérisque dans l'éditeur de données.

Les champs peuvent être également cachés si l'on ne souhaite pas les afficher dand l'éditeur de données.

Commandes de classement

Le menu "Données" comporte des commandes pour organiser et aplatir les données par catégorie et par référence. Ces méthodes sont utilisées pour ajouter ou supprimer automatiquement des niveaux de noeuds situés en dessous du noeud sélectionné de l'arborescence.

La commande "Ajouter un Niveau de Classement" permet de sélectionner un ou plusieurs des champs que les fils ont en commun. Ces éléments sont utilisés pour créer de nouveaux noeuds parents à partir des fils, en les groupant par catégories. Par exemple, dans une liste de livres, en choisissant les champs "nom_auteur" et "prénom_auteur" on obtient une structure hiérarchique dans lequel les livres sont classés par auteur.

La commande "Aplatir par classement" est pratiquement la commande inverse de la précédente "Ajouter un Niveau de Classement". Elle élimine tous les noeuds ayant des fils, tout en transférant leurs champs de données vers leurs fils. Ces champs sont renommés plutôt que d'écraser d'autres champs ayant le même nom, mais cette commande est la plus utile quand parents et fils ont chacun des champs de noms et types différents.

Commandes basées sur les références

Les commandes "Organiser par Référence" et "Aplatir par Référence" réorganisent les noeuds en utilisant des pointeurs sur la valeur des champs de références de leurs parents. Ces commandes présupposent que l'on utilise des valeurs uniques dans les champs références, comme un numéro d'identification unique . La commande "Aplatir par Référence" ajoute un champ contenant l'identification unique du parent à chacun des noeuds descendants. Il place alors tous ces noeuds sous le noeud-racine sélectionné. La commande "Organiser par Référence" exécute l'opération inverse, en plaçant chaque noeud avec le parent correspondant à l'identification de référence. Si il y a plusieurs noeuds avec la même identification, le noeud le plus proche au-dessus du fils est choisi. Tout noeud trouvé sans parent (orphelin) est placé directement sous le noeud sélectionné.

La commande "Mise à jour par Référence" utilise un autre fichier pour mettre à jour les valeurs des champs manquants. Les valeurs uniques sont mises en correspondance dans les champs de référence. Tout champ d'un noeud du fichier qui ne se trouve pas dans le noeud original est ajouté. Des éléments peuvent être supprimés dans le fichier original pour forcer la mise à jour, puisque le champ doit être manquant et non pas seulement vide.

Trie

La commande "Données->trier les noeuds" ouvre une boîte de dialogue contenant des options permettant de trier soit l'entièreté de l'arbre , les branches sélectionnées , les enfants sélectionnés ou les frères séléctionnés . Le trie peut être basé sur des champs spécifiques au sein de types spécifiques ou seulement sur des titres .

Trier par types permet la sélection de plusieurs champs à utilisé en tant que première clés , deuxième clés etc ... Plusieurs types peuvent êtres selectionné dans la liste de gauche . Les champs ayant un types en commun sont listé à droite. Les champs utilisé en tant que clés sont choisis dans l'ordre avec le bouton de gauche de la souris et la direction peut être changé avec le bouton droit de la souris ##### les commandes "Trier les Fils du Noeud", "Trier un Type dans la branche" et "Trier la Branche par le Titre". Les deux premières commandes permettent la sélection des champs qui vont être utilisés comme clés pour le tri. Ces clés sont sélectionnés dans l'ordre avec le bouton gauche de la souris et la direction de recherche est changée avec le bouton droit. La commande "Trier les Fils du Noeud" trie uniquement les fils du node, tandis que la commande "Trier un Type dans la branche" trie tous les descendant d'un type donné. La commande "Trier la Branche par le Titre" trie tous les descendant par le titre.

Filtres

Numérotation

La commande "Numérotation" est utilisée pour ajouter un champ numérique aux noeuds descendants. Le champ numérique n'est pas mis à jour automatiquement quand l'arbre est modifié - la commande "Numérotation" doit être répétée. Dans la boîte de dialogue, un nouveau champ ou un champ existant est entré, et le noeud sélectionné peut être inclus dans la numérotation si cela est souhaité. Un parmi trois types de numérotation peut être choisi: le type outline redémarre la numérotation pour chaque nouveau groupe de fils, le type section ajoute le numéro du fils au numéro du parent, et le type niveau unique numérote seulement le premier niveau des fils. Les formats par défaut peuvent être utilisés ("I, II..., A, B..., 1, 2..." pour les types outlines; "1, 2..., 1.1, 1.2..." pour les types sections), ou bien des formats configurés peuvent être spécifiés pour chaque niveau. Les formats configurés doivent contenir l'un des caractères suivants: "1", "A", "a", "I", ou "i". Les séries continueront à partir d'ici (utilisant les nombres, les lettres ou les chiffres romains, respectivement). La dernière occurrence de l'un de ces caractères est celle qui est utilisée - les occurrences précédentes sont considérées comme faisant partie du format.

Modification des Données Sélectionnées

Et enfin, la commande "Modifier les Données Sélectionnées" permet de modifier la valeur d'un champ simultanément pour tous les noeuds sélectionnés. Sélectionner tout simplement le champ souhaité et entrer la nouvelle valeur. Pour effacer les valeurs d'un champ , entrer un nouveaux caractères , ensuite supprimer le - cela permet d'indiquer que l'on souhaite un champ blanc.

Options d'Impression

Dans le menu "Fichier->Options d'impression" , sous le premier onglet nommé "Options générales" , sur la guache , on peut choisir soit d'imprimer l'arbre entier , soit les noeuds sélectionné , ou soit les branches sélectionnés . Le deux premières options permettent d'imprimer tous les descendants avec l'indentation des enfants

Les options à droite permettent de dessiner les lignes de l'aborescence , incluants le noeud racine , et incluant seuelemnt les enfants ouvert et gardant le premier enfant avec ses parents . L'arborescence est dessiner pour connecter les noeuds parents et efnats . Cela permet de visualiser plus facilement les relations enfants / parents , spécialement à travers de multiples pages . Ces traits peuvent ne pas être imprimés correctement quand on utilise certaines balises HTML.

Par défaut, TreeLine évite d'insérer un saut de page entre un parent et ses premiers fils. Ce comportement peut être désactivé dans l'option d'impression "Garder le premier fils avec le parent".

Disposition de la page

Le deuxième onglet de la boîte de dialogue "Options d'impression" est "Disposition de la page" . Sur la gauche sont disposé les paramètres concernant la taille de la page, son orientation et son unité de mesure . Sur la droite les paramètres pour les colonnes , l'indentation d'offset , et les marges .

Polices de caractères d'impression

Le troisième onglet de la boîte de dialogue "Options d'impression" est "Sélection Police" . L'impresson va utilise la même police que le panneaux des "Police pour sorties de données" si celle ci est coché . Si celle ci n'est pas coché une police spécifique peut être sélectionné pour l'impression

En-tête et pied de page

Dans la boîte de dialogue options d'impression le troisième onglet est utilisé pour configurer les en-têtes et pieds de page. Ce bouton fait apparaître une nouvelle boîte de dialogue avec le nom des champs du fichier dans la partie gauche et six boîtes d'édition en-tête/pied de page (justification à gauche, au centre et à droite) sur la droite. Ces champs peuvent être ajoutés et combinés avec du texte entré dans les boîtes d'édition, exactement comme dans la boîte de dialogue "Données->Paramètres du Type de Données". La configuration en-tête/pied de page est sauvegardée avec le fichier TreeLine.

Aperçu avant impression

Un aperçu peut être vue en utilisant le menu "Fichier->Aperçu avant impression" ou le même bouton de la boite de dialogue "Options d'impressions" . Les boutons sur la fenêtre sont utilisé pour naviguer entre les pages , ouvrir la boîte de dialogue '"Options d'impression", ou ouvrir la boîte de dialogue d'impression . Un aperçu avant impression est affiché avant l'impression (mais après avoir cliqué sur 'OK' dans la boîte de dialogue impression). La fenêtre d'aperçu avant impression montre plus de détails quand elle est agrandie.

Problèmes à l'Impression

Quelques uns de problèmes d'impression, tout spécialement les problèmes liés aux marges et à la césure des mots, peuvent être éliminés en utilisant la police qui est la mieux adaptée à l'imprimante utilisée.

Compression de Fichier

Un fichier TreeLine est au format XML. Il est également possible de travailler avec des fichiers compressés (au format gzip) pour économiser de la place. Les fichiers peuvent être configurés comme étant compressés avec le menu "Options->Options de Fichier" ou à partir de la boîte de dialogue "Enregistrer Sous". Il existe aussi une option générale pour configurer ce mode pour tous les nouveaux fichiers TreeLine.

Cryptage de Fichier

Il existe une option pour crypter avec un mot de passe les fichiers TreeLine. Les fichiers peuvent être configurés comme étant cryptés avec le menu "Options->Options de Fichier" ou à partir de la boîte de dialogue "Enregistrer Sous". Il existe aussi une option générale pour configurer ce mode pour tous les nouveaux fichiers TreeLine. Le cryptage utilise une fonction de hashage SHA - elle peut être considérée comme relativement sûre.

Sauvegarde Automatique

Un mécanisme de sauvegarde automatique sauvegarde le fichier en ajoutant au nom de fichier le suffixe "~" (tilde). Ce fichier est automatiquement supprimé quand le fichier est sauvegardé par l'utilisateur. Le délai de sauvegarde automatique est configuré dans les options générales. En configurant ce délai à zéro, on désactive cette fonctionalité.

Etat de l'arbre sauvegardé

Quand un fichier TreeLine récent est ouvert, TreeLine restaure les états des noeuds ouverts et sélectionnés. Cette information est sauvegardée dans le fichier de configuration TreeLine de l'utilisateur. Si cela est souhaité, cette fonctionalité peut être désactivée avec une option générale.

Ligne de Commande

Les options de la ligne de commande permet d'effectuer des opérations non interactives d'export et d'import de fichiers. Cela permet le traitement par lots. Pour plus de détails, exécuter "treeline -h" à partir de la ligne de commande. Sous Windows, il n'y a pas d'affichage sur la console et en conséquence celui-ci doit être redirigé vers un fichier: ("treeline -h > log.txt").

Texte Délimité

Un fichier TreeLine est au format XML. Les autres types de fichiers peuvent être importés simplement en les ouvrant. Ouvrir un fichier qui n'est pas un fichier XML TreeLine affiche une boîte de dialogue qui permet de définir le type de fichier à importer.

Texte Délimité

TreeLine peut importer un fichier texte structuré hiérarchiquement par des tabulations. Dans ce cas, seul le noeud titre est importé, et les éléments supplémentaires sont ignorés. Cette méthode est utilisée pour ouvrir les fichiers TreeLine créés par de vieilles versions de TreeLine.

Un tableau délimité par des tabulations peut aussi être importé. Il devient un arbre avec un seul niveau de fils, chaque noeud contenant les éléments de chaque colonne du tableau. La première ligne du tableau est utilisée pour les noms d'éléments et chaque ligne suivante devient un noeud.

Texte Ordinaire

Il y a deux types d'importation de texte ordinaire. L'un crée un noeud pour chaque ligne du texte. L'autre crée un noeud par paragraphe, on suppose ici que les paragraphes sont séparés par une ligne vide . Dans les deux cas, le fichier TreeLine résultant est tel que tout le texte se trouve sous un seul parent, mais c'est un bon point de départ. Des éléments de structure peuvent être rajoutés plus tard.

Fichiers Treepad

Il existe aussi un filtre pour importer des fichiers au format Treepad. Seuls les nodes Treepad de type texte sont supportés.

Fichiers de Favoris

TreeLine importe les fichiers de favoris au format Mozilla HTML (navigateurs Mozilla, Firefox et Netscape) et au format XBEL (navigateurs Konqueror, Galeon et Elinks). Chaque favori devient un noeud avec un élément nom et un élément lien. Les informations de ces fichier de type date et référence d'icône ne sont pas importées. Pour un exemple, voir le fichier "sample_bookmarks" (en utilisant la commande "Fichier->Ouvrir Exemple").

XML Générique

TreeLine importe et exporte les fichiers génériques XML. Cette méthode n'est pas sophistiquée - chaque noeud devient un élément XML et chaque champ devient un attribut XML sauf pour les champs nommé "Element_Data" qui devient un élément texte. Cela permet d'utiliser TreeLine comme un éditeur XML rudimentaire.

Document texte ODF

Treeline peut importer les texte de type Open Document Format (ODF ), de logiciel tels qu'OpenOffice.org et Kword . La strucuture du noeud formé est basé sur les styles d'en-tête assigné du document d'origine. Tous textes en dessous des styles d' en-têtes devient un textes de cet en-tête. Le filtre d'import seulement destiné à des usages simples . Le formatage n'est pas maintenu , les objets tel que les tableaux et les images ne sont pas importés .

HTML

Les fichiers sont exportés en utilisant la commande "Fichier->Exporter". Une boîte de dialogue s'affiche avec les types d'export disponibles et les options.

HTML

L'export en fichier HTML est identique à 'impression avec les mêmes options. Il peut inclure l'en-tête et pied de page d'impression et il est possible de configurer le nombre de colonnes.

Il existe aussi un export de fichiers HTML multiples qui crée une arborescense de dossiers. Les dossiers sont nommés en utilisant le contenu du premier champ, celui-ci doit contenir des caractères légaux utilisables dans les noms de dossiers et il ne doit pas y avoir de contenus identiques sous le même parent. Chaque fichier HTML est un tableau de données pour un ensemble de frères, avec des liens vers le parent et le fils.

Texte Délimité

Les données peuvent être exportées vers du texte tabulé (le vieux format TreeLine) et des tableaux délimités par des tabulations. Ces formats sont les mêmes que les formats d'import correspondant. Lorsqu'on exporte vers un tableau, seul le premier niveau de fils est utilisé, aussi vous pouvez peut-être aplatir les données avant de les exporter.

Fichiers de Favoris

TreeLine exporte les fichiers de favoris au format HTML Mozilla (navigateurs Mozilla, Firefox et Netscape) et au format XBEL (navigateurs Konqueror, Galeon et Elinks).

XML Générique

TreeLine importe et exporte les fichiers génériques XML. Cette méthode n'est pas sophistiquée - chaque noeud devient un élément XML et chaque champ devient un attribut XML sauf pour les champs nommé "Element_Data" qui devient un élément texte. Cela permet d'utiliser TreeLine comme un éditeur XML rudimentaire.

XSLT

En plus d'exporter les données, le format d'un fichier peut être exporté vers un fichier XSLT . Cela peut être utilisé pour afficher des données XML à partir d'un fichier TreeLine dans un navigateur sans exporter les données en HTML. Les versions récentes de la plupart des navigateurs supportent le format XSLT. Notez que le formattage de types de champs complexes est ignoré par XSLT.

Lors de l'export en XSLT, un lien vers le fichier XSL est ajouté au fichier TreeLine. Dés lors le fichier TreeLine doit être sauvé. En général , le fichier Treeline devrait avoir une extention en ".xml" , ainsi TreeLine pourra les ouvrir directement dans un navigateur standardisé. Après , le fichier XSL ne nécéssite plus d'être re-exporté pour le changement de données (seulement le changement de formatage ).

Les balises HTML qui sont utilisées dans les formats et qui seront exportés en XSLT, doivent utiliser le style xHTML (<br /> au lieu de <br> par exemple). A l'exportation, TreeLine demande le nom d'une feuille de style optionnelle (css). Ce nom est enregistré dans le fichier TreeLine comme une valeur par défaut pour les opérations d'export ultérieures. De même, la référence au fichier XSLT dans le fichier TreeLine peut être supprimée avec la commande "Outils->Supprimer Ref XSLT".

Docuemnt texte ODF

Treeline peut exporté un titre dans un le format texte de document ODF , qui est compatible avec OpenOffice.org et Kword. Au titre de chaque noeud est assigné un style d'en-tête de niveau apprprié . Tout texte d'affichage de la sortie de chaque noeud devient un texte normal sous les en-têtes . Le filtre d'export est seulement à destination de titres simples . Tout formattage HTML est enlevés , et tout objets tel que des tables et des images ne sont pas supportés .

Options

Le comportement de Treeline peut être modifié par plusieurs paramètres disponibles dans "Outils -> Options Générales" . La plupart de ses options sont abordées dans une section de ce document

Polices de caractères

Les polices de caractères utilisé dans l'arborescence , l'affichage et l'éditeur peuvent être configuré dans le menu "Outils-> Fixer les polices".

Raccourcis clavier

Les raccourcis clavier peuvent être personnalisé en utilisant la commande "Outils-> Fixé les raccourcis clavier " . Les raccourcis éditeur ont un onlet pour les commandes du menu et celles qui ne sont pas du menu . Simplemenet presser la nouvelle séquence de touches dans le champ approprié sélectionné.

Barre d'outils

Un editeur pour personnalisé la barre d'outils est disponible dans "Outils-> Personnalise les barre d'outils". Le nombre de barre d'outil peut être configuré et les boutons de chacune d'entres-elles définis .

Couleurs

La couleur de l'interface utilisateur peut être configuré en utilisant les trois derniers éléments dans le menu "Outils" . Si la commande "Utilise les couleurs par défaut du système " est activé , les paramètres utilisateurs des couleurs de fonds et de textes sont écrasés .

Icones de l'arborescence

Il y a un répertoire d'icones dans le repertoire de configuration utilisateur ("~/.treeline-1.x/icons" sous Linux, "Documents and Settings\<user>\Application Data\bellz\treeline-1.x\icons" sur Windows) . Les fichiers images (PNG ou BMP ) placés dans ce répertoire deviennent disponibles en tant qu'icones d'arborescence .

Description

TreeLine possède une interface permettant d'ajouter des modules plugins. Cela permet d'ajouter des extensions à TreeLine qui implémentent des fonctionnalités utilisées par quelques utilisateurs sans encombrer le code principal de TreeLine. Les plugins peuvent ajouter des menus, accéder aux données TreeLine et lire et écrire les fichiers TreeLine.

Les plugins disponibles sont affichés sur la page "Downloads" du site web de TreeLine.

Installation

Les plugins sont installés en copiant leurs fichiers Python (*.py) dans le dossier plugins ("<préfixe>/lib/treeline/plugins/" sous Linux ou "TreeLine\lib\plugins\" sous Windows). La liste des plugins chargés est obtenue avec la commande "Aide->A propos Plugins".

Il existe aussi une configuration de fichier, "DossierUtilisateurPlugins", qui permet de spécifier un autre emplacement pour les plugins. Cela permet d'installer des plugins sans avoir les droits d'accès root/administrateur. Cette configuration peut seulement être modifiée en éditant le fichier de configuration (~/.treeline sur Linux, treeline.ini sur Windows).

Interface

Les informations nécessaires pour écrire de nouveaux plugins peuvent être trouvées dans le fichier "plugininterface.py" dans le code source de TreeLine.

Paneaux fermés

Si un volet n'est pas visible alors qu'il devrait contenir des données , il a probablement été réduit à une taille de zéro . Cela s'applique pour le volet de gauche et le volet bas de droite . Pour corriger cela, chercher une fine bordure aux frontières des panneaux qui peut être tiré pour ramener le volet dans sa position normal.

Erreur XML

Un message d'erreur, "Erreur en chargeant le Décodeur XML", signifie que TreeLine n'a pas pu trouver la librairie XML. Sous Linux, Python utilise une librairie externe pour décoder le XML. En installant soit la librairie expat ou la package PyXML on doit résoudre ce problème. Sous Windows, Python inclut le décodeur XML, de sorte que ce message ne devrait pas apparaître à moins que le fichier soit inexistant ou corrompu.

Impression

Quelques problèmes d'impression, spécialement les problèmes liés aux marges et à la césure des mots, peuvent être éliminés en choisissant une police mieux adaptée à l'imprimante utilisée.