Support pageWidth, pageHeight, and omitCover params so OpenStack

writers can do a print version of their OPs guide.

src/main/java/com/rackspace/cloud/api/docs/PDFMojo.java

@@ -128,6 +128,28 @@ public abstract class PDFMojo extends AbstractFoMojo {
      */
     private String coverColor;
 
+    /**
+     * 
+     *
+     * @parameter expression="${generate-pdf.pageWidth}" default-value=""
+     */
+    private String pageWidth;
+
+    /**
+     * 
+     *
+     * @parameter expression="${generate-pdf.pageHeight}" default-value=""
+     */
+    private String pageHeight;
+
+    /**
+     * Should cover be omitted?
+     *
+     * @parameter expression="${generate-pdf.omitCover}" default-value=""
+     */
+    private String omitCover;
+
+
     /**
      * The greeting to display.
      *
@@ -374,6 +396,16 @@ public abstract class PDFMojo extends AbstractFoMojo {
 	transformer.setParameter("coverUrl", coverUrl);
 	transformer.setParameter("coverColor", coverColor);
 
+	if(null != pageWidth){ 	
+	    transformer.setParameter("page.width", pageWidth); 
+	}
+	if(null != pageHeight){ 	
+	    transformer.setParameter("page.height", pageHeight); 
+	}
+	if(null != omitCover){ 	
+	    transformer.setParameter("omitCover", omitCover); 
+	}
+
     String sysDraftStatus=System.getProperty("draft.status");
     getLog().info("adjustTransformer():sysDraftStatus="+sysDraftStatus);
     if(null!=sysDraftStatus && !sysDraftStatus.isEmpty()){

src/main/java/com/rackspace/cloud/api/docs/WebHelpMojo.java

@@ -172,7 +172,25 @@ public abstract class WebHelpMojo extends AbstractWebhelpMojo {
      */
     private String coverColor;
 
+    /**
+     * 
+     *
+     * @parameter expression="${generate-pdf.pageWidth}" default-value=""
+     */
+    private String pageWidth;
 
+    /**
+     * 
+     *
+     * @parameter expression="${generate-pdf.pageHeight}" default-value=""
+     */
+    private String pageHeight;
+    /**
+     * Should cover be omitted?
+     *
+     * @parameter expression="${generate-pdf.omitCover}" default-value=""
+     */
+    private String omitCover;
 
 
     /**
@@ -447,6 +465,17 @@ public abstract class WebHelpMojo extends AbstractWebhelpMojo {
 	transformer.setParameter("coverUrl", coverUrl);
 	transformer.setParameter("coverColor", coverColor);
 
+	if(null != pageWidth){ 	
+	    transformer.setParameter("page.width", pageWidth); 
+	}
+	if(null != pageHeight){ 	
+	    transformer.setParameter("page.height", pageHeight); 
+	}
+	if(null != omitCover){ 	
+	    transformer.setParameter("omitCover", omitCover); 
+	}
+
+
         transformer.setParameter("enable.disqus", enableDisqus);
         if (disqusShortname != null) {
             transformer.setParameter("disqus.shortname", disqusShortname);
@@ -842,6 +871,11 @@ public abstract class WebHelpMojo extends AbstractWebhelpMojo {
         	pdfBuilder.setSourceDirectory(getSourceDirectory());
         	pdfBuilder.setAutopdfTargetDirectory(targetDir);
         	pdfBuilder.setCoverColor(coverColor);
+
+        	pdfBuilder.setPageWidth(pageWidth);
+        	pdfBuilder.setPageHeight(pageHeight);
+        	pdfBuilder.setOmitCover(omitCover);
+
         	pdfBuilder.setCoverLogoPath(coverLogoPath);
         	pdfBuilder.setSecondaryCoverLogoPath(secondaryCoverLogoPath);
         	pdfBuilder.setCoverLogoLeft(coverLogoLeft);

src/main/java/com/rackspace/cloud/api/docs/builders/PDFBuilder.java

@@ -101,6 +101,9 @@ public class PDFBuilder {
 	//transformer settings
 	//TODO: need to somehow pass coverLogoPath, secondaryCoverLogoPath, coverLogoLeft, coverLogoTop, coverUrl from the WebHelp flow
 	private String coverColor;
+	private String pageWidth;
+	private String pageHeight;
+	private String omitCover;
 	private String coverLogoPath;
 	private String secondaryCoverLogoPath;
 	private String coverLogoLeft;
@@ -352,6 +355,16 @@ public class PDFBuilder {
 		transformer.setParameter("coverUrl", coverUrl);
 		transformer.setParameter("coverColor", coverColor);
 
+		if(null != pageWidth){
+		    transformer.setParameter("page.width", pageWidth);
+		}
+		if(null != pageHeight){
+		    transformer.setParameter("page.height", pageHeight);
+		}
+		if(null != omitCover){ 	
+		    transformer.setParameter("omitCover", omitCover); 
+		}
+
 		if(null != sectionAutolabel){
 		    transformer.setParameter("section.autolabel", sectionAutolabel);
 		}
@@ -609,6 +622,28 @@ public class PDFBuilder {
 		this.branding = branding;
 	}
 
+	public String getPageWidth() {
+		return pageWidth;
+	}
+	public void setPageWidth(String pageWidth) {
+		this.pageWidth = pageWidth;
+	}
+
+ 	public String getPageHeight() {
+		return pageHeight;
+	}
+	public void setPageHeight(String pageHeight) {
+		this.pageHeight = pageHeight;
+	}
+
+ 	public String getOmitCover() {
+		return omitCover;
+	}
+	public void setOmitCover(String omitCover) {
+		this.omitCover = omitCover;
+	}
+
+
 	public String getSecurity() {
 		return security;
 	}

src/main/resources/cloud/fo/docbook.xsl

@@ -40,7 +40,7 @@
   <xsl:param name="coverLogoTop"/>
   <xsl:param name="coverUrl"/>
   <xsl:param name="secondaryCoverLogoPath"/>
-
+  <xsl:param name="omitCover"/>
   <xsl:param name="draft.mode">no</xsl:param>
 
   <xsl:param name="alignment">start</xsl:param>
@@ -299,6 +299,12 @@
     </fo:block>
   </xsl:template>
 
+  <xsl:template name="book.titlepage.before.verso">
+    <xsl:if test="$omitCover = '0'">
+      <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" break-after="page"/>
+    </xsl:if>
+  </xsl:template>
+
   <!-- Page Number Format -->
   <xsl:template name="page.number.format">
     <xsl:param name="element" select="local-name(.)"/>
@@ -398,6 +404,7 @@
 
   <!-- Sets up the Cloud Title Page -->
   <xsl:template name="user.pagemasters">
+    <xsl:if test="$omitCover = '0'">
     <fo:simple-page-master master-name="cloudpage-first"
                            page-width="8.5in"
                            page-height="11in"
@@ -449,6 +456,7 @@
         </fo:conditional-page-master-reference>
       </fo:repeatable-page-master-alternatives>
     </fo:page-sequence-master>
+    </xsl:if>
   </xsl:template>
 
   <xsl:template name="select.user.pagemaster">
@@ -457,7 +465,7 @@
     <xsl:param name="default-pagemaster"/>
 
     <xsl:choose>
-      <xsl:when test="$default-pagemaster = 'titlepage'">
+      <xsl:when test="$default-pagemaster = 'titlepage' and $omitCover = '0'">
         <xsl:value-of select="'cloud-titlepage'" />
       </xsl:when>
       <xsl:otherwise>