Francisation des noms de fichier de la doc fr

docs/fr/configuration.rst

@@ -0,0 +1,154 @@
+Fichier de configuration
+************************
+
+On va créer un fichier de configuration que l’on va appeler **settings.py**. On peut
+utiliser Pelican sans faire ce fichier, mais il faudrait à chaque fois passer les paramètres
+en ligne de commande. Et comme il va nous servir à faire d’autres choses bien utile,
+autant l’appréhender de suite. Cependant, nous n’allons voir que la base pour l’instant.
+
+Paramètres de base
+==================
+
+AUTHOR :
+	Désigne l’auteur par défaut ;
+
+DEFAULT_CATEGORY :
+        La catégorie par défaut des articles. Si ce paramètre n’est
+	pas documenté, il prendra la valeur misc — pour miscellaneous (divers en français) ;
+
+SITENAME :
+	Le nom de votre site ;
+
+OUTPUT_PATH : 
+	Le répertoire de sortie du blog.
+
+Quand je dis qu’on va faire simple, on fait simple !
+Passons donc à ce quoi doit ressembler le fichier de configuration ::
+
+	# -*- coding: utf-8 -*-
+	AUTHOR = "Guillaume"
+	DEFAULT_CATEGORY = "GNU-Linux"
+	SITENAME = "Free Culture"
+
+
+Si vous avez un serveur comme Apache de configuré pour votre machine, vous
+pouvez paramétrer le répertoire de sortie vers **/var/www/blog** par exemple ::
+
+	OUTPUT_PATH = "/var/www/blog"
+
+Une remarque importante. Si vous avez besoin de passer un caractère accentué, il
+faut le préciser que la chaine est en unicode en faisant par exemple
+*AUTHOR = u"Guillaume LAMÉ"*
+
+Pour bien vérifier que les paramètres sont bien pris en compte, nous allons enlever les lignes *:author: Guillaume* et *:category: GNU-Linux* de notre fichier
+**premier_article.rst** et regénérer le blog.
+
+Rafraichissez votre page, ce devrait être bon.
+
+Nous allons maintenant passer en revue les différents paramètres de Pelican. Je les
+ai regroupé par thème. Cependant, c’est surtout un listing avant de rentrer dans les
+détails au prochain chapitre.
+
+Flux de syndication
+===================
+
+CATEGORY_FEED : 
+	Chemin d’écriture des flux Atom liés aux catégories ;
+
+CATEGORY_FEED_RSS : 
+	Idem pour les flux rss (Optionnel);
+
+FEED :
+	Chemin du flux Atom global ;
+
+FEED_RSS :
+	Chemin du flux Rss global (Optionnel);
+
+TAG_FEED :
+	Chemin des flux Atom pour les tags (Optionnel);
+
+TAG_FEED_RSS :
+	Chemin des flux Rss pour les tags (Optionnel).
+
+
+Traductions
+===========
+
+DEFAULT_LANG :
+	Le langage par défaut à utiliser. «*en*» par défaut ;
+
+TRANSLATION_FEED :
+	Chemin du flux pour les traductions.
+
+
+Thèmes
+======
+
+CSS_FILE :
+	Fichier css à utiliser si celui-ci est différent du fichier par défaut (*main.css*) ;
+
+DISPLAY_PAGES_ON_MENU :
+	Affiche ou non les pages statiques sur le menu du thème ; 
+
+DISQUS_SITENAME :
+	Indiquer le nom du site spécifié sur Disqus ;
+
+GITHUB_URL :
+	Indiquez votre url Github ;
+
+GOOGLE_ANALYTICS :
+	'UA-XXXX-YYYY' pour activer Google analytics ;
+
+JINJA_EXTENSIONS :
+	Liste d'extension Jinja2 que vous souhaitez utiliser ;
+
+LINKS :
+	Une liste de tuples (Titre, url) pour afficher la liste de lien ;
+
+PDF_PROCESSOR :
+	Génère ou non les articles et pages au format pdf ;
+
+REVERSE_ARCHIVE_ORDER :
+	Met les articles plus récent en tête de l'archive ;
+
+SOCIAL :
+	Une liste de tuples (Titre, url) pour afficher la liste de lien dans la section "Social" ;
+
+STATIC_THEME_PATHS :
+	Répertoire du thème que vous souhaitez importer dans l'arborescence finale ;
+ 
+THEME :
+	Thème à utiliser:
+
+TWITTER_USERNAME :
+	Permet d'afficher un bouton permettant le tweet des articles. 
+
+
+
+
+
+Paramètres divers
+=================
+
+FALLBACK_ON_FS_DATE :
+	Si *True*, Pelican se basera sur le *mtime* du fichier s'il n'y a pas de date spécifiée dans le fichier de l'article ;
+
+KEEP_OUTPUT DIRECTORY :
+	Ne génère que les fichiers modifiés et n'efface pas le repertoire de sortie ;
+
+MARKUP :
+	Langage de balisage à utiliser ;
+
+PATH :
+	Répertoire à suivre pour les fichiers inclus ;
+
+SITEURL :
+	URL de base de votre site ;
+
+STATIC_PATHS :
+	Les chemins statiques que vous voulez avoir accès sur le chemin de sortie "statique" ;
+
+
+
+
+