restlet-tutorial icon indicating copy to clipboard operation
restlet-tutorial copied to clipboard

Published 20 hours ago • verified publisher icon restlet

Used GitBook approach

Open jlouvel opened this issue 12 years ago • 6 comments

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 avatar Aug 06 '12 08:08 jlouvel

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

jlouvel avatar Mar 15 '13 23:03 jlouvel

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...

templth avatar Mar 16 '13 08:03 templth

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.

jlouvel avatar Mar 16 '13 13:03 jlouvel

Okay. Sounds good to me

templth avatar Mar 17 '13 07:03 templth

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

thboileau avatar Nov 19 '13 04:11 thboileau

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

templth avatar Nov 19 '13 07:11 templth