Documentation as books

Elizabeth K. Joseph lyz at ubuntu.com
Wed Oct 29 00:53:50 UTC 2014


On Tue, Oct 28, 2014 at 2:01 PM, Shaun McCance <shaunm at gnome.org> wrote:
> You probably don't even want to touch the Makefile to get epub output.
> Just pass the page files to yelp-build, or just use "." to get all the
> page files in the current directory. So in C/:
>
> yelp-build epub -o ubuntu-user-guide.epub .

Thanks! I guess I had assumed there was some style stuff we wanted to
pull over, but you're right, as a first stab it's easier just to
convert the C version with all defaults and go from there.

Here's the first, all defaults, stab at the epub conversion:

http://people.ubuntu.com/~lyz/ubuntu-docs/ubuntu-user-guide.epub

Not the worst thing I've ever seen, but the text is a bit big so the
pages each don't have much content.

Using Calibre, I then converted it to .pdf, which didn't go as well...

http://people.ubuntu.com/~lyz/ubuntu-docs/ubuntu-user-guide.pdf

My hope is that with some configuration (and perhaps not using
Calibre, but that's what I had on hand) we could improve this if it's
something we want.

-- 
Elizabeth Krumbach Joseph || Lyz || pleia2
http://www.princessleia.com



More information about the ubuntu-doc mailing list