<br><br><div class="gmail_quote">On Thu, Apr 22, 2010 at 11:51 AM, <span dir="ltr"><<a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="im">On 02:57 pm, <a href="mailto:kevin.horn@gmail.com">kevin.horn@gmail.com</a> wrote:<br>
>On Wed, Apr 21, 2010 at 9:48 PM, <<a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a>> wrote:<br>
>><br>
>>So about the conversion, I wonder if we can start to generate the<br>
>>Sphinx<br>
>>version of the docs on buildbot sometime soon, and perhaps host them<br>
>>alongside the current docs, as the first step in phasing out the<br>
>>current<br>
>>version?<br>
><br>
>I suppose we could do this, if you think it would help. Note that the<br>
>lore2sphinx<br>
>script requires Python 2.6 and I think at least Sphinx 0.6.4 (I'm using<br>
>0.6.5).<br>
<br>
</div>Shouldn't be a problem.<br>
<div class="im">><br>
>><br>
>>How automated is the conversion process now? Are errors reported such<br>
>>that people could start looking at them and fixing the issues? It<br>
>>seems<br>
>>like you've done almost all of the hard work, and the rest is dealing<br>
>>with some edge cases in lore or restructured text, and that might be<br>
>>more easily spread out amongst more people.<br>
>><br>
>>Jean-Paul<br>
>I think the automatic conversion process has reached the point of<br>
>diminishing returns.<br>
>I've got it down to about 13 warnings in the Sphinx build process,<br>
>though<br>
>there are still<br>
>some markup errors in the output. Trying to make the conversion handle<br>
>these seems<br>
>to just introduce more errors in other places.<br>
<br>
</div>Would it be easier to fix these by changing the lore sources?<br>
<div><div></div><div class="h5"><br>
Jean-Paul<br>
<br>
<br></div></div></blockquote><div><br>I seriously doubt it. In fact I think it would be much more difficult.<br><br>Other than the 13 build warnings I mentioned above, almost all of the <br>rest of the markup errors are things like a missing space character.<br>
<br>Fixing this in the lore sources would require:<br>1) removing most if not all indentation from all the lore sources<br>2) making sure every <b>, <i>, <code>, <a> tag (and some others I'm sure) <br>
have exactly the same spacing before and after them...including tabs, newlines, etc.<br>3) revamping lore2sphinx to stop doing all the workarounds it currently does<br><br>I think it will be much easier to go through the ReST sources (which IMO will need to <br>
be done anyway) and add spaces or whatever where needed.<br><br>Kevin Horn<br><br>Kevin Horn <br></div></div><br><div style="visibility: hidden; display: inline;" id="avg_ls_inline_popup"></div><style type="text/css">#avg_ls_inline_popup { position:absolute; z-index:9999; padding: 0px 0px; margin-left: 0px; margin-top: 0px; width: 240px; overflow: hidden; word-wrap: break-word; color: black; font-size: 10px; text-align: left; line-height: 13px;}</style>