After having played with rST, Sphinx, and ReadTheDocs ... I have a HTML test page which provides a left menu similar to the one in RTD, only mine works properly (the RTD one has a number of bugs).
I'm not a graphic designer or web programmer .. so it would be good to get someone who is working on the graphic design and perhaps the implementation a HTML5/CSS/JS+DOM/Felix. RTD and my first version use a fixed width left margin. This sucks. Unfortunately, due to limitations in CSS and the DOM, style controls don't allow mixing dimensions when doing calculations. Since typical sexed up web pages line things up by trickery the only way to really do this right is to calculate the whole CSS style definition in Javascript. in particular we would like a draggable boundary between the left margin table of contents and the actual contents, with an initial size based on say 25% of the window width. Can't do that in CSS (because various elements are drawn a few pixels off that position ..and you can't calculate it in CSS so you have to do it in JS .. and you can't set the style components individually AFAIK). Which all means replacing the Felix calculations of the HTML string with JS code. Ultimately the only sane way to do a web page is pure JS or close to it. For example I tried menus with lists and CSS but in the end the constraints were too much of a pain. Plain old <div> with a class and id lets you do everything. Anyhow adding the left margin TOC to the fdoc processing gets us the left margin thing in all documents without changing any documents (or perhaps I will require a @do-left-margin command to enable it). At the cost of some implementation, this is better than relying on a bunch of half broken Python code, although with Sphinx it is nice you can get PDF out too. Someone can always write a fdoc to rST converter. -- john skaller skal...@users.sourceforge.net http://felix-lang.org ------------------------------------------------------------------------------ Want excitement? Manually upgrade your production database. When you want reliability, choose Perforce Perforce version control. Predictably reliable. http://pubads.g.doubleclick.net/gampad/clk?id=157508191&iu=/4140/ostg.clktrk _______________________________________________ Felix-language mailing list Felix-language@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/felix-language
