Skip to content

Transfer more information from Confluence import data to DITA to allow powerfull custom XSLT post processing #56

Description

@SanFanDocu

It seems, there is no way to customize the Confluence to DITA import.
Maybe it would be possible to pass more information to the DITA output.
This would help to develop custom XSLT post processing.

Todo

  • Pass div elements from HTML to DITA.
  • Translate span elements into e.g. data or unknown elements
  • Transform @Class attributes into e.g. @base in DITA.

Here is an example of a Confluence export HTML fragment containig a notice block:

     <div class="confluence-information-macro confluence-information-macro-note">
              <span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span>
              <div class="confluence-information-macro-body">
                    <p>Service may only be carried out by technicians trained by manufacturer!</p>
               </div>
      </div>        

the current generated DITA output looks like this

      <p>Service may only be carried out by technicians trained by manufacturer!</p>

if the importer would keep as much information, structure and metadata as possible like the following...

      <div base="confluence-information-macro confluence-information-macro-note">
                 <unknown base="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></unknown>
                  <div base="confluence-information-macro-body">
                        <p>Service may only be carried out by technicians trained by manufacturer!</p>
                  </div>
      </div>

... the customer has all information required to build a individual XSLT post processing output like this:

     <note type="warning">
              <p>Service may only be carried out by technicians trained by manufacturer!</p>   
     </note>                                   

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions