Marin Lagacé

Visionner des PDFs avec 'less'

2020-12-06T15:32:00-05:00

J'adore Vifm. Une de ses fonctionnalités que j'apprécie particulièrement est de pouvoir visionner le contenu de n'importe quel fichier texte simplement en appuyant sur la touche e. Cependant, j'aimerais également visionner des PDFs directement dans Vifm sans avoir à démarrer une visionneuse graphique. Pour ce faire, il suffit d'utiliser une application qui écrit le texte du PDF directement à la console.

Je cherchais une telle application lorsque je suis tombé sur cet article de StackOverflow. Il semblerait que le bon vieux less peut très bien se charger des PDFs. J'ai donc ajouté les lignes suivantes à mon fichier vifmrc.

fileviewer *.pdf
        \ less "%c",

Je peux maintenant visionner des PDFs directement dans Vifm et ça fonctionne plutôt bien.

Using 'less' to view PDFs

2020-12-06T14:39:00-05:00

I love Vifm. One of the features I like the most it that you can easily preview any text file by pressing the e key. But I would also like to preview a PDF directly in Vifm without having to start up a GUI viewer. The trick is to use an application that will output the PDF's text directly to the console.

I started looking for such an application when I came across this post from StackOverflow. It seems that good-old less can already do that. So, I added the following line to my vifmrc file.

fileviewer *.pdf
        \ less "%c",

I can now preview PDF files in Vifm and it works pretty well.

Qt Traduction: Qualifying with unknown namespace/class

2020-12-05T17:29:00-05:00

Je traduisais une librarie utilisant Qt lorsque j'ai rencontré cette erreur.

[ 44%] Generating foo_fr.ts
Bar.cpp:40: Qualifying with unknown namespace/class ::Bar
Updating 'foo_fr.ts'...
    Found 3 source text(s) (3 new and 0 already existing)

Je n'ai pas trouvé beaucoup d'information concernant cette erreur sur internet. Heureusement, je suis tombé sur cet article de StackOverflow qui m'a guidé vers une solution au problème.

Le problème provient du design de la librarie. Ses fichiers d'entête ne sont pas dans le même répertoire que ses fichiers d'implémentation.

Foo
|-- include
|   '-- foo
|       '-- Bar.hpp
+-- src
|   |-- Bar.cpp
|   +-- CMakeLists.txt
+-- CMakeLists.txt

Ceci pose problème parce que les utilitaires de traduction de Qt s'attendent à retrouver les fichiers d'entête dans le même répertoire que les fichiers d'implémentation. Si ce n'est pas le cas, on doit spéficier le répertoire des fichiers d'entête lorsqu'on utilise lupdate. Puisque la librarie que je traduisais est compilée à l'aide de CMake, il suffit d'utiliser la macro qt5_create_translation à laquelle on ajoute l'option -I suivie du répertoire des fichiers d'entête au paramètre OPTIONS.

qt5_create_translation(QM_FILES
    Bar.cpp
    foo_fr.ts
    OPTIONS -I ${CMAKE_CURRENT_SOURCE_DIR}/../include
)

Qt Translation: Qualifying with unknown namespace/class

2020-12-05T14:49:00-05:00

I was translating a widget library written in Qt when I got the following error.

[ 44%] Generating foo_fr.ts
Bar.cpp:40: Qualifying with unknown namespace/class ::Bar
Updating 'foo_fr.ts'...
    Found 3 source text(s) (3 new and 0 already existing)

I could not find a lot of info about this error on the internet. Luckily, I ran across this post on StackOverflow that guided me toward a solution.

The problem came from the way the library was designed. Its public header files are not in the same directory as its implementation files.

Foo
|-- include
|   '-- foo
|       '-- Bar.hpp
+-- src
|   |-- Bar.cpp
|   +-- CMakeLists.txt
+-- CMakeLists.txt

This poses a problem because Qt's translation utilities expect the header files to be in the same directory as their implementation files. In case they are not, one must specify their directory when calling lupdate. Since the library I was translating uses CMake as its build tool, this is done using the qt5_create_translation macro and adding the -I flag with the header files path to the OPTIONS parameter.

# Foo/src/CMakeLists.txt
qt5_create_translation(QM_FILES
    Bar.cpp
    foo_fr.ts
    OPTIONS -I ${CMAKE_CURRENT_SOURCE_DIR}/../include
)

Vim Portable sous Windows

2020-12-01T22:11:00-05:00

Lorsque j'écris du code sous Windows, j'utilise habituellement Vim sous Cygwin. J'utilise ma petite astuce pour rendre mon installation de Cygwin portable. Ceci me permet de la copier sur tous mes ordinateurs.

