Il est possible d'utiliser GCfilms avec d'autres logiciels en transformant la liste de films de deux manières. L'exportation est l'opération permettant de rendre une liste de films exploitable depuis un autre logiciel. L'importation réalise l'inverse et vous permettra par exemple de récupérer une liste de films créée avec un autre logiciel.
Généralités
Les modules sont décrits dans l'ordre où ils devraient apparaître dans les menus Exporter et Importer (sous-menus de Fichier). Si un de ceux-ci est absent, il est possible de savoir pourquoi en utilisant l'élement Dépendances dans le menu d'aide (?). Il affiche une boîte de dialogue ayant cet aspect :
Les éléments montrés ici sont des composant Perl qui sont utilisés par les modules d'importation et d'exportation. Si un de ceux-ci est absent du système, le module l'utilisant ne sera pas disponible. Dans l'exemple précédent, le module d'importation depuis Tellico ne pourra pas être utilisé et ne s'affichera pas dans le menu Importer car Archive::Zip est manquant.
Une fois le composant Perl ajouté (la manière de procéder dépend du système d'exploitation utilisé), il n'est pas nécessaire d'installer à nouveau GCfilms, mais il suffit de le quitter puis de le relancer.
Exporter le catalogue de films
Le menu Films a un sous-menu appelé Exporter. Il contient 5 éléments correspondant à des types d'exportation différents.
Exporter en CSV
Le premier module sert à créer un fichier CSV. Dans un tel fichier, il y a une ligne pour chaque film. Les informations associées au film sont séparées par un caractère (ou une chaine de caractères) défini par l'utilisateur.
La première option permet de choisir si les noms des colonnes doivent être ajoutées au fichier. Ce peut être utile de les avoir pour par exemple ensuite exploiter cette liste depuis un tableur.
Il est ensuite possible de choisir le délimiteur. Et au cas où ce dernier apparaîtrait dans une des valeurs à insérer, un caractère de substitution doit être indiqué.
Une autre option permet de choisir si les images doivent être copiées dans un sous-répertoire. Les chemins seront par la même occasion changés pour les rendre relatifs.
Les champs à exporter doivent être sélectionnés à l'aide du bouton présent. L'ordre a bien évidemment une importance dans ce cas.
Exporter en HTML
Grâce à cette fonctionnalité, une page HTML est générée contenant toute la liste de films courante avec leurs images. Pour stocker ces dernières, un répertoire est créé au même niveau que le fichier. Son nom est affiché dans une boîte de dialogue lorsque l'exportation est terminée. Pour pouvoir consulter cette page depuis un autre endroit (par exemple un serveur web), ce répertoire doit aussi être copié.
Plusieurs modèles sont disponibles avec des fonctionnalités et des apparences différentes.
Une option est également présente, Utiliser du Javascript. Elle n'a d'effet que pour le modèle Tian. Si elle est activée, certaines fonctionnalités seront ajoutée à la page HTML. Il y aura la possibilité de masquer ou afficher les informations associées à un film. Une recherche basique sera également présente. On peut alors saisir une chaîne à rechercher dans les titres ou toutes les données des films.
D'autres personnalisations sont possibles. Le titre de la page générée est modifiable par l'utilisateur. La taille des images correspondantes au film peut également être spécifiée.
Exporter en SQL
L'export SQL permet de créer un fichier contenant des requêtes d'insertion des élements dans une table. L'utilisateur doit indiquer le nom de la table en question, mais il y a aussi d'autres options.
Deux options servent à indiquer si des instructions doivent être placées avant les insertions. Il s'agit d'une destruction préalable de la table (DROP) et de sa création (CREATE).
L'option suivante permet d'indiquer s'il est nécessaire que les images associées au films soit copiées dans un sous-répertoire (qui sera créé) de celui ou va être enregistré le fichier SQL.
Le bouton se trouvant en dessous de ces options sert à spécifier quels champs doivent être exportés dans le fichier. Leur ordre est également modifiable à ce niveau.
Exporter en .tar.gz
Ceci permet de générer un fichier unique, une archive .tar.gz, qui contiendra le fichier de la liste des films mais aussi toutes les images. C'est utile pour par exemple transporter facilement une collection de films d'une machine vers une autre.
Exporter pour Tellico
Ce module permet d'exporter la liste de films afin qu'elle puisse être lue par Tellico, un gestionnaire de collections pour KDE.
La collection est crée sous forme d'un fichier XML unique contenant également les images.
Exporter en XML
L'export XML utilise des modèles pour générer le fichier. Le premier choix permet de selectionner où ce modèle est situé. Il peut être entré manuellement dans la zone de texte ou lu dans un fichier. GCfilms est également fourni avec des modèles pré-définis qui peut être utiles.
Un modèle contient trois sections définies comme suit.
[HEADER]
[/HEADER]
[ITEM]
[/ITEM]
[FOOTER]
[/FOOTER]
Dans la section HEADER doit se trouver tout ce qui sera au début du fichier. Ces informations seront présentes seulement une fois. Ce sera par exemple la définition de la DTD, l'ouverture des balises principales,...
Ce qui est dans la partie ITEM est ce qui se rapporte à un film. Ce sera répété autant de fois que nécessaire.
Enfin, la section FOOTER regroupe ce qui sera ajouté en fin de fichier.
Dans la section ITEM, des opérations particulières peuvent être réalisées. Quelque chose de la forme ${champ} sera remplacé par le champ correspondant dans le film. Les valeurs de champs possibles sont :
| Texte à utiliser | Description |
|---|---|
| ${title} | Titre du film |
| ${date} | Date de sortie (texte libre) |
| ${year} | Date de sortie (seulement l'année) |
| ${time} | Durée (texte libre) |
| ${length} | Durée (nombre de minutes) |
| ${director} | Réalisateur |
| ${nat} | Nationalité ou pays |
| ${type} | Genres du film (séparés par des virgules) |
| ${image} | Chemin vers l'image |
| ${orig} | Titre original |
| ${actors} | Liste d'acteurs (séparés par des virgules) |
| ${comment} | Commentaires |
| ${synopsis} | Synopsis |
| ${seen} | Film déjà vu (1) ou non (0) |
| ${format} | Type de support |
| ${number} | Nombre de supports |
| ${rating} | Note |
| ${url} | URL de la fiche du film |
| ${place} | Emplacement où est rangé le support |
| ${audio} | Langues audio (séparés par des virgules) |
| ${subt} | Langues sous-titres (séparés par des virgules) |
| ${borrower} | Nom de l'emprunteur |
| ${lendDate} | Date de prêt |
| ${history} | Historique des prêts (séparés par des virgules) |
Toutes les valeurs séparées par des virgules peuvent être utilisées dans une boucle. La syntaxe est la suivante :
[LOOP champ]
[/LOOP]
champ étant un des précédents (sanst ${ et } ). Tout le texte inclus dans cette section sera répété autant de fois que nécessaire. A chaque itération de la boucle, $$ sera remplacé par la valeur courante. Voici un exemple. Supposons que ce modèle soit utilisé.
<acteurs>
[LOOP actors]
<acteur>$$</acteur>
[/LOOP]
</acteurs>
Et qu'un film ait pour liste d'acteurs "Jacques, Francine, Paul". Le fichier généré contiendra :
<acteurs>
<acteur>Jacques</acteur>
<acteur>Francine</acteur>
<acteur>Paul</acteur>
</acteurs>
Une autre fonctionnalité est la section SPLIT. Sa syntaxe est la suivante.
[SPLIT value=champ sep=car]
[/SPLIT]
champ peut être n'importe laquelle des informations précédentes (pas seulement celles qui ne sont pas séparées par des virgules). car est le caractère qui sera utilisé en tant que séparateur. Dans le texte inclus dans cette section, des valeurs particulières peuvent être utilisées : $0, $1,... Elles seront remplacées par chacun des champs du film.
Pour prendre un exemple, considérons ce modèle :
<realisateur>
[SPLIT value=director sep= ]
<prenom>$1</prenom>
<nom>$2</nom>
[/SPLIT]
</realisateur>
Le séparateur utilisé ici est l'espace. Si pour un film le réalisateur est "Paul Martin", alors le fichier contiendra ceci :
<realisateur>
<prenom>John</prenom>
<nom>Doe</nom>
</realisateur>
Importation depuis d'autres logiciels
GCfilms peut être utilisé avec des collections générées depuis d'autres logiciels. Il existe des modules d'importation pour cela. La liste de films peut être importée dans celle courante ou il est possible d'en créer une nouvelle. Cela se choisit dans la boîte de dialogue d'imporation. Il y a plusieurs importations possibles.
Ant Movie Catalog
Ce module permet d'importer une liste de films générées avec Ant Movie Catalog. Il suffit de choisir le fichier .amc et tout sera fait, y compris l'importation des images de films.
CSV
De nombreux logiciels permettent d'exporter la liste au format CSV. Pour pouvoir importer une telle liste dans GCfilms, il faut utiliser ce module et spécifier le caractère utilisé comme séparateur et aussi les différents champs présents.
DVD Profiler
Avec ce module, ce sont les collections utilisées avec DVD Profiler qui peuvent être importées. Il ne fonctionne pas avec le format natif mais avec les fichiers XML générés par ce logiciel. Il faut donc tout d'abord utiliser la fonction d'exportation qu'il propose.
GCfilms
Ce peut être utile pour fusionner deux collections de films. Il suffit d'ouvrir la première puis d'importer la seconde. Ceci doit bien sûr être fait en choisissant d'importer dans la liste courante.
Liste de titres
Avec ce module, on peut importer une liste de titres. Cette liste doit être dans un fichier texte avec un titre par ligne. Il est ensuite possible de choisir depuis quel site les informations vont être automatiquement récupérées.
Parfois le titre peut donner plusieurs résultats sur le site de recherche. Le comportement dans ces cas là peut être indiqué par la case à cocher présente. Si elle est cochée, c'est systématiquement le premier résultat qui sera utilisé sans le demander à l'utilisateur. Si elle n'est pas cochée, l'utilisateur se verra demander quel film il veut choisir dans une liste.
.tar.gz
Cette importation permet de récupérer une liste de film qui a été générée par le module d'exportation correspondant. Il s'agit alors d'une archive compressée contenant la liste elle-même et les images.
Tellico
Ce module sert à importer une collection de films depuis Tellico, un gestionnaire de collections pour KDE.
Il sait ouvrir les deux types de collections utilisés par Tellico : Les fichiers .tc et les fichiers XML. Il n'importera que les collections qui sont de type vidéo.
Si avez rencontré un problème avec GCfilms, vous pouvez poster un bug sur Gna!.