Pelican documentation

Support apps
,
1

What app is this about, and its version: 1.1.3~ynh2
What YunoHost version are you running: 12.1.40.1
What type of hardware are you using: Old laptop or computer

Describe your issue

Bonjour,

Je viens d’installer Pelican dans Yunohost, malheureusement la documentation me paraît trop succinte pour pouvoir démarrer.

Déjà, où mettre les fichiers markdown ? Je suppose que c’est dans /var/www/pelican/content/

Ensuite comment on génére le html ?

Ces informations pourraient être ajoutées dans le fichier doc.

J’ai bien accès à la page : Monsite.net : Annuaire internet

Merci par avance !

Share relevant logs or error messages

rien

2

C’est tout à fait ça. :slight_smile:

Normalement il y a un service pelican qui tourne et détecte les modifications dans ce dossier pour regénérer le site.

Sinon, il suffirait a priori de passer par la ligne de commande yunohost app shell pelican et d’utiliser les commandes adéquates mentionnées dans la documentation de Pelican.

Si tu trouves des informations importantes pour améliorer la documentation de l’app, n’hésite pas à les ajouter sur Github (cf. Documenting apps | Yunohost). Ou sinon tu peux poster ton texte ici et je m’en occuperai. :slight_smile:

3

si ça peut aider,
voici la page wiki interne que j’avais faite pour pelican:

Pelican

Ou comment faire du web statique au format markdown sans trop se prendre la tête

les docs et dépots

les dossiers

tout se passe dans le docroot, ici /var/www/pelican, il y a un venv où l’on appelle ce qu’il faut:

root@krashboyz:/var/www/pelican# ./venv/bin/pelican --version
4.8.0

Puis l’arborescence est assez simple:

root@krashboyz:/var/www/pelican# ls -al
total 48
drwxr-x---   6 pelican www-data 4096 Nov 11 03:53 .
drw-r-xr-x+ 43 root    root     4096 Nov 10 13:04 ..
drwxr-x---   2 pelican www-data 4096 Nov 11 02:40 content
-rw-r-----   1 pelican www-data 4514 Nov  4 22:16 Makefile
drwxr-x---   5 pelican www-data 4096 Nov 11 00:13 output
-rw-r-----   1 pelican www-data  987 Nov 10 23:16 pelicanconf.py
-rw-r-----   1 pelican www-data  620 Nov  4 22:17 publishconf.py
drwxr-x---   2 pelican www-data 4096 Nov 10 23:16 __pycache__
-rw-r-----   1 pelican www-data 4967 Nov  4 22:16 tasks.py
drwxr-x---   6 pelican www-data 4096 Nov  4 22:17 venv

content: où on écrit son contenu en markdown
output: où le code html est pissé

la config

se fait très rapidement dans pelicanconf.py

éditer

en local avec n’importe quel éditeur de texte, ou en distant puis rsync les fichiers ou sftp, ou git.

publier

Pour publier ce que l’on vient d’éditer,
je me suis pris un peu la tête à comprendre les moulinettes à la YNH,
mais une fois que c’est trouvé, on va très vite:

 root@krashboyz:/var/www/pelican# ./venv/bin/pelican content -o output -s pelicanconf.py

et roule ma poule :slight_smile:

personnaliser son thème

TO DO

1 Like
4

Super, merci ! Espérons que cela convienne à claveryu. :slight_smile:

Et pour éviter de rester en root, yunohost app shell pelican et appeler le programme avec juste pelican dans le shell devrait faire l’affaire :wink:

1 Like