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

Mariano Montone marianomontone at gmail.com
Thu Mar 13 14:06:18 PDT 2025


Hi Hannes,

El 13/3/25 a las 17:58, H. Hirzel escribió:
>
> Hi Mariano
>
> I think I can live with the fact that storing imported DocBook XML 
> files as Smalltalk code is not implemented. It is fine that the XML 
> files are external.
>
I don't think it would be hard to implement. I'll have a look soon.
>
> With your new updates from yesterday -- proper rendering of bullet 
> lists and ordered lists -- the Docbook features supported are useful 
> for my purposes.
>
> But one thing is currently a show stopper when using it for program 
> documentation:
>
> *Program listing code can not be selected and copied.*
>
*Ok. I'll have a look.*
>
> The Docbook XML snippet
>
> <programlisting>
> pandoc -f markdown -t docbook MyDocBookTest1.md -o MyDocBookTest1.xml
> </programlisting>
>
> is rendered in a way that the code content can not be used without 
> retyping it.
>
> 1. A first solution would be to just set the attribute that the text 
> an be selected.
>
> 2. A better solution would be to have a 'copy' button which copies the 
> content to the clipboard.
>
> 3. And a third solution would be to also have some 'guessing strategy' 
> if the code is Smalltalk and then add a 'do it' button. For example if 
> the code ends with a full stop. Or just add both buttons so that the 
> user needs to decide.
>
> For the moment number 1 would be just fine. The attached debugger 
> window shows MorphicEruditeDocRenderer>>visitCode: aDocCode.
>
> I do not see where it  happens that the text can not be selected and 
> how that might be fixed.
>
> Kind regards
>
> Hannes
>
>
>
> On 12/03/2025 1:53 pm, Mariano Montone wrote:
>> Hi Hannes,
>>
>> El 12/3/25 a las 06:19, H. Hirzel escribió:
>>> Your example with the two attached files, one being the book 
>>> definition is very illustrative.
>>>
>>> <book xmlns='http://docbook.org/ns/docbook'
>>>       xmlns:xi='http://www.w3.org/2001/XInclude'
>>>       xml:id="docbook">
>>>   <xi:include href="CuisREADME.docbook"/>
>>> </book>
>>>
>>> It means I need to create an individual DocBook file for each 
>>> Erudite section (containing also a DocBook section which pandoc 
>>> creates by default) and bind them together with the book.xml file. 
>>> This is very doable.
>> Correct.
>>>
>>> There is a problem which I guess is easy to fix:  after choosing 
>>> 'store' for the imported book I get
>>>
>>>  EruditeBookStorer >> store
>>>
>>>  self subclassResponsibility
>>
>> It should be easy, but I haven't implemented it yet :|
>>
>>    Mariano
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20250313/3303c30e/attachment.htm>


More information about the Cuis-dev mailing list