GNOME Bugzilla – Bug 157789
Add UI for RELAX NG->documentation converter
Last modified: 2017-12-22 12:47:46 UTC
See http://www.techquila.com/rng-tools.html
I'm not sure what I had in mind when I filed this bug back in November. What should the user interface be? When working with a RELAX NG schema we could add an "Export to DocBook" feature, though since you'd want to do the documentation in one place it makes more sense to skip DocBook and go direct to the outputs from DocBook i.e. "Export as HTML", "Export as PDF", "Print" and "Print Preview". These would run the scripts to convert to DcoBook, then convert the DocBook accordingly (hiding the fact that docbook is in use). The other thing to do would be to have an "Export as SVG" option. The first thing to do is to try the scripts on that page (RNG->DocBook, and RNG->SVG) However I've only tried the RNG->SVG script, and I had some problems with it: (i) I hacked it into a GNU Make-friendly syntax (ii) none of the SVG renderers I has could cope with the output from the script. I reportedit for librsvg as bug 157815. Unfortunately the librsvg doesn't seem too willing to that himself at the moment, so we'd have to do it I guess.
So this would go in "Export..." in the File menu? I think the user interface should be a bit like the export feature of OpenOffice.org writer : a browser to choose where to save the exported file, a "name of the file" field and another field to choose the type of file we want. That's the way I would see it. Correct me if that's not really what we need.
I can agree with that approach, but I think it is more wise to use code from Conglomerate. See the current export functions, especial the PDF exporter, it has some extra input field ( "pick list" and "open value" ) The open value field is the User Interface that is needed to provide the parameters to the rng-doc.xsl ( 'title', 'default.documentation.string', 'intro' & 'target' )
Removing gnome-love keyword from all conglomerate bugs, since the module is not currently actively developed.
Conglomerate is not under active development anymore. It is currently unlikely that there will be any further Conglomerate development. Closing this report as WONTFIX as part of Bugzilla Housekeeping (bug 685689) to reflect reality. Please feel free to reopen this bug report in the future if anyone takes the responsibility for active development again.