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

[Mariano Montone]

El 11/3/25 a las 11:37, H. Hirzel escribió:
> Hi Mariano
>
> Thank you for answering and the screenshot in your other mail. 
> Exciting that Erudite has basic DocBook support! That will allow me to 
> display existing documentation in Cuis which I can get from markdown, 
> HTML, docx and texinfo sources using pandoc as a converter. I 
> encounter a few remaining glitches though:
>
> I loaded all the following:
>
> Feature require: 'Erudite'.
> Feature require: 'EruditeDocBook'.
> Feature require: 'EruditeExtensions'.
> Feature require: 'EruditeToolsExtensions'.
>
> Now I get a submenu 'Erudite' in the World menu which is more 
> populated. See the read function in my screen shot.
>
> The first 'read' three entries work well (see attachment).
>
> The fourth and the fifth no: It does not find the files 'guide.xml' 
> and 'book.xml'.

The TheCuisBook should have worked. It is loaded from paths in 
TheCuisBook>>initialize method.

Try evaluating the paths there and see what it gives you. Should point 
to the book in DocBook directory.

For the other book, you need to unzip defguide5.zip in DocBook directory.

>
> I downloaded
>
> https://github.com/Cuis-Smalltalk/Erudite/blob/master/DocBook/book.xml
>
> and ch01.xml, ch02.xml, ch03.cml
>
> and put them into my 
> C:\Users\Hirzel\Documents\Cuis-Smalltalk-7061-UserFiles but it still 
> did not find it.
>
> My questions:
>
> 1) Where do I get 'guide.xml' and 'book.xml'?
>
> 2) Where do I need to put them?
It is determined by the EruditeBook class. Look at 
TheCuisBook>>initialize and DocBookDefinitiveGuide>>initialize.
>
> 3) What determines what appears in the 'Read' menu?

Uses EruditeBook subclasses. Look at EruditeBook class>>bookList

Expect glitches. Erudite only works with a particular DocBook format but 
I don't remember the details. I will experiment with exporting some 
documents to DocBook using pandoc and see how to load them in Erudite.


           Mariano