[Cuis-dev] Erudite Help file system for Cuis -> Can it read Docbook files? PetitParser version?

[Mariano Montone]

El 12/3/25 a las 12:00, H. Hirzel escribió:
> On 11/03/2025 3:28 pm, Mariano Montone via Cuis-dev wrote:
>
>> Btw, last time I looked at DocBook, I didn't find it extensible the 
>> way I would have liked.
>>
>> In my opinion, we should have an XML standard that is easily 
>> extensible, and that completely separates semantic elements from its 
>> rendering.
>>
>> That would make it possible to manipulate documents and extract 
>> information from them in a powerful way, without losing information. 
>> And also render the documents for different mediums in a correct way.
>>
>> I don't understand why there's not something like that. I don't think 
>> DocBook is that, but it should have been.
> Could you please elaborate on this? For my purposes it seems to be 
> good enough. Or do you specifically mean the handling of the embedded 
> code expressions?

When I checked, DocBook schemas were not good enough for what I wanted. 
What I have in mind is extensible document elements, and the book 
pointing to needed extensions.

Let's say you want a book that shows Smalltalk code and also display 
plots, then you could have something like this:

<book>
    <schemas>
       <schema src="smalltalk.schema"/>
       <schema src="plots.schema"/>
    </schemas>
    <section title="My section">
        <smalltalk>
            Object inspect
        </smalltalk>
        <plot> ... </plot>
    </section>
</book>

with smalltalk and plot elements specified in the schemas, and they can 
be specified via inheritance, smalltalk element inheriting from code 
element, etc.

I think DocBook schemas supports this to some extent, but they are 
either too complicated, or they don't support inheritance, or I am wrong.

>>
>> That's what XMLEruditeBook is about.
>
> I have seen the start of that class in the code. It uses HTML code. 
> This is good if applied in a structured way. It is a huge standard an 
> may be adapted in may ways to suit a specific purpose. Do you have 
> plans to contine to work on this?

I would like to if I think the result may be valuable.

     Mariano
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20250312/7230a437/attachment-0001.htm>