----- NOM -----
Xlog - Journal de trafic utilisant GTK+ pour les radioamateurs
 
----- SYNOPSIS -----
Xlog [option] <log1.xlog> <log2.xlog> ...
 
----- OPTIONS ET ARGUMENTS -----
 -h affiche un résumé des options et quitte.
 -v affiche des informations détaillées et quitte.

Vous pouvez soit ouvrir des journaux à partir de la ligne de commande ou, si
vous n'avez entré aucun nom de journal, ouvrir les journaux définis dans les
préférences.
 
----- DESCRIPTION -----
Xlog est un programme de gestion des journaux de trafic pour les radioamateurs.
La fenêtre principale consiste en une barre d'outils, un cadre pour le QSO et
un journal que l'on peut parcourir. Les journaux sont enregistrés sous la forme
d'un simple fichier texte. Vous pouvez créer, ouvrir et fermer des journaux
selon vos besoins.

----- UTILISATION -----
Lorsque Xlog est lancé pour la première fois, une fenêtre vide s'affiche. Vous
devez alors choisir « Journal -> Nouveau » (Ctrl-N) à partir du menu pour
créer un nouveau journal.

                                       {xlog-newlogdialog.png}


Les QSO sont saisis dans le cadre des QSO qui se trouve dans la partie gauche
de la fenêtre principale. En cliquant sur le bouton « Date », le champ 
« Date » sera mis à jour ; le bouton « GMT » mettra à jour le champ 
« GMT ». Lorsque vous ajoutez un indicatif dans le champ correspondant, Xlog
va rechercher le préfixe correspondant et va afficher les informations DXCC qui
s'y rapportent en même temps que la distance calculée et le pointage de 
l'antenne. Si le QTH locator est renseigné dans un journal, Xlog va rechercher
la distance et l'azimut vers ce locator et les afficher dans un cadre séparé.

  {xlog-mainwindow.png}


Une fois tous les champs renseignés, cliquez le bouton « Ajouter » dans la
barre d'outils pour ajouter le QSO dans le journal qui se trouve dans la partie
droite de la fenêtre principale.

Des QSO peuvent être effacés du journal en sélectionnant la ligne du journal 
correspondante et en cliquant sur « Supprimer ».

De la même manière, une entrée peut être modifiée en sélectionnant une ligne
dans le journal, en modifiant le QSO dans le cadre du QSO et en cliquant sur
« Mettre à jour ».

Finalement, en sélectionnant « Éditer -> Tout effacer » à partir du menu, 
tous les champs du cadre QSO seront remis à blanc.
 
----- TOUCHES -----
Voici une liste des touches qui peuvent être utilisées pour naviguer dans
Xlog :

!  Ctrl a ou <Inser>  : ajouter un QSO.
!  Citrl d ou <Suppr> : supprimer le QSO sélectionné.
!  Ctrl h : ouvrir le manuel.
!  Ctrl i : ouvrir le dialogue d'informations.
!  Ctrl k : cliquer tous les boutons, remplir avec les valeurs par défaut.
!  Ctrl m : fusionner des journaux.
!  Ctrl n : créer un nouveau journal.
!  Ctrl o : ouvrir un journal.
!  Ctrl q : fermer le journal.
!  Ctrl r : activer le manipulateur.
!  Ctrl u : mettre à jour le QSO sélectionné.
!  Ctrl s : enregistrer le journal.
!  Ctrl t : afficher/cacher la barre d'outils.
!  Ctrl w : afficher/cacher le dialogue « Déjà contacté ».
!  Ctrl x : quitter le programme.
!  Ctrl y : effacer le contenu du cadre du QSO.
!  Ctrl f : rechercher un QSO dans le journal.
!  Tab    : se déplacer d'un champ à l'autre dans le QSO.
!  PgPréc : faire défiler le journal vers le haut.
!  PgSuiv : faire défiler le journal vers le bas.
!  Home   : aller au début du journal.
!  Fin    : aller à la fin du journal.
!  Flèche haute : sélectionner le QSO précédent.
!  Flèche basse : sélectionner le QSO suivant.
!  Alt 1, Alt2, etc. : basculer entre les différents journaux.
 
----- PRÉFÉRENCES -----

De façon à calculer la distance correcte par rapport à votre station, vous 
devez renseigner votre longitude et votre latitude dans l'onglet « Info » du 
dialogue des préférences. Vous pouvez aussi y préciser si la distance doit être
affichée en kilomètres ou en Miles Nautiques.

                             {xlog-preferencesdialog-info.png}


Lorsque vous comptez réaliser des QSO en VHF/UHF et que vous avez le champ 
« QTH Locator » renseigné dans le journal, il est souhaitable d'entrer votre
propre QTH locator dans le dialogue des préférences.
L'onglet des QSO vous permet de choisir entre une boîte de saisie et une liste
déroulante pour entrer la bande et le mode.

Dans l'onglet « Journaux », vous pouvez décider de l'emplacement où seront
enregistrés vos journaux et quels sont les journaux vous désirez charger au
démarrage (si aucun nom de journal n'est passé lors de l'appel au programme).
Bien sûr, vous devrez relancer xlog et vous assurer que vos journaux se 
trouvent bien à cet emplacement. Vous pouvez utiliser des jokers ou une liste
de journaux séparés par des virgules. L'extension .xlog sera automatiquement 
ajoutée, par exemple, avec un joker, « p* » chargera tous les journaux
commençant avec un « p » et se terminant avec « .xlog ».
 
----- IMPRIMER -----
Vous pouvez imprimer soit une plage de QSO soit la totalité du journal et vous
pouvez choisir quelles colonnes seront imprimées. Il existe deux styles
d'impression : en mode paysage avec 30 QSO par page et en mode portrait avec
50 QSO par page. Les lignes de journal seront réparties régulièrement le long 
de la page. Vous devrez vous assurer que le journal entre dans la largeur du 
papier en choisissant soit une police, soit le style correct.

                                  {xlog-printdialog.png}


Le fichier postscript créé est envoyé à l'imprimante par défaut, mais vous
pouvez aussi imprimer dans un fichier. Le fichier créé s'appelle log.ps, il se
trouve dans le répertoire $HOME/.xlog.

Pour les journaux de concours, vous pouvez activer deux colonnes vides appelées
« Multiplicateurs » et « Points » pour calculer votre résultat. Si vous
choisissez le style portrait, il est recommandé de ne pas sélectionner les 
colonnes « QSL  envoyée », « QSL reçue » et « Commentaires », sinon,
votre journal ne tiendra pas sur la largeur du papier.

----- ÉTIQUETTES DE QSL -----
Glabels est une application gnome pour imprimer des cartes de visite et des
étiquettes, veuillez consulter la page http://snaught.com/glabels. Elle est
conçue pour pouvoir fonctionner avec différentes étiquettes autocollantes et 
feuilles cartonnées pour imprimantes laser ou à jet d'encre que vous pourrez
trouver dans la plupart des magasins de fournitures de bureau. Les informations
qui suivent sont applicables à une version de glabels au moins égale à 0.4.

Vous pouvez utiliser le dialogue « Enregistrer sous » pour exporter votre 
journal vers un type appelé « TSV ». Ceci enregistrera vos champs de journal
dans un fichier avec les champs séparés par des caractères de tabulation. Les 
champs que vous désirez exporter doivent être sélectionnés dans l'onglet 
« Enregistrer sous » du dialogue « Paramètres -> Dialogues ». Le fichier
exporté peut être importé dans glabels en utilisant le patron  (« template ») appelé qsllabels.glabels in /usr/[local/]share/xlog.

1 - Lancer glabels
2 - Ouvrir qsllabels.glabels
3 - Sélectionner «  Propriétés de la fusion » à partir du menu « Outils »
4 - Faire pointer « emplacement » vers le ficher des étiquettes à exporter
5 - Ne changer aucunes des touches personnalisées, cliquer juste sur 
« Accepter »
6 - Vous pouvez maintenant imprimer

Vous pouvez personnaliser la planche d'étiquettes en utilisant « Éditer -> 
Sélectionner tout » à partir du menu, cliquez sur « Nouveau », sélectionnez
la feuille appropriée à partir de la liste déroulante et utilisez « Édition ->
coller » pour copier les champs dans la nouvelle feuille et déplacez-les à
votre convenance avec la souris jusqu'à ce qu'ils s'adaptent à l'étiquette.
Enregistrez ce fichier de façon à l'utiliser comme modèle pour vos étiquettes
de QSL.

----- ÉDITEUR DE JOURNAL -----
L'éditeur de journal, lorsqu'il est sélectionné à partir du menu des outils, 
peut être utilisé pour afficher ou cacher certaines colonnes du journal. Deux
colonnes sont disponibles pour des entrées libres, on peut leur donner un nom.
Les modifications aux colonnes du journal seront enregistrées lors de
l'enregistrement du journal.

                             {xlog-logeditor.png}


Remarquez qu'il peut être souhaitable d'utiliser un nom identique pour un champ
libre utilisant un format d'exportation ADIF tel que décrit dans les
spécifications ADIF que vous trouverez sur :
http://www.hosenose.com/adif/adif.html, section 3: Field Definitions.

