# ----------------------- ## Main Configs ## ----------------------- #url:http://yoursite.comtitle:My Octopress Blogsubtitle:A blogging framework for hackers.author:Your Namesimple_search:http://google.com/searchdescription:# Default date format is "ordinal" (resulting in "July 22nd 2007")# You can customize the format as defined in# http://www.ruby-doc.org/core-1.9.2/Time.html#method-i-strftime# Additionally, %o will give you the ordinal representation of the daydate_format:"ordinal"# RSS / Email (optional) subscription links (change if using something like Feedburner)subscribe_rss:/atom.xmlsubscribe_email:# RSS feeds can list your email address if you likeemail:# ----------------------- ## Jekyll & Plugins ## ----------------------- ## If publishing to a subdirectory as in http://site.com/project set 'root: /project'root:/permalink:/blog/:year/:month/:day/:title/source:sourcedestination:publicplugins:pluginscode_dir:downloads/codecategory_dir:blog/categoriesmarkdown:rdiscountpygments:false# default python pygments have been replaced by pygments.rbpaginate:10# Posts per page on the blog indexpagination_dir:blog# Directory base for pagination URLs eg. /blog/page/2/recent_posts:5# Posts in the sidebar Recent Posts sectionexcerpt_link:"Readon→"# "Continue reading" link text at the bottom of excerpted articlestitlecase:true# Converts page and post titles to titlecase# list each of the sidebar modules you want to include, in the order you want them to appear.# To add custom asides, create files in /source/_includes/custom/asides/ and add them to the list like 'custom/asides/custom_aside_name.html'default_asides:[asides/recent_posts.html,asides/github.html,asides/twitter.html,asides/delicious.html,asides/pinboard.html,asides/googleplus.html]# Each layout uses the default asides, but they can have their own asides instead. Simply uncomment the lines below# and add an array with the asides you want to use.# blog_index_asides:# post_asides:# page_asides:# ----------------------- ## 3rd Party Settings ## ----------------------- ## Github repositoriesgithub_user:github_repo_count:0github_show_profile_link:truegithub_skip_forks:true# Twittertwitter_user:twitter_tweet_count:4twitter_show_replies:falsetwitter_follow_button:truetwitter_show_follower_count:falsetwitter_tweet_button:true# Google +1google_plus_one:falsegoogle_plus_one_size:medium# Google Plus Profile# Hidden: No visible button, just add author information to search resultsgoogleplus_user:googleplus_hidden:false# Pinboardpinboard_user:pinboard_count:3# Deliciousdelicious_user:delicious_count:3# Disqus Commentsdisqus_short_name:disqus_show_comment_count:false# Google Analyticsgoogle_analytics_tracking_id:# Facebook Likefacebook_like:false
C’est ce fichier que l’on nomme “site”. Si vous faites un appel :
1
{{ site.author }}
Octopress ira chercher dans _config.yml la valeur de “author”. Pour l’instant la valeur retournée serait : “Your Name” . Compris ? Je récapitule, dans l’exemple ci-dessous, on aura donc dans l’ordre :
12345678910111213141516171819202122
# ----------------------- ## Main Configs ## ----------------------- #url:http://yoursite.comtitle:My Octopress Blogsubtitle:A blogging framework for hackers.author:Your Namesimple_search:http://google.com/searchdescription:# Default date format is "ordinal" (resulting in "July 22nd 2007")# You can customize the format as defined in# http://www.ruby-doc.org/core-1.9.2/Time.html#method-i-strftime# Additionally, %o will give you the ordinal representation of the daydate_format:"ordinal"# RSS / Email (optional) subscription links (change if using something like Feedburner)subscribe_rss:/atom.xmlsubscribe_email:# RSS feeds can list your email address if you likeemail:
site.url
site.title
site.subtitle
site.author
site.simple_search
site.description
site.date_format
site.subscribe_rss
site.subscribe_email
site.email
J’espère que tout est clair pour vous.
Passons maintenant à “page”.
Le paramètre “page”
Alors page représente tout simplement, le fichier en cours de modélisation, celui qui contient le
1
{{ content }}
entre doubles accolades.
Si on reprend le tuto dans l’ordre, notre fichier page est donc index.html pour le moment.
En effet, index.html appelait le modèle home.html qui lui même appelait les _includes. Dans notre cas index.html sera “page”, home.html sera le layout. Vous suivez ? Vous pouvez dans l’entête de “page” mettre des variables que vous appellerez par la suite grâce à
1
{{ page.nom_de_la_variable. }}
à l’endroit voulu.
Il existe des valeurs déjà utilisées par octopress comme :
page.content : le contenu brut de votre “page”,
page.title : le titre,
page.url : l’url unique sans le domaine (comme les permaliens wordpress),
page.date : la date Vous pouvez forcer un format en spécifiant YYYY-MM-DD HH:MM:SS,
page.id : un identifiant unqiue de votre page pour le flux RSS (/2012/08/05/titre par exemple),
page.categories : les catégories que vous lui affecter,
page.tags : les tags que vous lui affecter.
Vous pouver ajouter page.sommaire ou page.excerpt ou page.geolocalisation tant que dans l’entête de votre “page” comprise entre deux jeu de 3 —, vous spécifiiez (oui oui deux i, la langue française est merveilleuse) ces paramètres. Au cas où ils ne sont pas systématiques pensez juste à faire une boucle de test if endif sinon octopress génererait des erreurs et planterait le système.