Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
Denis Salem
VenC
Commits
1aa058ea
Commit
1aa058ea
authored
Mar 13, 2020
by
Denis Salem
Browse files
Fix typos and doc. Add new entries to doc
parent
ab435062
Changes
8
Hide whitespace changes
Inline
Side-by-side
VenC-site/entries/10__02-08-2020-18-32__Les_templates
View file @
1aa058ea
...
...
@@ -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 redondante
s
à 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.
VenC-site/entries/11__02-08-2020-19-17__Les_publications
View file @
1aa058ea
...
...
@@ -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.
VenC-site/entries/12__03-13-2020-11-51__Créer_une_nouvelle_publication
0 → 100644
View file @
1aa058ea
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!
VenC-site/entries/13__03-13-2020-16-48__Publier
0 → 100644
View file @
1aa058ea
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!
src/share/themes/dummy/chunks/header.html
View file @
1aa058ea
...
...
@@ -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>
...
...
src/share/themes/gentle/chunks/header.html
View file @
1aa058ea
...
...
@@ -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>
...
...
src/share/themes/tessellation/chunks/header.html
View file @
1aa058ea
...
...
@@ -20,7 +20,7 @@
<body>
<header>
<h1>
<a
href=
".:IfInThread:: ../.:GetRelativeOrigin:.
:: index.html
:. "
>
<a
href=
".:IfIn
Main
Thread:: ../
::
.:GetRelativeOrigin:. :. "
>
<img
src=
".:GetRelativeOrigin:..:GetBlogMetadataIfExists::Banner:."
alt=
".:GetBlogName:."
title=
".:GetBlogName:."
/>
</a>
</h1>
...
...
src/venc2/l10n/fr.py
View file @
1aa058ea
...
...
@@ -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."
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment