Re: Sect tags

[Karl Eichwalder <keichwa gmx net>]

Ali Abdin <aliabdin@aucegypt.edu> writes:

> Okay - apparently some people are writing docs with <sect> tags that do not
> have ideas. This is _EVIL_ :)
> 
> Lets just make this a rule starting now :) All <sect> tag's must have id's :)
> The reason is, gnome-db2html2 builds the Table of Contents from the <sect>
> tags - the 'links' are created through the sect-id's - If the id's do not
> exist, then the link just links back to the Table of Contents.

I'd recommend to add those contraints to the GNOME DTD customization;
inside the document you can do:

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!ENTITY % sect1.attlist          "IGNORE">
<!ENTITY % intermod.redecl.module "INCLUDE">
<!ENTITY % rdbmods SYSTEM         "gnome-ext.dtd">
<!ENTITY % local.sect1.attrib     "Id ID #REQUIRED">
<!--  ====>>>  ====>>>  ====>>>  ====>>> ^^^^^^^^^ -->
]>

And gnome-ext.dtd contains:

<!ATTLIST Sect1
		--
		Renderas: Indicates the format in which the heading should
		appear
		--
		Renderas	(Sect2
				|Sect3
				|Sect4
				|Sect5)		#IMPLIED
		%label.attrib;
		%status.attrib;
		
	%lang.attrib;
	%remap.attrib;
	--Role is included explicitly on each element--
	%xreflabel.attrib;
	%revisionflag.attrib;
	%effectivity.attrib;
	%local.common.attrib;
	%local.sect1.attrib;
>

-=-=-=-=-=-=-=-=-=-=-=-=-=- cut here -=-=-=-=-=-=-=-=-=-=-=-=-=-

This way the document remains 100% compatible with the official DocBook
DTD, but the parser is able to report missing ID attributes.

-- 
work : ke@suse.de                          |          ------    ,__o
     : http://www.suse.de/~ke/             |         ------   _-\_<,
home : keichwa@gmx.net                     |        ------   (*)/'(*)