L'éditeur de journaux peut aussi être utilisé pour définir la largeur des
colonnes du journal. Vous pouvez entrer un nombre supérieur à 20. Le changement
de la largeur des colonnes prendra effet pour tous les journaux alors ouverts.
Ce nombre peut être égal à zéro, ce qui permet de masquer une colonne.
  
----- VÉRIFICATION DES DOUBLONS -----
On peut vérifier la présence de doublons dans un journal à partir du menu des
outils. Il y a certaines restrictions sur le champ de la fréquence lorsque vous
utilisez la vérification des doublons. Il doit contenir soit un point après la
valeur en Mégahertz ou contenir 3, 6 ou 9 chiffres après le chiffre des unités
des Mégahertz.

                                       {xlog-dupecheckdialog.png}


Lorsque vous utilisez la hamlib, le nombre total de digits dans le champ
indiquant la fréquence peut être défini dans l'onglet « hamlib » du dialogue
des préférences.
 
----- TRI DU JOURNAL -----
Si vous sélectionnez « Outils -> Trier par Date », votre journal sera trié 
par date et heure. Le tri du journal suppose que l'ensemble du journal a été 
créé avec les mêmes paramètres régionaux. La date doit avoir le format 
« dd mmm yyyy » dans vos paramètres régionaux, par exemple « 01 May 2004 »
en anglais, « 01 mai 2004 » en français, etc. Vous pouvez vérifier le nom
correct du mois pour vos paramètres de langue à l'aide de la commande :


					"date --date='01 May'".

Le format de l'heure doit être « HHMM », par exemple « 1423 ». Un journal
trié sera marqué comme ayant été modifiér. Il est recommandé de sauvegarder le
journal sous un autre nom de façon à préserver l'original. Vous devriez 
vérifier que les dates et heures de ce journal sont correctes avant d'écraser 
le journal d'origine. Si le journal n'est pas trié correctement, lancez Xlog 
depuis un terminal et vérifiez si le tri ne produit aucune erreur.

----- DÉFAUTS -----
« Paramètres -> Défauts » affichera un dialogue où vous pourrez entrer les
valeurs par défaut pour la tenue du journal de trafic. Ces valeurs seront
utilisées en sélectionnant « Éditer -> Tout sélectionner » à partir du menu.

                                       {xlog-defaultsdialog.png}


----- DÉJÀ CONTACTÉ -----
Lorsque vous sélectionnez « Déjà contacté » dans le menu, une boîte de 
dialogue sera affichée, elle affichera une liste triée des contacts au fur et à
mesure que vous saisissez l'indicatif. Ceci est particulièrement utile lors de
concours.

                        {xlog-workedwindow.png}


Les colonnes affichées dans ce dialogue peuvent être modifiées depuis le menu 
« Paramètres -> Dialogues » (premier onglet).
 
----- RECHERCHE LORS DE LA FRAPPE -----
Lors de la saisie d'un indicatif, une recherche est effectuée dans le journal,
lorsqu'une correspondance est trouvée, le nom, QTH, locator et commentaires sont
remplis automatiquement. Vous pouvez modifier ce comportement dans le dialogue
des préférences.
 
----- HAMLIB -----
Lorsque Xlog est compilé avec la gestion de la hamlib vous pouvez lire la
fréquence de votre émetteur par l'intermédiaire d'un port série. Vous devez
sélectionner le modèle de votre émetteur et le port utilisé à partir de la liste
disponible dans l'onglet hamlib du dialogue des préférences. Si vous comptez
utiliser un appareil RPC, le port à utiliser sera alors «localhost ».

Le même onglet vous permet d'afficher un fréquencemètre et un s-mètre dans la
barre d'état.

                             {xlog-preferencesdialog-hamlib.png}


Lorsque la hamlib est activée, trois boutons cliquables sont ajouté au cadre de
saisie du QSO de façon à ce que vous puissiez facilement saisir la fréquence, le
mode et la force du signal dans les champs appropriés. Si vous enregistrez la
puissance d'émission dans vos journaux (obligatoire dans certains pays), il y a
aussi un bouton de puissance cliquable dans la fenêtre de QSO.

Vous pouvez choisir d'interroger en permanence votre transceiver à un certain
intervalle de temps ou de récupérer les informations en utilisant « Éditer ->
Tout sélectionner » ou Ctrl-k

Le port hamlib que vous utilisez peut être configuré dans l'onglet « hamlib »
du dialogue des préférences. Vous pouvez entrer quelque chose comme : 
rts_state=ON,timeout=600,serial_speed=19200

----- TEST DE HAMLIB -----
Il faudrait maintenant lire le manuel de votre émetteur pour connaître la
manière de le connecter au port série. Pour mon transceiver Kenwood, il faut
un câble série standard avec deux connecteurs 9 broches. Vous devez aussi avoir
les droits en écriture sur ce port série. Sur mon système, cela signifie qu'il
faut que je fasse partie du groupe dialout, ceci peut se faire avec une 
commande comme celle qui suit :


	adduser 'username' dialout

Ensuite, vous pouvez tester la hamlib avec rigctl, un exécutable distribué avec
la hamlib. 

Pour afficher les transceivers gérés :

	rigctl --list

Lancez ensuite rigctl avec le numéro correspondant à votre transceiver, par 
exemple « 210 » pour un Kenwood TS-870S relié au port COM2:

	rigctl -r /dev/ttyS1 -m 210

Vous pouvez vérifier si le mode, le PTT, la fréquence, la force du signal et 
la puissance (qui sont tous utilisés  par Xlog) sont bien récupérés. À l'invite
« Rig command: », entrez :

	'f': récupérer la fréquence
	'm': récupérer le mode
	't': récupérer le PTT (TX/RX mode)
	'l' et ensuite « STRENGTH » : récupérer la force du signal 
	(-54=S0 et 0=S9)
	'l' et ensuite « RFPOWER » : récupérer la puissance d'émission 
	(0.39 = 100 Watts)

La FAQ de hamlib qu'on peut trouver à http://hamlib.sf.net/faq.html donne
quelques réponses aux problèmes les plus courants. Vous pouvez aussi poser vos
questions sur la liste de diffusion de hamlib, voir l'adresse suivante :
http://lists.sourceforge.net/lists/listinfo/hamlib-developer.

----- FENÊTRE MANIPULATEUR -----
La fenêtre du manipulateur, disponible dans le menu des Outils, est en fait une
simple interface à cwdaemon (destinée aux concours). Vous pouvez programmer
toutes vos touches de fonction avec des messages en CW et contrôler votre 
vitesse de transmission à partir de là. Un clic sur le bouton d'arrêt ou 
l'utilisation de la touche « Echap » arrêtera la transmission d'un message.
Vous pouvez aussi y voir un conteur pour le numéro du QSO, une sélection pour 
des numéros courts et un menu pour sélectionner le mode CQ ou le mode 
« Search & Pound »  : S&F.

                                  {xlog-keyerwindow.png}


La boîte de saisie en bas permet d'entrer du texte. La programmation des 
touches de fonction peut utiliser les macros suivantes :

!  % - mon indicatif
!  @ - son indicatif
!  # - compteur

le compteur s'auto-incrémentera. Les valeurs par défaut seront utilisées pour
remplir les reports de concours, la macro # peut être utilisée dans le champ
TX(RST) de ce dialogue.

----- CONCOURS EN MODE CQ -----
 - le curseur est sur le champ de l'indicatif
 - <Entrée> sur un champ d'indicatif vide va appeler <F1> : « CQ de PG4I PG4I
   test »
 - entrez l'indicatif que vous entendez en pressez <Entrée>
 - <F3> sera transmis : "PA0R 5nntt1"
 - les valeurs correspondant à l'échange seront remplies à partir des valeurs
   par défaut
 - Xlog va sauter à la fin du champ de l'échange <RX(RST)>
 - entrez le numéro de l'échange que vous entendez et pressez <Entrée>
 - Xlog va compléter les champs de date, d'heure et de fréquence
 - l'entrée <CQTU> sera alors transmise : "tu PG4I test"
 - utilisez <ctl-a> oo <Inser> pour enregistrer le QSO dans le journal
 - le compteur sera incrémenté
 - tous les champs seront effacés et Xlog se positionnera sur le champ de 
    l'indicatif

----- CONCOURS EN MODE S&P -----
 - le curseur est sur le champ de l'indicatif
 - entrez l'indicatif que vous entendez et pressez <Entrée>
 - <F6> sera transmis : « PG4I »
 - les entrées de l'échange seront remplies à partir des valeurs par défaut
 - Xlog sautera à la fin du champ de l'échange <RX(RST)>
 - remplissez l'échange et pressez <Entrée>
 - <S&PTU> sera transmis : « TU 5nntt1 »
 - utilisez <ctl-a> ou <Inser> pour inscrire le QSO dans le journal
 - le compteur sera incrémenté
 - tous les champs seront effacés et Xlog se positionnera sur le champ de
 l'indicatif

