Configuration d'un thème

Il s'agit d'un fichier de configuration au format YAML qui accompagne chaque thème installable dans le blog avec la commande :

jeanrochefort@anonymous ~ $ venc --intall-theme

Ce fichier s'appel config.yaml et est structuré de la façon suivante :

info:
    description : ''
    
override:
    whatever_field_1: 'whatever_value'
    whatever_field_2: 'whatever_value2'
    ...

assets_dependencies: ['awesome.css','not_so_shitty_script.js',]

includes_dependencies: ['source_code.example','whatever_you_want.file']
  • info : ce champ contient les métadonnées du thème.
    • description : il s'agit d'un cours texte présentant le thème.
    • version : optionnel. Indique la version du thème.
    • author : optionnel. Indique le ou les auteurs du thème.
  • override : Ce champ est optionnel et contient les propriétés remplaçant ou s'ajoutant au fichier de configuration principal. Typiquement, un thème qui fonctionne avec trois colonnes, par exemple, devra inclure le champ 'columns' ayant la valeur 3.
  • assets_dependencies : il s'agit d'une liste contenant les assets (images, feuilles de styles, scripts) contenu dans ~/.local/share/VenC/themes_assets. C'est notamment utile pour inclure des modules VenC Javascript.
  • includes_dependencies : comme pour le champ précédent, il s'agit d'une liste contenant des noms de fichiers. Il s'agit de fichiers HTML à inclure avec .:IncludeFile:: ... :.. Ces fichiers sont installés par défaut avec VenC et se trouve dans ~/.local/share/VenC/themes_includes.