Page 1 of 1
An error throwed when generating Webhelp Responsive
Posted: Thu Mar 28, 2024 11:09 am
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.
Re: An error throwed when generating Webhelp Responsive
Posted: Thu Mar 28, 2024 12:09 pm
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
Re: An error throwed when generating Webhelp Responsive
Posted: Wed Apr 03, 2024 4:28 am
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?
Re: An error throwed when generating Webhelp Responsive
Posted: Wed Apr 03, 2024 7:11 am
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
Re: An error throwed when generating Webhelp Responsive
Posted: Mon Apr 15, 2024 9:08 am
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.
Re: An error throwed when generating Webhelp Responsive
Posted: Thu Apr 25, 2024 9:30 am
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
Re: An error throwed when generating Webhelp Responsive
Posted: Wed May 08, 2024 1:27 pm
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?
Re: An error throwed when generating Webhelp Responsive
Posted: Thu May 09, 2024 10:54 am
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