The FreeBSD Documentation Project: Is it just me or anyone is interested in reading the FAQ and

[Michael B. Eichorn]

On Thu, 2015-10-29 at 03:25 +0100, John via freebsd-questions wrote:
> On Fri, 23 Oct 2015, jungle Boogie wrote:
> 
> > You mean like this:
> > ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/
> > 
> > There's not an epub format but a pdf, txt, rtf,
> > html and ps
> 
> Okay, let's see 
> http://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/handbook/
> I've chosen the formats seem to most suitable for my purposes (
> https://marc.info/?l=freebsd-questions&m=144608407002871), that is, to
> be able to simply generate an ebook from the input (in my case, Kindle,
> but you can get an EPUB almost the same way):
> 
> book.html.tar.zip
> book.rtf.zip
> 
> The HTML almost looks good from here, but when I download, extract and
> run the main book.html file, the images are not downloaded; even if I
> open it in a web browser.

Can confirm, I have the images but opening in Firefox and Chromium I only
see the alt-text rendered.

The image links are of the form:
<img src="/local0/docbuild/build/doc/en_US.ISO8859
-1/books/handbook/../../../share/images/books/handbook/geom/striping.png"
align="middle" alt="Disk Striping Illustration">

When they should be:
<img src="geom/striping.png" align="middle" alt="Disk Striping
Illustration">

> The RTF looks broken in Windows 7's WordPad, it freezes LiberOffice and
> the conversion  crashes under Calibre.

This is strange. I just looked at it, the rtf is actually a pdf?!

$ file book.rtf
book.rtf: PDF document, version 1.4

Also applies to the postscript file

$ file book.ps
book.ps: PDF document, version 1.4

> Now I understand there might be issues with different encodings between
> Unix and Windows, but I don't know much about these issues. I
> downloaded the .zip versions assuming they are more Windows-friendly.

Not an encoding problem (this time). The encoding here is ISO 8859-1 as
shown in the url. This is sometimes called Latin-1 and is roughly
equivalent to Windows-1252. (Quotes and control characters are
different).

> Now, how to get the Handbook (and FAQ) to my book reader? Thanks!

Well the book.txt checks out. There are not very many pictures, you can
probably get by without them.

To get this done quickly with graphics, I would use the html and then use
a find-replace tool to repair the image links. Alternately, file a bug
against the docs and wait for a volunteer to fix the problem.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 5761 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-questions/attachments/20151028/8f3be76c/attachment.bin>