On 1/12/2010 13:02, eegg wrote:
Hi,
Over the years and as part of my job, most of the documents I've
produced have been in difficult, esoteric, GUI-oriented, even
proprietary formats. Over the past couple of months I've been trying
to shift significant amounts of this to plaintext -- and my eventual
tools of choice here are reST, and more recently, sphinx.
A conclusion I've come to is that reST/sphinx can potentially provide
a *complete* replacement of things like OpenOffice.org. In other
words, I've found them to be ideal for the production non-technical
documents. I see reST/sphinx as a friendly plaintext formatting
language providing an alternative to TeX and the like (of which I'm
not a massive fan).
Lately I've been using reST (and Sphinx when needed) for everything from
blog posts to fiction writing to python documentation.
Which brings me to my question: is there no interest in using tools
like sphinx in this regard, and if not, why? It seems architecturally
odd to me that both reST and sphinx provide many things which will
only be of use to code documentation.
I definitely wouldn't classify it as "no interest"... if you wander
through the Sphinx usage examples you'll see all kinds of things,
including entire websites and "blogs" using Sphinx.
So a second question: would it make more sense to anyone else out
there if the sphinx "python documentation generator" was a rather
thinner set of utilities built on top of a generalized formatting
suite?
That mostly seems to be the direction that Sphinx is naturally heading,
as more languages want to make use of Sphinx and more additional uses of
Sphinx are discovered and taken up.
For instance, one of the biggest work in progress projects, referred to
as "domains", is definitely part of the next step of this evolution:
http://pythonic.pocoo.org/2009/9/12/new-in-sphinx-1-0-domains
--
--Max Battcher--
http://worldmaker.net
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
