Ce billet est plus un mémento personnel qu'un guide. Il présente une technique qui n'est pas recommandable, à moins de savoir parfaitement ce que l'on fait. La manipulation décrite ici est à effectuer sous environnement Linux.

Lors des mises à jour automatique de Dotclear, il vérifie que les fichiers de l'application n'ont pas été modifiés. S'il y a des changements, nous avons alors droit à un message similaire à :

Il est alors impossible de mettre à jour automatiquement l'application, il faut le faire manuellement. Si comme moi vous avez tendance à éditer vos fichiers de template directement via l'interface d'administration, c'est une erreur récurrente qui est plus embêtante qu'utile. Dotclear possède en fait la liste des empreinte md5 (hash) d'une partie des fichiers qui le compose. Lors de la mise à jour, il compare l'empreinte attendue avec l'empreinte trouvée. Si cela diffère, l'erreur affichée précédemment apparaît. Sinon, tout roule et la mise à jour automatique se fait sans problème.

L'idée ici est de regénerer cette liste d'empreinte à partir des fichiers qu'on a, qui ont justement été modifié depuis la dernière installation / mise à jour. Pour cela, il faut récupérer tous les fichiers via FTP, en précisant bien le mode "binaire" pour le type de transfert. Une fois les fichiers récupérés, on fait une copie de inc/digest que l'on met de côté. On efface le fichier, puis on lance un terminal dans le dossier racine. On lance alors la commande suivante :

md5sum `find . -type f -not -path "./inc/digest" -not -path "./cache/*" -not -path "./db/*" -not -path ./CHANGELOG -not -path "./themes/*" -not -path "./public/*" -not -path "./plugins/*"` > inc/digests

Cette commande va calculer les empreintes de tous les fichiers, sauf ceux cités dans le répertoire cache/, db/, themes/, public/ et plugins/. Notez que j'ai choisi d'exclure ces dossiers parce qu'ils ne me semblent pas pertinents dans la vérification de l'intégrité de l'application. A vous de choisir quels dossiers exclures selon vos propres besoins !

Dernière étape : on envoie notre nouveau fichier digest via FTP sur le serveur. Et là, la mise à jour sera fonctionnelle.

Introduction

Un des problèmes de LaTeX sous Debian (et d'autres distributions comme Linux Mint ou Ubuntu), c'est que les packages ne sont pas à jour. Ainsi, lorsqu'on souhaite utiliser le package geometry pour manipuler les marges d'un document, nous sommes privés de commandes telles que \newgeometry{...} ou \restoregeometry{}. La compilation échoue sur un "Undefined control sequence"... Il faut donc mettre à jour ce package pour résoudre ce problème !

Télécharger la dernière version

La dernière version du package geometry est disponible sur le site du CTAN. Nous pouvons utiliser le lien en haut de la page pour récupérer un fichier zip qu'il suffira d'extraire.

Générer le .sty

L'archive contient seulement 5 fichiers :

• README
• changes.txt
• geometry.dtx
• geometry.ins
• geometry.pdf

On obtient le fichier .sty en lançant la commande :

tex geometry.dtx

Notez que d'autres fichiers ont été créé par la même occasion. Seuls deux vont nous intéresser ici : geometry.sty et geometry.cfg

Installer la nouvelle version

Les deux fichiers cités ci-dessus doivent être placés dans le dossier ~/texmf/tex/latex/geometry/. S'il n'existe pas, vous pouvez le créer ainsi :

mkdir -p ~/texmf/tex/latex/geometry/

Ensuite, on copie les fichiers :

cp geometry.sty geometry.cfg ~/texmf/tex/latex/geometry/

Dorénavant, lors de la compilation de vos fichiers LaTeX, le nouveau package geometry sera utilisé à la place de l'ancien, fourni par votre distribution. On peut alors utiliser les dernières commandes bien pratiques, telles que \newgeometry qui permet de redéfinir les marges d'un document en plein milieu de celui-ci.

Aller plus loin

Pour rendre cette mise à jour commune à tous les utilisateurs de votre système, vous pouvez placer le fichier geometry.sty et geometry.cfg dans le répertoire /usr/share/texmf-texlive/tex/latex/geometry.