Par

Nouveau blog du lab !

Categories : welcome

Tags : sculpin markdown github lanetscouade

Le blog du lab est de retour ! Il est hébérgé sur Github Pages et généré par Sculpin. Notre repository git est disponible à cette adresse https://github.com/LaNetscouade/LaNetscouade.github.io. Pourquoi Sculpin ? Comment l'installer ? Comment l'utiliser avec Github Pages.

Pourquoi Sculpin ?

Pour notre blog nous voulions un outil simple, et si possible sans maintenance. Avec Scuplin et les Github Pages, pas besoin de serveur ni de sauvegardes et pas de soucis concernant la maintenance. D'autres outils existent notament Jekyll en ruby, mais comme nous somme plus habitués à PHP et à Symfony 2 et Twig, Sculpin nous sembait plus adapté.

Comment l'installer ?

Pour l'installer, plusieurs possibilités, nous avons décidé d'utiliser l'installation avec composer. voici notre fichier composer.json

{
    "name": "lanetscouade/lelab-leblog",
    "require": {
        "sculpin/sculpin": "2.0.*@dev",
        "composer/composer": "1.*@dev"
    },
    "config": {
        "bin-dir": "bin"
    },
    "minimum-stability": "dev"
}

une fois ce fichier créé lancez la commande composer install

Pour démarer votre blog voici une structure minimale

▾ app/
  ▾ config/
      sculpin_site.yml
▾ source/
  ▾ _includes/
  ▾ _posts/
      2014-03-05-mon-premier-post.md
  ▾ _views/
      default.html
      post.html
    index.html

Vos posts sont contenu dans le dossier source/_posts en markdown en html ou bien en textile, ici nous utiliserons markdown

Voici le contenu du fichier 2014-03-05-mon-premier-post.md

---
title: Mon premier post !
---

Ceci est mon premier post avec scuplin

La partie entre les deux lignes --- est en YAML et vous permet de spécifier les variables liées à votre post, celles-ci seront accessible dans vos templates par page.title