[Twisted-Python] Refactoring Documentation
exarkun at twistedmatrix.com
exarkun at twistedmatrix.com
Thu Jan 20 17:06:24 MST 2011
On 20 Jan, 11:57 pm, screwtape at froup.com wrote:
>On Thu, Jan 20, 2011 at 05:22:55PM -0600, Kevin Horn wrote:
>>Hmmm...yes, I think it does. It looks like the l2s_builder script is
>>choking on fetching the DTD for some reason. lore2sphinx itself is
>>supposed
>>to cache the DTD between runs, but I'm betting it doesn't work in the
>>buildbot due to the (hopefully) clean environment it has every time it
>>runs.
>>
>>I can change it to not care about that, but if I do, then it won't be
>>able
>>to resolve HTML entities (of which there are a few in the Lore
>>sources,
>>mostly em-dashes IIRC).
>
>You mean these DTDs?
>
> twisted/lore/xhtml1-strict.dtd
> twisted/lore/xhtml1-transitional.dtd
>
>They reference the xhtml-*.ent entity definitions which are also in the
>same directory. It would be neat if lore2sphinx could be taught to use
>the DTDs packaged with lore instead of having to download them from the
>Internet every time.
It could even use Lore's parser, twisted.lore.tree.parseFileAndReport ;)
Jean-Paul
More information about the Twisted-Python
mailing list