Site Tools


informatique:web:pelican

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
informatique:web:pelican [2024/11/13 21:22] yahikoinformatique:web:pelican [2024/12/18 22:39] (current) – removed yahiko
Line 1: Line 1:
-====== Pelican ====== 
-<WRAP center round important 60%> 
-Notes personnelles, je ne sais à peu près pas ce que je fais. 
-</WRAP> 
- 
-Notes d'installation du générateur de sites statiques [[https://getpelican.com|Pelican]]. On me l'a conseillé parce que Python, parce que simple pour les idiots qui n'ont pas envie de se prendre le chou avec Hugo ou Jekyll. 
- 
-Notes suite à une installation pour test sur un conteneur Debian 12 sous Proxmox. 
- 
-===== Installation ===== 
-On installe pip, Python3 était déjà installé sur mon conteneur Debian :  
-<code bash> 
-apt install python3-pip -y 
-</code> 
- 
-On défini un environnement pour Python (je crois) :  
-<code bash> 
-mkdir undossier 
-python3 -m venv ~/undossier 
-source undossier/bin/activate 
-</code> 
- 
-On installe Pelican :  
-<code bash> 
-pip install "pelican[markdown]" 
-</code> 
- 
-===== Créer un premier site ===== 
-On créé un dossier et on lance l'assistant de Pelican :  
-<code bash> 
-mkdir monsupersite 
-cd monsupersite 
-pelican-quickstart 
-</code> 
- 
-On répond aux questions de l'assistant :  
-<code> 
-pelican-quickstart  
-Welcome to pelican-quickstart v4.10.1. 
- 
-This script will help you create a new Pelican-based website. 
- 
-Please answer the following questions so this script can generate the files 
-needed by Pelican. 
- 
-     
-> Where do you want to create your new web site? [.]  
-> What will be the title of this web site? Erreur503 
-> Who will be the author of this web site? Yahiko 
-> What will be the default language of this web site? [en] fr 
-> Do you want to specify a URL prefix? e.g., https://example.com   (Y/n) Y 
-> What is your URL prefix? (see above example; no trailing slash) https://blog.erreur503.xyz 
-> Do you want to enable article pagination? (Y/n) Y 
-> How many articles per page do you want? [10] 5 
-> What is your time zone? [Europe/Rome] Europe/Paris 
-> Do you want to generate a tasks.py/Makefile to automate generation and publishing? (Y/n) Y 
-> Do you want to upload your website using FTP? (y/N) N 
-> Do you want to upload your website using SSH? (y/N) y 
-> What is the hostname of your SSH server? [localhost]  
-> What is the port of your SSH server? [22]  
-> What is your username on that server? [root]  
-> Where do you want to put your web site on that server? [/var/www]  
-> Do you want to upload your website using Dropbox? (y/N)  
-> Do you want to upload your website using S3? (y/N)  
-> Do you want to upload your website using Rackspace Cloud Files? (y/N)  
-> Do you want to upload your website using GitHub Pages? (y/N)  
-Done. Your new project is available at /root/pelican 
-</code> 
- 
-===== Créer une page ===== 
-Dans ''monsupersite/content'' on créé un fichier ''md''. 
- 
-<file md article.md> 
-Title: Mon super article 
-Date: 2024/11/13 21:43 
-Category: 3615 Ma vie 
-Tags: pelican, ma vie, test, osef 
-Slug: mon-super-article 
-Authors: Lapinours 
- 
-# Titre 1 
-## Titre 2 
-Wow, un **super** article sur `Pelican`. 
- 
-Tellement _beau_ et **_frais_**. 
-</file> 
- 
-===== Publier ===== 
-<code bash> 
-pelican /chemin/monsupersite/content -s /chemin/monsupersite/pelicanconf.py 
-</code> 
- 
-Pour mon environnement de test j'ai installé Apache comme un sagouin. J'ai copié le contenu du dossier ''output'' de Pelican vers ''/var/www/html/output'' 
-<code bash> 
-cp -r /chemin/supersite/output /var/www/html 
-</code> 
- 
-La commande ''make html'' permet aussi d'exporter le site en HTML en utilisant ''pelicanconfig.py''. 
- 
-''make publish'' va publier le site selon le fichier de conf ''make publish'' 
- 
-===== Installer un thème ===== 
- 
-<WRAP center round alert 60%> 
-Pas terminé, je suis propablement teubé, ou j'ai encore lu la doc trop en diagonale. 
-</WRAP> 
- 
-De base Pelican produit des pages HTML très simples. C'est bien mais ce n'est pas très très pratique. On va installer les thèmes depuis le [[https://github.com/getpelican/pelican-themes|dépôt git]]. La page [[https://pelicanthemes.com/|Pelican Theme]] propose d'un aperçu d'une partie des thèmes. Globalement tout est un petit peu pas très joli 😅. 
- 
-On va suivre bêtement la doc et cloner le repo git des thèmes Pelican :  
-<code bash> 
-git clone --recursive https://github.com/getpelican/pelican-themes ~/pelican-themes 
-</code> 
- 
-On va éditer le fichier de conf du site :  
-<file python pelicanconf.py> 
-THEME = "/home/jeanjean/pelican-themes/nomdutheme" 
-</file> 
- 
- 
- 
  
informatique/web/pelican.1731532944.txt.gz · Last modified: 2024/11/13 21:22 by yahiko