Récupérez mon système de blog

J’ai publié une version light de mon système de blog hier soir. Par light il faut comprendre avec un CSS plus épuré et plus portable (sans les bords ronds). Vous pouvez le récupérer sur github.com.

Que pouvez-vous attendre de ce système de blog ?

  • Tous les avantages liés à nanoc ;
  • Facilité de la gestion de plusieurs langues ;
  • coloration syntaxique des codes sources pour la plupart des languages ;
  • commentaires gérés avec intenseDebate de façon asynchrone ;
  • très portable avec ou sans javascript, XHTML Strict 1.0 / CSS3 ;
  • écrivez vos entrées au format Markdown (pas de HTML) ;
  • des améliorations typographiques (pas de ‘:’ en début de ligne en Français par exemple),
  • entrez directement le code de graphes qui se génèreront automatiquement en image à l’aide de Graphviz.

Pour vous donner une idée plus précise, voici la documentation que j’ai faite (en anglais) pour accompagner le code.


Main Documentation Page

Cette page est seulement en anglais désolé.

Use It NOW!

Once installed (follow the README.md instructions).

Now your website reside into the output directory.


Documentation

Useful things to know

Multi-language

All files in multi are processed and copied in the content directory. For each file in multi, each line starting by ‘fr:’ are copied (without the fr: into the content/html/fr/ tree, but not into the content/html/en tree. File not starting by fr: or en: are copied in each destinations.

If you want to add another language, you’ll have to modify tasks/config, and config.yaml, create a content/html/xx where xx is the language code.

Edition & Rendering

additional keywords

You can separate multi content div using the: n``ewcorps directive (see examples).

You can create div using b``egindiv(classname), e``nddiv. (See some existing blog entries for example). Use the class intro for the abstract part.

You can create nice description table using <``desc> (See source code for example).

Typography

In French all ‘:’, ‘;’, ‘!’ and ‘?’ are preceded automatically by &nbsp. This enable not to have a line starting by a single special character.

You can use small caps using <sc> tags.

  • (c``) is replaced by (c).
  • (r``) is replaced by (r).
  • <``- is replaced by <-.
  • -``> is replaced by ->.

source code

To write source code you should use the following format:

~~~~~~ {.html} ~~~~~~ {.ruby} The code ~~~~~~

The file attribute is not required.

blog

If you want to make really long blog post, you can separate them into many files. To accomplish that, you simply have to make your files like:

multi/blog/2010-06-01-the-title.md
multi/blog/2010-06-01-the-title/second_part.md
multi/blog/2010-06-01-the-title/third_part.md

mobileme

All files are intended to be generated into the output/Scratch directory. This was made like that to work nicely with iWeb organisation of websites.

The order of post is done using the menupriority meta-data in the header of the files.

You can hide some file from the menu by setting: isHidden: true in the header.

Details

To know more about this blog engine, you should look at nanoc project.

Then look at the files inside your project:

README.md : readme for the project (used by github) :: latest.md : symbolic link to the last blog entry :: multi/ : Directory containing multi-language articles :: tasks/ : scripts for website live :: config.yaml : global configuration file :: Rules : generation rules :: content/ : content files processed by nanoc :: layouts/ : erb templates :: lib/ : ruby libraries used to process files :: output/ : website :: Rakefile : not mandatory for this blog ::