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 >>>>>>> >>>>>>> >>>>> >>>>> >>>>> >> >> >> >> >>
signature.asc
Description: OpenPGP digital signature
