![]() Un générateur de site statique qui casse des briques. VenC est tellement rapide qu'il enfreint le principe de causalité et produit de l'énergie surunitaire ! |
En suivant la procédure normale, vous trouverez VenC dans :
~/.local/lib/python3.w/site-packages/VenC-x.y.z-py3.w.egg
w
étant la version courante de Python et x.y.z
la version courante de VenC
Les fichiers additionnels de VenC se trouvent dans :
~/.local/share/VenC
On y trouve les thèmes, des templates, des assets, des modules JS et d'autres choses.
Et bien c'est très simple camarade, comme dirait Jean-Pierre Coffe, les systèmes d'exploitations propriétaires, c'est de la merde !
VenC devrait être installé avec pip, dans l'environnement Python, côté utilisateur (pas dans le système donc). De cette façon, le système a besoin de connaître l'emplacement de VenC, dont l'exécutable devrait se trouver dans ~/.local/bin
.
Sur certaines distributions GNU/Linux, comme Archlinux ou Gentoo, la variable d'environnement PATH
peut être incomplète par défaut, ce qui produit une erreur du type "commande introuvable".
Dans ce cas, vous pouvez ajouter à votre fichier ~/.bashrc
la ligne suivante :
export PATH=$PATH:~/.local/bin
Si le fichier n'existe pas déjà, il faudra le créer.
Après ça, tapez dans le terminal actif :
source ~/.bashrc
Et voilà, ça devrait être bon :)
Normalement, VenC gère toutes les erreurs et exceptions de sorte à ne pas interrompre le programme, ou à vous aviser du problème de façon commode.
Si malgré tout vous obtenez des erreurs, c'est probablement que votre installation n'est pas correcte.
Cela arrive lorsque VenC est installé avec la version de Python 2 de pip. VenC fonctionne avec Python 3, il faut donc installer VenC avec pip3
. En général, la version de pip que vous utilisez par défaut correspond à la version de Python également utilisée par défaut sur votre système.
En particulier sur les système basés sur Debian, vous devrez installer pip3
:
sudo apt-get install python3-pip
Après ça, désinstallez VenC avec la version Python 2 de pip :
pip uninstall venc
Et réinstallez VenC avec la version Python 3 de pip :
pip3 install venc --user
Ça devrait le faire, sinon c'est que vous avez peut-être trouvé un bug et dans ce cas c'est sympa de le signaler en ouvrant un ticket sur Github ou sur Framagit. Pensez à indiquer la version de VenC que vous utilisez, ainsi que la version de Python.
Vous pouvez obtenir ces informations d'un coup avec la commande :
venc -v
Et bien sûr, pensez à indiquer le message d'erreur que vous obtenez.
C'est fort possible en effet, mais ce n'est pas du ressort de VenC dans la mesure où cette fonctionnalité dépend d'une tierce librairie, développée indépendamment de VenC.
Cette librairie est jeune et encore en développement. Son développeur étant très réactif, si quelque chose ne fonctionne pas correctement, signalez le problème sur la page Github du projet, cela devrait être alors résolu relativement rapidement !
Vérifiez qu'aucun de vos sous-répertoires définis manuellement dans blog_configuration.yaml
ne commence par "/
".
Par exemple :
path: category_directory_name: '/{category}' # Incorrect archives_directory_name: '%m-%Y' # Correct archives_sub_folders: '/' # Incorrect categories_sub_folders: '' # Correct entries_sub_folders: '{entry_title}' # Correct
Si l'environnement système est mal configuré, vous pourriez avoir quelque chose comme ça :
denissalem@nonagon ~/VenC/VenC-site $ venc -xb VenC: unsupported locale setting
Cela signifie que vos locales, c'est-à-dire vos paramètres régionaux (comme la langue et la disposition de votre clavier), ne sont pas correctement configurées. La résolution de ce problème est spécifique à chaque distribution GNU/Linux.
Si le projet vous plaît et que vous souhaitez me soutenir, c'est possible en :