git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[Patch v2 0/8] Create single PDF for all HTML files

From
Thomas Ackermann <th.acker66@arcor.de>
Date
Oct 11, 2012, 17:13 UTC
Message-ID
<1412437370.46782.1349975589890.JavaMail.ngmail@webmail22.arcor-online.net>
 
Hi,

here is my reworked patch series for creating a single PDF for all git documentation files.

Thanks to Junio Hamano, Philip Oakley and Jeff King for your comments!

In general, the following problems had to be fixed in doc files in order to create HTML by using asciidoc and afterwards create a nice looking PDF using wkhtmltopdf:

- Wrong sectioning syntax (e.g. "===" instead of "---")
- Left-over shell scripting commands (in some release notes files)
- Over-long lines which caused very wide right margins in the resulting PDF
- Wrong formatting for email quotes, quoted script code, tables

Also some of the headlines in the documents where changed or even created initially in order to give a more consistent structure in the resulting 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

--- Thomas

Next: Thomas Ackermann
Message 1 of 12 in “Create single PDF for all HTML files”
  1. 0/8 Create single PDF for all HTML filesThomas Ackermann, Oct 11, 2012
  2. 1/8 Split over-long synopsis in git-fetch-pack.txt into several linesThomas Ackermann, Oct 11, 2012
  3. 2/8 Shorten two over-long lines in git-bisect-lk2009.txt by removing some white-spaceThomas Ackermann, Oct 11, 2012
  4. Junio C HamanoOct 11, 2012
  5. 3/8 Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txtThomas Ackermann, Oct 11, 2012
  6. 4/8 Prerequisites for creating nice html for all files in Documentation/technicalThomas Ackermann, Oct 11, 2012
  7. 5/8 Prerequisites for creating nice html for all files in Documentation/howtoThomas Ackermann, Oct 11, 2012
  8. Junio C HamanoOct 11, 2012
  9. 6/8 Prerequisites for creating nice html for all files in Documentation/RelNotesThomas Ackermann, Oct 11, 2012
  10. 7/8 Create pdf from all html filesThomas Ackermann, Oct 11, 2012
  11. 8/8 Wire everything into Makefile and Documentation/MakefileThomas Ackermann, Oct 11, 2012
  12. Junio C HamanoOct 11, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.