J'utilise abondamment Fugitive qui est un module qui facilite grandement l'utilisation de Git sans devoir quitter Vim. Malheureusement, Fugitive tourne extrêmement lentement sur mon princial ordinateur de travail. Ainsi, sur cet ordinateur, j'utilise plutôt gVim Portable de la plateforme PortableApps . Le petit défi est de faire intéragir gVim Portable avec Git (pour Fugitive) et Python (pour UltiSnips). Le truc est d'installer Git et la version appropriée de Python et ensuite ajuster le fichier de configuration de gVim Portable.

Installation de Git portable

Téléchargez-le du site web. Assurez-vous de télécharger la version portable.

Installez-le au côté de gVim Portable.

e:
├── gVimPortable
│   ├── App
│   ├── ...
│   ├── gVimPortable.exe
│   └── ...
└── PortableGit
    ├── bin
    ├── ...
    ├── git-bash.exe
    ├── git-cmd.exe
    └── ...

Installation de Python

Il est important d'installer la version appropriée de Python. Vous devez installer Python 3 parce qu'Ultisnips ne supporte plus Python 2. De plus, vous devez installer la version de Python que Vim s'attend à retrouver sur votre système. Référez-vous à mon article sur l'installation d'Ultisnips sous Cygwin pour une explication des opérations à exécuter pour déterminer la version de Python pour laquelle Vim a été compilée.

Au moment de l'écriture de cet article, gVim nécessite Python 3.6. De plus, gVim a été compilé pour la version 32 bits de Windows.

La version portable x86 doit donc être utilisée.

Tel que pour Git, installez Python au côté de gVim.

e:
├── gVimPortable
│   ├── ...
│   ├── gVimPortable.exe
│   └── ...
├── PortableGit
│   ├── ...
│   ├── git-bash.exe
│   ├── git-cmd.exe
│   └── ...
└── Python36-x86
    ├── ...
    ├── python.exe
    ├── ...
    ├── python36.dll
    └── ...

Configuration de gVim Portable

Nous devons maintenant informer gVim Portable de l'endroit où est installé Git et Python. Pour ce faire, nous devons modifier le fichier gVimPortable.ini situé au fin fond de la structure de répertoire de gVim Portable.

e:
└── gVimPortable
    └── App
        └── AppData
            └── Launcher
                └── gVimPortable.ini

Ajoutez les variables PYTHON_HOME et GIT_HOME à la section [Environment] du fichier.

[Environment]
VIM=%PAL:AppDir%\vim
VIMRUNTIME=%PAL:AppDir%\vim\vim80
HOME=%PAL:DataDir%\settings
LANG=%PAL:LanguageCustom%
PYTHON_HOME=%PAL:PortableAppsDir%\Python36-x86
GIT_HOME=%PAL:PortableAppsDir%\PortableGit

Finalement, modifiez la variable PATH dans votre fichier .vimrc pour y ajouter l'endroit où se situe vos installation de Git et Python.

if !empty($PYTHON_HOME)
  let $PATH .= ';' . $PYTHON_HOME . ';' . $PYTHON_HOME . '\scripts'
  let $PYTHONHOME = $PYTHON_HOME
endif
if !empty($GIT_HOME)
  let $PATH .= ';' . $GIT_HOME . '\bin'
endif

Une fois les modifications terminées, Fugitive et Ultisnips devrait fonctionner parfaitement lorsque vous éditerez des fichiers avec votre installation de gVim Portable.

Portable Vim on Windows

2020-12-01T21:36:00-05:00

When doing Windows development, I usually use Vim under Cygwin. I use my little Cygwin hack to make it portable. This allows me to easily copy my Cygwin installation along with all my settings to multiple computer.

I rely heavily on Fugitive which is a great Vim plugin for Git. Unfortunately, it runs extremely slowly on my main work computer. So, on that computer, I use gVim Portable from the PortableApps platform. It works great. The tricky part is making it work along with Git (for Fugitive) and Python (for UltiSnips). It involves installing Git along with the proper version of Python and tweaking a configuration file of gVim Portable.

Installing Portable Git

Download it from their website. Make sure to download the portable version.

Then, install it alongside of gVim.

e:
├── gVimPortable
│   ├── App
│   ├── ...
│   ├── gVimPortable.exe
│   └── ...
└── PortableGit
    ├── bin
    ├── ...
    ├── git-bash.exe
    ├── git-cmd.exe
    └── ...

Installing Python

