[publican-list] Publican Tools to organise Chapters and sections names automatically

Mon Aug 18 22:33:57 UTC 2014

-----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
> <daobrien at redhat.com> 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 
>>>> <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
>>>> 
> 
> 
>> 
>> _______________________________________________ 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)

iQEcBAEBAgAGBQJT8n9VAAoJEDpAHQqWGp+3OMQIAOEQTZINuwNf6vtWTIkH/2St
xCIM4nBoIzVblmI8IoKUUWcrckhy37puJXqFjnZOyNNCqXBt60mJwCqxosej0gWA
gbzKMWB1bgmXkLHZfHn3XZSA3CXlJDIkSgbIZJAMmbqcnpv5HHlsQnEP3ygTX+EF
5wnY+a/20W7kRmEJ0GHJ9dIoIQirsnbL4Asw/sIhTdmGjT2wkCStd320G0MGfKU/
fty1PzP9wDtdB3iH/OANPgwAdEnXrlo+yaAx0wvDb8PNYS4a2AlPumZO1S8nO5uv
W4r7H9fapQ/BwSNRCd/4uZjk0pwBhd5YKnHzeLD8h4t42gCZ1a2hogt3FQRndaI=
=/fMt
-----END PGP SIGNATURE-----