This time on "How the Docs Conversion Turns"...<br><br>Moving along at about the same pace, but this time have some very visible results!<br><br>Here's the latest:<br><br> - The generated toctree directives now preserve the order of the links <br>
from the original source documents. This makes the "prev"/"next" links <br> work in a sane fashion in the resulting Sphinx docs.<br><br> - Comments in Lore docs are now translated properly.<br>
<br> - You want Trac integration? I got your Trac integration right here!<br><br> <a href="http://twistedsphinx.funsize.net/">http://twistedsphinx.funsize.net/</a><br><br> OK, so it's not quite done yet, but I was pretty impressed at the <br>
results of what amounts to about a day's work. It still needs some <br> tweaks here and there, but I'm mostly satisfied with it. If there <br> are any CSS gurus out there who are willing to take a look at this, <br>
there are a few spots that are giving me fits. Send me an email or <br> look me up on IRC.<br> <br> In any case, I'd appreciate it if everyone would take a look and <br> tell me what they think.<br>
<br> (Disclaimer: I haven't really tested this in anything but Firefox, except <br> for a brief glance in IE, so if people could test it out in Safari, etc. <br> that would be helpful)<br><br> - The previous look (which was just the default theme, with a color <br>
scheme to match the Twisted website) has been moved into it's own <br> Sphinx theme. Sphinx's theme inheritance made this really easy. <br> This way people can build the docs with the "old" look if they wish,<br>
or maybe we can use it for docs tarballs or .CHM files or something.<br> <br>Still to come:<br><br> - <code class="API"> tags still need handling.<br> <br> - Certain links need special handling as they don't quite display properly.<br>
<br> - "Inline markup" still needs a bit more work.<br> <br> - XHTML entities need resolving, but as I've mentioned previously, this <br> will probably be the very last thing I address.<br>
<br>All in all, I think this is starting to come together. I'm hoping to have <br>the rest completed by PyCon, but if I don't manage that, I'll probably <br>sprint on this on Monday.<br><br>code is here: <a href="http://bitbucket.org/khorn/lore2sphinx/">http://bitbucket.org/khorn/lore2sphinx/</a><br>
<br>current converted docs here: <a href="http://twistedsphinx.funsize.net/">http://twistedsphinx.funsize.net/</a><br><br>Until next time..<br><br><br>Kevin Horn<br> <br>