MANUEL GJOTS2
g j o t s 2
Par
Bob Hepple
Brisbane
Queensland
Australie
Version _VERSION
bhepple@freeshell.org
http://bhepple.freeshell.org/gjots
Traduction : Rui Nibau (RNB)
rui.nibau@omacronides.com
\NewEntry
Introduction
gjots2 est un éditeur de notes pour le bureau Gnome.
Pourquoi aurions-nous besoin d'un autre programme de prise de notes ? Et bien, lorsque mon cher et vieux organiseur Psion-5 a rendu l'âme, j'ai dû transférer toutes mes données sous Linux et j'ai commencé à rechercher des logiciels répondant à mes besoins. J'en ai trouvé plusieurs agenda et j'ai même écrit une calculatricer (gdcalc), mais rien de vraiment adapté à la prise de notes.
Les programmes que j'ai essayé étaient :
* trop simples (un seul niveau de hiérarchisation),
* trop complexes (trop de composants comme Cobra, SQL ou équivalents)
* basé sur une interface web
* incapables d'afficher l'arborescence et de travailler en même temps sur les notes
* trop fouilli - créant une multitude de fenêtres type post-it sur tout l'écran
Et puis il y avait ceux que je n'arraivais pas à faire fonctionner.
Au final, il y avait de nombreux et d'excellents programmes, mais aucun qui répondait totalement à mes besoins. Kjots semblait être à ce moment là le meilleur de la catégorie.
J'avais de toute façon besoin d'apprendre à créer des arborescences GTK et à utiliser Glade - et Gjots est donc né, et poursuit son chemin depuis. Il a d'abord été écrit en C (maintenant en Python), glade et gtk, était assez rapide et je l'utilise tous les jours. A en juger par les e-mails que j'ai reçu, il est aussi utile à beaucoup d'autres, ce qui est très bien. Il y a même eu une version japonaise du premier gjots (0.3?) mais le code n'a jamais été intégré à la branche principale de développement, ce qui est fort dommage.
Quoi qu'il en soit, le monde ne s'est pas arrêté et GTK-2 est apparu et de nombreuses personnes voulaient des LOTE (Languages Other Than English, ou Langues autre que l'anglais), y compris moi-même. Je voulais aussi apprendre la programmation python et l'actuelle version de gjots - gjots2 ou "le fils de gjots" a vu le jour. Une version écrite en language interprété fût plus compliquée à mettre en route que le gjots original, mais cela permet d'avoir de plus grandes fonctionnalités :
Like Goldilocks said about the chairs, porridge and beds, gjots2 is "just right". (LÃ , si quelqu'un comprend cette citation, qu'il me fasse signe. NdT)
\NewEntry
Installation
Utilisez de préférences les paquetages rpm ou emerge (Gentoo) plutôt que setup.py. Ils permettent une meilleur gestion des dépendances et de la désinstallation.
\NewFolder
\NewEntry
Prerequis
Vous pourriez avoir besoin d'installer (ou de ré-installer) libglade, pygtk, gnome-python, bonobo-python, pyorbit ou gtk pour votre version de python ou plus simplement d'ajuster le chemin de Python comme ci-dessous :
export PYTHONPATH=/usr/local/lib/python2.3/site-packages/
A l'heure où j'écris ses lignes (gjots-2.3.8), ma configuration est la suivante (sur une Gentoo) :
dev-python/gnome-python-2.22.0 (2)
dev-python/gnome-python-desktop-2.22.0 (0)
gnome-base/gnome-common-2.20.0 (3)
gnome-base/gnome-keyring-2.22.3 (0)
gnome-base/gnome-mime-data-2.18.0 (0)
gnome-base/gnome-vfs-2.22.0 (2)
gnome-base/libgnome-2.22.0 (0)
gnome-base/libgnomecanvas-2.20.1.1 (0)
gnome-base/libgnomeui-2.22.1 (0)
x11-themes/gnome-icon-theme-2.22.0 (0)
dev-python/pygtk-2.12.1-r2 (2)
x11-libs/gtk+-2.12.11 (2)
gnome-base/libglade-2.6.3 (2.0)
dev-python/pyorbit-2.14.3 (0)
gnome-base/orbit-2.14.13 (2)
Les distributions à base de rpm (RedHat, Mandrake/Mandriva, SuSE) ont certainement des paquetages similaires (m'avertir si ce n'est pas le cas). Apparemement, Fedora nécessite en plus gnome-python2-gconf.
Assurez-vous que les paquetages python sont installés dans le répertoire "site-packages" de la version de python que vous utilisez (faites un "python -V" pour trouver cette version) :
/usr/lib/pythonX.X/site-packages
Si ce n'est pas le cas, vous devrez les ré-installer - cela m'est par exemple arrivé lors du passage de la version 2.2 à la version 2.3 de python - le répertoire /usr/lib/python2.X/site-packages n'est pas automatiquement mis à jour. J'ai donc du faire :
emerge unmerge libglade pygtk gnome-python bonobo-python pyorbit
emerge libglade pygtk gnome-python bonobo-python pyorbit
Gjots2 a été écrit avec glade-2 donc si vous souhaitez modifier ou corriger le code, il faudra l'installer aussi. Sinon, c'est juste du python !
\NewEntry
Sur une Gentoo
Tant que Gjots2 n'a pas de paquetage officiel ebuild (regardez dans /usr/portage/app-office) vous devrez faire ce qui suit :
Les paquetages nécessaires sous Gentoo (par ordre de dépendance - il y aura sans doute moins de problèmes d'installation en partant de la droite de cette liste et en laissant Gentoo s'occuper des dépendances des modules) :
>=gtk+-2 >=libglade-2 >=pygtk-2 gnome-python-2 >=pyorbit-2
Assurez-vous que vous avez une ligne identique à ce qui suit dans /etc/make.conf :
PORTDIR_OVERLAY=/usr/local/portage
Vous aurez besoin de la ligne suivante dans /etc/portage/packages.keywords :
app-office/gjots2 ~x86
Puis :
VERSION=_VERSION
CAT=/usr/local/portage/app-office/gjots2
cd /usr/portage/distfiles
wget http://bhepple.freeshell.org/gjots/gjots2-${VERSION}.tgz
mkdir -p ${CAT}
cd ${CAT}
wget http://bhepple.freeshell.org/gjots/gjots2-${VERSION}.ebuild
ebuild ${CAT}/gjots2-${VERSION}.ebuild digest
emerge gjots2
\NewEntry
Avec les paquetages RPM
Faîtes simplement ce qui suit :
VERSION=_VERSION
wget http://bhepple.freeshell.org/gjots/gjots2-${VERSION}-1.noarch.rpm
rpm -i gjots2-${VERSION}-1.noarch.rpm
Vous devrez bien-sur installer toutes les dépendances comme pygtk, libglade, etc.
Sur ma Fedora core 4, voici les dépendances listées :
gtk2-2.6.7-4
libglade2-2.5.1-2
pygtk2-2.6.0-2
gnome-python2-2.10.0-1
gnome-python2-gconf-2.10.0-1
pyorbit-2.0.1-4
\NewEntry
A partir des sources
VERSION=_VERSION
wget http://bhepple.freeshell.org/gjots/gjots2-${VERSION}.tgz
Si vous installez à partir de l'archive tarball, placez-vous dans le répertoire des sources après l'extraction de l'archive puis :
python setup.py install [ --prefix=/usr/... ]
Désinstallez avec le script uninstall.sh fournit.
Sur certains systèmes, vous pourriez avoir des problèmes de permissions. Tous les répertoires installés doivent avoir les permissions 0755 et tous les fichiers installés les permissions 0644, à l'exception de 'docbook2gjots', 'gjots2', 'gjots2docbook' et 'gjots2html', qui doivent avoir les permissions 0755.
\EndFolder
\NewEntry
Contribuer
Nous avons deux listes de discussion, pour le développement et pour l'utilisation de gjots :
Gjots Developers <gjots2-devel@lists.sourceforge.net>:
http://lists.sourceforge.net/lists/listinfo/gjots2-devel
Gjots Users <gjots2-users@lists.sourceforge.net>:
http://lists.sourceforge.net/mailman/listinfo/gjots2-users
Les corrections de bugs sont les bienvenus !
Si quelqu'un veut traduire gjots dans une autre langue, contactez-moi et je vous fournirais une version traduisible et les catalogues de message.
J'ajouterai toute nouvelle fonctionnalité à laquelle les utilisateurs veulent contribuer si je l'aime aussi. Si vous souhaitez participer au développement principal du code, contactez-moi d'abord pour être sur que d'autres personnes ne travaillent pas sur le même sujet.
S'il vous plait, utilisez diff -ru pour créer un patch, et envoyez-le sous forme d'archive compressée gzip en pièce attachée.
Si je décide de ne pas incoprorer votre fonctionnalité, vous êtes libre de créer un fork, mais s'il vous plait choisissez un nom différent pour votre programme.
Il s'agit de code sous GPL après tout.
Notez que pour respecter la licence GPL, je devrais inclure vos nom et e-mail dans la section Auteurs & Licence.
Si vous souhaitez contribuer, contactez la liste de diffusion du développement <gjots2-devel@lists.sourceforge.net>, pour être sur qu'il n'y a pas de doublons dans le travail.
Pour des questions plus générales, lisez "Fonctionnalités prévues".
\NewEntry
MANUEL UTILISATEUR
\NewFolder
\NewEntry
Démarrage
Lancez juste "gjots2" - cela sauvegradera tout dans le fichier $HOME/.gjotsfile
Ou ajoutez un argument - gjots2 s'ouvre avec un fichier uniquement :
gjots2 fichier.gjots
Voici les options disponibles :
--help
Affiche l'aide
-g, --geometry LARGEURxHAUTEUR[+X+Y]
Taille initiale de la fenêtre. X et Y sont pour le moment ignorés.
-r, --readonly
Ouvre un fichier en lecture seule
-d, --debug
Affiche des informations pour le déboguage
\NewEntry
Ouvrir et enregistrer
Ouvrir et enregistrer ont la même fonction que partout ailleurs, pour des fichiers au format gjots (voir plus bas).
A moins que l'option Lecture seule soit active, gjots2 créé un fichier verrouillé à chaque ouverture pour assurer qu'un seul utilisateur puisse y écrire, tout en permettant de multiples lecteurs. Si un fichier est ouvert alors qu'il est déjà verrouillé, un petit message d'alerte donnera à choisir entre "lecture seule" et "ré-essayer". L'option "ré-essayer" permet de quitter le programme qui verrouille le fichier. Le fichier verrouillé est un fichier nommé .#nom_fichier, ou "nom_fichier" est le nom du fichier en train d'être édité. Il se situe dans le même répertoire que le fichier gjots2 original et il contient juste l'identifiant du processus (pid) qui le verrouille. Si le processus qui verrouille s'arrête sans nettoyer ce fichier, alors gjots2 pourrait le détecter à la prochaine ouverture.
Le verrouillage est valable même sur un volume NFS.
Un fichier ouvert en lecture seule n'est pas verrouillé.
Il existe une entrée dans le menu "fichiers" qui permet d'activer l'option "Lecture seule". Elle prend aussi soin de verrouiller ou de déverrouiller le fichier.
Quand Gjots2 enregistre un fichier, il enregistre aussi la version précédente dans un fichier de sauvegarde, à la manière d'emacs. Si vous enregistrez un fichier "fichier.gjots", alors la version sauvegardée s'appelera "fichier.gjots~".
Si l'extension du fichier est ".cpt", gjots essayera de chiffrer et déchiffrer le fichier en utilisant ccrypt(1). Si ccrypt n'est pas installé (il ne l'est pas par défaut dans de nombreuses distributions Linux), l'enregistrement échouera.
De la même manière, les fichiers .ssl seront ouvert avec (DES3) openssl et les fichiers .gpg avec (DES3) gpg.
Installer ccrypt, openssl or gpg pour une meilleure sécurité !
\NewEntry
Contrôles
La fenêtre possède une barre de menus et une barre d'outils suffisamment explicites.
La barre d'outil sur la gauche contrôle la hiérarchie de l'arborescence. Amusez-vous un peu avec les boutons et vous verrez vite comment les utiliser.
"Nouvelle Page" créé une nouvelle note soeur de la note courante.
"Nouvel Enfant" créé une note fille de la note courante.
"Haut" place la sélection avant la note précédente.
"Bas" fait exactement le contraire.
"Remonter" fait remonter les notes sélectionnées d'un niveau dans la hiérarchie.
"descendre" fait descendre d'une niveau les notes sélectionnées.
"Scinder la note" prend le texte sélectionné (dans la fenêtre d'édition, à droite) et le place dans une nouvelle note
"Fusionnez les notes" prend le texte et les notes sélectionnés pour les fusionner en une seule note.
"Masquer Tout" masque l'arborescence de l'arbre pour ne garder les notes filles de la note racine.
"Montrer Tout" affiche toute l'arborescence de la note courante.
"Trier l'arbre" affiche la fenêtre de tri avec différents critères pour modifier l'organisation.
Lorsqu'une note ou dossier perd toutes ces notes filles, elle redevient une note simple.
Dans la barre d'outils principale :
"Nouvelle Page", "Ouvrir" et "Enregistrer" font ce qui est habituel.
Le bouton "Impression" affiche la fenêtre d'impression.
"Couper", "Coller" et "Copier" ont une double fonctionnalité puisqu'ils agissent à la fois sur le texte et sur l'arborescence, en fonction de ce qui est sélectionné.
Le bouton "Retour" formate le paragraphe courant en coupant la ligne à la longueur spécifier dans les préférences. (activer par le raccourci-clavier CTRL+L)
Le bouton "Ed.Ext." ouvre l'éditeur de texte définit dans les préférences. La commande par défaut est 'nedit %s', 'xedit %s' ou 'xterm -e vi %s' - en fonction de votre distribution - le %s étant remplacé par le nom du fichier temporaire. Tout autre éditeur peut être utilisé s'il accepte un nom de fichier comme argument - personnellement, je préfère "emacsclient %s".
Le bouton "Date" insère le date/l'heure à la position du curseur. vous pouvez spécifier le format de cette insertion dans les préférences.
Le bouton "Chercher" ouvre la fenêtre chercher/remplacer.
Le bouton "Trier" affiche la fenêtre de tri.
Le bouton "Prefs" affiche la fenêtre des préférences.
\NewEntry
Cherchez et Remplacer
Ctrl+F, Edition->Rechercher ou le bouton "Chercher" dans la barre d'outils principale affichent la fenêtre de recherche.
Son utilisation est assez intuitive : tapez le mot à rechercher dans le champ "Chercher" est cliquez sur le bouton "Chercher".
Pour remplacer une occurence, tapez le nouveau texte dans le champ "Remplacer" et cliquez sur le bouton "Remplacer". Le programme cherche cette première occurence. Cliquez sur le bouton de nouveau et elle sera remplacée et l'occurence suivante sera trouvée.
Pour remplacer toutes les occurences, utilisez le bouton "Remplacer Tout".
Les boutons "Fermer" et "Annuler" ferment tout deux la fenêtre de recherche - le bouton "Fermer" sauvegarde tous les nouveaux paramètres pour une utilisation ultérieure (à l'exception des chaînes à chercher et à remplacer).
Le bouton "Effacer" efface juste les champs "Chercher" et "Remplacer".
Toutes les erreurs apparaissent dans la zone directement au dessous du bouton et dans la barre d'état de gjots2.
Les options sous les boutons sont :
- "sensible à la casse", pour limiter la recherche en fonction de la casse
- "Global" permet d'effectuer les opérations sur tout le fichier; sinon, elles se font sur la note courante
- "Expression régulière" permet d'utiliser les expressions régulières (ER) étendues POSIX. Ces expressions sont définies dans "man 7 regex" (utilisées de la même manière dans egrep).
Voici une rapide introduction aux expressions régulières (notez que gjots2 utilise les paquetages python - consultez la documentation python pour plus de détails, c'est beaucoup plus simple que regex utilisé dans la version en C de gjots) :
. n'importe quel caractère
^ Début de ligne (si placer au début de l'ER)
$ Fin de ligne (si placer en fin d'ER)
* répétitions 0 ou plusieurs fois du caractère précédent
+ répétition une ou plusieurs fois du caractère précédent
? présence ou absence du caratère précédent
{n} le caractère précédent doit être répété n fois
{n,} le caractère précédent doit être répété n fois ou plus
{n,m} le caractère précédent est répété entre n et m fois
[ ] trouver n'importe quel caractère situé entre les crochets. ex. [a-z]
[^ ] Les caractères entre crochets ne doivent pas être dans l'expression recherchée
( ) Définition d'un groupe
| le "ou" : x|y signifie "trouver x ou y"
\n n de 1 à 9 - référence aux groupes définis avant
\b Début ou fin de mot
\d tout caractère numérique == [0-9]
\s n'importe quel espace (fin de ligne, tabulation, etc.) == [ \t\n\r\f\v]
\S Tout caractère qui n'est pas un espace
\w caractère alphanumerique
\W caractère non-alphanumerique
Pour trouver un des caractères "magiques" ^.[$()|*+?{\ il faut le faire précéder d'un \
Pour remplacer l'expression, les fonctions suivantes sont disponibles :
\& coller toute la chaîne trouvée
\1..\9 coller le groupe désigné (de 1 à 9), défini par (...)
\n insérer une nouvelle ligne
\NewEntry
Impression
La fenêtre d'impression vous permet de choisir ce que vous voulez imprimer :
la page courante,
la sélection ou
tout le fichier
Quelques petites personnalisations :
alimenter l'imprimante avec une nouvelle page après chaque note et
numérotation des pages (pas encore fonctionnelle)
Les réglages actuels de la commande "Impression" essayent d'imprimer par l'intermédiaire du programme de pré-visualisation de votre système tel que :
if type gv; then
GV='gv -seascape'
else
if type ggv; then
GV=ggv
else # no preview command found, just print it
lpr $1
exit
fi
fi
T=/tmp/.tmp.$$
mpage -f -2 -I1 -P- $1 > $T
($GV $T; rm $T)&
En plus d'être un peu compliqué, ce script souffre de ne pouvoir reconnaître d'autres visionneurs postscripts (kghostview, evince, etc) ou des incompatibiltés de versions, comme gv-3.6.1 qui ne comprend pas -seascape, il nécessite --seascape.
Jusqu'à ce qu'il y ait un système standardisé pour pré-visualiser une impression dans X (pour Kde, Gnome et les autres!!), nous nous en remettons à vous, aimables utilisateurs, pour personnaliser le script afin qu'il convienne à votre configuration.
Quelques suggestions pouvant remplacer le script par défaut :
Envoyer simplement les données vers l'imprimante :
lpr $1
Pour utiliser un programme de pré-visualisation, ajustez la commande "Impression" comme suit :
GV='gv -seascape'; T=/tmp/.tmp.$$;mpage -f -2 -I1 -P- $1 > $T;($GV $T; rm $T)&
Cela suppose que vous ayez gv-3.5.8. Pour utiliser un autre programme ou des options différentes, modifiez les paramètres de GV comme suit :
# pour utiliser gv-3.6.1:
GV='gv --seascape'
# pour utiliser ggv:
GV='ggv'
# pour utiliser kghostview:
GV='kghostview'
# pour utiliser evince (non testé):
GV='evince'
Remarquez que ggv, kghostview et evince (?) n'ont pas d'option en ligne de commande pour inverser l'image, vous devrez donc le faire avec la souris. C'est fou non ?
Moi ? J'utilise gv.
\NewEntry
Préférences
Les données suivantes peuvent être personnalisées et utilisées par gconf :
Formatteur de texte - par défaut, "fmt -w %d"
Longueur de ligne - Utiliser dans le formatage d'un paragraphe, (65)
Editeur externer - éditeur à utiliser avec le bouton "Ed.Ext.". Exemples :
nedit %s
xedit %s
xterm -e vi %s
emacsclient %s
Format Date - chaîne à adresser à strftime(3) pour insérer la date/l'heure. Faites un "man strftime" pour comprendre la syntaxe. Exemples :
%F : (2002-11-03)
%c : Sun 03 Nov 2002 10:33:22 AM EST
(%d %b %y) : (03 Nov 02)
Police - Police à utiliser pour afficher le texte. Les boutons et l'arbre utilisent les polices par défaut de GTK-2.
\NewEntry
Raccourcis clavier
La plupart des raccourcis clavier de gjots sont ceux utilisés ailleurs. Dans la fenêtre d'édition du texte, les raccourcis GTK-2 sont utilisés (quelque peu différents de ceux de la version C/GTK-1 de gjots):
Ctrl+a Selectionner tout le texte
home Retour en début de ligne
fin Aller en fin de ligne
gauche retour en arrière d'un caractère
droite Avancer d'un caractère
Ctrl+gauche Reculer d'un mot
Ctrl+droite Avancer d'un mot
bas Aller à la ligne suivante
haut Remonter d'un ligne
Ctrl+home/fin Aller au début/à la fin du texte
suppr supprimer un caractère
retour Supprimer le caractère précédent
Ctrl+L Formater le paragraphe
La touche Maj et les flèches permettent de selectionner le texte.
Ces raccourcis clavier fonctionnent aussi:
Ctrl+x couper
Ctrl+c copier
Ctrl+v coller
Les raccourcis dans l'arbre:
En général, les touches simples permettent de se déplacer dans l'arbre.
La touche Contrôle manipule l'arbre.
haut Aller à la note précédente
bas Aller à la note suivante
Ctrl+haut Déplace la note courante vers le haut
Ctrl+bas Déplace la note courante vers le bas
maj-haut/bas Etend la sélection
gauche ascend the tree
right descend the tree
Ctrl+gauche Remonte la sélection dans l'arborescence
Ctrl+bas Descend la sélection dans l'arborescence
home Aller à la première note du niveau courant
end Aller à la dernière note du niveau courant
Ctrl+home Aller à la toute première note
Ctrl+fin Aller à la toute dernière note (visible)
Raccourcis clavier globaux:
Ctrl+s Enregistrer
Ctrl+q Quitter
Ctrl+f Fenêtre de recherche
\NewEntry
Importer and exporter
Vous pouvez importer ou exporter des données dans gjots en utilisant les fonctions dédiées à cet effet. L'opération s'effectue dans la note courante donc vous pouvez contrôler ce qui sera enregistré.
Le format des fichier est le format habituel de gjots2.
\NewEntry
Format des fichier gjots2
Le même que celui de gjots, qui est le même que celui de kjots, avec la hiérachie en plus :
\NewEntry
titre1
Texte qui appartient à la note de titre1
\NewFolder
\NewEntry
titre2
Texte de la note titre2, fille de titre1
\NewEntry
titre3
Texte de la note titre3, toujours fille de titre1
\EndFolder
Les mots-clés \mots-clés doivent être en début de ligne pour qu'ils soient reconnus.
\NewEntry
Chiffrement
gjots2 peut chiffrer et déchiffrer des fichiers en utilisant les paquetages ccrypt(1), openssl(1) et gpg(1).
Les fichiers sont enregistrés avec un chiffrement qui dépend du suffixe utilisé :
.cpt ccrypt
.ssl openssl
.gpg gpg
gjots2 demandera un mot de passe quand cela est nécessaire.
Assurez-vous d'avoir installé ccrypt, openssl ou gpg si vous voulez utiliser ces fonctionnalités.
Ne perdez pas votre mot de passe - je ne pourrais pas vous aider à le retrouver.
\NewEntry
Sécurité
Pour le chiffrement avec ccrypt, j'ai utilisé l'équivalent de :
{write cleartext} | KEYWORD=password ccencrypt -E KEYWORD >filename.cpt
Ceci expose brièvement le mot de passe en tant que paramètre d'environnement bien qu'il soit 'ré-écrit' et supprimé du processus de gjots2 juste après son utilisation. D'après le manuel de ccrypt, "sur la plupart des systèmes modernes", la commande ps protège les paramètres d'environnement des utilisateurs. Sous Linux, vous pouvez faire un 'cat/proc/PID/environ' pour voir les paramètres d'environnement qui vous appartiennent - seul le root peut espionner les autres environnements donc utiliser -E n'est pas moins sécurisé que votre mot de passe de session ou le mot de passe du root.
L'unique autre manière de faire cela (AFAICS) serait :
{write cleartext} >file.gjot
echo password |ccencrypt -k - file.gjot
... alors que cela offre une meilleure protection du mot de passe, cela expose aussi (brièvement) le cleartext en tant que fichier - tout aussi mauvais que d'exposer la clé en tant que paramètre d'environnement !
Le déchiffrement est plus simple - j'utilise stdin pour transmettre le mot de passe :
echo password |ccdecrypt -c -k - filename.cpt | {read from pipe}
Une voie supplémentaire (ex. stdin=0, stdout=1 stderr=3 stdpasswd=3) pour que ccrypt lise les mots de passe pourrait être une meilleure solution (mais ccrypt ne le permet pas).
\NewEntry
Utilitaires
\NewFolder
\NewEntry
gjots2html
gjots2html convertit les fichiers gjots2 en fichier HTML avec un sommaire qui ressemble à l'arborescence du fichier.
Lisez la page man dédiée pour en savoir plus.
gjots2html.py est une version python du même utilitaire sans doute plus digne de confiance.
\NewEntry
gjots2docbook
Convertit le fichier gjots2 au format XML DOCBOOK.
Lisez la page man dédiée pour plus de détails.
\NewEntry
docbook2gjots
Convertit un fichier XML DOCBOOK en fichier gjots2.
Lisez la page man dédiée pour plus de détails.
\EndFolder
\EndFolder
\NewEntry
Etat du projet
Si vous avez des idées pour améliorer gjots2, envoyez un e-mail à gjots2-users@lists.sourceforge.net
\NewFolder
\NewEntry
Fonctionnalités prévues
Ce qu'il reste à ajouter se limitera au niveau du design à ce qui est "rapide et léger", mais pourra inclure :
Traduction
============
Depuis la version _VERSION, gjots2 est prêt pour d'éventuelles traductions. Si vous souhaitez avoir une version de gjots dans votre langue, contactez la liste de diffusion consacrée au développement <gjots2-devel@lists.sourceforge.net>
gjots2
======
Ajouter la date/l'heure à toutes les notes.
Tri automatique on/off
Edition->Effacer, Propriétés,
Paramètres->préferences
Enregistrement automatique
Supportpour des options su les notes: \les options incluant:
fermer/ouvrir
détails des paramètres
...?
gjots2html
==========
gjots2html pourrait être modifié. Il y a un script python encore en phase beta qui permet :
1) d'ajouter un <HR> après chaque section.
2) d'ajouter un lien vers le sommaire après chaque section.
3) de définir un titre pour la page.
4) d'insérer le résultat de la conversion par gjots2html.py dans un modèle de page HTML.
5) de supprimer le sommaire des sections.
6) d'ajouter le contenu dans un fichier HTML spécifié.
7) d'ajouter un lien vers une feuille de styles en cascade.
8) de couper le texte de gjots2 à une largeur définie.
Il permet aussi un nombre de niveaux hiérarchiques arbitraires, même si HTML n'en possède que 6.
Ajouter les options:
-r N, --rule=N: <HR> pour tous les niveaux supérieurs à N
\NewEntry
Bugs connus
Aucun de connu, bien sur, Ã part :
Message d'erreur innaproprié s'il est impossible d'ouvrir un fichier gjots2 au premier lancement
The sort dialog can't set itself to the values stored in gconf.
\NewEntry
Plateformes
Tester sur les plateformes suivantes :
Gentoo Linux i386
Ubuntu 5.10
Mandrake 10.1
Fedora Core 3, 4
Novell Linux Desktop 9
SUSE 9.2, 9.3
Nous sommes toujours à la recherche de personnes capables de tester gjots2 sur leur distribution favorite. Laissez-nous un message à <gjots2-devel@lists.sourceforge.net> et nous serons heureux d'ajouter votre distribution dans la liste des plateformes testées.
Certaines de ces distributions nécessitent peut-être une mise à jour de certains paquetages. Voyez la FAQ pour plus de détails.
\EndFolder
\NewEntry
FAQ Gjots
Foire Aux Questions ou questions fréquemment posées sur Gjots2
Si vous avez une question qui n'est pas listée ci-dessous, laissez un message sur la liste de discussion des utilisateurs de gjots2 <gjots2-users@lists.sourceforge.net>.
\NewFolder
\NewEntry
Q: Les icones de la barre d'outils latérales sont écrasées.
R: vous utilisez une version buguer de libglade2. Mettez à jour votre système avec une version >= 2.4.1. Nous vous conseillons de le faire par l'intermédiaire du gestionnaire de paquetages de votre distribution.
\NewEntry
Q: Je reçois le message d'erreur suivant: ImportError: No module named distutils.core when building gjots2 from source.
R: Votre distribution n'a pas inclut les modules distutils lors de l'installation des paquetages python. Installez python correctement pour résoudre le problème. Cela arrive pour Ubuntu (5.10), NLD9, SUSE 9.2.
Correction pour Ubuntu 5.10:
# apt-get install pythonX.X-dev
\NewEntry
Q: Je reçois le message d'erreur suivant: ImportError: No module named gconf
R: Installez gnome-python-2. Ce paquetage contient les liens Python pour gconf. Vous pouvez le trouver ici :
http://www.pygtk.org/
Vous devriez trouver des paquetages déjà construit comme les suivants.
Mandrake 10.1:
# rpm -ivh gnome-python-gconf-2.0.3-1mdk.i586.rpm
Fedora Core 3:
# rpm -ivh gnome-python2-gconf-2.6.0-3.i386.rpm
\NewEntry
Q: Comment utilisez gjots2 sur une distribution Novell Linux Desktop?
R: Vous devrez installer gnome-python (et toutes ses dépendances).
\NewEntry
Q: Quelles sont les différences entre l'ancienne version en C (gjots-0.X) et la nouvelle version en python (gjots-2.X.X)
R: Pour la version 2.0.0, voici les différences (pour les versions ultérieures, lisez le CHANGES logs):
Support de l'Unicode - je peux donc écrire des notes en Russe - peut-être en turque, en arabe, qui sait comment ca marchera. Toutes remarques à ce sujet sont les bienvenues !
Support pour LOTE (langues autre que l'anglais). Des volontaires pour I18N et L10N?
Glisser-déposer dans l'arborescence pour faciliter l'organisation.
Support gconf avec les thèmes GTK-2.
Tri du texte ou des notes
Fusion des notes
Scinder les notes
Impression
\EndFolder
\NewEntry
Auteurs & Licence
\NewFolder
\NewEntry
Auteurs
Ecrit par :
Bob Hepple <bhepple@freeshell.org>
Gabriel Munoz <munozga@gmail.com>
Logo par :
DSP Popeck <wokoglopulator@yahoo.com>, 2002
Traduction française par :
Rui Nibau <rui.nibau@omacronides.com>, 2005
\NewEntry
Licence (GPL) - français
Vous pouvez trouver une traduction française de la GNU GPL ici :
http://fsffrance.org/gpl/gpl-fr.fr.html
Attention : seule la version originale, en anglais, reproduite ci-dessous, à valeur juridique. La traduction française n'est là que pour mieux vous aidez à comprendre le sens de cette licence.
\NewEntry
Licence (GPL)
Copyright (C) 2005 Robert Hepple
Copyright (C) 2002 DSP Popeck
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
\EndFolder
