maven으로 docbook 다루기 - 좀 더 복잡하게~~

docbkx-tools는 편리한 대신, xslt와 fop의 세밀한 옵션을 조절할 수 없다. 그래서 좀 더 삽질을 해봤다.

말이 maven이지 ant로 했다면 훨씬 간단했을 듯...하지만, maven에서 xslt나 fop를 다루는 예제라고 생각하면 뭐... 손해볼 건 없다.

1. maven-dependency-plugin의 unpack-dependencies 골을 실행하여 docbook 스타일 시트와 카탈로그를 작업 디렉토리에 풀어 놓자. 예제에서는 generated-resources 페이즈에 net.sf.docbook:docbook-xsl 아티팩트를 target/generated-resources 폴더 아래에 풀어 놓는다(말이 참 어려운데... 가만히 들여다 보면 별거 아니다):

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
   <artifactId>maven-dependency-plugin</artifactId>
    <executions>
      <execution>
        <id>unpack-shared-resources</id>
        <goals>
          <goal>unpack-dependencies</goal>
        </goals>
        <phase>generate-resources</phase>
        <configuration>
          <outputDirectory>${project.build.directory}/generated-resources</outputDirectory>
          <includeGroupIds>net.sf.docbook</includeGroupIds>
          <includeArtifactIds>docbook-xsl</includeArtifactIds>
          <includeClassifiers>resources</includeClassifiers>
          <excludeTransitive>true</excludeTransitive>
        </configuration>
      </execution>
    </executions>
</plugin>

2. xml-maven-plugin의 transform 골을 실행하여, 앞에서 풀어놓은 docbook 스타일 시트와 카탈로그들을 사용하여 xslt(여기서는 xalan을 사용했지만 saxon등 다른 xslt를 사용해도 된다)를 실행하여 fo 파일을 만든다.  예제에서는 generated-resources 페이즈에 src/docbook 디렉토리 아래에 manual.xml을 처리하여 처리하여 manual.fo인 파일을 만든다(parameters 요소를 사용하여 XSLT 파라메터를 지정할 수 있다):

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>xml-maven-plugin</artifactId>
   <version>1.0-beta-2</version>
   <executions>

    <execution>
      <goals>
        <goal>transform</goal>
      </goals>
      <!-- linked with generate-resources phase -->
      <phase>generate-resources</phase>
    </execution>
  </executions>
  <configuration>
      <catalogs>
        <catalog>${project.build.directory}/generated-resources/docbook/catalog.xml</catalog>
      </catalogs>
      <transformationSets>
        <transformationSet>
          <dir>src/docbook/</dir>
          <includes>
            <include>manual.xml</include>
          </includes>
          <stylesheet>${project.build.directory}/generated-resources/docbook/fo/docbook.xsl</stylesheet>
          <fileMappers>
            <fileMapper

 implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
            <targetExtension>.fo</targetExtension>
          </fileMapper>
        </fileMappers>
        <outputDir>${project.build.directory}/</outputDir>
        <!-- see http://docbook.sourceforge.net/release/xsl/current/doc/fo/ -->
        <parameters>
          <parameter>
            <name>body.font.family</name>
            <value>UnBatang</value>
          </parameter>
          <parameter>
            <name>sans.font.family</name>
            <value>UnDotum</value>
          </parameter>
          <parameter>
            <name>title.font.family</name>
            <value>hline</value>
          </parameter>
          <parameter>
            <name>monospace.font.family</name>
            <value>UnTaza</value>
          </parameter>
        </parameters>
      </transformationSet>
    </transformationSets>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>net.sf.docbook</groupId>
      <artifactId>docbook-xsl-xalan</artifactId>
      <version>1.0.0</version>
    </dependency>
  </dependencies>
</plugin>

3. maven-antrun-plugin의 run 골을 실행하여, fop를 실행하여 앞에서 만들어진 fo 파일들을 처리하여 pdf를 만들어 낸다. 이 부분은 maven에서 ant 스크립트를 사용하는 전형적인 형태다. 예제에서는 pre-site 페이즈에 fop에 포함된 ant task를 사용하여 manual.fo를 처리하여 manual.pdf를 만든다(userconfig 속성를 통해 fop 설정 파일을 지정할 수 있다):

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-antrun-plugin</artifactId>
  <version>1.3</version>
  <dependencies>
    <dependency>
      <groupId>org.apache.xmlgraphics</groupId>
      <artifactId>fop</artifactId>
      <version>0.95-1</version>
    </dependency>
  </dependencies>
  <executions>
    <execution>
      <phase>pre-site</phase>
        <goals>
          <goal>run</goal>
        </goals>
      </execution>
    </executions>
  <configuration>
  <tasks>
    <echo message="processing docbook..." />
    <taskdef name="fop" classname="org.apache.fop.tools.anttasks.Fop">
    </taskdef>

    <fop

userconfig="src/docbook/fop-userconfig.xml"

format="application/pdf"

fofile="target/manual.fo"

outfile="target/manual.pdf" />

    </tasks>
  </configuration>
</plugin>

세삼 확인하게 되는 사실...

이런 류의 "절차적인" 삽질을 할때는 maven이 쥐약이라는 거...-,.-;;;