Used GitBook approach

[jlouvel]

https://github.com/schacon/gitbook

They write the doc in the markdown format (easy with GitHub):
http://github.github.com/github-flavored-markdown/

We can then produce HTML and PDF pretty easily using tools such as Pandoc or similar tools:
http://johnmacfarlane.net/pandoc/

That could be much more convenient to write, maintain and receive contributions thanks to GitHub.

[jlouvel]

Should we create an issue for the PDF/HTML generation with Pandoc, or change the focus of this ticket?

[templth]

I don't know. I'm sure Pandoc is a great but I can't install and make it work. The tool isn't in the public repositories for Debian / Ubuntu and I can't see which repository to add... We have now a chain to generate HTML / PDF from markdown...

[jlouvel]

I see. I thought we already had something in place for the Restlet.org web site to produce the HTML from the MD. @thboileau knows for sure. Let's just make sure we use the same tools.

[templth]

Okay. Sounds good to me

[thboileau]

pandoc can be installed simply using apt-get command on ubuntu.

[templth]

Yes, I finally installed it. Doesn't know what exactly happened the first time I tried to install it...