blip
1.0.0
Blip utilise une structure de répertoires spécifique pour les modèles et l'organisation du site. Consultez le répertoire example-site/ pour une démo, ou poursuivez votre lecture pour une description complète.
Les modèles sont des guides de mise en page pour l'index de vos sites et les pages de publications. Les éléments suivants se trouvent dans config/templates/ :
index_template.html : Les principales pages d'index de votre site.
index_post_template.html : La disposition de l'aperçu de la publication sur les pages d'index.
post_template.html : La mise en page de la page de publication individuelle.
Blip utilise des « jetons » personnalisés pour les tâches courantes et les remplacements de texte. Utilisez Config.swift pour personnaliser les chaînes de remplacement.
Démarquage (messages) :
[[MORE]] : interrompt la publication à ce stade dans les pages index*.html et insère un lien Read More vers la publication complète.Modèles :
$(COPYRIGHT) : insère une chaîne de copyright personnalisée dans un modèle d'index.
$(POSTS) : insère une liste d'extraits de publication dans un modèle d'index.
$(POSTS_OLDER) : Insère un lien "Articles plus anciens" dans un modèle d'index.
$(POSTS_NEWER) : Insère un lien "Messages plus récents" dans un modèle d'index.
$(POST_TITLE) : Insère le titre de la publication dans un modèle de publication ou d'index.
$(POST_TIMESTAMP) : insère l'horodatage de la publication dans un modèle de publication ou d'index.
$(POST_BODY) : insère le corps de la publication dans un modèle de publication ou d'index (le modèle d'index affichera jusqu'à n'importe quel jeton [[MORE]] ).
$(POST_PERMALINK) : Insère un lien permanent de publication dans un modèle de publication ou d'index.
Les publications doivent être au format Markdown et doivent suivre une convention de dénomination YYYYMMDD.md (l'extension de fichier .markdown est également prise en charge).
Le répertoire posts/ doit contenir au moins deux sous-répertoires :
drafts : c'est ici que vous devez placer vos fichiers Markdown (.md) pour la publication.
published : Blip générera index*.html et publiera les pages dans ce répertoire. Vous devez utiliser le contenu de ce répertoire pour votre site Web.
Les articles publiés sont organisés en fonction de la date indiquée dans leur nom de fichier. Ainsi, par exemple, une publication portant le nom de fichier 20171220.md sera publiée au chemin suivant : posts/published/2017/12/20.md . Actuellement, Blip ne prend en charge qu'une seule publication par jour, principalement parce que je ne blogue pas très souvent...
published/stylesheets/ : les modèles par défaut utilisent le index.css inclus comme feuille de style. Vous pouvez déposer d'autres fichiers CSS ici et les référencer dans vos modèles, si nécessaire,
published/images/ : déposez vos images ici et vous pourrez les référencer dans Markdown comme suit : 
Écrivez votre message dans Markdown, avec la convention de nom de fichier correcte ( YYYYMMDD.md ), puis déposez-le dans le répertoire drafts/ .
Exécutez ensuite la commande suivante :
./blip /path/to/your/blog/ -r
-r Reconstruit l'intégralité du site en publiant tous les fichiers Markdown dans le répertoire drafts/ .
-w Surveille votre répertoire drafts/ pour détecter les nouveaux fichiers Markdown et les publie automatiquement.
-i Reconstruit uniquement les pages index*.html du site.
-h Affiche l'aide.
Un observateur de système de fichiers simple et facile à utiliser/étendre à l'aide de Swift.
Rendu Markdown ultra-rapide dans Swift, basé sur cmark.
Visitez mon site personnel pour un exemple d'utilisation de Blip.
