An error throwed when generating Webhelp Responsive

Having trouble installing Oxygen XML WebHelp? Got a bug to report? Post it all here.
felixliu
Posts: 24
Joined: Thu Jun 09, 2022 11:04 am

An error throwed when generating Webhelp Responsive

Post by 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
Posts: 837
Joined: Mon Dec 05, 2011 6:04 pm

Re: An error throwed when generating Webhelp Responsive

Post by 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
Costin Sandoi
oXygen XML Editor and Author Support
felixliu
Posts: 24
Joined: Thu Jun 09, 2022 11:04 am

Re: An error throwed when generating Webhelp Responsive

Post by 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
Posts: 9092
Joined: Fri Jul 09, 2004 5:18 pm

Re: An error throwed when generating Webhelp Responsive

Post by 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
felixliu
Posts: 24
Joined: Thu Jun 09, 2022 11:04 am

Re: An error throwed when generating Webhelp Responsive

Post by felixliu »

Radu wrote: Wed Apr 03, 2024 7:11 am 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
Posts: 520
Joined: Wed Oct 16, 2019 3:47 pm

Re: An error throwed when generating Webhelp Responsive

Post by 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
Posts: 24
Joined: Thu Jun 09, 2022 11:04 am

Re: An error throwed when generating Webhelp Responsive

Post by felixliu »

julien_lacour wrote: Thu Apr 25, 2024 9:30 am 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
Posts: 520
Joined: Wed Oct 16, 2019 3:47 pm

Re: An error throwed when generating Webhelp Responsive

Post by 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
Post Reply