Commit 77e53eb2 authored by Denis Salem's avatar Denis Salem
Browse files

WIP doc: add metadata chapter, progress on entry getters, add external link to Yaml reference

parent 24f3e2db
authors: 'Denis Salem'
categories: ''
tags: ''
chapter: 4.4
chapter: 4.5
title: Les templates
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
......
authors: 'Denis Salem'
categories: ''
tags: ''
tags: 'yaml'
chapter: 4.3
title: Les publications
---VENC-BEGIN-PREVIEW---
......@@ -16,8 +16,7 @@ Le nom de fichier d'une publication est formaté de la façon suivante:
<id>__<mois>-<jour>-<année>-<heure>-<minute>__<titre>
:.
Une publication contient une premiere partie au format Yaml contenant les
métadonnées de la publication, puis une seconde au format Markdown qui
Une publication contient une premiere partie au format [Yaml](https://yaml.org/) contenant [les métadonnées](.:GetRelativeOrigin:.Metadonnee) de la publication, puis une seconde au format Markdown qui
elle contiendra la publication à proprement parler. Cette seconde partie
est elle-même scindé en deux. L'une contiendra la prévisualisation de la
publication, et l'autre son véritable contenu.
......@@ -47,7 +46,7 @@ C'est le nom de votre publication tel que vous l'avez définit au moment de cré
## Métadonnées optionnels
Il est également possible de rajouter librement des champs optionnels. Il y a cependant deux
Il est également possible de rajouter librement des [champs optionnels](.:GetRelativeOrigin:.Metadonnee). Il y a cependant deux
champs réservé:
### chapter
......@@ -72,4 +71,5 @@ 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.
- __none__ : Le langage de balisage est désactivé. Permet d'incorporer
de l'html/CSS dans une publication.
......@@ -2,7 +2,7 @@ authors: 'Denis Salem'
categories: ''
tags: ''
title: Les Thèmes
chapter: 4.5
chapter: 4.6
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
Un thème est l'ensemble des fragments qui seront assemblés et
......@@ -24,7 +24,7 @@ librairies comme JQuery ou bootstrap.
- rssEntry.html
- rssFooter.html
- __config.yaml__ : Un fichier de configuration yaml permettant
- __config.yaml__ : Un fichier de configuration [Yaml](https://yaml.org/) permettant
d'indiquer les dépendances du thème, supplanter des options de
configuration et décrire le thème. Plus d'infos plus bas dans ce
chapitre.
......
authors: 'Denis Salem'
categories: ''
tags: ''
chapter: 4.5.1
chapter: 4.6.1
title: Configuration d'un thème
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
......
authors: 'Denis Salem'
categories: ''
tags: ''
tags: 'yaml'
chapter: 4.2
title: Fichier de configuration principal
---VENC-BEGIN-PREVIEW---
---VENC-END-PREVIEW---
__blog_configuration.yaml__ est un document Yaml à la racine du projet définissant les propriétés du blog, comme son titre, le nom de son auteur, ainsi que des détails fonctionnels comme le nombre de publications par pages ou l'ordre d'affichage de celles-ci.
__blog_configuration.yaml__ est un document [Yaml](https://yaml.org/) à la racine du projet
définissant les propriétés du blog, comme son titre, le nom de son auteur,
ainsi que des détails fonctionnels comme le nombre de publications par pages ou
l'ordre d'affichage de celles-ci.
Immédiatement après avoir créé votre blog, il s'agira sans doute du premier fichier que vous éditerez. Après avoir rempli ces champs dont l'usage est détaillé ci-dessous, vous n'aurez normalement plus besoin d'y retoucher.
Immédiatement après avoir créé votre blog, il s'agira sans doute du premier
fichier que vous éditerez. Après avoir rempli ces champs dont l'usage est
détaillé ci-dessous, vous n'aurez normalement plus besoin d'y retoucher.
## .:DisableMarkup::blog_name:.
......
Supports Markdown
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