Les bases de Pelican
####################

Créer son premier article
=========================

Pour créer notre premier article, nous allons éditer un fichier, par exemple premier_article.rst ::

	Premier article pour Pelican
	############################
	:author: Guillaume
	:date: 2011-01-08 10:20
	:category: GNU-Linux
	:tags: tutoriel, git
	Ceci est un tutoriel pour configurer git.
	Bla, bla, bla ....

Maintenant que ce fichier est créé, on va lancer la création du blog ::

	pelican .

Vous aller obtenir une sortie comme celle ci — $PATH représente le dossier où vous
avez créé votre article ::

	[ok] writing $PATH/output/feeds/all.atom.xml
	[ok] writing $PATH/output/feeds/GNU/Linux.atom.xml
	[ok] writing $PATH/output/feeds/all-en.atom.xml
	[ok] writing $PATH/output/premier-article-pour-pelican.html
	[ok] writing $PATH/output/index.html
	[ok] writing $PATH/output/tags.html
	[ok] writing $PATH/output/categories.html
	[ok] writing $PATH/output/archives.html
	[ok] writing $PATH/output/tag/tutoriel.html
	[ok] writing $PATH/output/tag/git.html
	[ok] writing $PATH/output/category/GNU-Linux.html


Première analyse
================

Nous allons décortiquer un peu tout ça ensemble.

* Un dossier output/ a été créé pour y mettre le fichiers xml et html du blog.
* Dans le dossier feeds/, nous retrouvons les différents flux de syndication.
* Le fichier de l’article et la page principale du blog a été généré.
* Le répertoire tag/ propose une page par tag.
* La page correspondant à la catégorie est générée dans le répertoire category/

Si vous ouvrez le fichier index.html — ou un autre — avec votre navigateur, vous
remarquerez que :

* Le thème utilisé par défaut est notmyidea
* Le nom du blog est A Pelican Blog.
  
Bien évidemment, il y a des paramètres de base que l’on peut modifier pour mettre
un peu tout ça à sa sauce. C’est ce que nous allons voir au travers du fichier de configuration.