====== Pelican ======

J'utilise Pelican comme moteur pour mon blog [[https://blog.simonlefort.be/]] depuis 2014.

===== Installation en local =====
<code bash>
$ pip3 install pelican[Markdown] --user
</code>

===== Générer le blog =====
<code bash>
$ pelican content
Done: Processed 19 articles, 0 drafts, 3 pages, 0 hidden pages and 0 draft pages in 0.51 seconds.
</code>

Ou via un [[informatique:alias]] dans ''~/bash_aliases'' : 
<code bash>
alias blog-compile='pelican ~/path/to/content/ -s ~/path/to/pelicanconf.py -t ~/path/to/themes/my-theme/ -o ~/path/to/output/'
</code>
===== Servir le blog localement =====
<code bash>
$ pelican --listen
</code>

On y accède via l'url [[127.0.0.1:8000|127.0.0.1:8000]].
===== Mettre le blog dans un dépôt git =====
J'ai mis le blog dans un depôt git avant de garder une trace des modifications et pouvoir commencer un nnouvel article sur une branche. 
===== Installer sur Yunohost =====
Pour installer Pelican sur [[Yunohost]], j'ai installé l'application [[https://github.com/YunoHost-Apps/my_webapp_ynh|Custom Webapp]].

===== Transférer le blog sur le serveur =====
La [[https://github.com/YunoHost-Apps/my_webapp_ynh|Custom Webapp]] permet d'avoir un accès SFTP pour envoyer les fichiers. 

On peut envoyer avec [[Filezilla]] ou en ligne de commande, par exemple avec [[lftp]]. On se place d'abord dans le répertoire du blog et on oublie pas de générer les fichiers statique avec ''pelican content''.

<code bash>
$ lftp

lftp :~> open -u user,password sftp://blog.simonlefort.be

lftp user@blog.simonlefort.be:~> ls
drwxr-xr-x    3 0        0            4096 Aug 10 12:53 .
drwxr-xr-x    3 0        0            4096 Aug 10 12:53 ..
drwxr-xr-x   10 995      995          4096 Aug 10 20:34 www

lftp user@blog.simonlefort.be:/> mirror -R output/ www/

lftp user@blog.simonlefort.be:/> quit
</code>

Ou via un [[informatique:alias]] : 
<code bash>
alias blog-upload='lftp sftp://USER:PASSWORD@blog.simonlefort.be -e "mirror -e -R ~/path/to/output/ www/ ; quit"'
</code>

==== Erreur rencontrée ====

J'ai eu cette erreur : //LFTP "Fatal error: Host key verification failed" error//

La solution est d'essayer de se connecter en SSH, juste pour avoir le "RSA key fingerprint".

<code bash>
$ ssh -p 21 user@1.2.3.4
The authenticity of host '[1.2.3.4]:21 ([1.2.3.4]:21)' can't be established.
RSA key fingerprint is 01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '[1.2.3.4]:21' (RSA) to the list of known hosts.
user@1.2.3.4's password:
</code>
(source : https://www.wizlab.it/code/lftp-fix-fatal-error-host-key-verification-failed.html )