Re: Call for help about html_css doc pages

Mark Wiesemann a écrit :
> Laurent Laville wrote:
>> Mark Wiesemann a écrit :
>>> Hi Laurent,
>>>
>>> Laurent Laville wrote:
>>>> As you've perharps noticed, I tried to include (following PEAR 
>>>> manual standard/examples) html_css doc, but there are still few errors
>>>>
>>>> See : http://peardoc.m-takagi.org/en/build.log
>>> Didn't you read my commit message? You'll "simply" have to change two
>>> files (in which you aren't following the examples). If you correct the
>>> nesting of your files, the error (it's basically only one that occurs
>>> multiple times) should be gone.
>>>
>>
>> Mark,
>>
>> Sorry but I don't understand. I've followed html quickform example 
>> which   seems to be equal than html css, but don't use the
>>
>> <?xml version="1.0" encoding="iso-8859-1" ?>
>>
>> you've added on previous commit.
>
> That's not the problem here. (I thought that this line would be 
> missing, but I was wrong. It doesn't hurt to have it.)
>
> There are two problems:
>
> (1) In html-css.xml you have these two lines inside the <sect2> tag:
>   &package.html.html-css.faq;
>   &package.html.html-css.whatsnew;
>
> If you put these two "references" into another <sect3> tag, the first 
> errors are gone. (Note: The refs to "...api;" and "...errorhandler;" 
> are fine. The system only doesn't like the combination of <sect2> and 
> <sect3>.)
>
Curious, because html_quickform used syntax like

....

&package.html.html-quickform.html-quickform.setmaxfilesize;
&package.html.html-quickform.html-quickform.updateelementattr;
 </sect2>

 <sect2 id="package.html.html-quickform.elements">
  <title>Classes representing form elements</title>
  <para>
To be written
  </para>
  <sect3 id="package.html.html-quickform.elements.base">
    <title>Base classes</title>
&package.html.html-quickform.html-quickform-element;
&package.html.html-quickform.html-quickform-element.html-quickform-element;
&package.html.html-quickform.html-quickform-element.accept;
&package.html.html-quickform.html-quickform-element.apiversion;

...

&package.html.html-quickform.html-quickform-input.settype;
  </sect3>

Where are difference from mine ? I'm not myself a DockBook expert, but 
here I really don't understand what 's wrong !

> (2) api.xml won't work in the current way. References to e.g. 
> &package.html.html-css.html-css.html-css; are not allowed inside 
> <refsect1>. I'm not a Docbook expert but I guess that you'll need to 
> follow the example of html-css.xml (using <sect*>).
>
Ok here it's my fault !
Because I've changed from my previous implementation with chapter and 
section  TO  refsect
refentry allow only parents as defined by   
http://www.docbook.org/tdg/en/html/refentry.html#d0e153142

> Regards,
> Mark
>
Thanks Mark