3.2 Créer une nouvelle publication

Une publication valide doit avoir un nom de fichier avec un format particulier. Vous pourriez le faire vous-même, mais ça craint un peu...

VenC vous permet de créer une publication en une commande avec le bon nom de fichier et un contenu de base prêt à être complété.

venc -ne "nom de la publication"

Ou :

venc --new-entry "nom de la publication"

Pour créer une nouvelle publication, vous devez :

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

$(venc -pp)/themes_templates

$(venc -pp) étant le répertoire où se trouvent les assets de VenC.

Par exemple :

venc -ne "nom de la publication" nom_de_fichier_du_template

À noter que certains templates nécessitent des paramètres supplémentaires pour fonctionner. Le chapitre 4.5.1 fournit des exemples sur la façon dont cela fonctionne.

À l'issue de cette commande, VenC essaiera d'ouvrir la nouvelle publication avec l'éditeur de texte spécifié dans la variable d'environnement EDITOR ou à défaut dans le fichier de configuration principale blog_configuration.yaml.

Maintenant, il faut rédiger le contenu de votre choix. Vous voulez sans doute le faire dans un langage de balisage cool et décontracté. Avec Markdown par exemple. VenC supporte aussi AsciiDoc ou reStructuredText. Dans tous les cas, ces langages de balisage nécessitent les modules Python correspondant. Ceux-là ne sont pas installés par défaut et vous devez les installer explicitement :

Une fois que le module que vous souhaitez utiliser est installé il faut indiquer le langage de markup dans les métadonnées de votre publication.