Keith, I made an HTML and a PDF. Should I email them to your personal account? I believe attachments are stripped out on this list. Francis
On Mon, Jun 8, 2020 at 11:55 AM Keith N. McKenna <keith.mcke...@comcast.net> wrote: > Francis; > If you have some time try the XML file from this location > https://1drv.ms/f/s!AsMYmStvrJNJinVnnJWlYCHrxzmc just right click on the > XML file and chose download on the fly out menu. It is a draft of my > analysis document. Thanks for the work you are putting in on this. > > Regards > Keith > > On 6/8/2020 12:46 PM, F Campos Costero wrote: > > Looking at my first post, I should not have said "[not] even remotely > close > > to high quality material". Let me amend that to "definitely needs work". > > Francis > > > > On Mon, Jun 8, 2020 at 9:03 AM F Campos Costero <fjcc.apa...@gmail.com> > > wrote: > > > >> Keith, > >> I would not say it was a disappointing result at all. I am a complete > >> novice with DocBook and I have used XSL exactly one time before this. I > may > >> have committed any number of rookie mistakes. I was just playing with > the > >> tools to see what worked right away and what would need tweaking. > >> > >> I used both OpenOffice's Save As DocBook option and Pandoc's odt -> > >> DocBook option to make the xml version of the odt document > >> For html output, I used libxslt to translate the xml into html > >> For PDF output, I used libxslt to translate the xml into an fo file and > >> then I used Apache FOP to make a PDF from that. > >> > >> My test document was an OpenOffice Installation Guide I pulled off the > web. > >> > >> The biggest problem with the PDF was the placement of the table of > >> contents. It is at the top of the document before the title page and I > >> cannot move the dang thing. Just my ignorance I am sure. A couple of > the > >> figures are not well placed, the document title is formatted as regular > >> text and some links appear as the raw link instead as the desired text. > >> > >> The html also has the title misformatted, it has no table of contents at > >> all and it generally looks very bland. I am not sure whether the figures > >> were correctly included in my first try or if I had to fiddle with the > xml > >> content to get them to appear. > >> > >> If I were to continue along the DocBook path, I would redo my tests and > >> record carefully what worked and what needed adjustment. I held off on > that > >> because I did not want to waste time if you were to say that you found a > >> better solution than DocBook. My guess, a very ill informed one, is > that > >> neither the OpenOffice export nor Pandoc's odt -> DocBook process will > give > >> us perfectly formatted DocBook files but they will do a very large > fraction > >> of the work. Some manual editing will be needed but once we understand > what > >> that is, it will not be a big deal. Getting to that understanding may be > >> painful if no one knows DocBook any better than me. > >> > >> How is your knowledge of XSL? I can look at the code and guess what some > >> of it does but I cannot write anything myself. > >> > >> Francis > >> > >> On Mon, Jun 8, 2020 at 7:29 AM Keith N. McKenna < > keith.mcke...@comcast.net> > >> wrote: > >> > >>> On 6/7/2020 11:28 PM, F Campos Costero wrote: > >>>> Keith, > >>>> I have played with generating DocBook files from odt files and then > >>>> producing HTML or PDF from the DocBook. None of the output is even > >>> remotely > >>>> close to high quality material but I was pleased to get something > >>> readable. > >>>> Rather than spending more time on what may be a dead end, I will wait > >>> for > >>>> your summary of the project needs. > >>>> > >>>> Regards, > >>>> Francis > >>> > >>> Francis; > >>> > >>> This is indeed disappointing. Which of the XSL publishing tools did you > >>> use? I had been leaning towards using DocBook due to the ability to > >>> create multiple different formats. > >>> > >>> Regards > >>> Keith > >>> > >>>> > >>>> On Wed, Jun 3, 2020 at 7:11 AM Keith N. McKenna < > >>> keith.mcke...@comcast.net> > >>>> wrote: > >>>> > >>>>> On 5/30/2020 8:41 PM, Keith N. McKenna wrote: > >>>>>> I should probably have my head examined but I am thinking of one > more > >>>>>> time trying to revive the documentation effort for AOO. One of the > >>>>>> drawbacks is that most people that have started to help have left as > >>>>>> there has been very limited availability of mentoring. I do not see > >>> this > >>>>>> changing but I am hoping that by defining a new process we can > reduce > >>>>>> the dependency on mentoring. > >>>>>> > >>>>>> One idea for this would require that the MediaWiki extension be made > >>>>>> functional again. This would allow for using Writer to create the > >>> source > >>>>>> which could be stored in the git repository and then be transferred > to > >>>>>> the mwiki for easy online access. By storing the source in the > >>>>>> repository it would give us better revision control over the > >>>>>> documentation. Plus it may help relieve the mentoring problem as > many > >>>>>> more people are familiar with using Writer. > >>>>>> > >>>>>> Another would be to use Docbook, though this is not as appealing as > I > >>>>>> have no familiarity with it and it appears that there is a steep > >>>>>> learning curve to its use and that would be a disadvantage to > >>> attracting > >>>>>> new people. > >>>>>> > >>>>>> I look forward to any other suggestions that could move this effort > >>>>>> along as it has languished for far to long. > >>>>>> > >>>>>> Regards > >>>>>> Keith > >>>>>> > >>>>> AS part of this effort I am working on a document laying out What I > see > >>>>> as the need for this project and a number of alternatives that could > be > >>>>> used to to address those needs. Once completed I will share it both > >>> here > >>>>> and on doc@for more comments and suggestions. > >>>>> > >>>>> Thanks to all who have responded for there time and suggestions > >>>>> > >>>>> Regards > >>>>> Keith > >>>>> > >>>>> > >>> > >>> > >>> > > > > >
