Merge branch 'master' of https://github.com/Freeculture/pelican

docs/fr/astuces.rst

@@ -0,0 +1,20 @@
+Trucs et astuces pour Pelican
+#############################
+
+Personnaliser l'url d'un article pour Pelican
+=============================================
+
+Par défaut, quand vous créez un article ayant pour titre *Mon article pour Pelican*,
+l'url par défaut devient *mon-article-pour-pelican.html*. Cependant, il est possible 
+de modifier cela en utilisant la technique utilisée pour les traductions d'article,
+c'est à dire le paramètre *:slug:* ::
+
+	Mon article pour Pelican
+	########################
+
+	:date: 2011-01-31 11:05
+	:slug: super-article-pour-pelican
+
+	bla, bla, bla …
+
+En prenant cet exemple ci dessus, votre url deviendra *super-article-pour-pelican.html*

docs/fr/conf.py

@@ -24,7 +24,7 @@ release = version
 # a list of builtin themes.
 sys.path.append(os.path.abspath('../_themes'))
 html_theme_path = ['../_themes']
-html_theme = 'flask_small'
+html_theme = 'flask'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

docs/fr/index.rst

@@ -50,3 +50,6 @@ Documentation
    installation
    bases
    configuration
+   parametres_article
+   astuces
+   faq

docs/fr/parametres_article.rst

@@ -0,0 +1,106 @@
+Les paramètres des articles dans Pelican
+########################################
+
+Les catégories
+==============
+
+Nous avons vu que pour affecter un article à une catégorie, nous avions le paramètre *:category:*.
+Il y a cependant plus simple, affecter un répertoire à une catégorie. 
+  
+Dans le répertoire ou vous avez vos articles, créez le repertoire **GNU-Linux** et déplacez y le fichier
+**premier_article.rst**. Bien évidemment nous ne verront pas la différence, car jusqu'ici *GNU-Linux*
+est notre catégorie par défaut.
+  
+Nous allons faire un autre exemple d'article avec la catégorie Pelican. Créez le répertoire **Pelican**
+et collez cette exemple d'article ::
+
+	Préparation de la documentation
+	###############################
+
+	:date: 2011-01-27 15:28
+	:tags: documentation
+	
+	Il y a quand même pas mal de boulot pour faire une documentation !
+
+Et lancez la compilation du blog. Vous voyez que la catégorie est affectée automatiquement. 
+
+Les tags
+========
+
+Pour les tags, il n'y a rien de compliqué. il suffit de mettre le(s) tags séparés si besoin d'une virgule. ::
+
+	Préparation de la documentation
+	###############################
+
+	:date: 2011-01-27 15:28
+	:tags: documentation, pelican
+
+Par contre, par soucis de clarté au niveau des url je vous conseille de mettre les expression de plusieurs 
+mots séparées par des tirets ::
+
+	:tags: mise-a-jour
+
+et non ::
+
+	:tags: mise a jour
+
+
+Les auteurs
+===========
+
+Par défaut, vous pouvez indiqué votre nom en tant qu'auteur dans le fichier de configuration.
+S'il y a plusieurs auteurs pour le site, vous pouvez le définir manuellement dans
+l'article avec la méta-donnée ::
+
+	:author: Guillaume
+
+La date
+=======
+
+La date se met au format anglophone : **YYYY-MM-DD hh:mm** ::
+
+	:date: 2011-01-31 14:12
+
+
+Les traductions
+===============
+
+Pelican permet de générer un blog multilingue assez facilement. Pour cela nous devons :
+
+* Définir la langue de base du blog ;
+* Donner une référence à l'article initial ;
+* Définir la langue du fichier traduit et y reporter la référence.
+
+Pour définir la langue de base nous allons modifier le fichier **settings.py** et y rajouter la ligne suivante ::
+
+	DEFAULT_LANG = "fr"
+
+Puis ajouter la référence dans notre article d'origine qui deviendra ::
+
+	Préparation de la documentation
+        ###############################
+
+        :date: 2011-01-27 15:28
+        :tags: documentation
+	:slug: preparation-de-la-documentation
+
+        Il y a quand même pas mal de boulot pour faire une documentation !
+
+Nous n'avons plus qu'à créer l'article en anglais ::
+
+	Start of documentation
+	######################
+
+	:slug: preparation-de-la-documention
+	:lang: en
+
+	There are still a lot of work to documentation !
+
+**Il est important de comprendre que la valeur de :slug: deviendra votre url. Ne mettez donc pas un diminutif pour 
+identifier l'article**
+
+Rien de plus à savoir pour traduire efficacement des articles.	
+
+
+Maintenant que vous avez toutes les clés en main pour créer un article, nous allons passer à la personnalisation 
+du fichier de configuration.