pdf-generation-from-html-v0.9.1.txt This describes how to generate the PDF file from the HTML - for OSLC in particular, but also for others where HTML-to-PDF is used. There are two main steps: A) Prepare HTML file. B) Construct the command string to generate the OASIS-styled PDF file, and generate the PDF. A) If the HTML file is already set up as an OASIS document, then (usually) the only issues to address are related to pagination. HTML files don't handle pagination in the same way as PDF, so changes are necessary. The OASIS style for page-oriented formats has two elements which are missing in most HTML files: 1) page footers/headers containing specific text [this is handled by the "wkhtmltopdf" software - see (far) below] 2) page breaks before major sections [this is discussed immediately below] A) 2) How to insert page breaks before the major sections a) Basic approach: use the

tags in the HTML to generate new page in the PDF. b) Alternative approach [not yet tested, but may be better]: use the

tags to generate a new page in the PDF. A) 2) a) How to use the
tags to control pagination. - Since the OASIS style for HTML files requires horizontal lines above every major section heading, there will be
(horizontal rule) tags in the HTML code at the desired locations. - The
tags can be used to generate both a line and a page break, by tweaking the "styles". - tweaking the "styles": This is done either a.1) in a