<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>On Sep 21, 2011, at 8:31 AM, Kevin Horn wrote:</div><div><div><br class="Apple-interchange-newline"><blockquote type="cite">Kevin Horn<br><br><div class="gmail_quote">On Wed, Sep 21, 2011 at 6:53 AM, Jean-Daniel <span dir="ltr"><<a href="mailto:jeandaniel.browne@gmail.com">jeandaniel.browne@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0.8ex; border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex; position: static; z-index: auto; ">Hello,<br>
<br>
Can we write a doc for Twisted using Sphinx at this point?<br>
<br>
What is the status of the Lore to Sphinx transition project? I could find:<br>
<br>
#4621 lore2sphinx should make pretty links to included files.<br>
#4586 Code-listings generated by lore2sphinx should include line-numbers<br>
<br>
Is there any other info/update available?<br></blockquote></div></blockquote><blockquote type="cite"><br></blockquote><blockquote type="cite">Currently this is waiting on changes to the Twisted release automation code.<br><br>Docs should still be written using Lore, and then you should check the Lore buildbot to see if they are being translated to Sphinx properly.<br></blockquote><div><br></div><div>Lore is just simple HTML with a few 'class' decorations for features like syntax highlighting (as you can see from the examples) so it should be easy enough to write. If you want to write the document with Sphinx, someone on the development team would be happy to translate it manually - creating the content is much harder than writing the markup :).</div><br><blockquote type="cite">If you care to take a look at the release automation code, please feel free.<br></blockquote></div><br></div><div>You can see the milestone here:</div><div><br></div><div><span class="Apple-tab-span" style="white-space:pre"> </span><<a href="http://twistedmatrix.com/trac/milestone/Lore%20to%20Sphinx">http://twistedmatrix.com/trac/milestone/Lore%20to%20Sphinx</a>></div><div><br></div><div>and the ticket for actually doing the conversion is here:</div><div><br></div><div><span class="Apple-tab-span" style="white-space:pre"> </span><<a href="http://twistedmatrix.com/trac/ticket/4500">http://twistedmatrix.com/trac/ticket/4500</a>></div><div><br></div><div>there's already some commentary on that ticket explaining what needs to be done next.</div><div><br></div><div>-glyph</div></body></html>