It is important to install the appropriate version of Python. It needs to be a Python 3 version because UltiSnips does not support Python 2 anymore. Furthermore, it needs to be the Python version expected by Vim. See my previous article on installing Ultisnips on Cygwin for a description of the technique to use to find out which Python version your installation of Vim expects to find on your system.

As of this writing, gVim Portable needs Python 3.6. Furthermore, gVim Portable was compiled for 32-bit systems.

So the portable x86 version should be used.

As for Git, install it alongside gVim.

e:
├── gVimPortable
│   ├── ...
│   ├── gVimPortable.exe
│   └── ...
├── PortableGit
│   ├── ...
│   ├── git-bash.exe
│   ├── git-cmd.exe
│   └── ...
└── Python36-x86
    ├── ...
    ├── python.exe
    ├── ...
    ├── python36.dll
    └── ...

Configuring gVim Portable

We must now tell gVim where to find our intallations of Git and Python. For that, we must edit the gVimPortable.ini file located deep into the directory structure.

e:
└── gVimPortable
    └── App
        └── AppData
            └── Launcher
                └── gVimPortable.ini

Add the PYTHON_HOME and GIT_HOME variable definitions to the [Environment] section of the file.

[Environment]
VIM=%PAL:AppDir%\vim
VIMRUNTIME=%PAL:AppDir%\vim\vim80
HOME=%PAL:DataDir%\settings
LANG=%PAL:LanguageCustom%
PYTHON_HOME=%PAL:PortableAppsDir%\Python36-x86
GIT_HOME=%PAL:PortableAppsDir%\PortableGit

Finally, modify the PATH variable in your .vimrc file to add the path to your Git and Python installation.

if !empty($PYTHON_HOME)
  let $PATH .= ';' . $PYTHON_HOME . ';' . $PYTHON_HOME . '\scripts'
  let $PYTHONHOME = $PYTHON_HOME
endif
if !empty($GIT_HOME)
  let $PATH .= ';' . $GIT_HOME . '\bin'
endif

After this, Fugitive and Ultisnips should work fine when editing files in your gvim installation.

LineScout

2020-08-14T11:04:00-04:00

The LineScout is one of the first robots designed at the robotics department. Its main goal is to inspect high voltage power lines. It can do visual inspection using its four high definition cameras as well as do resistance measurements on sleeves and corrosion assessments of the steel spine of the cables. It main advantage is that it can easily manage most obstacles found on power lines such as spacers and vibration dampeners.

Originally, the video feeds were analog and recorded on MiniDV magnetic tapes. During the robot's last update, the analog cameras were changed to digital cameras. My job was to update the robot control software to display and record the new digital video feeds coming from the cameras.

For those who are not familiar with the LineScout, here is a corporate video describing it. The video was make before the update described above.

LineScout

2020-08-14T11:04:00-04:00

Le LineScout est un des premiers robots conçus au département de robotique d'inspection et de maintenance. Sa principale fonction est l'inspection des lignes à haute tension. Il peut faire autant de l'inspection visuelle à l'aide des ses quatre caméras à haute définition que des mesures de résistance sur les manchons et des mesures de corrosion sur l'âme d'acier des conducteurs. Son principal avantage est qu'il peut franchir la plupart des obstacles qu'on retrouve sur les lignes tels que les entretoises et les amortisseurs.

À l'origine, tous les flux vidéo étaient analogiques et enregistrés sur des rubans magnétiques de format MiniDV. Lors de la dernière mise à jour du robot, les caméras analogiques ont été changées pour des caméras numériques. Ma tâche a été de mettre à jour le logiciel de contrôle du robot afin qu'il puisse faire la visualisation et l'enregistrement des nouveaux flux vidéo numériques provenant des caméras.

Pour ceux qui ne serait pas familier avec le robot LineScout, voici un vidéo corporatif le décrivant. Le vidéo a été réalisé avant la mise à jour décrite plus haut.

UltiSnips on Cygwin

2020-06-27T10:01:00-04:00

UltiSnips is the plugin for Vim that I use the most. It allows for the creation of macros (named snippets) that insert predefined chuncks of text at the desired location in a file. These snippets automate the insertion of repetitive lines of code. They can be very simple like the following one which write the necessary C++ code to print text to the console:

They can be much more complex like this one which creates the header for a C++ class:

UltiSnips requires Python3 to run. Thus, Vim must have been compiled with Python3 support. To check, start Vim with the --version argument.

Fortunately, this is the case for the version of Vim found in the Cygwin repo.

It is not enough to have installed Python for UltiSnips to work out of the box. We need to have installed the same version that Vim was compiled for. To check that the link between Vim and Python works proprely, we can simply try to run any Python expression in Vim using the :python3 command. ¹

If the Vim/Python link is correct, the command will be executed without any error. Otherwise, an error message will be displayed at the bottom of the window.

We see here that Vim is looking for Python 3.7. We just need to start the Cygwin installation app and install the python37 package.

Once installed, UltiSnips should properly work.

UltiSnips does not support Python2 since commit d2f42d6. It is thus important to use the :python3 command for our test. ↩

UltiSnips sous Cygwin

2020-06-27T10:01:00-04:00

UltiSnips est un des modules d'extension de Vim que j'utilise le plus. Il permet d'écrire des macros (appelés snippets) qui insèrent des bouts de texte prédéfinis à l'endroit désiré dans le fichier. Ces snippets me permettent d'automatiser l'écriture de bout de code répétitif. Ils peuvent être plutôt simple comme celui-ci qui écrit le code C++ nécessaire pour imprimer du texte à l'écran:

Ils peuvent également être plus complexes comme celui-ci qui crée l'entête d'une classe en C++:

UltiSnips requiert Python3 pour rouler. Il faut donc que Vim ait été compilé avec le support pour Python3. Pour vérifier, démarrez Vim avec l'argument --version.

C'est heureusement le cas pour la version de Vim de la logithèque de Cygwin.

Il ne suffit cependant pas d'avoir installé Python pour qu'UltiSnips fonctionne automatiquement. Il faut avoir installé la même version que celle pour laquelle Vim a été compilé. Pour déterminer si le lien entre Vim et Python fonctionne bien, on peut simplement essayer d'exécuter n'importe quelle expression Python dans Vim à l'aide de la command :python3. [ref] UltiSnips ne support plus Python2 depuis le commit d2f42d6. Il est donc important de tester à l'aide de la command :python3. [/ref]

Si le lien Vim/Python est bon, l'expression sera exécutée sans erreur. Dans le cas contraire, un message d'erreur apparaîtra au bas de la fenêtre.

On voit ici que Vim recherche la version 3.7 de Python. Il ne suffit donc que de retourner dans l'application d'installation de Cygwin et installer le paquet python37.

Une fois l'installation du paquet complétée, UltiSnips devrait fonctionner correctment.

Portable Cygwin

2020-06-12T21:20:00-04:00

I do most of my software development on Linux. Since my employer is a Windows shop, most of the software I write must run on Windows. Since I use cross-platform libraries (like Boost or Qt), I can still do most of my development work on Linux. Unfortunately, at some point, I need to move to Windows to compile and test the software.

On Linux, I mainly use Vim with tmux. I am very familiar with those tools. I have my tmux sessions, windows and panels set up just the way I like them. I also have fully configured my Vim plugins and key bindings. I really would like to keep using these tools and my workspace configuration when coding on Windows. And I can by using Cygwin.

According to Wikipedia:

Cygwin is a POSIX-compatible environment that runs natively on Microsoft Windows. Its goal is to allow programs of Unix-like systems to be recompiled and run natively on Windows with minimal source code modifications by providing them with the same underlying POSIX API they would expect in those systems. ¹

Cygwin is a great tool. I can use Vim and tmux without any problem. All the plugins and configuration files I used on Linux work flawlessly on Cygwin.

In my work, I have access to multiple computers. I want to use Cygwin on all of them so I can have access to all my development tools. The problem is that Cygwin can be long and tedious to install and configure. I would like a version that can be run from a USB drive.

There are many projects on GitHub that hack on a local Cygwin installation to make it portable. Some of them are quite old and look abandoned. Some others I find too complex for my needs. So here is my own hack to make Cygwin portable.

Install Cygwin to your hard drive. It does not matter to which directory you install it. Here, I chose to install it to c:CygwinX86.

Set the local package directory location to a subdirectory of the installation directory. Here, I use the packages subdirectory.

Follow the installation procedure to the end. There is no other special care to take during the installation process.

Once the installation procedure is complete, add a batch file named PortableCygwin.bat ² to the Cygwin root directory.

The file should contain the following lines:

@echo off
"%~dp0\bin\mintty.exe" -i /Cygwin-Terminal.ico -

This file will start the Cygwin terminal from whichever directory it is installed on.

Cygwin will create a home folder using the current Windows user name. My user name changes from computer to computer. This means that the name of my home folder will also change from computer to computer. We thus need to set a fix home folder to make our installation more portable. This can be easily accomplished by editing the /etc/nsswitch.conf file, uncommenting the db-home line and setting its value to a fixed path:

# /etc/nsswitch.conf
#
#    This file is read once by the first process in a Cygwin process tree.
#    To pick up changes, restart all Cygwin processes.  For a description
#    see https://cygwin.com/cygwin-ug-net/ntsec.html#ntsec-mapping-nsswitch
#
# Defaults:
# passwd:   files db
# group:    files db
# db_enum:  cache builtin
db_home:  /home/foo
# db_shell: /bin/bash
# db_gecos: <empty>

In the above case, Cygwin will always set the home directory to /home/foo. Restart your terminal and check that your home directory has the expected path.

$ cygpath -w ~
c:\CygwinX86\home\foo

We need to register the proper path to the local package directory. This path is recorded in the /etc/setup/setup.rc file.

last-cache
        c:\CygwinX86\packages
mirrors-lst
        http://cygwin.mirror.constant.com/;cygwin.mirror.constant.com;United States;New Jersey
        http://cygwin.mirror.hoobly.com/;cygwin.mirror.hoobly.com;United States;Pennsylvania
        http://mirrors.koehn.com/cygwin/;mirrors.koehn.com;United States;Missouri
        http://mirrors.metapeer.com/cygwin/;mirrors.metapeer.com;United States;Washington
        ...

We need to replace the second line with the path to the local package directory on our USB key. Adding the following line to your .profile file will do the trick.

sed -i '2s|.*|\t'$(cygpath -m /)'/packages|' /etc/setup/setup.rc

It is important to specify the proper subdirectory in the command. Here we specified packages since this is the subdirectory we used during installation earlier. Now, every time we start Cygwin, the .profile file will be run and the setup.rc file will be updated with the actual path to the local package directory.

Finally, copy the whole installation directory anywhere on your USB drive. Use the PortableCygwin.bat file to start Cygwin and enjoy your portable POSIX experience.

https://en.wikipedia.org/wiki/Cygwin ↩
You can of course name it any way you like. ↩

Cygwin Portable

2020-06-12T21:20:00-04:00

Je développe principalement sous Linux. Comme mon employeur ne supporte officiellement que les applications Windows, la plupart de mes application doivent rouler sous Windows. Puisque j'utilise des librairies multiplateformes (tel que Boost ou Qt), je peux tout de même développer mes applications sous Linux. Malheureusement, je dois éventuellement passer à Windows pour compiler et tester mon code.

Sous Linux, j'utilise principalement Vim et tmux. Je suis très familier avec ces outils. J'ai une configuration de sessions, fenêtres et panneaux tmux que j'aime bien. J'ai également une configuration de Vim avec des extensions et des raccourcis clavier qui me conviennent. J'aimerais vraiment conserver ces outils et leur configuration lorsque je travaille sous Windows. Et je le peux grâce à Cygwin.

D'après Wikipedia:

Cygwin est une collection de logiciels libres à l'origine développés par Cygnus Solutions permettant à différentes versions de Windows de Microsoft d'émuler un système Unix. Il vise principalement l'adaptation à Windows de logiciels qui fonctionnent sur des systèmes POSIX (tels que les systèmes GNU/Linux, BSD, et Unix). Cygwin simule un environnement Unix sous Windows, rendant possible l'exécution de ces logiciels après une simple compilation. [ref] https://fr.wikipedia.org/wiki/Cygwin [/ref]

Cygwin est une outil incroyable. On peut utiliser Vim et tmux sans problème. Toutes les extensions ainsi que les fichiers de configuration que j'utilise sous Linux fonctionne à la perfection sous Cygwin.

À mon travail, j'ai accès à plusieurs ordinateurs différents. Je voudrais utiliser Cygwin sur chacun d'entre eux afin d'avoir accès à tous mes outils de développement. Le problème est que Cygwin peut être long et fastidieux à installer et configurer. J'aimerais avoir une version que puisse rouler à partir d'une clef USB.

Il existe plusieurs projets sur GitHub qui modifie une installation locale de Cygwin pour la rendre portable. Certains de ces projets sont plutôt vieux et semblent abandonnés. D'autres me semblent trop complexes pour mes besoins. Voici donc les modifications que j'ai faites pour rendre Cygwin portable.

Installez Cygwin sur votre disque dur. Peu importe dans quel répertoire vous décidez de l'installer. J'ai choisi de l'installer dans c:CygwinX86.

Fixez le répertoire des paquets téléchargés comme un sous-répertoire de votre répertoire d'installation. Ici, j'utilise le sous-répertoire packages.

