On 12/6/2011 8:24 AM, Kent A. Reed wrote: > Gentle persons: > > I know dealing with the V2.5 documentation issues is like being > subjected to water torture, but they're still with us. > > Concerning the HTML style, here's some issues that came to mind as I > compared just one section, Kinematics, between V2.4 > (motion_kinematics.html) and V2.5 (motion/kinematics.html). > > 1. the lack of navigation links "up", "next", and "previous" (if not the > first) at the top of the documents. Francis touched on this recently. > The new style does not provide for their use so whether or not we are > generating the cross references file is moot. The navigation links were being generated from the lyx documents so until we can come up with a way to do the same from the txt files those are gone. > > 2. each HTML document has its own table of contents section at the > beginning---which isn't being generated, at least in the Kinematics > document, there's just the place keeper text "table of contents"---but > no list of figures section, and no index section at the end. Truthfully, > I never found the list of figures or index very useful, but I don't > remember any discussion whether to continue using them. I'll look into that one... actually looking for that I see a few that are borked. > > 3. The markup for footnotes is not being acted on properly. The material > is rendered at the place it occurs instead than being placed in a > footnotes section at the end of the document and linked to from the text. > > 3. there are defects in the new presentation style---presumably defined > in one or more .css files. > > 3a. "class=mathblock" sections are not centered on the page > > 3b. "class=literalblock" sections are not indented > > 3c. "class=imageblock" sections are not centered on the page as they > should for figure placement, at least. > > 3d. "class=title" sections are not centered on the page, as they should > be for figure captions, at least. > > 3e. tt (teletype) font is not displayed as tt font > > 4. the document numbering style has changed. In V2.4, this Kinematics > document itself was 1., its Introduction was 1.1, etc. In V2.5, the > introduction is 1., etc. I'm fine with this but it's a change. > > 5. And, of course, the problems of latexmath I identified previously. In > addition to the awkward alignment of the latexmath png files, there are > places where associated text is being lost. See, for example, in 3.1 of > the Kinematics section, there's a mysterious loss of ", likewise" > between "we can easily see that AD**2 = x**2 + y**2" and "BD**2 = (Bx - > y)**2 + y**2". > > I hate just throwing these observations over the fence for someone else > to deal with, but current events in my life don't give me the quality > time I need to examine and propose changes to the appropriate style > sheets and transformation processes. I'm getting bits of time here and > there. > > I can only apologize and hope these observations help the transition > process.
I'll see if I can find and fix all of the above... John ------------------------------------------------------------------------------ Cloud Services Checklist: Pricing and Packaging Optimization This white paper is intended to serve as a reference, checklist and point of discussion for anyone considering optimizing the pricing and packaging model of a cloud services business. Read Now! http://www.accelacomm.com/jaw/sfnl/114/51491232/ _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
