134 liens privés
Les explications derrière la conception du thème Pélican pour solar.lowtechmagazine.com , très intéressantes.
Installer Isso pour Pelican, sur Apache.
Suite à mon problème d'encodage ( voir http://links.simonlefort.be/?6HjX8A ), je me suis retrouvé avec un fichier qui ne passe plus dans la moulinette de Pelican (pour mon blog). L'erreur renvoyée par Pelican :
| ========
ERROR: Could not process ./article.md
| 'utf8' codec can't decode byte 0xe9 in position 208: invalid continuation byte
| ========
Voici comment convertir le fichier en forçant l'utf-8 :
| ========
$ vim article.md
:set bomb
:set fileencoding=utf-8
:wq
| ========
Pelican fonctionne parfaitement après ça. Je n'ai pas bien compris ce que fait la commande "set bomb" mais pas eu le temps de chercher.
Je me rends compte que j'ai lu pas mal d'articles sur l'installation de Pelican et que chacun fait ça un peu différemment...
Chaque fois que je veux écrire un truc sur mon petit blog, je dois fouiller les vieux articles pour me souvenir de la syntaxe -pourtant très simple- de Markdown. Du coup, je me suis forcé à noter tout ce dont je pourrais avoir besoin à un seul endroit. Ça servira peut-être à d'autres. :-)
La documentation officielle du langage Markdown.
Un autre blog utilisant Pelican. Il utilise Isso pour les commentaires. (Isso que j'essaye péniblement d'installer...)
[autre lien pour installer Isso : https://blog.jeanchampemont.com/installation-serveur-commentaire-libre-isso/
Documentation résumée sur le Restructured Text (reST).
J'ai depuis peu un serveur virtuel chez OVH et j'ai configuré le firewall iptables en partie grâce à ce tutoriel : http://fr.openclassrooms.com/informatique/cours/securiser-son-serveur-linux
Étonnement, il ne parle pas d'HTTPS et du port 443 à ouvrir au besoin.
Quand j'ai voulu installer Pelican via PIP (voir http://www.simonlefort.be/links/?TcVjJw ), j'ai eu l'erreur suivante :
| ========
| simon@ordi:~$ sudo pip install pelican
| Downloading/unpacking pelican
| Cannot fetch index base URL http://pypi.python.org/simple/
| Could not find any downloads that satisfy the requirement pelican
| No distributions at all found for pelican
| Storing complete log in /root/.pip/pip.log
| ========
J'ai donc rajouté les lignes suivantes dans le script de configuration d'iptables :
| ========
| simon@ordi:~$ sudo nano /etc/init.d/firewall
| iptables -t filter -A OUTPUT -p tcp --dport 443 -j ACCEPT
| iptables -t filter -A INPUT -p tcp --dport 443 -j ACCEPT
| ========
J'ai ensuite relancé le script :
| ========
| simon@ordi:~$ sudo /etc/init.d/firewall
| ========
J'ai enfin pu installer Pelican :
| ========
| simon@ordi:~$ sudo pip install pelican
| Downloading/unpacking pelican
| Real name of requirement pelican is pelican
| Downloading pelican-3.4.0.tar.gz (259Kb): 259Kb downloaded
| Running setup.py egg_info for package pelican
| (...)
| ========
J'ai aussi installé markdown :
| ========
| simon@vps89550:~$ sudo pip install markdown
| Downloading/unpacking markdown
| Real name of requirement markdown is Markdown
| Downloading Markdown-2.4.1.tar.gz (279Kb): 279Kb downloaded
| Running setup.py egg_info for package markdown
| (...)
| ========
A tester quand j'aurai deux minutes...
Pas encore réussi à le faire fonctionner, je reviens dessus au plus vite. C'est un plugin conçu par Yax : http://blogduyax.madyanne.fr/migration-du-blog-sous-pelican.html
Pour télécharger tous les thèmes qui sont sur le dépo github :
| simon@ordi: ~$ git clone --recursive https://github.com/getpelican/pelican-themes ~/pelican/themes
Pour essayer un thème, il faut modifier le fichier pelicanconf.py :
| simon@ordi: ~/pelican$ nano pelicanconf.py
Et ajouter la ligne :
| THEME = "/home/simon/pelican/themes/nom-theme"
Par exemple, avec le thème "fresh" :
| THEME = "/home/simon/pelican/themes/fresh"
On peut alors re-compiler le site et le recopier dans /var/www/ :
| simon@ordi: ~/pelican$ make html
| simon@ordi: ~/pelican$ sudo rm -r /var/www/
| simon@ordi: ~/pelican$ sudo cp -r output/ /var/www/
Ou, en une seule ligne :
| simon@ordi: ~/pelican$ sudo pelican /home/simon/pelican/content/ -o /var/www/ -s /home/simon/pelican/pelicanconf.py
On peut aussi ajouter un alias dans le fichier /home/simon/.bashrc , pour faire la même commande plus rapidemment :
| simon@ordi: ~$ nano .bashrc
Pour faire un alias, il suffit de rajouter :
| #alias pour compiler le site en pelican
| alias peli='sudo pelican /home/simon/pelican/content/ -o /var/www/ -s /home/simon/pelican/pelicanconf.py'
Après avoir enregistré (ctrl + o) et quitté nano (ctrl + x), on peut relire le .bashrc pour tenir compte des modifications :
| simon@ordi: ~$ source ~/.bashrc
Après, on peut utiliser la commande "peli" :
| simon@ordi: ~$ peli
| [sudo] password for simon:
| Done: Processed 2 articles and 0 pages in 0.16 seconds.
Après l'installation de Pelican avec pip ( voir http://www.simonlefort.be/links/?TcVjJw ), j'ai eu un soucis en voulant compilant des articles de test.
| simon@ordi: ~/pelican $ make html
| [ ! -d /home/simon/pelican/output ] || find /home/simon/pelican/output -mindepth 1 -delete pelican /home/simon/pelican/content -o /home/simon/pelican/output -s /home/simon/pelican/pelicanconf.py
| WARNING: No valid files found in content.
| Done: Processed 0 articles and 0 pages in 0.37 seconds.
Or, il y a deux articles en markdown dans le dossier "content". Problème résolu en installant python-markdown (qui aurait pourtant du s'installer avec l'installation de Pelican ?).
| simon@ordi: ~/pelican $ sudo apt-get install python-markdown
Après, on re-tente un "make html" :
| simon@ordi: ~/pelican $ make html
| pelican /home/simon/pelican/content -o /home/simon/pelican/output -s /home/simon/pelican/pelicanconf.py
| Done: Processed 2 articles and 0 pages in 0.15 seconds.
On nettoie le dossier /var/www/ qui contient le site :
| simon@ordi: ~/pelican $ sudo rm -r /var/www/*
Et on recopie le dossier pelican/output/ dans /var/www/ :
| simon@ordi: ~/pelican $ sudo cp -r output/* /var/www/
Ça marche ! :-)
J'ai commencé à m'intéresser à Pelican depuis quelques semaines (voir http://simonlefort.be/links/?aJMafA ). J'ai depuis installé une Debian 7.5 (Wheezy) dans une machine virtuelle pour tester vraiment avec un serveur bien installé et propre. J'ai donc du réinstaller Pelican.
La première chose à faire, installer pip :
| simon@debian:~$ sudo apt-get install python-pip
Si vous vous demandez ce qu'est pip, foncez chez Sam&Max : http://sametmax.com/votre-python-aime-les-pip/ !
Une fois pip installé, il n'y a plus qu'à installer Pelican avec :
| simon@debian:~$ pip install pelican
(note : Pas besoin d'être root si un seul compte l'utilise. Pour que tous les utilisateurs puissent l'utiliser, alors il est préférable de table "sudo pip install pelican".)
C'est tout ! \o/
Il y a également une histoire d'environnement virtuel avec virtualenv qui permet de séparer les différents projets sur lesquels on travaille mais je ne me suis pas encore penché sur son fonctionnement. Plus d'informations -encore une fois- chez S&M : http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/
Je trouve plein de blogs qui utilisent Pelican (et qui du coup, racontent aussi des choses intéressantes!).
Pelican correspond à ce que je recherche pour créer un site. Mais il faut que j'apprenne à dompter la bête, ce qui n'est pas encore gagné. Comme ça parait "simple" pour beaucoup, il y a très peu de ressources et tutoriels pour apprendre à utiliser ce genre de générateur... Si j'y arrive, j'écrirai un petit article sur la méthode pour y arriver.
Installation de Pelican : (/!\ J'ai vu après qu'il était possible de l'installer via pip, ce qui est plus simple!)
Télécharger l'archive .zip depuis github, se rendre dans le bon dossier et l'extraire.
| simon@ordi ~ $ unzip pelican-master.zip
Se rendre dans dossier pelican-master :
| simon@ordi ~ $ cd pelican-master
Installer pelican :
| simon@ordi ~ $ sudo python setup.py install
| (...)
| Using /usr/lib/python2.7/dist-packages
| Finished processing dependencies for pelican==3.3
La suite ?
(Sources et tutoriels :
http://shebang.tuxfamily.org/introduction-a-pelican
http://docs.getpelican.com/en/3.3.0/
tutoriel pour démarrer et mettre le site sur Github : http://martinbrochhaus.com/pelican2.html
un autre : http://ntanjerome.org/blog/how-to-setup-github-user-page-with-pelican/
un autre : https://chdoig.github.io/create-pelican-blog.html
un autre : https://zonca.github.io/2013/09/automatically-build-pelican-and-publish-to-github-pages.html
un site en pelican sur Github, pas mal pour avoir des exemples : https://github.com/kfr2/kfr2.github.com => http://magically.us/
une autre ressource très intéressantes avec les documents de configs : http://terriyu.info/blog/posts/2013/07/pelican-setup/
plugin pour faire du LaTeX dans Pelican : https://github.com/getpelican/pelican-plugins/tree/master/render_math )
Pour ajouter un plugin dans Pelican, il faut ajouter le dossier vers les plugins (PLUGIN_PATH) et le noms des plugins (PLUGINS : []).
Le fichier à modifier est dans /usr/local/lib/python2.7/dist-packages/pelican .