[Twisted-Python] Refactoring Documentation

Kevin Horn kevin.horn at gmail.com
Thu Jan 20 17:34:17 MST 2011


On Thu, Jan 20, 2011 at 5:57 PM, Tim Allen <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.
>
>
Huh. Never even knew that was there.  It probably could, and the reason it
downloads from the internet was because that's the default way of doing it
in lxml.  I've since figured out how to override that behavior (which is how
the caching works) so maybe that wouldn't even be hard.  The easiest/fastest
fix for the moment though would probably be to pre-populate the cache as I
mentioned before, since IIRC, this would just involve adding the file to my
hg repo.  I'll have to look into it though, it may be just as easy to do it
the other way, though I don't want to depend necessarily on having Twisted's
code available (remember, this is supposed to work on the various divmod
projects, and anything else that uses Lore, too).

Kevin Horn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: </pipermail/twisted-python/attachments/20110120/e258dacd/attachment.html>


More information about the Twisted-Python mailing list