6 Foire aux questions

Où se trouvent les fichiers de VenC une fois qu'il est installé ?

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.

Pourquoi VenC n'est officiellement supporté que par GNU/Linux ?

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 !

Commande introuvable

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 :)

Erreurs Python

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.

latex2mathml semble incomplet ou ne fonctionne pas correctement

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 !

Les sous-répertoires que j'ai définis ne fonctionnent pas

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

Unsupported locale setting

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.

Où trouver le code source ?

Sur Github ou sur Framagit.

Comment soutenir le développeur ?

Si le projet vous plaît et que vous souhaitez me soutenir, c'est possible en :