search

bocoup / web-platform-contribution-guide

Source code for the Web Platform Contribution Guide, a guidebook to becoming a web platform contributor.
https://wpc.guide
13 stars 1 forks source link

Publishing an e-book #29

Open jugglinmike opened 4 years ago

jugglinmike commented 4 years ago

I'd like to support exporting the guide to e-book formats (and possibly to print some day). Doing this well will involve using a different markup language--here's a good explanation of why that is.

Do folks agree that this is a worthwhile goal? Is anyone uncomfortable with using something other than Markdown? (In keeping with that article, I like reStructured Text for this.)

zcorpan commented 4 years ago

I think this would be nice.

I don't mind switching to a different markup language.

https://github.com/zcorpan/html-parser-book/ uses Markua (which is very similar to Markdown) and is published as an e-book on Leanpub.

I don't think Leanpub supports rST. But we don't have to publish on Leanpub.

jugglinmike commented 4 years ago

I think this would be nice.

I don't mind switching to a different markup language.

Great!

https://github.com/zcorpan/html-parser-book/ uses Markua (which is very similar to Markdown) and is published as an e-book on Leanpub.

I don't think Leanpub supports rST. But we don't have to publish on Leanpub.

One of the drawbacks to Markdown is the proliferation of "dialects," so I'm wary about committing to something like Markua.

The good news is that Leanpub and Lulu both accept PDFs. If we choose a process that outputs to PDF (a format which is useful in its own right), then we should have a lot of flexibility when we need to print (presumably just before this guide becomes a New York Times bestseller).