Commit 1aa058ea authored by Denis Salem's avatar Denis Salem
Browse files

Fix typos and doc. Add new entries to doc

parent ab435062
......@@ -6,11 +6,13 @@ title: Les templates
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
Un template est en fait une publication vierge qui a cependant été
préformatée pour contenir des choses redondante à rédiger ou
préformatée pour contenir des choses redondantes à rédiger ou
programmer manuellement. Typiquement, pour une Galerie, vous pourriez
vouloir un template qui contiendrait déjà la ou les balises Markdown pour inclure
une ou plusieurs images, les champs __categories__ et __tags__ préremplits, etc...
Par exemple:
.:CodeHighlightInclude::Text::False::template_example:.
VenC est livrés avec des examples de templates. En voici la liste:
......@@ -24,3 +26,12 @@ VenC est livrés avec des examples de templates. En voici la liste:
_Parmis ces templates, certains servent surtout à illustrer l'usage
de certaine fonctionnalités de VenC._
Pour utiliser un template il suffit de passer son nom de fichier (sans le chemin)
à VenC au moment de la création d'une nouvelle publication. Par exemple:
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc -ne "Amanite tue-mouches" champignons_magiques
VenC va d'abord essayer de trouver votre template dans le
[répertoire templates](.:GetRelativeOrigin:.Arborescence) de votre blog,
sinon, il essayera de le trouver parmis ceux prédéfinis et listés plus haut.
......@@ -67,3 +67,9 @@ point. Quelques exemples pour aider à visualiser le truc.
Il est possible de spécifier un langage de balisage qui sera utilisé pour
la publication courante, en lieu et place du langage définit dans le
fichier de configuration du blog.
VenC supporte deux langages de balisage:
- __Markdown__ : qui est le langage par défaut.
- __reStructuredText__ : un peu plus complet et puissant que Markdown.
- __none__ : Le langage de balisage est désactivé. Permet d'incorporer de l'html/CSS dans une publication.
authors: 'Denis Salem'
categories: ''
tags: ''
title: Créer une nouvelle publication
chapter: 3.2
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
Pour créer une nouvelle publication, placez vous dans le répertoire de votre blog et tapez la commande suivante
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc --new-entry "Ma Première Publication"
vous pouvez également utiliser la version racourcie de la commade
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc -ne "Ma Première Publication"
Cette commande crée la publication et la stock dans le repertoire *entries* de votre blog.
__Astuce__ : _L'éditeur de texte par défaut définit dans votre fichier de
configuration devrait être **nano**. Quand vous créez une nouvelle
publication VenC l'ouvre pour vous dans l'éditeur de texte ainsi
définit. Vous pouvez changer votre éditeur de texte dans
[.:DisableMarkup::blog_configuration.yaml:.](.:GetRelativeOrigin:.Fichier-de-configuration-principal/)._
Une publication vierge ressemble à ça
.:CodeHighlightInclude::Text::False::empty_entry:.
C'est un document découpé en trois parties:
- La premiére partie contient les méta-données de la publication au format [yaml](http://www.yaml.org/).
- La seconde peut contenir un résumé de la publication pour la prévisualisation.
- La troisième contient le corps de votre publication.
__Astuce : Par défaut VenC utilise la syntax
[Markdown](https://daringfireball.net/projects/markdown/),
vous pouvez cependant changer le langage de balisage. Plus d'information
à ce sujet [ici](.:GetRelativeOrigin:.Les-publications/).__
Pour en savoir plus sur les méta-données des publications rendez vous [ici](.:GetRelativeOrigin:.Les-publications/).
Une fois que vous avez terminé d'écrire le meilleur billet de blog de tous les internets, enregistrez, et c'est finis! Il n'y à plus qu'à publier!
authors: 'Denis Salem'
categories: ''
tags: ''
title: Publier
chapter: 3.3
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
Vous avez donc écris un ou plusieurs articles et vous voulez voir ce que ça donne! Placez vous dans le répertoire de votre blog et lancez la commande
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc --export-blog gentle
Cette commande va créer les pages HTML de votre blog en utilisant le thème __*gentle*__. Pour connaitre quels sont les thèmes disponibles, tapez
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc -it
Vous pouvez alors recompiler votre blog en passant en paramètre le nom
d'un des thèmes dans la liste, en vert.
Si vous souhaitez faire votre propre thème HTML/CSS vous pouvez vous
aider du thème __*dummy*__ qui contiens un squelette HTML pouvant servir
de base. Pour installer un théme dans votre blog (généralement pour le
modifier), par exemple __gentle__, utilisez la commande:
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc -it gentle
Pour compiler le blog avec ce thème bien à vous:
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc --export-blog
VenC utilise par défaut le thème local quand aucun nom de thème ne lui est précisé.
Pour en savoir plus sur les thèmes rendez-vous [ici]()
Le contenu de votre site est maintenant disponible dans le repertoire
_blog_ de votre blog. Pour visualiser le résultat vous pouvez utiliser la commande
> .:SetColor::jeanrochefort@anonymous::green:. .:SetColor::~ $::cyan:. venc --serv
VenC crée un serveur http local accessible par défaut à l'adresse suivante:
> http://localhost:8888
_(Pour tuer le processus, ctrl+c dans le terminal actif)_
Et voilà! Le moins qu'on puisse dire, c'est que _vous pesez lourd dans le game_ maintenant!
......@@ -12,7 +12,11 @@
</head>
<body>
<header>
<h1><a href=".:GetRootPage:.">.:GetBlogName:.</a></h1>
<h1>
<a href=".:IfInMainThread:: ../ :: ../.:GetRelativeOrigin:. :. ">
.:GetBlogName:.
</a>
</h1>
<h2>.:GetBlogLicense:. | .:GetAuthorName:.</h2>
</header>
<aside>
......
......@@ -18,7 +18,7 @@
<body>
<header>
<h1>
<a href=".:GetRootPage:.">
<a href=".:IfInMainThread:: ../ :: .:GetRelativeOrigin:. :. ">
<img id="banner" src=".:GetRelativeOrigin:..:GetBlogMetadataIfExists::header_image::{value}:." alt=".:GetBlogName:." title=".:GetBlogName:." />
</a>
</h1>
......
......@@ -20,7 +20,7 @@
<body>
<header>
<h1>
<a href=".:IfInThread:: ../.:GetRelativeOrigin:. :: index.html :. ">
<a href=".:IfInMainThread:: ../ :: .:GetRelativeOrigin:. :. ">
<img src=".:GetRelativeOrigin:..:GetBlogMetadataIfExists::Banner:." alt=".:GetBlogName:." title=".:GetBlogName:." />
</a>
</h1>
......
......@@ -66,7 +66,7 @@ class Messages:
arg_template_name="Nom du template"
arg_input_filename="Nom de fichier"
blog_folder_doesnt_exists="Le dossier de destination n'existe pas... VenC s'en fiche et va en faire un nouveau."
theme_description_academik = "Thème mono colonne, avec de note de bas de page. Idéal pour un blog."
theme_description_academik = "Thème mono colonne, avec note de bas de page. Idéal pour un blog."
theme_description_dummy = "Le thème vide. Il donne une bonne base pour concevoir le votre."
theme_description_gentle = "Thème mono colonne, très clair, aéré et élégant. Idéal pour un blog."
theme_description_tessellation = "Thème comportant trois colonnes, très clair, aéré et élégant. Idéal pour une galerie."
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment