Re: Re: [Patch 0/5] Create single PDF for all HTML files

From: "Thomas Ackermann" <redacted>

There are "patched QT" and "unpatched QT" versions of wkhtmltopdf
(see http://code.google.com/p/wkhtmltopdf/). I am using V0.9.9 for 
Windows
which is "patched QT".

There is one drawback with wkhtmltopdf: At least on my Netbook (Win7 
64bit,
Pentium 1.5GHz) it is very slow. It takes more than 3 hrs to create 
git-doc.pdf.

If you want to have a quick look on the resulting pdf just clone
https://github.com/tacker66/git-docpdf.git. This repo contains
a current version of user.manual.pdf and git-doc.pdf

Even as a 'draft' I found it to be useful to see all the documentation 
collated together in one place/pdf. All 763 pages!

Even just reading through the contents list (34 pages) showed the scale 
of the git documentation, and areas of documentation I wasn't aware of.

Putting the Tutorials, Everyday GIT and workflows at the beginning 
looked good.

For a polished version it would be good if the major breaks (e.g. 
between ToC, gittutorial, git-add [should start with git(1)], 
gitattributes, GIT Howto, API, Git Index Format, ReleaseNotes) could 
start on a new page.

A few minor nits: I wasn't sure if the 'fighting regressions with git 
bisect', and 'a short git tools survey' were in the right place. There 
appear to be two 'git-send-pack' titles, though they are different. And 
the HowTo section would need some beefed up headings to give them enough 
prominence in the ToC once it all hangs together.

----- Original Nachricht ----
Von:     Jeff King [off-list ref]
An:      Thomas Ackermann [off-list ref]
Datum:   06.10.2012 21:32
Betreff: Re: [Patch 0/5] Create single PDF for all HTML files

quoted

On Sat, Oct 06, 2012 at 05:51:15PM +0200, Thomas Ackermann wrote:

quoted

I wanted to have a single PDF file which contains the complete Git

documentation

quoted

(except user-manual) for easier reading on my tablet. The simplest 
way to

do

quoted

this was by using wkhtmltopdf which can combine a set of HTML files 
into a

sinlge

quoted

PDF file and also apply some reformatting. To this end HTML files 
for all

the missing

quoted

files in Documentation/technical and Documentation/howto and also 
for all

the

quoted

release notes in Documentation/RelNotes were created.

It seems like a reasonable goal. I do not have a strong opinion on 
the
approach or how the final output looks, but I wasn't able to actually
get output at all after applying your patches. Running "make fullpdf"
(after installing dblatex) got me:

  The switch --book, is not support using unpatched qt, and will be
  ignored.The switch --footer-html, is not support using unpatched 
qt,
  and will be ignored.The switch --disable-external-links, is not
  support using unpatched qt, and will be ignored.

after which wkhtmltopdf began pegging my CPU. I let it run for 10
minutes before giving up.

Another way of doing this would be to format the individual troff
manpages into dvi or postscript, convert that into pdf, and then
concatenate that. Something like:

  for i in *.[157]; do
    man -Tdvi -l "$i" >"$i.dvi"
    dvipdfm "$i"
  done
  pdftk *.[157].pdf cat output full.pdf

works for me, though obviously that does not handle some of the 
non-man
items you included. No idea on how the output compares to yours, but
it's something you may want to look at.

-Peff

---
Thomas
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


-----
No virus found in this message.
Checked by AVG - www.avg.com
Version: 2013.0.2677 / Virus Database: 2591/5813 - Release Date: 
10/06/12