On Mar 25, 2013, at 9:16 AM, Kevin Horn <kevin.h...@gmail.com> wrote:
> How can you tell that this was created by a directive? You can't, because it
> could just as easily have been a list full of links to begin with.
But, I don't care if it was created by a directive or not.
I think we're talking about two different things.
What you seem to be talking about is using Sphinx to do source-to-source
Lore-to-ReST transformation. In that case, you're (sort of) right, in that
information is lost when you invoke directives. If we did this, and it worked,
it would just be a slightly better way to implement lore2sphinx; we'd still
need to manage the transition in largely the same way.
What *I'm* talking about is just using Lore source as an input to Sphinx, and
going straight to the output HTML. In order to do this, we just need to
construct the right tree and actually *invoke* the directive callables at the
right time. They produce whatever output they want to produce, and we hand
that back to Sphinx, and it outputs some docs. With this strategy, we just
switch to sphinx by switching our build process; we don't switch input formats.
Then, if someone wants to use Lore they can, if they want to use ReST they
can, and we can migrate on an as-needed basis; there's no need for a single big
format migration for us to start using Sphinx.
-glyph
_______________________________________________
Twisted-Python mailing list
Twisted-Python@twistedmatrix.com
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python