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

[H. Hirzel]

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.

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.*

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/7ce2e178/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: MorphicEruditeDocRenderer__renderCode_Trace.gif
Type: image/gif
Size: 313670 bytes
Desc: not available
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20250313/7ce2e178/attachment-0001.gif>