search

restlet / restlet-tutorial

Comprehensive Restlet tutorial
25 stars 30 forks source link

Used GitBook approach #1

Open jlouvel opened 12 years ago

jlouvel commented 12 years ago

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 commented 11 years ago

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

templth commented 11 years ago

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 commented 11 years ago

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 commented 11 years ago

Okay. Sounds good to me

thboileau commented 10 years ago

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

templth commented 10 years ago

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