Comment ajouter du contenu a tetalab.org

Posted on Dec 20 -

Récupérer le repo git sur son ordi

sur mac/linux, en ligne de commande

$ git clone ssh://git@git.tetalab.org:22101/jekyll.git

sur windows

  • installer tortoisegit: http://code.google.com/p/tortoisegit/
  • Howto welcome: comment cloner un repo git dans tortoise git avec une clé ssh

Ajouter du contenu au site

Une fois que vous avez le clone du repo git sur votre ordi, le répertoire posts sera seul endroit que vous aurez besoin de modifier pour rajouter un article sur le site.

Créer un article

Dans le repertoire posts, rajouter un fichier, avec ceci comme nom: year-month-day-title.markdown

Par exemple: 2010-12-21-comment-rajouter-du-contenu-a-tetalab.markdown

Le header de l’article

Chaque article doit avoir un header pour être afficher sur le site, il se compose ainsi:

---
layout: post
title: Installation et utilisation de Gource
description: Gource est un soft de visualisation d'ajouts/modifications de noeuds par des agents suivant un timestamp
image: /images/alx/add_article.jpg
author: Alex
---

Le contenu de l’article

Apres le header, vous pouvez ajouter le contenu de l’article au format markdown. Markdown est un langages syntaxique qui évite de se taper du HTML pour faire des documents simple.

Il est toujours possible de faire son article en full-html pour les furieux, et de mettre du html standard pour rajouter des videos ou des embed externes pour ceux qui veulent rajouter plus de contenu.

Syntax Markdown

Ajouter des images

En attendant le retour de meta.tetalab.org il est possible de rajouter des images en les mettant dans le repertoire images à la racine du projet jekyll.

Je vous laisse organiser les dossier dans lequel vous voulez mettre vos images, ça peut être le bordel rapidement tant qu’on s’y retrouve.

La syntax pour afficher une image en markdown:

![image_title](image_url)

Exemple:

![ajouter du contenu sur tetalab.org](/images/alx/add_article.jpg)

Resultat:

ajouter du contenu sur tetalab.org

Ajouter du code

A venir…

“Comment il a fait ça sur cette article?”

Tous les articles sont disponibles dans le repertoire posts, vous pouvez apprendre des nouvelles manières d’ajouter du contenu en allant voir comment cela à déjà été fait.

Envoyer les articles sur le serveur

Maintenant que vous avez terminé d’ecrire votre articles et de rajouter vos images, il faut penser a le mettre sur le serveur pour l’afficher sur tetalab.org

Eviter les conflits: git pull

Pendant que vous avez ecrit un article, peut être que d’autres personnes sont venu modifié le site. Afin d’éviter les erreurs, vous devez (à chaque fois, c’est le mieux) effectuer la commande git pull afin de récupérer les dernières modifications du repo git:

git pull

Ajouter vos nouveau fichier: git add

Pour ajouter l’articles et les images que vous venez de créer dans votre projet jekyll, lancez la commande git add pour rajouter ces fichier dans le repo git:

git add

Modifier le projet jekyll avec un message: git commit -a -m “message”

Maintenant que tout est en ordre, vous pouvez modifier le repo git chez vous avec cette commande:

git commit -a -m "message"

Par exemple:

git commit -a -m "ajout d'un article howto ajouter du contenu a tetalab.org"

Envoyer vos modifications sur le serveur git: git push

Il ne reste plus qu’a envoyer vos modifications sur le serveur git:

git push

Compiler le site et l’afficher sur tetalab.org

Cette étape n’est pas encore automatique mais devrait l’être prochainement.

Jekyll doit être executé afin de transformer les fichiers que vous venez d’ajouter en fichiers html qui seront affichés sur le site.

Pour le moment, demander à quelqu’un de lancer la commande suivante sur le serveur:

/home/webadmin/update_jekyll.sh

Other Posts