On 12/6/2011 2:16 PM, John Thornton wrote: > > 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.
OK. Honestly, I don't think this would be hard to do, I just haven't had time to figure it myself. At first blush, it would seem that the links would be generated from the overarching definition of EMC2 document organization, which for us is contained in the Submakefile, not the individual txt files, because that's where you learn about which follows what. As an aside, this use of the Submakefile is perfectly legitimate but goes against my personal sense of coding practice. Left to my own devices, I'd put the stuff related to the organization of EMC2 documentation into a separate file. Then I could quickly change the organization without touching any of the low-level apparatus like Makefile/Submakefile. But that's just me. > <stuff deleted> > > 3e. tt (teletype) font is not displayed as tt font I was only half right on this one. Looking at the page source, I see the style does switch to mono-space for tt. It's just that I'm used to seeing that certain teletype font as well. > <more stuff deleted> > > > I'll see if I can find and fix all of the above... > > John Thanks, John. I just now started trying to understand what my Firefox browser wants by hand-editing the css-portion of the file kinematics.html to add various flavors of style. I figure if I can succeed at that then I can make recommendations for changes to the linuxcnc.css style sheet that is used by AsciiDoc in generating our HTML output. So far, I have nothing to write home about. Regards, Kent ------------------------------------------------------------------------------ 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