Suivez la procédure d'installation jusqu'à la fin. Il n'y a rien de spécial à effectuer d'ici la fin de la procédure d'installation.

Une fois la procédure d'installation terminée, ajoutez un fichier nommé PortableCygwin.bat [ref] Vous pouvez le nommer comme vous le voulez. [/ref] au répertoire d'installation de Cygwin.

Le fichier devrait contenir les lignes suivantes:

@echo off
"%~dp0\bin\mintty.exe" -i /Cygwin-Terminal.ico -

Ce fichier va démarrer la console de Cygwin à partir du répertoire dans laquelle elle se retrouve.

Cygwin va créer une dossier d'accueil utilisant votre nom d'usager Windows. Mon nom d'usager change d'ordinateur à ordinateur. Ceci signifie que mon dossier d'accueil change également d'ordinateur à ordinateur. Nous devons donc fixer le nom du dossier d'accueil afin de rendre notre installation portable. Ceci peut être facilement accompli en modifiant le fichier /etc/nsswitch.conf. Il suffit de modifier la ligne contenant db-home pour y écrire le nom du dossier d'accueil désiré:

# /etc/nsswitch.conf
#
#    This file is read once by the first process in a Cygwin process tree.
#    To pick up changes, restart all Cygwin processes.  For a description
#    see https://cygwin.com/cygwin-ug-net/ntsec.html#ntsec-mapping-nsswitch
#
# Defaults:
# passwd:   files db
# group:    files db
# db_enum:  cache builtin
db_home:  /home/foo
# db_shell: /bin/bash
# db_gecos: <empty>

Dans l'exemple ci-haut, Cygwin fixera toujours son dossier d'accueil à /home/foo. Redémarrez la console et vérifiez que le dossier d'accueil est bien celui désiré.

$ cygpath -w ~
c:\CygwinX86\home\foo

Maintenant, nous devons modifier le chemin du répertoire de sauvegarde des paquets. Ce chemin se retrouve dans le fichier /etc/setup/setup.rc.

last-cache
        c:\CygwinX86\packages
mirrors-lst
        http://cygwin.mirror.constant.com/;cygwin.mirror.constant.com;United States;New Jersey
        http://cygwin.mirror.hoobly.com/;cygwin.mirror.hoobly.com;United States;Pennsylvania
        http://mirrors.koehn.com/cygwin/;mirrors.koehn.com;United States;Missouri
        http://mirrors.metapeer.com/cygwin/;mirrors.metapeer.com;United States;Washington
        ...

Nous devons remplacer la seconde ligne avec le chemin du répertoire de sauvegarde des paquets sur notre clef USB. L'ajout de la ligne suivante à notre fichier .profile fera l'affaire.

sed -i '2s|.*|\t'$(cygpath -m /)'/packages|' /etc/setup/setup.rc

Il est important de bien spécifier le bon sous-répertoire dans cette commande. Ici, nous spécifions packages puisqu'il s'agit du sous-répertoire que nous avons utilisé lors de la procédure d'installation effectuée plus tôt. À partir de maintenant, à chaque fois que nous démarrerons Cygwin, le fichier .profile sera exécuté et le fichier setup.rc sera mis à jour avec le chemin actuel du répertoire de sauvegarde des paquets.

Les modifications sont terminées. Copiez le répertoire d'installation au complet sur votre clef USB. Utilisez PortableCygwin.bat pour démarrer Cygwin et apprécier votre environnement POSIX portable.

FileBeagle

2020-05-31T19:50:00-04:00

Vim has netrw as a built-in directory browser. It is pretty basic and some people like that. Others find it a bit too basic or unintuitive. Tim Pope wrote vinegar to "enhance netrw, partially in an attempt to mitigate the need for more disruptive 'project drawer' style plugins". ¹

A very popular tree explorer plugin is NERDTree. It is very pretty and has a lot of features but I find it a little too heavy for my taste.

I prefer to use FileBeagle as my directory browser. It is simple and efficient. As stated by its developer:

Vim is a text editor, not an operating system that can edit text. FileBeagle respects this, and attempts to conform to this both in spirit and in practice. If you are looking for a plugin to serve as a filesystem manager from within Vim, FileBeagle is not it. FileBeagle does not support copying, deleting, moving/renaming, or any other filesystem operations. FileBeagle lists and opens files. ²

The - key is mapped to open FileBeagle on the directory of the current buffer. You can then use the standard Vim navigation keys to move to a file or a directory or press - to go to the parent directory. Pressing Enter will either go into the selected directory or open the selected file for editing. There are many more functions available. I refer you to the plugin's documentation for more info.

