summaryrefslogtreecommitdiffstats
path: root/doc/fr/advanced.docbook
blob: dec1bbec535a7ebbc14df19fbaf11dbef03daa74 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<chapter id="advanced">
<title>Utilisation avancée</title>

<sect1 id="command-line">
<title>Options en ligne de commande</title>

<para>
Lorsque vous exécutez &appname; depuis la ligne de commande, il existe plusieurs
options pour ouvrir des fichiers de données. Ces options peuvent être vues en
exécutant <userinput>tellico --help</userinput>.
</para>

<programlisting>
Usage: tellico [TQt-options] [TDE-options] [options] [filename]

Tellico - a collection manager for KDE

Options:
  --nofile                  Do not reopen the last open file
  --bibtex                  Import &lt;filename&gt; as a bibtex file
  --mods                    Import &lt;filename&gt; as a MODS file
  --ris                     Import &lt;filename&gt; as a RIS file

Arguments:
  filename                  File to open
</programlisting>

</sect1>

<sect1 id="dcop-interface">
<title>Interface &DCOP;</title>

<para>
&appname; dispose d'une interface &DCOP; minimale, qui peut être utilisée pour
automatiser l'application ou interagir avec depuis une la ligne de commande.
Co,,e pour tous les appels &DCOP;, vous devez spécifier l'application avec
laquelle vous souhaitez interagir ; ainsi que l'interface spécifique. Les appels
&DCOP; décris dans ce document sont tous disponibles dans l'interface 
<constant>tellico</constant> de &appname; ; alors que le nom de l'application
est <constant>tellico-pid</constant>, où <emphasis>pid</emphasis> est le
<emphasis>process id</emphasis> de l'application.
</para>

<sect2 id="dcop-commands">
<title>Commandes DCOP</title>

<para>
La liste complète des commandes &DCOP; de l'objet <constant>tellico</constant>
est disponible ci-dessous :
</para>

<programlisting>
bool importTellico(TQString file, TQString action)
bool importBibtex(TQString file, TQString action)
bool importMODS(TQString file, TQString action)
bool importRIS(TQString file, TQString action)
bool exportXML(TQString file)
bool exportBibtex(TQString file)
bool exportHTML(TQString file)
bool exportCSV(TQString file)
bool exportPilotDB(TQString file)
QStringList bibtexKeys()
</programlisting>

<para>
Pour les quatre commandes d'import, le premier paramètre est le nom du fichier
à importer, et le second l'action lors de l'import. Trois types d'actions sont
disponibles : <emphasis>replace</emphasis> (remplacer),
<emphasis>append</emphasis> (ajouter) et <emphasis>merge</emphasis> (fusioner).
Quatre formats de fichier sont possibles pour l'import : fichier XML Tellico,
BibTeX, MODS et RIS.
</para>

<para>
La collection ouverte dans &appname; peut être exportée vers un fichier, dans
le format XML de Tellico, BibTeX, HTML ou CSV.
</para>

<para>
Enfin, si la collection courante est un bibliographie, appeler
<command>bibtexKeys()</command> donnera comme résultat la clef de citation
BibTeX de toutes les entées sélectionnées.
</para>

</sect2>

<sect2 id="dcop-examples">
<title>Exemples DCOP</title>

<para>
Voici quelques exemples de scripts &appname; utilisant l'interface &DCOP;.
Puisque le <emphasis>pid</emphasis> doit être connu, la façon la plus simple de
l'inclure dans la commande shell suivante :
<userinput>dcop $(dcop | grep tellico) tellico</userinput>.
</para>

<screen width="40">
<emphasis>Ouvrir un fichier BibTeX</emphasis>
<prompt>%</prompt>
<userinput>dcop $(dcop | grep tellico) tellico importBibtex ~/documents/reference.bib replace</userinput>
<computeroutput>true</computeroutput>
</screen>

<screen width="40">
<emphasis>Exporter un fichier BibTeX</emphasis>
<prompt>%</prompt> <userinput>dcop $(dcop | grep tellico) tellico exportBibtex ~/documents/reference.bib</userinput>
<computeroutput>true</computeroutput>
</screen>

<screen width="40">
<emphasis>Afficher la clef de citation de la sélection courante</emphasis>
<prompt>%</prompt> <userinput>dcop $(dcop | grep tellico) tellico bibtexKeys</userinput>
<computeroutput>stephenson2004</computeroutput>
</screen>

</sect2>

</sect1>

</chapter>