Uploaded image for project: 'jboss.org'
  1. jboss.org
  2. ORG-1232

Confluence export escaping special characters problematically.

    XMLWordPrintable

Details

    Description

      When exporting from docs.jboss to docbook, the escaping of special characters is currently problematic.

      The following issues have been encountered:

      • Extracted code samples are wrapped in a cdata tag. The angle-brackets in the cdata tag are then escaped, resulting in <![CDATA[. Build systems then render the tag as visible code rather than reading it as valid markup.
      • Instances of ampersand characters in URLs in code fragments are being converted to entities and then rendered by the build system in their escaped form, breaking the validity of the URL. Ampersand characters inside code samples need to be excluded from escaping rules (provided a cdata tag is being inserted) In most instances, this problem could probably be avoided by not putting URLs in code fragments, but there may be times when it's necessary.

      Attachments

        Activity

          People

            velias@redhat.com Vlastimil Eliáš
            smumford_jira Scott Thomas (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: