Dernières publications | Jean-Philippe Fleury

Gestion de projet avec Git

Tue, 01 May 2012 00:59:00 -0400

Ce qui suit illustre une méthode de travail avec Git.

Création du projet

Note: l'emplacement distant utilisé en exemple pour héberger le projet est sur Baregit.

cd /tmp
mkdir projet-demo
cd projet-demo
git init
touch version.txt
git add .
git commit -m "Début de versionnage de projet-demo"
git remote add origin git@baregit.com:utilisateur/projet-demo.git
git push origin master

Création d'une branche de développement

La branche de développement est utilisée pour préparer la prochaine version. C'est donc sur cette branche que le travail s'effectue. La branche master contient toujours le code de la dernière version stable publiée.

git checkout -b dev
touch fichier1
git add .
git commit -m "Message fichier1"
git push origin dev

Création d'une branche topique

Une branche topique, créée à partir de la branche dev, est utile pour travailler sur une nouvelle fonctionnalité, qui pourra être ajoutée plus tard dans la branche de développement.

git checkout -b fonctionnalite1
touch fonctionnalite1-fichier1
git add .
git commit -m "Message fonctionnalite1-fichier1"
touch fonctionnalite1-fichier2
git add .
git commit -m "Message fonctionnalite1-fichier2"

Continuation du travail sur la branche de développement

git checkout dev
touch fichier2
git add .

# On met de côté les modifications en cours pour travailler sur autre chose.
git stash
touch fichier3
git add .
git commit -m "Message fichier3"

# On retourne travailler sur les changements précédemment mis de côté.
git stash pop
git status
git add .
git commit -m "Message fichier2"
git push origin dev

Travail sur le même projet à partir d'un autre emplacement

git clone git@baregit.com:utilisateur/projet-demo.git ../autre-emplacement-projet-demo
cd ../autre-emplacement-projet-demo
git checkout dev
touch fichier4
git add .
git commit -m "Message fichier4"
git push origin dev

Retour au premier emplacement

Pour mettre à jour une branche locale, il est souvent conseillé d'utiliser git pull. Cette commande effectue en réalité deux actions:

git fetch, pour récupérer les modifications présentes à l'emplacement distant;
git merge, pour intégrer ces modifications dans la branche locale courante.

Si la branche locale ne contient pas de modifications inconnues de l'emplacement distant, git merge va simplement déplacer la référence HEAD vers la dernière révision. Exemple (les graphiques ont été générés avec gitg):

Avant git merge:
Après git merge:

Dans le cas contraire, les deux branches divergent et une nouvelle révision va être créée pour contenir les modifications de la fusion. Cette révision va bien sûr apparaître dans l'historique. Exemple:

Avant git merge:
Après git merge:

Avec le temps, l'historique va en être considérablement alourdi. Pour cette raison, j'utilise git rebase, qui permet de réappliquer les modifications locales à la suite de la dernière révision de la branche distante. L'historique demeure donc linéaire. Exemple:

Avant git rebase:
Après git rebase:

Voir l'article Rebasing Merge Commits in Git concernant l'importance d'utiliser le paramètre -p (--preserve-merges) avec git rebase.

Note: au lieu des deux commandes git fetch origin et git rebase -p origin/dev ci-dessous, un alias peut être créé:

git config --global alias.frp '!git fetch origin && git rebase -p origin/$(branche="$(git symbolic-ref HEAD 2>&-)" && echo ${branche#refs/heads/})'

Pour que l'alias soit actif seulement pour le projet courant, enlever le paramètre --global.

cd ../projet-demo
git checkout dev
git fetch origin
git rebase -p origin/dev
touch fichier5
git add .
git commit -m "Message fichier5"
echo "1.0" > version.txt
git add .
git commit -m "Mise à jour du numéro de version (1.0)"

Publication de la première version

Lorsque la branche de développement reflète l'état désiré pour la prochaine version du logiciel, elle est fusionnée dans la branche master, et une étiquette est créée avec le numéro de version.

Le paramètre --no-ff est utilisé lors de la fusion pour s'assurer que les révisions de la branche de développement soient regroupées dans l'historique et facilement distingables des autres révisions.

Aussi, le paramètre -s utilisé avec git tag permet de créer une étiquette signée. Utiliser le paramètre -a pour créer un objet tag sans le signer.

git checkout master
git fetch origin
git rebase -p origin/master
git checkout dev
git rebase -p master
git push origin dev
git checkout master
git merge --no-ff dev
git tag -s 1.0 -m "Message 1.0"
git push --tags origin master

Développement de la deuxième version

git checkout dev
touch fichier6
git add .
git commit -m "Message fichier6"
git push origin dev

Continuation du développement de la fonctionnalité 1

Noter l'utilisation de git rebase pour ajouter dans la branche topique les modifications de la branche de développement.

git checkout fonctionnalite1
git rebase -p dev
touch fonctionnalite1-fichier3
git add .
git commit -m "Message fonctionnalite1-fichier3"

Intégration de la fonctionnalité 1

Lors qu'une foncitonnalité est terminée, la branche topique correspondante est fusionnée à la branche de développement, et est ensuite supprimée. Noter l'utilisation du paramètre --no-ff lors de la fusion.

git checkout dev
git fetch origin
git rebase -p origin/dev
git checkout fonctionnalite1
git rebase -p dev
git checkout dev
git merge --no-ff fonctionnalite1
git branch -d fonctionnalite1

Continuation et fin du développement de la deuxième version

touch fichier7
git add .
git commit -m "Message fichier7"
echo "2.0" > version.txt
git add .
git commit -m "Mise à jour du numéro de version (2.0)"
git push origin dev

Publication de la deuxième version

git checkout master
git fetch origin
git rebase -p origin/master
git merge --no-ff dev
git tag -s 2.0 -m "Message 2.0"
git push --tags origin master

L'historique résultant de ce projet de démonstration est le suivant:

Corbeille-SpaceFM: corbeille pour SpaceFM conforme à la spécification de freedesktop.org

Thu, 05 Apr 2012 15:27:00 -0400

Read this page in English.

Aperçu

Corbeille-SpaceFM est une extension ajoutant le support de la corbeille au gestionnaire de fichiers SpaceFM.

Corbeille-SpaceFM est conforme à la spécification de freedesktop.org relative à la corbeille, et est donc interopérable avec d'autres implémentations conformes, qui pourront gérer les fichiers mis à la corbeille par Corbeille-SpaceFM, et vice versa. Des essais ont été effectués avec Thunar, Nautilus et Dolphin.

Corbeille-SpaceFM gère sans problème les noms de fichiers formés de n'importe quel caractère valide, par exemple des retours à la ligne.

Aussi, une attention particulière a été portée à la vitesse d'exécution. Corbeille-SpaceFM supporte les processeurs multicoeurs et peut manipuler des centaines ou des milliers de fichiers sans souffrir d'un ralentissement trop important. Voir la section Précisions ci-dessous pour des tests de performance.

Dépendances

Un effort a été déployé pour requérir un minimum de dépendances. Corbeille-SpaceFM est écrit en Bash et fait seulement appel à quelques commandes externes provenant toutes du paquet coreutils (ls, mv, rm...); il devrait donc fonctionner pour tout le monde sans installation supplémentaire.

Installation

La marche à suivre pour installer une extension dans SpaceFM est décrite dans le manuel du logiciel. En gros, il y a deux possibilités:

Installer une extension. Les fichiers de l'extension sont protégés contre une modification inopportune puisqu'ils appartiennent au superutilisateur (le mot de passe du superutilisateur est nécessaire lors de l'installation), et l'extension est disponible pour tous les utilisateurs dans le menu Plugins de SpaceFM.
Copier une extension.. Une fois copiée, l'extension peut être collée dans n'importe quel menu (aucun mot de passe superutilisateur requis).

Pour chacune des options, il est possible de télécharger soi-même l'extension pour ensuite la sélectionner sur son disque dur, ou bien de fournir une URL et laisser SpaceFM gérer le téléchargement. Consulter la liste des fichiers offerts en téléchargement.

Alternativement, une archive peut être construite à partir du code source:

Télécharger le code source..
Extraire l'archive.
Ouvrir une console dans le dossier extrait.
Dans la console, lancer la commande suivante:
```
./script.sh archive $LANGUE
```

Les valeurs possibles pour $LANGUE sont en et fr. Une archive sera créée à la racine du dossier. Elle peut être directement utilisée par SpaceFM pour procéder à l'installation.

Désinstallation

Voir les instructions pour désinstaller une extension dans le manuel de SpaceFM.

Utilisation

Corbeille-SpaceFM correspond à un ensemble de 9 commandes (disponibles dans le menu Plugins | Corbeille de SpaceFM si l'installation a été effectuée avec les droits d'administration). Prendre note qu'il n'y a pas de fenêtre de confirmation après qu'une commande est sélectionnée.

Mettre à la corbeille: au moins un fichier en dehors de la corbeille doit être sélectionné pour que cette commande soit active. Les fichiers sélectionnés seront déplacés vers la corbeille.

Le raccourci clavier Maj+Suppr permet de mettre à la corbeille les fichiers sélectionnés. Note: il semble y avoir un bogue avec SpaceFM, qui ne reconnaît pas un raccourci clavier paramétré par une commande d'une extension. Pour l'instant, il faudra le créer manuellement.
Restaurer: au moins un fichier dans la corbeille doit être sélectionné pour que cette commande soit active. Les fichiers sélectionnés seront déplacés vers leur emplacement original. Si un fichier existe déjà à cet emplacement, aucun déplacement n'aura lieu et un message d'erreur sera affiché.
Supprimer définitivement: au moins un fichier dans la corbeille doit être sélectionné pour que cette commande soit active. Les fichiers sélectionnés seront supprimés définitivement, donc ils ne pourront plus être restaurés à partir de la corbeille.
Aller à la corbeille: cette commande est toujours active. Le dossier de la corbeille sera ouvert dans un nouvel onglet dans la fenêtre actuelle de SpaceFM. Aussi, si des corbeilles racine sont trouvées (par exemple, une corbeille à la racine d'un support amovible), elles seront ouvertes chacune dans un nouvel onglet.
Afficher les propriétés: cette commande est toujours active. Une boîte de dialogue affichera le nombre de fichiers mis dans la corbeille ainsi que la taille totale de la corbeille.
Vider la corbeille: cette commande est toujours active. Il s'agit d'un raccourci pour supprimer définitivement tous les fichiers de la corbeille. Le même résultat peut être obtenu en sélectionnant tous les fichiers de la corbeille et en choisissant de les supprimer définitivement.
Limiter la taille de la corbeille: cette commande est toujours active. Elle permet de réduire la corbeille à une taille donnée. Les fichiers sont supprimés en ordre croissant de date de mise à la corbeille (les fichiers mis à la corbeille depuis le plus longtemps sont supprimés en premier).
Supprimer les anciens fichiers: cette commande est toujours active. Elle permet de supprimer les fichiers mis à la corbeille depuis un nombre de jours donné.
Supprimer les fichiers volumineux: cette commande est toujours active. Elle permet de supprimer les fichiers mis à la corbeille et dont la taille est supérieure ou égale à une taille donnée.

Précisions

Vitesse

Corbeille-SpaceFM a été pensé pour être rapide, même lorsque qu'un nombre important de fichiers doivent être manipulés. Les processeurs multicoeurs sont supportés, les commandes intégrées de Bash ont été privilégiées autant que possible et le nombre de sous-processus à l'intérieur de boucles a été réduit au minimum.

Des tests de performance ont été effectués pour comparer Corbeille-SpaceFM avec Thunar, le gestionnaire de fichiers par défaut de Xfce (Thunar a été choisi, car Xfce est le gestionnaire de bureau que j'utilise). Chaque commande du test manipulait 1000 fichiers texte et a été lancée 5 fois. Les résultats correspondent au temps moyen en secondes.

Le premier test a été effectué sur un portable ayant un processeur Intel Core 2 Duo T9300 et 4 Gio de mémoire vive. SpaceFM 0.7.3 et Thunar 1.2.3 ont été utilisés sous Xubuntu 11.10. Les résultats sont les suivants:

	Corbeille-SpaceFM	Thunar
Mettre à la corbeille	3	12
Supprimer définitivement	3	12
Restaurer	4	15
Vider la corbeille	1	1

Le deuxième test a été effectué sur un miniportable ayant un processeur Intel Atom N450 et 2 Gio de mémoire vive. SpaceFM 0.7.3 et Thunar 1.2.3 ont été utilisés sous Ubuntu 11.10. Les résultats sont les suivants:

	Corbeille-SpaceFM	Thunar
Mettre à la corbeille	15	41
Supprimer définitivement	14	44
Restaurer	19	50
Vider la corbeille	10	6

Symboles utilisés pour la taille des fichiers

Pour la taille des fichiers, Corbeille-SpaceFM utilise la signification habituelle du préfixe binaire, c'est-à-dire la puissance de 2, mais avec les nouveaux termes proposés pour différentier sans équivoque les préfixes binaires des préfixes du système international (en puissance de 10). Par exemple, Mio est utilisé pour 1024 Kio, et 1 Kio équivaut à 1024 octets.

Fichiers pouvant être mis à la corbeille

Les fichiers présents sur la même partition que la corbeille de bureau sont déplacés vers cette corbeille, c'est-à-dire $XDG_DATA_HOME/Trash. La plupart du temps, cela signifie déplacer les fichiers vers /home/user/.local/share/Trash/files.

Les fichiers sur d'autres partitions ne sont pas gérés par Corbeille-SpaceFM, comme permis par la spécification. Les raisons sont qu'un tel système est complexe et, à mon humble avis, pas très ergonomique.

Selon la spécification, les fichiers d'autres partitions peuvent être mis à la corbeille de bureau. Cependant, tenons compte de ces situations:

Déplacer des fichiers externes vers la corbeille de bureau résulterait en une copie de ces fichiers à partir de leur emplacement original vers la partition de la corbeille de bureau. Cette situation pourrait convenir pour quelques fichiers sur un support amovible en USB 2.0, mais pas nécessairement pour la mise à la corbeille de 50 Gio de données, ou de fichiers distants ou présents sur des périphériques lents.

La spécification permet de faire l'usage d'exceptions, par exemple de désactiver la mise à la corbeille de fichiers distants. Cependant, cela ne permet pas vraiment de résoudre le problème, et je crois que le déplacement de fichiers d'une partition vers une autre devrait être le fait d'une action explicite entreprise par l'utilisateur.
Les supports amovibles sont parfois montés chaque fois avec un nouveau nom. Ainsi, un fichier mis à la corbeille à un moment donné peut ne pas être restauré si le périphérique a été démonté et remonté depuis.
Un fichier mis à la corbeille à partir d'un support amovible ne pourra pas être restauré si le périphérique en question n'est pas monté.

Une implémentation peut supporter plutôt la mise à la corbeille dans des dossiers racine, c'est-à-dire à la racine d'un système de fichiers monté. Cependant, prenons en compte ce qui suit:

Deux emplacements sont possibles, $topdir/.Trash/$uid et $topdir/.Trash-$uid, donc deux emplacements doivent être vérifiés, avec le risque de se retrouver avec deux corbeilles non vides sur le même périphérique pour le même utilisateur.
Plusieurs situations sont épineuses: systèmes de fichiers sans support du bit collant, sans identifiant utilisateur numérique ou tout simplement sans identifiant utilisateur, sans permissions, etc. S'il y a trop d'exceptions, est-ce encore utile?
Il est possible d'utiliser un support amovible sous plusieurs systèmes avec différents identifiants utilisateur, donc chaque fois avec un dossier de corbeille différent. Dans ces conditions, nos propres fichiers mis précédemment à la corbeille ne nous sont pas accessibles (sauf à avoir les droits d'administration).

Aussi, j'ai consulté plusieurs rapports de bogue sur Launchpad au sujet de la mise à la corbeille. J'ai trouvé plusieurs situations intéressantes:

Les fichiers mis à la corbeille sont situés dans un dossier caché, donc ils ne sont pas affichés par défaut dans la plupart des gestionnaires de fichiers. Il y a des rapports de bogue au sujet d'utilisateurs ayant partagé leur périphérique sans savoir que les fichiers supprimés se trouvaient dans un dossier caché. Ceux avec qui le périphérique avait été partagé pouvaient avoir accès à la corbeille, surtout en prenant en compte le fait que cette dernière ne constitue pas un dossier caché sous Windows.
Il y a des rapports de bogue à propos d'utilisateurs incapables d'ajouter des fichiers sur leur périphérique alors qu'ils ont supprimé des données. Ils ne s'étaient pas rendu compte qu'une corbeille cachée était présente sur leur périphérique et prenait encore de la place.
Il y a des rapports de bogue à propos du fait que des dossiers cachés de corbeille sont créés automatiquement sans jamais être supprimés, même lorsqu'ils sont vides.
Il y a des rapports demandant l'ajout d'une option pour désactiver la mise à la corbeille dans les dossiers racine.

Voir par exemple ce vieux rapport (datant de 2005), Shouldn't put .Trash-$USER on removable devices, ayant 13 doublons et 104 commentaires, ou cet autre rapport (2004), Ask to empty when unmounting media with items in trash, ayant 12 doublons et 44 commentaires. Les deux sont marqués comme étant résolus, mais en réalité ce n'est pas le cas. Nous pouvons noter de la confusion de la part des utilisateurs ainsi que des implémentations pas très claires (ou bien est-ce la spécification qui n'est pas assez claire).

Personnellement, j'ajouterais que certains gestionnaires de fichiers affichent les fichiers des corbeilles racine directement dans la corbeille de bureau, et ce sans différentier ces fichiers de ceux locaux. Un utilisateur peut donc vider la corbeille de bureau sans se rendre compte qu'il vide également toutes les corbeilles situées sur d'autres partitions. Un utilisateur peut vouloir vider une corbeille racine sans vider la corbeille de bureau, toutefois sans trouver de moyen d'accomplir une telle action. Un utilisateur risque de penser que tous les fichiers listés dans la corbeille de bureau sont (en toute logique) situés sur la partition utilisateur, mais, après avoir démonté son support amovible (et potentiellement après l'avoir partagé), réaliser que certains fichiers mis à la corbeille ne sont plus accessibles (ou, autrement dit, que le périphérique contient encore les fichiers mis à la corbeille). Tout ceci est plutôt source de confusion.

Je crois vraiment que le meilleur moyen de gérer la mise à la corbeille de fichiers situés sur une partition différente de celle de la corbeille de bureau est de laisser l'utilisateur gérer le cas manuellement. Par exemple, il est possible de déplacer manuellement les fichiers vers la partition utilisateur pour ensuite les mettre à la corbeille de bureau.

Cependant, prendre note que la commande Aller à la corbeille de Corbeille-SpaceFM affiche, s'il y a lieu, les corbeilles racine, puisqu'il est écrit dans la spécification:

If an implementation does NOT provide such trashing, and does provide the user with some interface to view and/or undelete trashed files, it SHOULD make a “best effort” to show files trashed in top directories (by both methods) to the user, among other trashed files or in a clearly accessible separate way.

Traduction

Corbeille-SpaceFM peut être traduit:

Cliquer droit sur une des commandes de Corbeille-SpaceFM et sélectionner Command | Browse | Files. Ouvrir le fichier init.inc.sh, situé à la racine du dossier. Les phrases à traduire se trouvent dans les sections Localization, 1 of 2 et Localization, 2 of 2.
Cliquer droit sur une des commandes de Corbeille-SpaceFM et sélectionner Command | Browse | Plugin. Ouvrir le fichier plugin, situé à la racine du dossier. Les phrases à traduire se présentent sous la forme suivante:
```
cstm_00000000-label=Phrase à traduire
cstm_00000000-desc=Phrase à traduire
```

Toute personne intéressée à effectuer une traduction peut donc traduire les phrases et m'envoyer le résultat. Pour l'instant, Corbeille-SpaceFM est disponible en français et en anglais.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

Corbeille-SpaceFM dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Ce programme est un logiciel libre; vous pouvez le redistribuer ou le modifier suivant les termes de la GNU General Public License telle que publiée par la Free Software Foundation: soit la version 3 de cette licence, soit (à votre gré) toute version ultérieure.

Ce programme est distribué dans l'espoir qu'il vous sera utile, mais SANS AUCUNE GARANTIE: sans même la garantie implicite de COMMERCIALISABILITÉ ni d'ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez la Licence publique générale GNU pour plus de détails.

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Bascule: déplacer la fenêtre active d'un écran à un autre

Mon, 23 Jan 2012 23:14:00 -0500

Read this page in English.

Aperçu

Bascule est un script Bash permettant de déplacer la fenêtre active d'un écran à un autre sous GNU/Linux à l'aide d'un raccourci-clavier.

Bascule supporte deux écrans (de même résolution ou non) ayant un segment latéral qui se touche, peu importe la position sur l'axe des y, par exemple:

            |¯¯¯¯¯¯¯¯¯¯¯|
            |           |
            |           |
            |           |
            |___________|
|¯¯¯¯¯¯¯¯¯¯¯|
|           |
|           |
|           |
|___________|

            |¯¯¯¯¯¯¯¯¯¯¯|
            |           |
|¯¯¯¯¯¯¯¯¯¯¯|           |
|           |           |
|           |___________|
|           |
|___________|

|¯¯¯¯¯¯¯¯¯¯¯|¯¯¯¯¯¯¯¯¯¯¯|
|           |           |
|           |           |
|           |           |
|___________|___________|

|¯¯¯¯¯¯¯¯¯¯¯|
|           |
|           |¯¯¯¯¯¯¯¯¯¯¯|
|           |           |
|___________|           |
            |           |
            |___________|

|¯¯¯¯¯¯¯¯¯¯¯|
|           |
|           |
|           |
|___________|
            |¯¯¯¯¯¯¯¯¯¯¯|
            |           |
            |           |
            |           |
            |___________|

Bascule prend également en compte les tableaux de bord, peu importe leur nombre et leur emplacement. Ainsi, une fenêtre déplacée vers un autre écran ne sera jamais cachée en partie sous un tableau de bord, ni étendue au-delà du nouvel écran. Une fenêtre maximisée le demeurera sur le nouvel écran.

Bascule est inspiré d'un script présenté sur le forum anglophone d'Ubuntu.

Dépendances

Les paquets suivants doivent être installés:

wmctrl
x11-utils
xdotool

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.

Utilisateur courant

Le script est prêt à être utilisé par l'utilisateur courant.

Tous les utilisateurs

Pour rendre accessible le script à tous les utilisateurs, ajouter le fichier bascule.sh dans le dossier /usr/bin/ (nécessite d'avoir les droits d'administration).

Dans ce cas, le dossier créé par l'extraction de l'archive peut être effacé ou mis à la corbeille après la copie.

Désinstallation

Utilisateur courant

Supprimer simplement le dossier créé par l'extraction de l'archive.

Tous les utilisateurs

Supprimer le fichier précédemment copié dans /usr/bin/ (nécessite d'avoir les droits d'administration).

Utilisation

Ouvrir le script bascule.sh dans un éditeur de texte et renseigner les quelques variables au début du fichier (section Variables à modifier.).
Ouvrir le gestionnaire de raccourcis-clavier offert par son gestionnaire de bureau (exemple sous Xfce: Menu principal > Paramètres > Gestionnaire de paramètres > Clavier > Raccourcis des applications).
Assigner le raccourci voulu à Bascule en précisant le chemin du script dans le dossier local ou dans /usr/bin/, selon le cas.

Utiliser ce raccourci clavier va déplacer la fenêtre active d'un écran à un autre.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

Bascule dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Open URI Context Menu: ouvrir une URI à partir de gedit

Wed, 23 Nov 2011 22:48:00 -0500

Read this page in English.

À propos

«Open URI Context Menu» est un greffon pour gedit, l'éditeur de texte par défaut de Gnome. Ce greffon ajoute deux options dans le menu contextuel lors d'un clic droit sur une URI contenue dans le texte d'un fichier: ouverture dans le navigateur ou ouverture dans gedit pour consultation du code source.

La version originale a été développée par Martin Szulecki pour gedit 2.

Le présent dépôt constitue un portage du greffon vers gedit 3.

Dépendances

Le greffon utilise la commande xdg-open du paquet xdg-utils.

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Copier les fichiers open-uri-context-menu.plugin et open-uri-context-menu.py dans le dossier suivant:
```
~/.local/share/gedit/plugins/
```
Activer le greffon dans le menu Édition > Préférences > Greffons de gedit.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

«Open URI Context Menu» dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

oneko-css: petite image en noir et blanc de chat ou de chien sur son site web

Wed, 26 Oct 2011 13:57:00 -0400

Read this page in English.

Aperçu

oneko-css permet d'ajouter une petite image en noir et blanc de chat ou de chien dans une colonne de site web. Au chargement de la page, l'image est prise au hasard dans une banque de 64 images (32 de chat et 32 de chien).

Voici quelques exemples:

Utilisation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Copier le dossier extrait dans un espace d'hébergement web.
Visiter la démo (fichier demo.php).

Il ne reste plus qu'à intégrer les fichiers à votre site web selon votre configuration et vos préférences.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

oneko-css dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Ce programme est un logiciel libre; vous pouvez le redistribuer ou le modifier suivant les termes de la GNU Affero General Public License telle que publiée par la Free Software Foundation: soit la version 3 de cette licence, soit (à votre gré) toute version ultérieure.

Vous devriez avoir reçu une copie de la Licence publique générale GNU Affero avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Matériel tiers

Toutes les images proviennent du logiciel oneko, publié dans le domaine public.

Clearwaita: thème GTK2/GTK3 proche visuellement de Clearlooks

Wed, 26 Oct 2011 13:58:00 -0400

Read this page in English.

À propos

Clearwaita = Clearlooks + Adwaita

Clearwaita est un thème GTK2/GTK3. Les fichiers pour GTK3 correspondent à une modification d'Adwaita, le thème par défaut de Gnome 3, pour en faire un thème proche visuellement de Clearlooks. Les fichiers pour GTK2 sont une copie non modifiée du thème Clearlooks original.

Aussi, des fichiers pour les gestionnaires de fenêtres Metacity, Openbox et Xfwm4 sont inclus.

Voici deux captures d'écran (cliquer pour télécharger l'image au format original):

Dépendances

S'assurer que le paquet gnome-themes-standard est installé. Ça devrait être le cas sous Gnome 3, mais pas sous Xfce.

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Renommer le dossier extrait en Clearwaita.
Copier le dossier Clearwaita dans un des deux emplacements suivants:
- ~/.themes/ pour l'utilisateur courant;
- /usr/share/themes/ pour tous les utilisateurs, incluant le style des logiciels lancés en tant que superutilisateur (par exemple Synaptic).
Ensuite, choisir le thème Clearwaita:
- sous Gnome: avec le logiciel gnome-tweak-tool;
- sous Xfce: en allant dans Paramètres > Apparence du menu principal pour le thème GTK, et dans Paramètres > Gestionnaire de fenêtres pour le thème de Xfwm4.

Configuration

Par défaut, le texte des icônes sur un bureau géré par Nautilus est noir. Pour afficher le texte en blanc, ouvrir le fichier gtk-3.0/gtk.css dans un éditeur de texte, trouver la ligne suivante (à la fin du fichier):

/*@import url("apps/nautilus.css");*/

et la décommenter, ce qui donne:

@import url("apps/nautilus.css");

Pour avoir une couleur personnalisée, modifier la couleur directement dans le fichier gtk-3.0/apps/nautilus.css.

Icônes et arrière-plan

Sur les captures d'écran, le thème d'icônes utilisé est Mist, installé avec le paquet gnome-themes.

L'arrière-plan est une légère modification d'une image de volvoguy.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

Clearwaita dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Matériel tiers

Thème Adwaita, provenant du paquet gnome-themes-standard, sous licence LGPL.
Fichier gtk-2.0/gtkrc, provenant du paquet gtk2-engines, sous licence LGPL.
Fichier metacity-1/metacity-theme-1.xml, provenant du paquet gnome-themes-selected, sous licence LGPL.
Fichier openbox-3/themerc, provenant du paquet openbox, sous licence GPL.
Thème Clearlooks XFWM4, sous licence GPL.

GConjugo, apprentissage de la conjugaison dans plusieurs langues

Jean-Philippe Fleury — Tue, 08 Mar 2011 00:00:00 -0500

GConjugo est un logiciel libre permettant de pratiquer la conjugaison des verbes dans plusieurs langues et selon plusieurs niveaux de difficulté. Il est développé par Maxence Dolle.

pdfmm: assistant graphique pour réduire la taille d'un fichier PDF

Wed, 26 Oct 2011 21:48:00 -0400

Read this page in English.

Aperçu

pdfmm (pour «pdf moins moins», ou «pdf--») est un assistant graphique pour réduire la taille d'un fichier PDF.

Voici quelques résultats obtenus avec des fichiers PDF choisis au hasard:

Taille de départ	Taille à la sortie	% d'optimisation
29 Kio	23 Kio	20 %
363 Kio	72 Kio	80 %
733 Kio	658 Kio	10 %
991 Kio	349 Kio	65 %
1,7 Mio	0,8 Mio	52 %
1,9 Mio	1,1 Mio	40 %
2,3 Mio	1,6 Mio	31 %
3,4 Mio	1,3 Mio	60 %
7,1 Mio	5,4 Mio	23 %
14,8 Mio	9,4 Mio	36 %
54,3 Mio	14,6 Mio	73 %

Bien sûr, ces chiffres sont donnés seulement à titre d'exemples. Le résultat ne sera sûrement pas le même avec d'autres fichiers de taille similaire. Tout dépend du contenu.

Dépendances

pdfmm est un script shell dépendant de bash (>= 4.0), zenity et ghostscript.

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.

Utilisateur courant

Le script est prêt à être utilisé par l'utilisateur courant.

Tous les utilisateurs

Pour rendre accessible le script à tous les utilisateurs, ajouter le fichier pdfmm dans le dossier /usr/bin/ (nécessite d'avoir les droits d'administration).

Dans ce cas, le dossier créé par l'extraction de l'archive peut être effacé ou mis à la corbeille après la copie.

Désinstallation

Utilisateur courant

Supprimer simplement le dossier créé par l'extraction de l'archive.

Tous les utilisateurs

Supprimer le fichier pdfmm précédemment copié dans /usr/bin/ (nécessite d'avoir les droits d'administration).

Utilisation

Notes:

Aucun fichier original n'est modifié. Le fichier optimisé est créé dans le même dossier que le fichier original.
Un fichier de configuration est créé dans le dossier personnel de l'utilisateur lançant pdfmm:
```
~/.config/pdfmm.conf
```
Ce fichier contient le dossier du dernier fichier sélectionné. C'est ce dossier qui sera proposé par défaut lors de la prochaine ouverture de pdfmm.

Utilisateur courant

Pour utiliser le script dans une console, lancer le fichier pdfmm en précisant son chemin d'accès:

chemin/vers/pdfmm

Si vous vous trouvez dans le même dossier que le fichier pdfmm, la commande est:

./pdfmm

Dans tous les cas, il est possible de préciser en argument le fichier PDF à optimiser, par exemple:

./pdfmm chemin/vers/le/fichier.pdf

Il est également possible d'ouvrir le script en cliquant sur le fichier pdfmm (simple clic ou double clic selon votre configuration) et en choisissant de le lancer.

Vous pouvez également créer un lanceur dont la commande correspond au chemin absolu vers le fichier, par exemple:

/home/NOM/chemin/vers/pdfmm

Tous les utilisateurs

Dans une console, simplement saisir pdfmm. Le fichier PDF à optimiser peut être précisé en argument.

Un lanceur peut également être créé. Dans ce cas, la commande est simplement pdfmm.

Traduction

pdfmm peut s'afficher dans plusieurs langues. Toute personne intéressée à effectuer une traduction peut donc traduire les phrases présentes dans la section Localisation du fichier pdfmm et m'envoyer le résultat. Pour l'instant, pdfmm est disponible en français et en anglais.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

pdfmm dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

MyNotex, logiciel libre de prise et de gestion de notes

Jean-Philippe Fleury — Tue, 28 Dec 2010 00:00:00 -0500

Résumé

Ceci est une traduction de la page d'accueil du site de MyNotext, un logiciel libre de prise et de gestion de notes. Le développeur de MyNotex est Massimo Nardello.

MyNotex est un logiciel libre sous GNU/Linux pour la prise et la gestion de notes. Les notes sont classées par sujet et sont composées d'un titre, d'une date, de mots clés (étiquettes) et d'un contenu textuel. Le contenu peut être mis en forme (police, taille, couleur, surlignage, gras, italique, souligné et barré). MyNotex gère également l'alignement des paragraphes ainsi que les listes non ordonnées et ordonnées avec indentation automatique. Un fichier MyNotex peut contenir plusieurs sujets et notes.

Voici quelques exemples d'utilisation de MyNotex:

Prendre des notes lors de réunions, de cours, de conférences, etc.
Écrire et conserver des idées, des mémos, des lettres, des rapports, des agendas, des projets, etc.
Écrire et conserver des rapports chiffrés de réunions confidentielles.
Écrire et conserver des séries de cours et de conférences.
Écrire et tenir un journal (quotidien ou non).
Dresser et tenir une liste d'articles au format PDF (joindre chaque fichier PDF à une note classée dans un sujet thématique, insérer l'auteur et le titre de l'article dans le titre de la note, et insérer le résumé dans le texte de la note ou les mots clés; ainsi, il est possible de faire appel à la fonction de recherche de MyNotex pour retrouver l'article).
Écrire et conserver des archives de code source (pour les programmeurs).
Écrire et conserver des critiques de livres, de films, etc.
Recueillir de nombreux documents écrits simples (sans image, note de bas de page, titre, etc.) dans un seul fichier.
Créer une archive de textes en ligne (articles de magazines en ligne, blogues, etc.) en les copiant à partir du navigateur.
Conserver une liste chiffrée de mots de passe.
Gérer une liste de tâches.
Partager des notes et des documents avec d'autres.

Les nouvelles fonctionnalités ajoutées dans la version 1.2.0 sont:

Alignement des paragraphes et indentation des listes.
Surlignage du texte.
Possibilité d'activer la synchronisation automatique lorsqu'un fichier est ouvert ou fermé.
Paramétrage du niveau de transparence de l'interface.
Création de liens dans le texte d'une note vers d'autres notes.
Ajout d'une pièce jointe ou de plusieurs à la fois par glisser-déposer.
Recherche par date.

Les autres principales fonctionnalités du logiciel sont les suivantes:

Ajout de pièces jointes (fichiers de tout type) aux notes. Les pièces jointes sont compressées et conservées dans un dossier situé dans le même emplacement que le fichier MyNotex et portant le même nom (sans l'extension), et sont gérées par le logiciel. Leur nombre n'est limité que par l'espace disque disponible.
Chiffrement du contenu des notes avec l'algorithme AES.
Recherche dans le titre des sujets, le titre et le texte des notes, le nom des pièces jointes, la date et les mots clés.
Recherche à l'aide de plusieurs mots clés (condition de type OU) ou entre deux dates.
Liste des mots clés utilisés dans le fichier en cours d'utilisation, utile pour les ajouter par double clic lors de la création d'une note ou lors d'une recherche.
Déplacement d'une note (et de ses pièces jointes, s'il y a lieu) d'un sujet à un autre.
Importation d'un sujet et de ses notes et ses pièces jointes à partir d'un autre fichier MyNotex, ou exportation vers un autre fichier.
Importation de fichiers texte ou de documents texte d'OpenOffice.org ou de LibreOffice.
Importation de notes créées avec Tomboy ou Gnote.
Ouverture du texte de la note actuelle dans OpenOffice.org ou LibreOffice (utile entre autres pour imprimer la note).
Exportation des données au format HTML, pouvant facilement être ouvert avec un traitement de texte comme OpenOffice.org ou LibreOffice.

Enfin, il est possible de synchroniser deux fichiers MyNotex différents pour faire en sorte que les modifications (ajout, modification ou suppression de sujets, de notes ou de pièces jointes) dans chacun d'eux soient répercutés dans l'autre; ainsi, à la fin du processus, les deux fichiers et leur dossier de pièces jointes sont identiques. Cette fonctionnalité permet de modifier hors ligne plusieurs fichiers MyNotex pour ensuite les synchroniser par Internet ou LAN, ou par un service d'hébergement de données dans les nuages comme Dropbox ou Ubuntu One.

Un fichier MyNotex correspond à une base de données SQLite, moteur de base de données populaire dont le contenu peut être lu et exporté facilement grâce à différents outils disponibles sur Internet. La version de SQLite utilisée par MyNotex est 3.7.2-1 ou une version plus récente (disponible depuis Ubuntu 10.04), mais MyNotex devrait fonctionner également avec toute version égale ou supérieure à 3.

L'utilisation de SQLite et l'absence d'une structure en arborescence pour afficher le titre des sujets et des notes démarquent MyNotex des autres logiciels de prise de notes. MyNotex a été développé dans un soucis de gestion d'un très grand nombre de notes, même s'il peut être utilisé plus modestement pour seulement quelques notes. L'utilisation de grilles au lieu d'une structure en arborescence ainsi que du format SQLite au lieu d'un fichier XML offre une robustesse et une vitesse accrues lors de la manipulation d'une grande quantité de données. Cela rend MyNotex utile non seulement pour un usage personnel, mais aussi pour partager de nombreux documents au sein d'un groupe ou d'une organisation. Voir plus bas le résultat d'un test de charge.

MyNotex est en anglais par défaut, mais s'il est installé à partir du paquet deb, il sera automatiquement traduit, s'il y a lieu, en allemand, en français ou en italien, selon la langue du système. Si seul l'exécutable est téléchargé, lancer MyNotex et aller dans Tools – Set language... pour installer un fichier de langue disponible sur la page de téléchargement du site Web de Mynotex. Il est également possible d'ouvrir avec un éditeur de texte le fichier english.lng (un simple fichier texte) présent dans le dossier d'installation du logiciel (/usr/lib/mynotex) ou obtenu sur la page de téléchargement, y traduire toutes les phrases dans la langue voulue à partir de l'anglais et l'installer.

MyNotex a été développé avec Lazarus et les composants suivants: TDBZVDateTimePicker, TRichMemo (version modifiée) et DCPcrypt. Il a été développé et testé sous Ubuntu 11.10 et compilé pour Gnome.

MyNotex est un logiciel libre et est publié sous la Licence publique générale GNU, version 3 (http://www.gnu.org/licenses/gpl-3.0.txt).

Le développeur (Massimo Nardello) ne prévoit pas publier de version de MyNotex pour Windows et Mac OS, et ce à cause d'un manque de temps et de ses préférences pour les logiciels libres. À tout le moins, l'EDI (environnement de développement intégré) utilisé (Lazarus) peut compiler le même code pour GNU/Linux, Windows et Mac OS. Ainsi, MyNotex peut en théorie être compilé pour ces plate-formes, mais le code devrait préalablement être revu; et la modification du composant TRichMemo, complétée.

L'auteur de MyNotex tient à remercier Jean-Philippe Fleury pour sa participation au débogage du logiciel et pour ses suggestions d'amélioration.

Captures d'écran

Voici une capture d'écran de la version actuelle de MyNotex:

Cliquer sur l'image pour l'agrandir

Mis à disposition sous la licence publique générale de GNU, version 3 ou toute version ultérieure.

Voir d'autres captures d'écran de MyNotex.

Voici une vidéo de démonstration d'une ancienne version de MyNotex (version 1.1.1), créée par Jean-Philippe Fleury:

Mis à disposition sous la licence publique générale de GNU, version 3 ou toute version ultérieure.

Télécharger la vidéo originale au format Theora ainsi que les sous-titres (24 Mio).

Insérer cette vidéo sur votre site:

<!--[if !IE]> -->
  <object type="application/x-shockwave-flash" data="http://www.youtube.com/v/HVrNk5jelfo?fs=1&amp;hl=fr_FR&amp;cc_load_policy=1" width="480" height="385">
<!-- <![endif]-->
<!--[if IE]>
  <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0" width="480" height="385">
      <param name="movie" value="http://www.youtube.com/v/HVrNk5jelfo?fs=1&amp;hl=fr_FR&amp;cc_load_policy=1" />
<!--><!-- http://Validifier.com -->
  </object>
<!-- <![endif]-->

Aide et contacts

Pour poser des questions, partager des idées ou rapporter des bogues au sujet de MyNotex, il est possible de visiter le forum en ligne ou de s'y inscrire. Ce forum est géré par Jean-Philippe Fleury. Les messages peuvent être écrits en anglais ou en français.

Pour contacter l'auteur de MyNotex, écrire à ms.nardello _arobas_ gmail _point_ com. Cependant, ne pas le contacter pour du support sur l'installation ou l'utilisation du logiciel, car il ne peut malheureusement pas répondre individuellement à chaque demande.

Améliorations

La page des améliorations liste les nouvelles fonctionnalités ajoutées au fil des versions de MyNotex.

Articles

La page des articles liste les revues du logiciel publiées en ligne.

Demandes

La page des demandes liste les fonctionnalités suggérées qui seront implémentées dans MyNotex.

Rapports de bogue

La page des rapports de bogue liste les problèmes connus de la version actuelle de MyNotex et qui seront résolus dans la prochaine version.

Téléchargement

La dernière version stable de MyNotex est la 1.2.0, publiée le 10 décembre 2011.

La page de téléchargement offre les fichiers suivants:

Un paquet deb pour installer MyNotex sur Ubuntu avec Unity.
Un paquet deb pour installer MyNotex sur Debian ou des distributions fondées sur cette dernière, mais sans Unity.
Une archive contenant le fichier exécutable du programme, permettant d'utiliser MyNotex sur les autres distributions (télécharger l'archive, l'extraire, rendre exécutable le fichier, copier ce dernier dans le dossier voulu et le lancer; SQLite >= 3 doit être installé sur le système).
Les fichiers de langue pour l'allemand, le français et l'italien (utiles seulement pour une installation de MyNotex sur des distributions non fondées sur Debian).
Le manuel d'utilisation de MyNotex (en anglais, en français et en italien; la traduction en allemand est en cours) au format PDF.
Le code source de MyNotex et du composant TRichMemo modifié.

Les paquets deb ainsi que le fichier exécutable sont disponibles en 32-bit et 64-bit.

Aller à la page de téléchargement.

Test de charge

Pour tester la réactivité de MyNotex (version 1.0.6) avec une grande quantité de données, un fichier de 100000 notes a été créé grâce à un logiciel et a ensuite été divisé en 100 sujets (1000 notes par sujet); chaque note était composée d'un texte d'environ 15000 caractères, équivalant à quatre pages pleines au format A4 (totalisant un milliard et demi de caractères). Bien que le fichier avait une taille d'environ 1,5 Gio, le logiciel avait encore un bon temps de réponse, sauf pour la recherche dans le texte des notes, qui a pris environ 25 secondes. L'ordinateur utilisé pour le test est un portable muni d'un processeur Intel Core i5 et de 4 Gio de mémoire vive.

Une installation optimisée de Drupal

Tue, 01 May 2012 01:00:00 -0400

Quelques pistes pour une installation optimisée de Drupal 6. Il s'agit d'un brouillon, une sorte de mémo, et il faudrait bien que je prenne le temps de faire du gros ménage là-dedans et d'en faire un tutoriel un peu plus abouti.

La base

Premièrement, on récupère la dernière version de Drupal. On trouvera le lien sur l'accueil de Drupal francophone. Ensuite on télécharge les fichiers pour le français. Une fois les deux archives extraites, on fusionne les dossiers, ce qui donne par exemple cp -R fr-6.x-1.0/. drupal-6.9. On installe le tout sur son serveur.

La configuration et les modules à ajouter

On a une installation de base de Drupal. Il va falloir ajouter ou configurer plusieurs modules pour modeler Drupal à notre convenance.

Option URLs simplifiées

On active les URL simplifiées, option disponible par défaut dans Drupal.

On passe donc maintenant de liens ?q=node/1 à des liens node/83.

Choisir entre conserver ou supprimer les www

Le contenu dupliqué est le fait qu'un même contenu puisse être accessible par plus d'une URL. C'est le cas par exemple si un site présente le même contenu sur exemple.com et www.exemple.com. Les moteurs de recherche essaient de réduire le contenu dupliqué dans leurs résultats. Par exemple, s'il y a du contenu dupliqué reconnu par Google, ce dernier affiche à la dernière page de résultats une phrase de ce type:

Pour limiter les résultats aux pages les plus pertinentes (total : 128), Google a ignoré certaines pages à contenu similaire. Si vous le souhaitez, vous pouvez relancer la recherche en incluant les pages ignorées.

C'est mieux de choisir soi-même. Commençons par choisir entre un site avec www ou un site sans www. Dans le .htaccess de Drupal, il y a une section qu'on peut décommenter. Voir ce qui suit ce paragraphe:

# If your site can be accessed both with and without the 'www.' prefix, you
# can use one of the following settings to redirect users to your preferred
# URL, either WITH or WITHOUT the 'www.' prefix. Choose ONLY one option:

Page title

Le module Page Title permet de personnaliser pour chaque page le contenu de la balise title dans l'en-tête HTML de notre page. Par exemple, on peut saisir soi-même le contenu, faire ajouter automatiquement le terme associé, etc. Dans ce dernier cas, s'il n'y a pas de terme, plusieurs séparateurs peuvent se suivre. Par exemple, si on met [page-title] | [term] | [site-name] comme contenu de la balise title et qu'il n'y a pas de terme, on va obtenir comme titre Mon titre | | Mon site. J'ai fait un rapport de bogue à ce sujet: http://drupal.org/node/386014.

Pour ajouter la pagination dans le titre, voir la demande http://drupal.org/node/224262 et le code proposé. En espérant que le correctif soit intégré au module Token bientôt.

À noter que ce module dépend du module Token.

Meta tags

Le module Meta tags permet de personnaliser plusieurs métabalises, dont keywords et description. Bien sûr le référencement ne repose plus sur les métabalises, mais il peut y avoir un intérêt quand même. Par exemple, le contenu de la balise description est souvent affiché dans les résultats des moteurs de recherche. Il y a donc un intérêt à la soigner. Pour sa part, la balise keywords pourrait permettre, si son contenu est personnalisé, d'éviter que certaines pages ayant un contenu ressemblant soient considérées comme du contenu dupliqué.

Pour la pagination (page 1, page 2, etc.), ce module met pour l'instant noindex. Dans mon cas, ce n'est pas adapté parce que je mets une description de la catégorie sur ces pages. Voir http://drupal.org/node/294996, en espérant qu'un correctif soit apporté bientôt.

Pathauto

Le module Pathauto permet d'obtenir des URL plus parlantes, par exemple ouverture-de-mon-site au lieu de node/1. À noter que ce module dépend du module Path (livré par défaut avec un Drupal de base).

Il est recommandé d'installer en complément le module Path redirect.

Note: pour que la redirection de flux RSS fonctionne, il faut mettre 0/feed dans le champ «Internal feed alias text (leave blank to disable) :». Voir Taxonomy term path feed problem.

Path redirect

Le module Path redirect permet de rediriger d'anciennes adresses vers les nouvelles dans le cas où on modifie l'URL d'une page. Quand le module Pathauto est également installé, ce dernier peut être configuré pour faire automatiquement les redirections.

Global Redirect

Le module Global Redirect s'assure qu'il n'y a pas de page ayant deux adresses différentes. Si une page est accessible par exemple par node/1 et ouverture-de-mon-site, le module va effectuer une redirection 301 de la première adresse vers la seconde.

Formulaire de contact

Maintenant on ajoute un forumlaire de contact en activant le module Contact, livré par défaut avec Drupal.

GeSHi Filter (coloration syntaxique)

Si vous voulez ajouter proprement du code source sur vos pages, le module GeShi Filter permet d'activer la coloration syntaxique pour du code.

Markdown filter

Si vous voulez utiliser la syntaxe Markdown dans vos pages, installez le module Markdown filter.

Note: si on active GeSHi Filter et Markdown filter, il faut bien faire attention à ce que le filtre Markdown soit analysé avant le filtre GeSHi.

Mailhandler

Si vous voulez créer du contenu par courriel, installez le module Mailhandler.

Mailsave

Le module Mailsave est un complément à Mailhandler. Il permet entre autres de créer automatiquement des fichiers attachés aux pages créées par Mailhandler selon les pièces jointes au courriel.

À noter qu'on doit aussi activer le module Upload (qui est livré par défaut avec Drupal), étant donné que Mailsave se base sur les droits définis pour ce module.

CustomError

Le module CustomError permet de configurer les pages d'erreur 403 et 404 sans avoir à créer de noeud spécial.

Ne pas oublier d'aller sur la page admin/settings/error-reporting et configurer les adresses comme ceci:

customerror/403
customerror/404

XML Sitemap

Le module XML Sitemap permet de générer automatiquement un plan du site.

Note: en date du 17 février 2009, ce module est encore en version de développement pour Drupal 6.

CCK

Le module CCK est quasiment un incontournable. Il permet d'ajouter des champs selon nos besoins, donc de créer ou de configurer des types de contenu.

Views

Le module Views est le compagnon de CCK. Il permet de créer selon des critères précis des listes de contenu. Ensuite, on peut utiliser ces listes pour former notre page d'accueil, des pages de section, des blocs, etc.

Advanced Help

Pour profiter d'une aide avancée de Views, il faut installer le module Advanced Help.

Insert View

Le module Insert View permet d'insérer des vues (générées par le module Views) dans du contenu sans devoir passer par du code PHP. Exemple: [view:nom].

robots.txt

Si nécessaire, personnaliser ce fichier (oui, il faudrait que je développe un peu plus :)).

filter_default

À faire.

Comment mail

Le module Comment mail permet de recevoir un courriel à chaque nouveau commentaire posté sur le site.

Comment Notify

Le module Comment Notify ajoute une option dans le formulaire de commentaire pour permettre aux internautes de s'abonner aux réponses à leur commentaire ou de s'abonner à tous les nouveaux commentaires de l'article.

Captcha

Le module Captcha permet d'éviter le pourriel dans les commentaires.

Pagination

Le module Pagination permet de paginer de longues pages. Cependant, ce module incrémente déjà la variable GET page, ce qui entre en conflit avec le correctif que j'ai appliqué à Drupal pour faire la même chose. Voir le rapport http://drupal.org/node/386154.

Optimiser la structure des pages

Par défaut, la plupart des thèmes mettent le titre du site dans une balise h1 et le titre de la page (ou du noeud) dans une balise h2. À changer. Le titre du site devrait être dans une div et le titre de page dans un h1. Sur la page d'accueil, c'est pas une mauvaise idée de mettre le titre de site exceptionnellement dans un h1.

Faire débuter le numéro de la pagination à 1 et non 0

Par exemple, le lien vers la deuxième page est ?page=1, mais ça devrait plutôt être ?page=2. J'ai soumis un correctif pour le fichier includes/pager.inc.

Term Fields et afficher la description des termes de taxonomie seulement sur la première page

Par défaut, ce n'est pas vraiment possible d'avoir une page personnalisée pour la page d'index des termes de taxonomie. Par exemple, la page /taxonomy/term/id va lister les noeuds faisant partie de ce terme, avec possiblement la description dans le haut si cette information a été remplie. Si la description s'affiche, elle va s'affiche pour toutes les pages (donc sur la page 1, page 2, page 3, etc.). Si on veut écrire une grande description, ce n'est pas adapté. Ce que je propose, c'est donc de faire afficher la description complète sur la première page, et seulement un petit résumé sur les pages suivantes.

On va donc installer le module Term Fields, qui va nous permettre d'ajouter des champs personnalisés aux termes. On va donc installer ce module et ajouter un champ résumé, qu'on va faire afficher seulement sur les pages supérieures à 1. Pour ce faire, on peut ajouter par exemple la fonciton suivante dans notre fichier template.php:

/* Afficher la description des termes de taxonomie seulement sur la première page, et afficher le résumé sur les pages subséquentes */

/**
 * Render a taxonomy term page HTML output.
 *
 * @param $tids
 *   An array of term ids.
 * @param $result
 *   A pager_query() result, such as that performed by taxonomy_select_nodes().
 *
 * @ingroup themeable
 */
function phptemplate_taxonomy_term_page($tids, $result) {
  drupal_add_css(drupal_get_path('module', 'taxonomy') .'/taxonomy.css');

  $output = '';

  // Only display the description if we have a single term, to avoid clutter and confusion.
  if (count($tids) == 1) {
    $term = taxonomy_get_term($tids[0]);
    $description = $term->description;

    // Check that a description is set.
    if (!empty($description)) {
      $output .= '<div class="taxonomy-term-description">';
      // Si on se trouve sur la première page, on affiche la description complète
      if (empty($_GET['page'])) {
        $output .= '<p class="legende"><span>Description de la catégorie <em>' . $term->name . '</em></span></p><div class="taxonomy-term-description-contenu">';
        $output .= filter_xss_admin($description);
        $output .= '</div>';
      }

      // Sinon on affiche seulement le résumé.
      else {
        $output .= '<p class="legende"><span>Résumé de la catégorie <em>' . $term->name . '</em></span></p><div class="taxonomy-term-description-contenu">';
        $output .= term_fields_get_field($term->tid, 'resume');
        $output .= l ('<p class="taxonomy-term-description-contenu-plus">En savoir plus sur la catégorie <em>' . $term->name . '</em>...</p>', taxonomy_term_path($term), array('html' => TRUE));
        $output .= '</div>';
      }

      $output .= '</div>';
    }
  }

  $output .= taxonomy_render_nodes($result);

  return $output;
}

Et un style qui l'accompagne:

/* Description des termes de taxonomie */

div.taxonomy-term-description {
    margin-top: 1.5em;
    border: 1px solid #eee;
}

p.legende {
    margin-top: -0.8em;
    margin-left: 10px;
    float: left;
}

p.legende span
{
    padding: 0px 10px;
    background-color: #fff;
    font-weight: bold;
}

div.taxonomy-term-description-contenu {
    clear: left;
    padding: 10px 0 10px 10px;
}

p.taxonomy-term-description-contenu-plus {
    margin-top: 10px;
}

Syndication

Le module Syndication permet de créer une page recenssant tous les flux RSS du site. On peut également générer des flux RSS en mariant plusieurs termes.

Taxonomy Menu

Le module Taxonomy Menu permet d'ajouter dans un menu une liste de terme pour chaque vocabulaire.

Note: j'utilisais avant le module Taxonomy Blocks, qui permet de créer un menu listant chaque terme d'un vocabulaire (optionnellement, on peut faire afficher entre parenthèses le nombre d'éléments de chaque terme). Cependant, dû à un certains nombre de bogues, dont le problème de non-génération des classes habituelles pour les listes (par exemple leaf first), j'ai changé pour le module Taxonomy Menu.

Piwik - Web analytics

Le module Piwik - Web analytics permet d'ajouter le code nécessaire au suivi statistique des visites à l'aide du logiciel Piwik (que l'on doit installer à part).

Node Hierarchy

Le module Node Hierarchy permet de créer facilement une hiérarchie entre les pages, par exemple en assignant telle page enfant de telle autre page parente. On peut configurer pathauto pour que l'URL reflète la hiérarchie, et on peut également faire créer automatiquement le menu hiérarchisé.

Menu block

Le module Menu block permet d'ajouter un bloc qui reflète le menu dans lequel la page courante fait partie.

Note: le module Local Menu permet de réaliser la même chose, mais pour seulement un bloc, alors que Menu block permet de créer autant de bloc qu'on veut.

Le module Table of Contents permet de générer une table des matières d'une page en se basant sur les titres HTML de niveau 1 à 6.

Search config

Le module Search config permet de configurer les options dans la recherche avancée (et plus).

Autres modules potentiellement utiles

Taxonomy Title

Le module Taxonomy Title permet de configurer le titre (contenu de la balise h1 ou h2 selon les thèmes) pour les pages d'index de chaque terme.

SiteMenu

Le module SiteMenu permet de générer une page listant tous les noeuds classés par catégorie.

Note: en date du 7 mars 2009, ce module est encore en version de développement pour Drupal 6.

À tester plus tard

Taxonomy redirect

Le module Taxonomy redirect permet de changer l'adresse de taxonomie, mais ne permet pas encore une redirection automatique de l'ancienne adresse par défaut de Drupal vers la nouvelle.

À faire

Avoir des URL simplifiées aussi pour la pagination, donc se débarrasser des ?page=.

Motus: protéger ses informations importantes en les chiffrant

Wed, 26 Oct 2011 13:57:00 -0400

Aperçu

Motus est un logiciel permettant de chiffrer et déchiffrer rapidement un fichier texte sur un système GNU/Linux. Il est particulièrement utile pour sauvegarder des mots de passe et des identifiants de connexion.

Une coloration syntaxique est offerte pour gedit, l'éditeur de texte par défaut de Gnome. Ainsi, les informations peuvent facilement être mises en valeur visuellement.

Motus a vu le jour pour proposer une alternative à la plupart des logiciels de gestion de mots de passe qui ont une structure définie à l'avance et qui empêchent ainsi l'utilisateur d'entrer et d'ordonner ses informations comme il le souhaite.

Dépendances

Motus est développé en langage Shell (Bash). Les dépendances logicielles sont les suivantes:

openssl
wipe
zenity

Les logiciels qui suivent ne sont pas obligatoires, mais sont suggérés pour tirer profit pleinement des fonctionnalités de Motus:

alltray
gedit
gettext
mktemp (si gedit 2 est utilisé; inutile pour gedit 3)
xdg-utils

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Ouvrir une console dans le dossier extrait.
Dans la console, lancer le script d'installation en mode superutilisateur, ce qui donne (sous Ubuntu):
```
sudo ./scripts.sh installer
```

Le dossier créé par l'extraction de l'archive peut être effacé ou mis à la corbeille après l'installation.

Désinstallation

Ouvrir une console dans le dossier extrait.
Dans la console, lancer le script de désinstallation en mode superutilisateur, ce qui donne (sous Ubuntu):
```
sudo ./scripts.sh desinstaller
```

Utilisation

Une entrée pour lancer Motus est ajoutée dans la section «Accessoires» du menu principal. Motus peut également être lancé en ligne de commande:
```
motus
```
Le fichier de configuration global est /usr/share/motus/config.inc.sh. La configuration peut être personnalisée pour l'utilisateur courant dans ~/.motus/config.inc.sh.
Un exécutable gedit-unique est créé dans /usr/bin. Il s'agit du script utilisé par défaut par Motus pour lancer l'éditeur de texte, mais ce script peut être utilisé en dehors de Motus. Il lance une instance de gedit avec un dossier temporaire unique, ce qui permet d'isoler le fichier ouvert dans cette instance (les prochains fichiers ouverts en passant par le gestionnaire de fichiers ou par la ligne de commande ne le seront jamais dans cette instance).
Le chiffrement utilisé est l'AES-256 en mode CBC (voir Standard de chiffrement avancé).
Par défaut, le chemin du fichier chiffré est ~/.motus/chiffre.
Par défaut, le chemin du fichier déchiffré est le suivant:
```
`/dev/shm/0x[0-9A-F]{8}-motus/0x[0-9A-F]{8}-dechiffre.motus`.
```
- /dev/shm/ correspond à un emplacement en mémoire vive, donc le fichier déchiffré n'est pas enregistré sur le disque dur. Si cet emplacement n'existe pas, Motus utilise le dossier /tmp/ (donc un emplacement sur le disque dur).
- 0x[0-9A-F]{8}-motus est un dossier temporaire commençant par 8 nombres hexadécimaux choisis au hasard. Les droits d'accès du dossier sont 700.
- 0x[0-9A-F]{8}-dechiffre.motus correspond au fichier déchiffré. Ses droits d'accès sont 600.
À la fermeture de Motus, le dossier temporaire 0x[0-9A-F]{8}-motus et son contenu sont supprimés de manière sécuritaire avec wipe. Si jamais des fichiers temporaires (par exemple 0x[0-9A-F]{8}-dechiffre.motus~) ont été créés dans cet emplacement par l'éditeur de texte utilisé pour modifier le fichier déchiffré, ils seront supprimés en même temps.
Le chemin des fichiers chiffré et déchiffré peut être modifié à l'aide de paramètres passés à Motus. Exemples:
```
motus /chemin/vers/le/fichier/chiffré
motus /chemin/vers/le/fichier/chiffré /chemin/vers/le/fichier/déchiffré
```
Si le chemin du fichier déchiffré est précisé en paramètre, seul ce fichier sera supprimé lors de la fermeture de Motus (et non le dossier qui le contient).
Un fichier de sauvegarde est automatiquement créé lors du chiffrement. Ce fichier correspond au dernier fichier chiffré auquel l'extension sauv est ajoutée:
```
/chemin/vers/le/fichier/chiffré.sauv
```
Par défaut, on a donc:
```
~/.motus/chiffre
~/.motus/chiffre.sauv
```

Localisation

Les messages de Motus sont localisables. Toute personne intéressée à effectuer une traduction peut donc copier le fichier motus.pot situé dans le répertoire locale de l'archive source, le renommer en LANGUE.po, traduire les phrases contenues dans le fichier et m'envoyer le fichier .po.

Pour l'instant, Motus est disponible en français.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

Motus dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Matériel tiers

Logo de Motus: le logo a été fait à partir de l'image scalable/emotes/face-plain.svg du thème d'icônes Gnome, sous licence GPL.

RapportHamster++: personnaliser les rapports du gestionnaire de temps Hamster

Wed, 26 Oct 2011 22:54:00 -0400

Read this page in English.

Aperçu

RapportHamster++ est un ensemble de fonctions PHP permettant de personnaliser les rapports HTML créés par le gestionnaire de temps Hamster. Le parcours et la modification des rapports HTML sont principalement effectués grâce à l'extension DOM de PHP.

Dépendances

RapportHamster++ nécessite une version de Hamster utilisant la nouvelle structure des rapports HTML. La version 2.31.6 utilise cette nouvelle structure. Il est possible que ce soit le cas également d'une version antérieure.

Il faut aussi bien sûr un interpréteur PHP, sur un serveur ou en ligne de commande (PHP CLI). Pour utiliser PHP en ligne de commande, installer le paquet php5-cli (testé sous Ubuntu).

Installation

Il n'y a pas d'installation nécessaire. Un fichier d'index est offert par défaut pour montrer l'utilisation possible des différentes fonctions avec PHP CLI.

Télécharger l'archive de la dernière version.
Extraire l'archive.
Ouvrir une console dans le dossier extrait.
Lancer le script d'index (les paramètres sont à titre d'exemples):
```
php index.cli.php "/chemin/vers/le/rapport.html" 1 1 1 1 1 " h" " min" 0
```
Le rapport modifié sera enregistré dans le même répertoire que le rapport original, par exemple /chemin/vers/le/rapport - 2.html.

Le dossier doc/exemple contient deux fichiers:

Gestion du temps, 2010-07-30 - 2010-08-05.html: un rapport créé par Hamster;
Gestion du temps, 2010-07-30 - 2010-08-05 - 2.html: le même rapport, mais modifié par RapportHamster++.

Pour plus de détails sur les paramètres et les fonctions, analyser le fichier index.cli.php dans un édtieur de texte et lire les commentaires de chaque fonction dans le fichier inc/fonctions.inc.php. Voir également ci-dessous l'aperçu des fonctionnalités.

Survol des fonctionnalités

Le fichier index.cli.php livré par défaut montre une utilisation possible des fonctions de RapportHamster++. Les fonctions en question sont:

ajouteClassesLignesTable(): ajoute des classes aux lignes d'une table donnée. Le résultat visible est une couleur d'arrière-plan pour les lignes paires;
ajouteDureeTotale(): ajoute la durée totale de toutes les activités du rapport;

colonneMarkdownVersHtml(): convertit le texte d'une colonne de la syntaxe Markdown vers le HTML. Utile pour rédiger les descriptions en Markdown. Par exemple:

Lorem *ipsum* dolor **sit** amet, `consectetuer` adipiscing [elit](dictum).

devient:

<p>Lorem <em>ipsum</em> dolor <strong>sit</strong> amet, <code>consectetuer</code> adipiscing <a href="dictum">elit</a>.</p>

dateSansZeroInitial(): supprime tout 0 initial dans les dates apparaissant dans le rapport. Par exemple:
```
08 mai 2010
```
devient:
```
8 mai 2010
```
Autre exemple:
```
Journal d'activité du 01 au 07 mai 2010
```
devient:
```
Journal d'activité du 1 au 7 mai 2010
```
dureeFormatHamsterVersMinutes(): convertit la durée en nombre de minutes. Par exemple, pour la durée 8 h 15 min, le retour est 495;
fusionneActivites(): fusionne les activités de la table «Journal d'activité» (deuxième onglet) du rapport. Les colonnes de début et de fin de l'activité sont supprimées.

La fusion consiste à rechercher les activités semblables (mêmes jour, activité, catégorie et étiquettes) et dont la description utilise une syntaxe spéciale pour lier les activités entre elles. Soit les cinq activités suivantes:
- description de l'activité 1 (1 h 35 min): [1] Début de l'activité. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
- description de l'activité 2 (20 min): [1]
- description de l'activité 3 (2 h 15 min): [1] Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
- description de l'activité 4 (1 h 10 min): [1]
- description de l'activité 5 (2 h 50 min): [1] Fin de l'activité. Praesent tempus; odio ac sagittis vehicula; mauris pede tincidunt lacus, in euismod orci mauris a quam.
Ces cinq activités, si elles ont les mêmes jour, activité, catégorie et étiquettes, sont liées entre elles par le nombre entre crochets situé au début de chaque description, et seront donc fusionnées. La durée totale de l'activité sera la somme de toutes les activités liées (8 h 10 min dans cet exemple) et la description résultante contiendra s'il y a lieu la description de chaque activité:
```
[1] Début de l'activité. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.

Fin de l'activité. Praesent tempus; odio ac sagittis vehicula; mauris pede tincidunt lacus, in euismod orci mauris a quam.
```
minutesVersDureeFormatHamster(): convertit le nombre de minutes en durée affichée par Hamster. Par exemple, pour 495, la durée retournée est 8 h 15 min;
supprimeColonnes(): supprime les colonnes données dans la table donnée;
supprimeJquery(): supprime jQuery du rapport. Utile lorsque des tables ont été supprimées et qu'une seule a été laissée;
supprimeTables(): supprime les tables données. Une table correspond à un onglet principal dans le haut du rapport.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

RapportHamster++ dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Matériel tiers

PHP Markdown: sous licence de style BSD.

gedit-mediawiki: coloration syntaxique de la syntaxe MediaWiki dans gedit

Wed, 26 Oct 2011 13:57:00 -0400

Read this page in English.

Aperçu

gedit-mediawiki ajoute la coloration syntaxique de la syntaxe MediaWiki dans gedit, l'éditeur de texte par défaut de Gnome.

Voici une capture d'écran:

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Copier le fichier mediawiki.lang dans le dossier approprié (créer le dossier s'il n'existe pas):
- pour gedit 2: ~/.local/share/gtksourceview-2.0/language-specs/
- pour gedit 3: ~/.local/share/gtksourceview-3.0/language-specs/

La coloration syntaxique de la syntaxe MediaWiki sera ajoutée à l'utilisateur courant (l'installation se fait donc sans les droits d'administration). Le dossier créé par l'extraction de l'archive peut être supprimé après l'installation.

Désinstallation

Supprimer le fichier précédemment installé.

Utilisation

Avant toute chose, redémarrer gedit s'il est ouvert.

Choisir la coloration en allant dans le menu Affichage > Mode de coloration > Autres de gedit et en cochant MediaWiki.

Un fichier démo se trouve dans le dossier doc de gedit-mediawiki.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

gedit-mediawiki dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Ce programme est un logiciel libre; vous pouvez le redistribuer ou le modifier suivant les termes de la GNU Lesser General Public License telle que publiée par la Free Software Foundation: soit la version 2.1 de la License, soit (à votre gré) toute version ultérieure.

Ce programme est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE: sans même la garantie implicite de COMMERCIALISABILITÉ ou d'ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez la Licence publique générale limitée GNU pour plus de détails.

Vous devriez avoir reçu une copie de la Licence publique générale limitée GNU avec ce programme; si ce n'est pas le cas, écrivez à la: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

gedit-markdown: support du langage Markdown dans gedit

Wed, 26 Oct 2011 13:57:00 -0400

Read this page in English.

Aperçu

gedit-markdown est un ensemble de fichiers ajoutant le support du langage Markdown (ou de la version spéciale Markdown Extra) dans gedit, l'éditeur de texte par défaut de Gnome.

Plus précisément, gedit-markdown ajoute:

la coloration syntaxique des fichiers Markdown ainsi que des extraits de code pour accélérer la rédaction;
le greffon Aperçu Markdown, affichant dans le panneau latéral ou inférieur de gedit un aperçu en HTML de la sélection ou du fichier en cours d'édition;
un outil externe permettant d'exporter le code HTML de la sélection ou du document en cours d'édition;
un jeu de couleurs, optionnel, colorant le code Markdown d'une manière plus ressemblante au rendu HTML.

Dépendances

gedit-markdown supporte gedit 2 et gedit 3. Il est livré avec un installateur pour GNU/Linux. Sous Windows XP, seuls certains fichiers fonctionnent, et doivent être installés à la main.
Le greffon «Aperçu Markdown» dépend de Python 2 (>= 2.6) ou de Python 3 (>= 3.1), bien que pour l'instant, gedit ne supporte que Python 2. L'installateur va copier le greffon seulement si la bonne version de Python est installée.
La désactivation de la vérification orthographique dans la coloration syntaxique pour les contextes non pertinents (par exemple dans les adresses URL) dépend de GtkSourceView >= 2.10.
Pour les utilisateurs d'Ubuntu 11.10 ou une version plus récente: le paquet gir1.2-webkit-3.0 doit être installé pour que le greffon «Aperçu Markdown» fonctionne.

Installation (ou mise à jour)

GNU/Linux

Télécharger l'archive de la dernière version.
Extraire l'archive.
Ouvrir une console dans le dossier extrait.
Lancer le script d'installation dans la console et répondre aux questions demandées, ce qui donne:
```
./gedit-markdown.sh installer
```

Le support de Markdown sera ajouté à l'utilisateur courant (l'installation se fait donc sans les droits d'administration). Le dossier créé par l'extraction de l'archive peut être supprimé après l'installation.

Windows XP

Voici la marche à suivre pour gedit 2:

Coloration syntaxique: dans l'archive de gedit-markdown, trouver le dossier language-specs, copier le fichier correspondant à la version de Markdown voulue, par exemple:
```
language-specs/markdown.lang
```
et le coller dans le dossier suivant:
```
C:Program Filesgeditsharegtksourceview-2.0language-specs
```
Jeu de couleurs optionnel: dans l'archive de gedit-markdown, copier le fichier styles/classic-markdown.xml et le coller dans le dossier suivant:
```
C:Program Filesgeditsharegtksourceview-2.0styles
```

Désinstallation

GNU/Linux

Ouvrir une console dans le dossier extrait.
Lancer le script de désinstallation dans la console, ce qui donne:
```
./gedit-markdown.sh desinstaller
```

Astuce: il est possible de préciser en ligne de commande la version de gedit. Les valeurs possibles sont 2 et 3. Ça peut être utile lors d'une mise à jour de gedit 2 vers gedit 3. Ainsi, le script peut être lancé pour supprimer les fichiers de l'ancienne version de gedit. Exemple:

./gedit-markdown.sh desinstaller 2

Windows XP

Simplement supprimer à la main les fichiers ajoutés lors de l'installation.

Utilisation

Avant toute chose, redémarrer gedit s'il est ouvert.

Coloration syntaxique

La coloration syntaxique devrait s'activer automatiquement pour les fichiers reconnus comme étant des fichiers Markdown (extensions .markdown, .md ou .mkd), sinon choisir la coloration en allant dans Affichage > Mode de coloration > Balisage et cocher Markdown.

Greffon Aperçu Markdown

Pour activer le greffon, aller dans Édition > Préférences > Greffons et activer Aperçu Markdown. Maintenant vous trouverez dans le menu Outils une action Aperçu Markdown, qui affichera dans le panneau latéral ou inférieur l'aperçu en HTML du document courant ou de la sélection. Le raccourci-clavier Ctrl+Alt+m (peut être modifié dans le fichier de configuration) peut également être utilisé pour effectuer la même chose.

Voici une capture d'écran du greffon lorsqu'il est situé dans le panneau inférieur:

Voici maintenant le même greffon situé dans le panneau latéral (cliquer pour télécharger l'image au format original):

Extraits de code

Pour utiliser les extraits de code de Markdown, il faut activer le greffon Extraits de code dans le menu Édition > Préférences > Greffons de gedit. Ensuite, aller dans Outils > Gérer les extraits de code... pour consulter les différentes possibilités.

Outil externe Exporter en HTML

Pour utiliser l'outil externe, il faut activer le greffon Outils externes dans le menu Édition > Préférences > Greffons de gedit. L'outil est accessible par le menu Outils > Outils externes > Exporter en HTML ou par le raccourci-clavier Ctrl+Alt+h. Le code Markdown du document en cours d'édition ou de la sélection sera converti en HTML, et le résultat sera inséré dans un nouveau document.

Pour modifier l'outil, aller dans Outils > Gérer les outils externes....

Jeu de couleurs optionnel

Un jeu de couleurs optionnel est installé automatiquement par gedit-markdown. Pour l'utiliser, aller dans le menu Édition > Préférences > Police et couleurs > Jeu de couleurs de gedit et sélectionner Classic Markdown. Cette coloration se rapproche d'un rendu HTML, par exemple les emphases fortes et les titres sont en gras et de couleur noire, les liens sont bleus et soulignés, etc. Ce jeu de couleurs resemble à ceci:

Fichier de configuration

Le fichier de configuration de gedit-markdown est le suivant:

~/.config/gedit-markdown.ini

Seule la section markdown-preview peut être modifiée, et contient trois paramètres:

panel: emplacement de l'aperçu Markdown. Valeurs possibles: side (panneau latéral) ou bottom (panneau inférieur).
shortcut: raccourci-clavier pour générer l'aperçu en HTML du document courant. La valeur par défaut est <Control><Alt>m.
version: la version du langage Markdown à utiliser pour générer l'aperçu et exporter en HTML. Valeurs possibles: standard ou extra.

Précisions ou limitations

La coloration syntaxique ainsi que les extraits de code pour Markdown (version standard) ont été ajoutés officiellement à GtkSourceView et gedit > 3.1.1. Dans l'installateur de gedit-markdown, si la version choisie est Markdown standard, une vérification sera effectuée pour ne pas copier des fichiers qui existent déjà (aucune vérification ne sera effectuée pour l'installation de Markdown Extra puisqu'il ne s'agit pas de la version livrée par défaut avec GtkSourceView et gedit > 3.1.1).
D'anciennes versions de gedit-markdown ajoutaient également un type MIME pour les fichiers Markdown ainsi que la reconnaissance d'une extension supplémentaire (.mdtxt). Depuis que le support des fichiers Markdown a été ajouté directement dans la base de données partagée MIME shared-mime-info (consulter le rapport de bogue), gedit-markdown n'ajoute plus son propre fichier de type MIME pour Markdown. Aussi, dans un but de conformité avec la spécification, l'extension .mdtxt n'est plus supportée.
Puisqu'il est possible d'ajouter du code HTML directement dans un texte écrit en Markdown, j'ai également ajouté la coloration syntaxique du HTML, ce qui a entre autres comme conséquence que le code Markdown dans du HTML est coloré syntaxiquement. Il faut cependant avoir en tête que selon la syntaxe officielle, du code Markdown dans un environnement HTML n'est pas transformé, il est affiché tel quel, et que selon la syntaxe du Markdown Extra, seul le code Markdown dans un bloc possédant un attribut markdown dont la valeur est de 1 (par exemple <div markdown="1">) est transformé.
Markdown permet d'écrire du code dans un paragraphe. Pour ce faire, le code doit être entouré d'un accent grave (`), ou de plusieurs, pourvu que le nombre soit identique de part et d'autre, et qu'il n'y ait pas dans le code un nombre identique d'accents qui se suivent. Exemples:
```
`lorem lorem lorem lorem`

`lorem lorem `` lorem lorem`

`lorem lorem ````` lorem lorem`

``lorem lorem lorem lorem``

``lorem lorem ` lorem lorem``

``lorem lorem ````` lorem lorem``
```
Prendre note que gedit-markdown supporte la coloration jusqu'à 2 accents de part et d'autre du code.
Un bloc de citation peut contenir des éléments Markdown de niveaux bloc ou texte, mais gedit-markdown supporte seulement la coloration des éléments de niveau texte (emphase, lien, etc.).
Il n'est pas possible de savoir dans quel contexte une ligne se trouve, entre autres parce que le retour à la ligne ne peut pas être utilisé dans les expressions rationnelles de la coloration syntaxique. En voici des conséquences:
- Selon la syntaxe du Markdown, pour écrire plusieurs paragraphes dans un item de liste, il faut indenter chaque paragraphe. Exemple:
```
- Item A (paragraphe 1).

    Item A (paragraphe 2).

    Item A (paragraphe 3).

- Item B.
```
  Il y a donc conflit au plan de la coloration syntaxique entre un paragraphe indenté à l'intérieur d'une liste (quatre espaces ou une tabulation) et une ligne de code indentée en dehors d'une liste (également quatre espaces ou une tabulation). Le choix a été fait de colorer une ligne de code seulement à partir de deux niveaux d'indentation.
- Seul le soulignement d'un titre de style Setext est analysé et coloré. Il n'y a donc pas de garanti qu'il s'agit bien d'un soulignement de titre.
- Avec Markdown Extra, quelques éléments sont analysés et colorés sans certitude qu'ils sont bien dans le bon contexte: l'attribut id pour un titre de style Setext, le deux-points séparateur dans une liste de définition et la ligne de séparation d'un tableau.

Traduction

Les messages de l'installateur peuvent être traduits. Toute personne intéressée à effectuer une traduction peut donc copier le fichier gedit-markdown.pot situé dans le répertoire locale, le renommer en LANGUE.po, y traduire les phrases et m'envoyer le résultat.

De même, le greffon Aperçu Markdown est également traduisible. Le fichier contenant les phrases à traduire est plugins/markdown-preview/locale/markdown-preview.pot.

Pour l'instant, gedit-markdown est disponible en français et en anglais.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

gedit-markdown dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Matériel tiers

Le greffon d'aperçu Markdown est basé sur Markdown Preview, sous licence GPL version 2 ou toute version ultérieure, et sur Python Markdown, sous licence de style BSD.

gedit-url: coloration syntaxique des URL dans gedit

Wed, 26 Oct 2011 13:57:00 -0400

Read this page in English.

Aperçu

gedit-url ajoute la coloration syntaxique des URL dans gedit, l'éditeur de texte par défaut de Gnome.

Voici une capture d'écran (cliquer pour télécharger l'image au format original):

Installation

Télécharger l'archive de la dernière version.
Extraire l'archive.
Copier le fichier url.lang dans le dossier approprié (créer le dossier s'il n'existe pas):
- pour gedit 2: ~/.local/share/gtksourceview-2.0/language-specs/
- pour gedit 3: ~/.local/share/gtksourceview-3.0/language-specs/

La coloration syntaxique des URL sera ajoutée à l'utilisateur courant (l'installation se fait donc sans les droits d'administration). Le dossier créé par l'extraction de l'archive peut être supprimé après l'installation.

Désinstallation

Supprimer le fichier précédemment installé.

Utilisation

Avant toute chose, redémarrer gedit s'il est ouvert.

Choisir la coloration en allant dans la menu Affichage > Mode de coloration > Autres de gedit et cocher URL.

Un fichier démo se trouve dans le dossier doc de gedit-url.

Développement

Le logiciel Git est utilisé pour la gestion de versions. Le dépôt peut être consulté en ligne ou récupéré en local.

gedit-url dispose également d'un système de suivi, sur lequel les rapports de bogues et les suggestions peuvent être soumis.

Licence

Vous devriez avoir reçu une copie de la Licence publique générale GNU avec ce programme; si ce n'est pas le cas, consultez http://www.gnu.org/licenses/.

Squeletml: système de gestion de contenu léger et sans base de données

Mon, 06 Sep 2010 10:04:00 -0400

Le logiciel libre Squeletml est un système de gestion de contenu léger, sans base de données et multilingue. Sa structure est un squelette XHTML 1.0 Strict géré par inclusion de fichiers PHP. Chaque page peut être personnalisée facilement (métabalises, langue, titre de premier niveau, fichiers CSS ou Javascript, table des matières, etc). Plusieurs fonctionnalités sont également livrées par défaut: formulaires de contact, galeries photo, classement par catégories, flux RSS, fonction «Faire découvrir à des ami-e-s», interface d'administration avec porte-documents, etc.

Aussi, un fichier de configuration permet de paramétrer en un rien de temps plusieurs aspets structurels et visuels sans devoir bidouiller dans les feuilles de style CSS ou la structure de page.