-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 08/19/2014 01:30 AM, Frederic Monestel wrote: > One more question, please, > > What editors do DTD validation? And what editor would you > recommend to write Publican Docbook materials?
That's close to being one of those "which distro is best?" questions :-) I use Kate on Fedora with xml plug-ins. I know vi and Emacs have similar capabilities. Some ppl I know use Oxygen. Best bet would be to google, try a few, and find something that you like and that works for you. Good luck~! David > > Many thanks for your help and keep up the good work! > > Fred > > > > On Mon, Aug 18, 2014 at 4:27 PM, David O'Brien > <[email protected]> wrote: > > Fred, > > A couple of different error types there: > > 1. ID chap-linux_book-Test_Chapter already defined > > Errors like that mean you have more than one ID of the same value > in the same book. IDs need to be unique. > > 2. Element listitem content does not follow the DTD > > Errors like that mean you haven't provided valid content for the > xml tags that you've used. The most telling part of the message is > often at the end, in this case "got ()" which means you used a > <listitem> tag but didn't put anything in it. > > To fix 1. you need to track down all your IDs and make sure they're > unique. For my own part, I use "publican clean_ids" but that's > quite invasive and not for everybody. It does, however, ensure all > your IDs are unique (at least, it hasn't failed me). Read the doc > before you use it, and maybe test on a backup copy. > > To fix 2. you need to make sure you use valid content in all your > elements. Some editors can help with that if they do DTD > validation for you. > > Hope this helps David > > On 08/18/2014 11:10 PM, Frederic Monestel wrote: >>>> Thanks very much for this precision Jeff, >>>> >>>> Here you go this is the errors I have, after: publican build >>>> --formats=html --langs=en-US >>>> >>>> Many thanks for your help and kind regards, >>>> >>>> Fred >>>> >>>> Beginning work on en-US DTD Validation failed for >>>> '/home/fred/Documents/IT/linux_book/tmp/en-US/xml/linux_book.xml': >>>> >>>> >>>> Chap_airport.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_airport.xml:16: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_Debian.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_Debian.xml:19: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_Debian.xml:111: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_Fedora.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_Fedora.xml:13: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_compil_stellarium.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_compil_stellarium.xml:13: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_compil_stellarium.xml:21: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_compil_stellarium.xml:32: validity error : Element >>>> listitem content does not follow the DTD, expecting >>>> (calloutlist | glosslist | bibliolist | itemizedlist | >>>> orderedlist | segmentedlist | simplelist | variablelist | >>>> caution | important | note | tip | warning | literallayout | >>>> programlisting | programlistingco | screen | screenco | >>>> screenshot | synopsis | cmdsynopsis | funcsynopsis | >>>> classsynopsis | fieldsynopsis | constructorsynopsis | >>>> destructorsynopsis | methodsynopsis | formalpara | para | >>>> simpara | address | blockquote | graphic | graphicco | >>>> mediaobject | mediaobjectco | informalequation | >>>> informalexample | informalfigure | informaltable | equation >>>> | example | figure | table | msgset | procedure | sidebar | >>>> qandaset | task | anchor | bridgehead | remark | highlights >>>> | abstract | authorblurb | epigraph | indexterm | >>>> beginpage)+, got () Chap_lenovo_Q180.xml:8: validity error : >>>> ID chap-linux_book-Test_Chapter already defined >>>> Chap_lenovo_Q180.xml:13: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_lenovo_Q180.xml:21: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_audio_vids_conversion.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_audio_vids_conversion.xml:76: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_audio_vids_conversion.xml:138: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_publican_docbook_serna.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_publican_docbook_serna.xml:25: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_publican_docbook_serna.xml:76: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> Chap_sh_backup.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_sh_backup.xml:25: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_bash.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_bash.xml:13: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_Clean_install.xml:8: validity error : ID >>>> chap-linux_book-Test_Chapter already defined >>>> Chap_Clean_install.xml:13: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>> Chap_Clean_install.xml:230: validity error : ID >>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>> >>>> >>>> On Mon, Aug 18, 2014 at 3:09 PM, Frederic Monestel >>>> <[email protected]> wrote: >>>> >>>>> Thanks very much for this precision Jeff, >>>>> >>>>> Here you go this is the errors, I have: >>>>> >>>>> Many thanks for your help and kind regards, >>>>> >>>>> Fred >>>>> >>>>> Beginning work on en-US DTD Validation failed for >>>>> '/home/fred/Documents/IT/linux_book/tmp/en-US/xml/linux_book.xml': >>>>> >>>>> >>>>> Chap_airport.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_airport.xml:16: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_Debian.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_Debian.xml:19: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already >>>>> defined Chap_Debian.xml:111: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>>> Chap_Fedora.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_Fedora.xml:13: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already >>>>> defined Chap_compil_stellarium.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_compil_stellarium.xml:13: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_compil_stellarium.xml:21: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>>> Chap_compil_stellarium.xml:32: validity error : Element >>>>> listitem content does not follow the DTD, expecting >>>>> (calloutlist | glosslist | bibliolist | itemizedlist | >>>>> orderedlist | segmentedlist | simplelist | variablelist | >>>>> caution | important | note | tip | warning | literallayout >>>>> | programlisting | programlistingco | screen | screenco | >>>>> screenshot | synopsis | cmdsynopsis | funcsynopsis | >>>>> classsynopsis | fieldsynopsis | constructorsynopsis | >>>>> destructorsynopsis | methodsynopsis | formalpara | para | >>>>> simpara | address | blockquote | graphic | graphicco | >>>>> mediaobject | mediaobjectco | informalequation | >>>>> informalexample | informalfigure | informaltable | >>>>> equation | example | figure | table | msgset | procedure | >>>>> sidebar | qandaset | task | anchor | bridgehead | remark | >>>>> highlights | abstract | authorblurb | epigraph | indexterm >>>>> | beginpage)+, got () Chap_lenovo_Q180.xml:8: validity >>>>> error : ID chap-linux_book-Test_Chapter already defined >>>>> Chap_lenovo_Q180.xml:13: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_lenovo_Q180.xml:21: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>>> Chap_audio_vids_conversion.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_audio_vids_conversion.xml:76: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_audio_vids_conversion.xml:138: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>>> Chap_publican_docbook_serna.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_publican_docbook_serna.xml:25: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_publican_docbook_serna.xml:76: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already defined >>>>> Chap_sh_backup.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_sh_backup.xml:25: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_bash.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_bash.xml:13: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_Clean_install.xml:8: validity error : ID >>>>> chap-linux_book-Test_Chapter already defined >>>>> Chap_Clean_install.xml:13: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_1 already defined >>>>> Chap_Clean_install.xml:230: validity error : ID >>>>> sect-linux_book-Test_Chapter-Test_Section_2 already >>>>> defined >>>>> >>>>> >>>>> >>>>> On Mon, Aug 18, 2014 at 12:32 AM, Jeff Fearn >>>>> <[email protected]> wrote: >>>>> >>>>>> On 08/17/2014 08:50 PM, Frederic Monestel wrote: >>>>>>> i mean that the book can be built and does not generate >>>>>>> errors while >>>>>> you do publican build. i believe i have to modify all >>>>>> ids and relate them to the file names, chapters and >>>>>> sections names. >>>>>> >>>>>> You do not have to set IDs. If an ID is not set then a >>>>>> random ID is created during the build process. >>>>>> >>>>>> If you are having build issues it is unlikely to be >>>>>> related to the lack of ID. >>>>>> >>>>>> If you include the errors we could help debug your >>>>>> issue. >>>>>> >>>>>> Cheers, Jeff. >>>>>> >>>>>> -- Jeff Fearn Senior Software Engineer GSS Subscriber >>>>>> Platform Red Hat Pty Ltd >>>>>> >>>>>> _______________________________________________ >>>>>> publican-list mailing list [email protected] >>>>>> https://www.redhat.com/mailman/listinfo/publican-list >>>>>> Wiki: https://fedorahosted.org/publican >>>>>> >>>>> >>>>> >>>> >>>> >>>> >>>> _______________________________________________ publican-list >>>> mailing list [email protected] >>>> https://www.redhat.com/mailman/listinfo/publican-list Wiki: >>>> https://fedorahosted.org/publican >>>> > > >> >> _______________________________________________ publican-list >> mailing list [email protected] >> https://www.redhat.com/mailman/listinfo/publican-list Wiki: >> https://fedorahosted.org/publican >> > - -- David -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.14 (GNU/Linux) iQEcBAEBAgAGBQJT8n9VAAoJEDpAHQqWGp+3OMQIAOEQTZINuwNf6vtWTIkH/2St xCIM4nBoIzVblmI8IoKUUWcrckhy37puJXqFjnZOyNNCqXBt60mJwCqxosej0gWA gbzKMWB1bgmXkLHZfHn3XZSA3CXlJDIkSgbIZJAMmbqcnpv5HHlsQnEP3ygTX+EF 5wnY+a/20W7kRmEJ0GHJ9dIoIQirsnbL4Asw/sIhTdmGjT2wkCStd320G0MGfKU/ fty1PzP9wDtdB3iH/OANPgwAdEnXrlo+yaAx0wvDb8PNYS4a2AlPumZO1S8nO5uv W4r7H9fapQ/BwSNRCd/4uZjk0pwBhd5YKnHzeLD8h4t42gCZ1a2hogt3FQRndaI= =/fMt -----END PGP SIGNATURE----- _______________________________________________ publican-list mailing list [email protected] https://www.redhat.com/mailman/listinfo/publican-list Wiki: https://fedorahosted.org/publican