I like FileBeagle to display hidden files and relative line numbers. Here are the variables I set in my .vimrc file to accomplish that.

let filebeagle_show_hidden=1
let filebeagle_show_line_numbers=1
let filebeagle_show_line_relativenumbers=0

Give FileBeagle a try. You might like it.

FileBeagle

2020-05-31T19:50:00-04:00

Vim possède netrw comme navigateur de répertoire. Il est plutôt basique ce qui plaît à certaines personnes. D'autre le trouve trop basique et peu intuitif. Tim Pope a écrit vinegar afin "d'améliorer netrw, partiellement comme tentative de mitiger le besoin pour des modules de style 'tiroir à projet' plutôt perturbateurs" [ref] "enhance netrw, partially in an attempt to mitigate the need for more disruptive 'project drawer' style plugins". (https://github.com/tpope/vim-vinegar/blob/master/README.markdown) [/ref]

Un navigateur de répertoire très populaire est NERDTree. Il est très joli et comporte beaucoup de fonctionnalités. Je le trouve un peu trop lourd à mon goût par contre.

Je préfère utiliser FileBeagle. Il est simple et efficace. Son créateur le décrit ainsi:

Vim est un éditeur de texte et non pas un système d'opération qui peut éditer du texte. FileBeagle respecte ce fait et tente de s'y conformer autant en esprit qu'en pratique. Si vous recherchez un module servant de gestionnaire de fichiers à même Vim, FileBeagle n'est par pour vous. FileBeagle ne peut copier, effacer, déplacer/renommer ou effectuer toute autre opération sur les fichiers. FileBeagle liste et ouvre les fichiers [ref] "Vim is a text editor, not an operating system that can edit text. FileBeagle respects this, and attempts to conform to this both in spirit and in practice. If you are looking for a plugin to serve as a filesystem manager from within Vim, FileBeagle is not it. FileBeagle does not support copying, deleting, moving/renaming, or any other filesystem operations. FileBeagle lists and opens files". (https://github.com/jeetsukumaran/vim-filebeagle/blob/master/README.md) [/ref]

La touche - ouvre le répertoire du fichier courant dans FileBeagle. Vous pouvez utiliser les touches de navigation standard pour vous déplacer vers un répertoire ou un fichier ou appuyer sur - pour remonter au répertoire parent. La touche Enter vous amène dans le répertoire sélectionné ou ouvre le fichier sélectionné. Il y a plusieurs autres fonctions disponibles. Je vous laisse le soin de consulter la documentation du module pour plus d'information.

J'aime bien que FileBeagle affiche les fichiers cachés et les numéros des lignes. Voici les variables que j'ai ajoutées à mon fichier .vimrc afin d'activer ces caractéristiques.

let filebeagle_show_hidden=1
let filebeagle_show_line_numbers=1
let filebeagle_show_line_relativenumbers=0

Essayez FileBeagle. Vous allez probablement l'apprécier.

Why Pelican?

2020-05-27T08:50:00-04:00

I created my first website more than twenty years ago. At that time, I wrote it in good old HTML4. The page layout was done by using a series of non-intuitively intertwined tables. This was before CSS.

I then moved on the dynamic websites like Wordpress. No need to write code anymore. One just need to concentrate on writing content and the engine takes care of the rest. This was great since I did not know any JavaScript nor any CSS. With the gain in popularity of the platform came the security issues mainly caused by the number of plugins available. What I found most annoying was the difficulty to migrate the website from one server to another. Even though there were plugins available for that, I always ended up having to go mess up with the database. Eww!!!

Then came DokuWiki which is also a dynamic website engine. The main difference with Wordpress is that DokuWiki does not use a database. All its articles are saved as plain and simple text files on the server. No more migration problem. Furthermore, creating backups of the website is a cinch. Great!

I used DokuWiki for a many years until I ran across an article praising the virtues of static websites. No databases. No PHP. One only needs to write articles in some markup language like Markdown or reStructuredText using any text editor. The text goes through a processor called directly on the command line and the entire website is generated directly in some directory on the hard drive. The whole thing just needs to be transferred to some server and presto! Since all the webpages are static, the website is harder to hack. If something bad was to happen, one only needs to regenerate the website and upload it again to the server.

What I like most about this is that I can use all the development tools I am most familiar with. I write the articles in reStructuredText. I use Vim which is my go-to text editor along with Git to manage and backup my articles. Everything is done on the command line. I don't need to leave the terminal which is where I spend 90% of my time anyway. Writing an article for my website uses the exact same workflow as I use for software development.

Finally, with the great quantity of static website engines available, why choose Pelican? Simply because it is written in Python which is a programming language that I use. Some of the most popular engines use JavaScript, Ruby or Go which are programming languages that I don't know. Although it is not necessary to know any programming to use these engines, it is still useful to know a little bit about the language in which they are written in order to tweak them to our liking.

The circle is now complete. After all this time, here I am right back with good old HTML (5 rather than 4 and with a dash of CSS)...

Pourquoi Pélican?

2020-05-27T08:50:00-04:00

J'ai créé mon premier site web personnel il y a plus de vingt ans. À l'époque, je l'avais écris en bon vieux HTML4. La mise en page était faite à l'aide d'une série de tableaux imbriqués les uns dans les autres de façon très peu intuitive. C'était avant l'avènement du CSS.

Je suis ensuite passé aux sites dynamiques tel que Wordpress. Plus besoin d'écrire de code. On peut uniquement se concentrer sur le contenu. L'engin se charge du reste. C'était génial puisque je ne connaissait pas le JavaScript ni le CSS. Avec la popularité de la plateforme sont venus les problèmes de sécurité principalement causés par la multitude de modules d'extension (plugins) disponibles. Ce qui m'irritait le plus cependant était la difficulté à migrer le site vers un autre serveur. Bien qu'il existait des plugins pour aider la tâche, je finissais toujours par devoir aller tripoter la base de données. Ouach!!!

Ensuite est venu DokuWiki qui est également un engin de site dynamique. La différence avec Wordpress est que DokuWiki n'utilise pas de base de données pour stocker ses articles. Tous les articles sont stockés sous la forme de simples fichiers texte sur le serveur. Plus de problème de migration. Il suffit simplement de copier tout l'arbre de fichiers d'un serveur à l'autre. La création de copies de sauvegarde est en plus très simple. Génial!

J'ai utilisé DokuWiki pendant de nombreuses années jusqu'au moment où je tombe par hasard sur un article vantant les vertus des sites web statiques. Pas de base de données. Pas de PHP. On écrit les articles dans un langage de balisage (markup language) tel que le Markdown en ou le reStructuredText en utilisant l'éditeur de texte de son choix. On passe le tout à travers un processeur appelé directement de la ligne de commande et on retrouve la totalité de notre site web dans un répertoire sur notre disque dur. Il suffit alors de transférer le tout sur mon serveur et presto! Comme toutes les pages sont statiques, le site est plus difficile à pirater. S'il venait qu'à avoir un problème et que le site soit corrompu, je n'ai qu'à le régénérer et le transférer à nouveau sur le serveur.

Ce que j'apprécie le plus cependant est que je peux utiliser tous les outils de développement de logiciel avec lesquels je suis très familié. J'écris les articles en reStructuredText. J'utilise Vim qui est mon éditeurs de texte par excellence et Git pour archiver et gérer l'historique des articles. Tout se fait directement à partir de la ligne de commande. Je n'ai donc pas besoin de quitter la fenêtre du terminal qui est l'endroit où je passe 90% de mon temps. Écrire un article pour mon site web utilise donc exactement le même processus de travail (workflow) que pour le développement de logiciel.

Finalement, avec la multitude de générateurs de site web statique disponible, pourquoi avoir choisi Pélican? Tout simplement parce qu'il utilise Python qui est un langage de programmation que je maîtrise. Les générateurs les plus populaires utilisent le JavaScript, le Ruby ou le Go qui sont tous des langages de programmation que je ne connais pas. Bien qu'il ne soit pas nécessaire de connaître la programmation pour utiliser ces générateurs, çà reste utile si on a besoin de les modifier pour nos besoins.

La boucle est finalement bouclée. Après tout ce temps, me revoici au bon vieux HTML (5 plutôt que 4 et avec un peu de CSS)...

Hello World

2020-05-26T01:31:00-04:00

Any respecting developer needs to first write the traditional Hello World app when learning a new programming language.

So, here we go...

<!DOCTYPE html>
<html lang="en">
   <head>
      <meta charset="utf-8">
      <title>HTML5: Hello World</title>
   </head>
   <body>
      <p>Hello World!</p>
   </body>
</html>

Hello World

2020-05-26T01:31:00-04:00

Tout développeur qui se respecte doit débuter son apprentissage d'un nouveau langage de programmation par l'écriture du fameux programme Hello World.

Alors voici...

<!DOCTYPE html>
<html lang="en">
   <head>
      <meta charset="utf-8">
      <title>HTML5: Hello World</title>
   </head>
   <body>
      <p>Hello World!</p>
   </body>
</html>