Added KDE3 version of Tellico

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/tellico@1097620 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 120 insertions, 0 deletions

diff --git a/doc/fr/advanced.docbook b/doc/fr/advanced.docbook
new file mode 100644
index 0000000..54f04b7
--- /dev/null
+++ b/doc/fr/advanced.docbook
@@ -0,0 +1,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 [Qt-options] [KDE-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(QString file, QString action)
+bool importBibtex(QString file, QString action)
+bool importMODS(QString file, QString action)
+bool importRIS(QString file, QString action)
+bool exportXML(QString file)
+bool exportBibtex(QString file)
+bool exportHTML(QString file)
+bool exportCSV(QString file)
+bool exportPilotDB(QString 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>