----- ÉCHANGE DE DONNÉES -----
Xlog peut échanger des données avec twpsk (version 2.0 ou supérieure) de
WA0EIR. Lorsqu'un indicatif est entré, il sera affiché dans le widget d'envoi
de twpsk (où vous entrez le texte) lorsque vous pressez Maj+Alt+h. Maj++Alt+o
affichera « hiscall de mycall ».

gmfsk de OH2BNS (à partir de la version 0.4) peut envoyer des données de 
journal à Xlog, lorsque vous cliquez sur le bouton « mettre l'entrée dans le
journal ». Marote (version 2.3 ou supérieure), un programme de contrôle de
transceiver destiné à l'elecraft K2 de AB6CV fait de même lorsque l'on clique
sur le bouton « Enregistrer dans le journal ».

ktrack deLX2GT (à partir de la version 2.1) peut échanger des données de
satellite avec Xlog. Pour pouvoir le faire, vous devez utiliser les deux champs
libres de l'éditeur de journal. Sélectionnez ensuite « ajoutez les données à
la trame du QSO » dans le dernier onglet du dialogue des préférences.
 
----- IMPORTER et EXPORTER des journaux -----
Xlog gère l'importation des formats ADIF, Cabrillo, EDI (format pour les 
concours CHF et au-delà recommandé apr l'IARU région 1), editest, OH1AA, Trlog 
(tlf). Les journaux peuvent être exportés vers les formats ADIF, Cabrillo et
EDI. L'option appropriée du menu doit être sélectionnée pour le type de fichier
lors de l'exportation ou de l'importation (en utilisant enregistrer sous) d'un
journal.

  {xlog-openlogdialog.png}


! Veuillez vérifier votre journal avant d'effectuer une importation et assurez-
! vous qu'il est dans le bon format. Le dialogue « Journal -> Ouvrir » ouvre
! un widget de prévisualisation qui lit les 10 premières lignes de votre 
! journal de façon à ce que vus puissiez le vérifier.

Lorsque vous utilisez une exportation EDI, vous devez avoir le champ locator
activé dans votre journal. Xlog va calculer automatiquement la distance et
l'ajouter dans le journal. Lorsque vous utilisez une exportation au format ADIF,
vous pouvez décider de convertir la fréquence en bandes. Pour ce faire,
utilisez l'onglet « Enregistrer sous » du dialogue « Paramètres ->
Dialogues ».

Le format d'exportation TSV (valeurs séparées par des tabulations : « Tab 
Separated Value ») est utilisé par glabels (voir le chapitre concernant les
étiquettes de QSL), mais il peut aussi être utilisé de façon à importer les
données du journal dans une feuille de calculs. Vous pouvez aussi utiliser 
l'onglet « Enregistrer Sous » du dialogue | Paramètres -> Dialogues » pour
définir les champs à exporter.

----- FUSION DES JOURNAUX -----
Xlog vous permet de fusionner 2 journaux en sélectionnant Journaux -> Fusion à
partir du menu. Il vous faudra sélectionner deux noms de journaux. Le nouveau
journal sera appelé « log1+log2 » après la fusion.

                                  {xlog-mergelogdialog.png}


Avant de fusionner les journaux, assurez-vous que vous avez le même nombre de
colonnes en utilisant l'éditeur de journaux pour ajouter ou supprimer des
colonnes. Après la fusion, vous pourrez utiliser « Outils -> Trier par Date »
pour trier votre journal.

----- FICHIERS -----
/usr/[local/]share/xlog/dxcc/cty.dat contient les entrées DXCC lues par Xlog.
Ce fichier peut être complété en ajoutant des entrées à 
/usr/[local/]share/xlog/dxcc/xlog.dat.
 
----- POLICE ET THÈMES -----
Les polices de Xlog sont gérées par le moteur de thème de GTK. Lorsque vous
utilisez un bureau gnome2, lancez gnome-font-properties. Sinon, éditez le
fichier ~/.gtkrc-2.0 et ajoutez une ligne comme :

	gtk-font-name = "Times New Roman 14"

ou ce que vous voulez. GNOME 2 applique son propre paramétrage aux programmes
GTK à l'aide du démon gnome-settings-daemon. Lorsque ce démon tourne, les
programmes GTK2 utilisent les paramètres de GNOME plutôt que ceux présents 
dans .gtkrc-2.0.

Il y a aussi une application appelée gtk-theme-switch2, qui vous permet de
modifier le thème ou la police que vous utilisiez gnome ou pas.

----- AUTEUR -----
Xlog a été écrit par Joop Stakenborg <pg4i at amsat.org> aka <pa3aba at
debian.org> et Stéphane Fillod <f8cfe at free.fr>. Avec les contributions
de nombreuses personnes, voir le fichier THANKS.

