Suivant l'esprit du Logiciel Libre, vous pouvez modifier &appname; autant que vous le désirez. Il devrait être très simple d'écrire des scripts pour importer, exporter ou modifier des données. Ce chapitre vous donne plus d'informations sur ce sujet. Le format de fichier par défaut de &appname; est une archive zip, normallement avec une extension de fichier en .tc. A l'intérieur de l'archive se trouve un fichier tellico.xml. Les images peuvent être placées dans le répertoire images/ dans l'archive, ou être incluses directement dans le flux &xml; encodées au format base64. Les images peuvent également être enregistrées dqns le repertoire de données de l'application ; auquel cas elles ne sont pas du tout présentes dans le fichier de données. &appname; peut également charger le fichier &xml; directement; non compressé. ]]> Le fichier commence par la déclaration et l'encodage &xml; requis, suivis par le type de document ("doctype"). Quand un nouveau champs est ajouté ou une propriété aditionelle attribuée aux champs par défaut, la version de DTD du doctype est incrémentée. &appname; est toujours capable d'ouvrir et lire les versions de DTD précédentes, mais sauvegarde les fichiers dans la version courante. La localisation DTD pointe vers le ficher DTD lui-même. L'élément racine est un élément <tellico>, contenant la déclaration de l'espace de nommage par défaut et la version de la syntaxe du fichier, qui devraient toujours etre identiques à ceux de la DTD. L'élément <tellico> contient un élément <collection>. Les collections multiples sont ignorées pour le moment. L'attribut title contient le nom de la collection, alors que l'attribut type specifie quel type d'entrées est contenu dans la collection. La liste des types disponibles est disponible dans une autre section. Un attribut optionnel entryTitle peut être utilisé pour spécifier le nom des entrées dans une collection personnalisée, et devrait être au pluriel. ]]> Tous les champs sont définis dans un élément <fields>, qui doit être unique. Toutes les informations d'un champ, à l'exception des propriétés étendues, sont incluses dans l'élément <field>. Les valeurs possibles pour les attributs flags, format, et type sont données dans une section suivante. Un élément <field> avec un attribut "name" égal à _default indique à &appname; d'inclure tous les champs par défaut de ce type de collection. Stroustrup, Bjarne Pearson Education 3rd 2003 2-7440-7003-3 Non-Fiction Programmation et langages Informatique et Internet cf65a2f023b6cb9e9233323dca10ac7c.jpeg ]]> Pour chaque champs de la collection, un élément <entry> peut contenir un élément dont le nom est identique à celui du champs. Si des valeurs multiples sont possibles pour ce champ, la lettre s est ajoutée au nom du champ pour créer un élément. Chaque valeur est ajoutée en tant que descendant de cet élément, comme c'est le cas pour les champs author, genre et keyword ci-dessus. En conséquence, si de nouveaux champs sont ajoutés à la collection, le fichier de données ne sera plus conforme à la DTD. Cependant, &appname; utilise un analyseur &xml; ne vérifiant pas la validité des champs, ceux-ci ne posent donc pas problème. ]]> A l'intérieur de chaque élément <images> apparait chaque image référencée par une entrée, ainsi que les attributs décrivant la taille de l'image, son format et son numéro d'identification. Si l'image est contenue dans le fichier Zip, l'élément est vide. Dans le cas contraire les données de l'image peuvent être contenues dans le flux &xml; sous forme de text encodé au format base64. Le type de collection est donné dans l'attribut "type" de l'élément "collection". La valeur est égale à celle de l'enum Type défini dans src/collection.h. Type de collection Valeur Custom Collection1Book Collection2Video Collection3Music Collection4Bibliography5Comic Book Collection6Wine Collection7Coin Collection8Stamp Collection9Trading Card Collection10Video Game Collection11File Catalog12 &appname; inclut tous les champs par défaut de la collection si le premier élément est nommé _default. Pour les champs Paragraphe, Tableau ou Image, la catégorie du champ doit être identique au titre du champ. Le type de champ est donné dans l'attribut type de l'élément. La valeur est égale à celle de l'enum FieldType défini dans src/field.h. Le type Lecture seule était prévu pour pour les champs devant être conservés ; mais ne pouvant pas être modifiés par l'utilisateur, tels que les champs ajoutés lors de l'import d'une collection dans une autre format. Il n'est pas utilisé. Type de champ Valeur Texte simple1Paragraphe2Choix3Case à cocher4Lecture seule5Nombre6URL7Tableau à une colonne8Tableau à deux colonnes9Image10Dépendant11Date12 Le champ peut avoir plusieurs options, données par la valeur d'un champ de bits dans l'attribut flags de l'élément du champ. L'option interdisant à l'utilisateur d'effacer un champ est prévue pour des données telles qu'une citation dans une entrée bibliographique. Option de champ Valeur Autoriser des valeurs multiples0x01Autoriser le regroupement0x02Activer l'auto-complétion0x04Interdire l'effacement0x08 La mise en forme du champ est donnée dans l'attribut format de l'élément. Date n'est pas utilisé pour le moment. Le regroupement par Personne utilise tous les champs ayant une mise en forme de Nom. Format de champ Valeur Capitales0Title1Nom2Date3Pas de mise en forme4 &appname; dispose de certaines options de configuration qui ne sont pas visibles dans la &config-dialog;. Elles ne sont pas suffisament importantes pour charger la boite de dialogue avec plus d'options, mais puisqu'elles peuvent être utiles à certains utilisateurs, l'application les lit dans le fichier de configuration. Les paramètres de &appname; sont enregistrés dans un fichier du répertoire de l'utilisateur, $KDEHOME/share/config/tellicorc. Dans ce fichier; les paramètres sont rassemblés dans des groupes qui apparaissent avec un nom entre crochet, tel que [General Options]. Pour ajouter un paramètre au groupe General Options, trouvez la ligne dans le fichier de configuration avec ce nom de groupe. S'il n'apparait pas, créez-le vous-même en ajoutant une ligne [General Options]. Les paramètres peuvent alors être ajoutés sur les lignes suivantes. Ces paramètres doivent être placés dans le groupe General Options. La taille maximum des icones dans la &icon-view; peut être changée avec cette option. La valeur par défaut est 96, et peut être modifiée entre 32 et 128. Max Icon Size=72 Ces paramètres doivent être placés dans le groupe Options - bibtex. Ce paramètre indique l'adresse lyxpipe pour envoyer les citations bibliographiques. Il ne doit pas inclure le suffixe .in. lyxpipe=$HOME/.lyx/lyxpipe Ces paramètres doivent être placés dans le groupe Export Options - PilotDB. L'encodage des données exportées dans le fichier PilotDB peut être changé avec ce paramètre. La valeur par défaut est le jeu de caractères de la locale de l'utilisateur. Charset=Windows-1250 Lorsque des fichiers BibTeX sont i,portés ou exportés, certains caractères sont convertis entre leur équivalent TeX et unicode. Ces tables de conversions sont contenues dans le fichier bibtex-translation.xml, se trouvant dans le repertoire de données installées par le logiciel. Ces tables de conversion peuvent être modifiée librement. L'élément clef contient le caractère Unicode, et les chaines contiennent les équivalents TeX, qui peuvent être multiples. Le premier est celui utilisé lors des exports qu format BibTeX. {\`A} \`{A} ]]> Quelques astuces pour écrire du XSLT pour traiter les données &xml; de &appname; : (à écrire).