An error throwed when generating Webhelp Responsive

[felixliu]

Hi, when generating Webhelp Responsive files, an error of "content is not allowed in prolog" is displayed. I clicked the error message, and it directs to the ditamap file. I cannot figure out what is wrong here, and the generated Webhelp Responsive files look just fine. Should I overlook that error or is there any way to solve it?
Thanks in advance.

[Costin]

Hi felixliu,

In case there are elements whose syntax is not correct in one of the files in your DITA Map, the "content is not allowed in prolog" error may be thrown.
It is recommended to open the DITA Map in the DITA Maps Manager view and validate it by running the "Validate and Check for Completeness" action on the map, to identify any potential issues withing the DITA Map, prior to running the WebHelp Responsive transformation scenario.
If there are validation errors, you should first debug / fix them then retry publishing the documentation to WebHelp, see if this error occurs anymore.

Kind Regards,
Costin

[felixliu]

Hi Costin,
Thanks for your support. I clicked the "Validate and Check for Completeness" button and no issue found.
BTW, such error occurs right after the upgrade of version 26.1, build 2024031806. I'm not sure if there are any new software-level rules added to the WebHelp transformation process that could possibly lead to the error?

[Radu]

Hi,

We know about this problem and it's registered to be resolved in our system.
This is a benign problem which should be ignored by you for now. We will work on our side to make some fixes in order to avoid presenting this message to our users.
More details: When using a WebHelp publishing template with parameter values which may contain HTML content, sometimes our publishing task attempt to convert the HTML content to wellformed XML and if they fail to do so, they issue this message and then fallback to other useful ways of interpreting the parameter value. In Oxygen version 26.0 and older this message was also reported in the DITA OT console output but since Oxygen 26.1 we started to gather and present such messages also in the "Transformation problems" list, so the message became more visible to you but it was issued in the logging console also in the past releases of Oxygen.
We will notify you on this thread when an Oxygen release which no longer reports this problem is available.

Regards,
Radu

[felixliu]

Hi,

We know about this problem and it's registered to be resolved in our system.
This is a benign problem which should be ignored by you for now. We will work on our side to make some fixes in order to avoid presenting this message to our users.
More details: When using a WebHelp publishing template with parameter values which may contain HTML content, sometimes our publishing task attempt to convert the HTML content to wellformed XML and if they fail to do so, they issue this message and then fallback to other useful ways of interpreting the parameter value. In Oxygen version 26.0 and older this message was also reported in the DITA OT console output but since Oxygen 26.1 we started to gather and present such messages also in the "Transformation problems" list, so the message became more visible to you but it was issued in the logging console also in the past releases of Oxygen.
We will notify you on this thread when an Oxygen release which no longer reports this problem is available.

Regards,
Radu

Got it. Thanks for your help.

[julien_lacour]

Hello,

A new maintenance build for Oxygen 26.1 is available on our website, in this build the "[Fatal Error] :1:1: Content is not allowed in prolog." error will not be displayed anymore in WebHelp Responsive transformation.

Regards,
Julien

[felixliu]

Hello,

A new maintenance build for Oxygen 26.1 is available on our website, in this build the "[Fatal Error] :1:1: Content is not allowed in prolog." error will not be displayed anymore in WebHelp Responsive transformation.

Regards,
Julien

Thanks for the information.
I have another question. When applying the transformation scenario, how can I generate only one chapter's content of several chapters?
For example, there are chapter A, B, and C in my ditamap. How can I just generate webhelp responsive only for chapter A and all the content under it?

[julien_lacour]

Hello,

If you want to transform the chapters separately, you need to have a ditamap for each of them.
You can have as many ditamaps as necessary in your structure, for example:

Code: Select all

Userguide.ditamap
  Chapter_A.ditamap
  Chapter_B.ditamap
  Chapter_C.ditamap
  etc.

Also, as a side note, when asking questions that are not related with the thread subject, the best practice is either to search the forum for a similar subject or to create a new thread. As it is unrelated other user with the same question will have difficulties to find the answers.

Regards,
Julien