[publican-list] Publican Tools to organise Chapters and sections names automatically
David O'Brien
daobrien at redhat.com
Mon Aug 18 14:27:36 UTC 2014
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
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
> <fred.itfm at gmail.com> 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 <jfearn at redhat.com>
>> 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 publican-list at redhat.com
>>> https://www.redhat.com/mailman/listinfo/publican-list Wiki:
>>> https://fedorahosted.org/publican
>>>
>>
>>
>
>
>
> _______________________________________________ publican-list
> mailing list publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list Wiki:
> https://fedorahosted.org/publican
>
- --
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.14 (GNU/Linux)
iQEcBAEBAgAGBQJT8g1YAAoJEDpAHQqWGp+3yzYH/3LGQ7tLEr3alqpbOiGI00Le
rkfcVfXtgXBCiVbUn5Qr5FqtiVUpe7oIWluCOzrvcYoccSbYdGzKTAC7mfVV0vfv
2MknWRqi5D6DYiEJElrYEycEXqZNiim5V4CrZ2vROvCFkg8Io+Z7WxX298qFTSKX
4oBbNqnkMNZUbyprjFcLcChae9bar4ARaA74dHYCLcBL0yWLhKrbqmBzv2J4JQAb
vIona2PYnzhiSo+Drm9DyFUSYUK7cnLMlCpEh3FZ5DedpJKMBvlv3KBNzw+OWFen
LnOsVHX82nzVqZILUV/vn9pboNt9t0D9CXpZOFEeVVX8bBkEzUTuK5/8V6Llx+A=
=hPPw
-----END PGP SIGNATURE-----
More information about the publican-list
mailing list