Uploaded image for project: 'Lustre Documentation'
  1. Lustre Documentation
  2. LUDOC-321

Operations manual PDF does not build if 2+ chapters have condition fields

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • Blocker
    • None
    • None
    • None
    • CentOS 6.7, fop-1.0-1.0.1.wc1.x86_64, xmlgraphics-commons-1.4-3.noarch, cloned copy of git://git.whamcloud.com/doc/manual
    • 3
    • 9223372036854775807

    Description

      When two or more chapters have a condition field in their XML chapter tag, the PDF version of the manual will not build. The error which results from make pdf (fop output) is:

      org.apache.fop.apps.FOPException: org.apache.fop.fo.ValidationException: Property ID "$" (found on "fo:block-container") previously used; ID values must be unique within a document!
      

      The reason for this error seems to be line 113 in style/customstyle_fo.xsl, which sets id to "${chunkid}" instead of "{$chunkid}". That results in a single "$" being inserted instead of the proper id. As long as only one chapter with a condition field exists, there is no conflict. Once the second chapter with a condition is added, the conflict over "$" results.

      After making this fix, there still is some duplication because of a duplicate block ID. Removing the "id={$id}" on line 123 in style/customstyle_fo.xsl appears to fix this and permits the PDF to build cleanly, but I don't know if there are any side effects.

      To duplicate this error, a condition must be added to another chapter in the manual. Currently, HSM (chapter 22) is the only chapter with a condition. This issue was discovered when creating a new chapter targeted at Lustre 2.9. An example of the error occurring in the build environment can be found at:

      https://build.hpdd.intel.com/job/lustre-manual-reviews/628/console

      Let me know if you need any more details.

      Attachments

        Issue Links

          Activity

            People

              rhenwood Richard Henwood (Inactive)
              hannac Chris Hanna (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: