[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