Question

我试图自定义我们的developer guide pdf以获得一个体面的第一页。我完全可以在photoshop中做所有事情，因为asciidoc在这里的能力似乎非常有限。

不幸的是，尽管无处不在，我似乎无法找到一种方法来自定义封面或将其替换为适用于asciidoctor-fopub的图像。

令人烦恼的是，在项目https://github.com/asciidoctor/asciidoctor-fopub的自述文件中（在自定义XSL模板下）中特别提到了这个用例，但没有提到如何实际执行它而不是＆＃34;它在XSL＆＃34;。作为一个不熟悉docbook的人，我不知道从哪里开始。

asciidoctor-pdf有一个标记用于包含图像，但它在我们的文档上有barfs并生成垃圾（ToC被绘制在所有内容上）。

Answer 1

这可以使用build / fopub / docbook / fo /

下的division.xsl文件来完成

搜索“占位符模板”

并在其下方粘贴代码，您将能够在生成的fopub中看到封面图片

<!-- Placeholder templates -->
<xsl:template name="front.cover">
  <xsl:call-template name="page.sequence">
    <xsl:with-param name="master-reference">titlepage-cover-image</xsl:with-param>
    <xsl:with-param name="content">
      <fo:block text-align="center">
     <fo:external-graphic src="url(path/to/cover.png)" content-height="250mm" content-width="176mm"/>
      </fo:block>
    </xsl:with-param>
  </xsl:call-template>
</xsl:template>

根据您的图书要求更改高度和宽度。

完成后，您需要在封面上提供图像保证金以便清楚。在pagesetup.xsl

中添加以下内容

<fo:simple-page-master master-name="titlepage-cover-image"
                           page-width="{$page.width}"
                           page-height="{$page.height}"
                           margin-top="{$title.page.margin.top}"
                           margin-bottom="{$page.margin.bottom}">
      <xsl:attribute name="margin-{$direction.align.start}">
        <xsl:value-of select="$page.margin.inner"/>
  <xsl:if test="$fop.extensions != 0">
    <xsl:value-of select="concat(' - (',$title.margin.left,')')"/>
        </xsl:if>
      </xsl:attribute>
      <xsl:attribute name="margin-{$direction.align.end}">
        <xsl:value-of select="$page.margin.outer"/>
      </xsl:attribute>
      <xsl:if test="$axf.extensions != 0">
        <xsl:call-template name="axf-page-master-properties">
          <xsl:with-param name="page.master">titlepage-cover-image</xsl:with-param>
        </xsl:call-template>
      </xsl:if>
      <fo:region-body margin-bottom="{$body.margin.bottom}"
                      margin-top="{$title.body.margin.top}"
                      column-gap="{$column.gap.titlepage}"
                      column-count="{$column.count.titlepage}">
        <xsl:attribute name="margin-{$direction.align.start}">
          <xsl:value-of select="$body.margin.inner"/>
        </xsl:attribute>
        <xsl:attribute name="margin-{$direction.align.end}">
          <xsl:value-of select="$body.margin.outer"/>
        </xsl:attribute>
      </fo:region-body>
      <fo:region-before region-name="xsl-region-before-first"
                        extent="{$region.before.extent}"
                        precedence="{$region.before.precedence}"
                        display-align="before"/>
      <fo:region-after region-name="xsl-region-after-first"
                       extent="{$region.after.extent}"
                        precedence="{$region.after.precedence}"
                        display-align="after"/>
      <xsl:call-template name="region.inner">
        <xsl:with-param name="sequence">first</xsl:with-param>
        <xsl:with-param name="pageclass">titlepage</xsl:with-param>
      </xsl:call-template>
      <xsl:call-template name="region.outer">
        <xsl:with-param name="sequence">first</xsl:with-param>
        <xsl:with-param name="pageclass">titlepage</xsl:with-param>
      </xsl:call-template>
    </fo:simple-page-master>

然后在fo-pdf.xsl中添加变量以将您的身体上边距归零。

HTH。

如何用asciidoctor-fopub生成封面图片图片

1 个答案: