Commandes

Ce chapitre présente les différentes commandes VenC qu'il est possible de réaliser dans un terminal.

Afficher la version de VenC

$ venc -v

ou

$ venc --version

Créer un nouveau blog

$ venc -nb <nom du blog>

ou

$ venc --new-blog <nom du blog>

VenC crée le répertoire contenant les sources du blog à l'endroit où vous tapez la commande.

jeanrochefort@anonymous ~ $ venc --new-blog "MonSuperBlog"

VenC: Votre blog a été crée!

jeanrochefort@anonymous ~ $ ls MonSuperBlog/

blog blog_configuration.yaml entries extra includes templates theme

Vous ne pouvez pas créer un blog sans en spécifier le nom.

Une fois que vous avez créé votre blog, la première chose à faire est en général d'éditer le fichier blog_configuration.yaml. Pour en savoir plus sur ce fichier de configuration, rendez-vous ici.

Créer une nouvelle publication

$ venc -ne "<nom de la publication>" [nom du template]

ou

$ venc --new-entry "<nom de la publication>" [nom du template]

Pour créer une nouvelle publication, vous devez être dans le répertoire de votre blog.

Vous ne pouvez pas créer une publication sans spécifier le titre de celle-ci.

Si vous ne spécifiez pas de nom de template, VenC produira une publication totalement vierge. Le nom de template est en fait le nom de fichier du template désiré, se trouvant dans le répertoire templates.

À l'issue de cette commande, VenC essaiera d'ouvrir la nouvelle publication avec l'éditeur de texte spécifié dans le fichier de configuration principal blog_configuration.yaml.

Exporter le blog

$ venc -xb [thème]

ou

$ venc --export-blog [thème]

Pour exporter votre blog vous devez être dans le répertoire de votre blog.

Dans celui-ci se trouve un répertoire sobrement intitulé blog. C'est dans ce répertoire que ce sera exporté votre site. Une fois l'exportation terminée, vous pouvez copier le contenu de ce répertoire vers votre serveur.

Pour en savoir plus sur l'arborescence, rendez-vous ici.

Vous pouvez spécifier un thème, le blog sera alors compilé avec. Si aucun thème n'est précisé, VenC compilera le blog avec le thème local.

Exporter le blog vers un serveur FTP

$ venc -xftp [thème]

ou

$ venc --export-via-ftp [thème]

Pour exporter votre blog, vous devez être dans le répertoire de votre blog.

Dans celui-ci se trouve un répertoire sobrement intitulé blog. Avec cette commande, tout le site est re-généré et placé dans le dossier blog. C'est le contenu de ce répertoire qui sera copié sur votre serveur. À ce moment, une invite d'authentification apparaîtra dans le terminal.

Comme pour l'exportation locale, vous pouvez spécifier un thème à utiliser.

Copie du blog vers un serveur FTP

$ venc -rc

ou

$ venc --remote-copy

Cette commande permet de copier le blog courant sur votre serveur FTP, sans le re-générer. Une invite d'authentification FTP apparaîtra dans le terminal pour lancer la procédure.

Éditer un fichier et exporter automatiquement

$ venc -ex <fichier>

ou

$ venc --edit-and-export <fichier>

Cette commande ouvre le fichier passé en paramètre avec l'éditeur de texte de votre choix, définit dans blog_configuration.yaml puis, une fois l'édition terminée, recompile l'ensemble du blog.

Afficher l'aide-mémoire

Vous avez oublié comment faire telle ou telle chose ? Cette commande affiche dans le terminal les commandes disponibles !

$ venc -h

ou

$ venc --help

Installer un thème

$ venc -it [Nom du thème)

ou

$ venc --install-theme [Nom du thème]

Quand aucun nom de thème n'est précisé, cette commande affiche la liste des thèmes disponibles.

Sinon, cette commande déplace et sauvegarde l'ancien thème dans un dossier daté à la racine de votre blog. Le nouveau thème, passé en paramètre, est alors installé.

Démarrer le serveur local

$ venc -s

ou

$ venc --serv