134 liens privés
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/
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 .