Keith, I understand you may be busy with other things. Did you get the documents I sent? I would be interested to hear your thoughts on how to proceed. Francis
On Mon, Jun 8, 2020 at 1:34 PM Keith N. McKenna <keith.mcke...@comcast.net> wrote: > On 6/8/2020 3:17 PM, F Campos Costero wrote: > > 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 > > > Francis; > > You can e-mail them to my private account. Thank you very much for your > help. > > Keith > > > > 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 > >>>>>>> > >>>>>>> > >>>>> > >>>>> > >>>>> > >> > >> > >> > >> > >> > > >
