Hello support team, hello Oxygen users,

 

I am trying to set up a WebHelp Responsive transformation for a DITA project.

My first step was to set up the output options (see Fig. 1 below).

The transformation completes successfully.

When I click on “index.html”, the main window opens and looks as expected.

However, none of the links to the topics work. They all produce an “Error. File not found” message.

The directory where the HTML files reside differs from that where they are searched for.

 

Examples:

File resides under C:\CGS\DOKU\DITA_projects\0000_recent\build\out\ctuner\help\enu\enu\shared-ctun\task\

 

In addition, the transformation results window logs “.... resource is outside the scope of the input directory” messages for many DITA files.

I have set the “outer.control” parameter to “warn”.

 

Maybe Oxygen does not like the directory structure of my DITA source files? It is as follows:

 

build

    sources

        common (language-independent files)

             images

        enu (English files)

            ctuner (location of DITA root map and Oxygen project)

                 concept (DITA files referenced by maps)

                 reference

                 reuse

                 task

                 images

           shared-ctun (DITA files shared with another project)

                 concept

                 reference

                 reuse

                 task

                 images

          shared (DITA files shared many other projects)

                 concept

                 reference

                 reuse

                 task

                 images

       out

            ctuner

                 help (for WebHelp Responsive)

                       enu (English version)

                     

There are many DITA projects in this folder tree, so changing the structure of the “source” folder is not an option. Restructuring the “out” folder is possible.

How can I instruct Oxygen to generate the files in the appropriate folders so that the links in the main window get resolved?

 

Previously, I generated CHM files from the project. Knowing that CHM does not support “..\” links, I generated it from the “sources” top-level directory.

But I thought, modern help formats support links to folders which are parallel to or on a higher level than the root ditamap being processed. Not true???

        

Any help is greatly appreciated.

 

Regards,

Frank

 

 

Fig. 1

 

 

Freundliche Grüße | Best regards

Frank Dissinger

Documentation Manager

..........................................

CGS ORIS GmbH

Email frank.dissinger@cgs-oris.com | Web www.cgs-oris.com

Address Kettelerstrasse 24 | 63512 Hainburg | Germany

Phone +49 6182 9626-0 | Fax +49 6182 9626-99

Commercial register Offenbach, HRB no. 21495

Managing directors Bernd Rückert, Christoph Thommessen, Kunio Muraji