headers
Lea Wiemann | 8 Apr 2008 02:18
Picon

Re: Google Summer of Code

I've just submitted a proposal for adding embedded formula/plot/graph 
support to Docutils/reStructuredText.

Here's the abstract:

------------------------------------------------------------------------
I propose to add image embedding support to the Docutils framework, 
including getting LaTeX formula, graphviz graph and gnuplot plot 
support, so that you can embed LaTeX/graphviz/gnuplot code in 
reStructuredText documents, and any of these programs can be 
automatically called to generate images that are then embedded into the 
output document.

This is especially helpful for the scientic Python community, since they 
frequently need to include formulas and plots.  Also, graphviz is 
*really* handy for creating graphs, which would improve our ability to 
quickly create graphical illustrations for software.
------------------------------------------------------------------------

Proposal text:

------------------------------------------------------------------------
  I propose to add image embedding support to the Docutils framework. 
This means that it should be easy to write plugins that generate images, 
and the framework takes care of writing those images to disk and 
referencing them appropriately.  Currently, images are only supported by 
URI reference, which is awkward and does not work reliably across writers.

Timeline (I have ~9 weeks due to being on vacation with my family):
(Continue reading)

Permalink | Reply | 4 comments |
headers
Gael Varoquaux | 8 Apr 2008 02:21
Favicon
Gravatar

Re: Google Summer of Code

On Mon, Apr 07, 2008 at 08:18:29PM -0400, Lea Wiemann wrote:
> I've just submitted a proposal for adding embedded formula/plot/graph 
> support to Docutils/reStructuredText.

> Here's the abstract:

> ------------------------------------------------------------------------
> I propose to add image embedding support to the Docutils framework, 
> including getting LaTeX formula, graphviz graph and gnuplot plot 
> support, so that you can embed LaTeX/graphviz/gnuplot code in 
> reStructuredText documents, and any of these programs can be 
> automatically called to generate images that are then embedded into the 
> output document.

Why Gnuplot and not Matplotlib? Matplotlib is Python, and thereforr much
easier to integrate. The Python scientific community strongly encourages
users to use MatPlotLib.

By the way, the SVN version of MatPlotLib as a LaTeX-like renderer that
does an amzing job of maching LaTeX's output. That might come in handy to
provide LaTeX functionnality without requiring LaTeX.

My 2 cents,

Gaël

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Register now and save $200. Hurry, offer ends at 11:59 p.m., 
Monday, April 7! Use priority code J8TLD2.
(Continue reading)

Permalink | Reply | 1 comment |
headers
Aahz | 8 Apr 2008 02:35

Re: Google Summer of Code

On Mon, Apr 07, 2008, Lea Wiemann wrote:
>
> I've just submitted a proposal for adding embedded formula/plot/graph 
> support to Docutils/reStructuredText.

Congrats!  Looks good!
--

-- 
Aahz (aahz <at> pythoncraft.com)           <*>         http://www.pythoncraft.com/

"It is easier to optimize correct code than to correct optimized code."
--Bill Harlan

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Register now and save $200. Hurry, offer ends at 11:59 p.m., 
Monday, April 7! Use priority code J8TLD2. 
http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
Permalink | Reply | 0 comments |
headers
Alan G Isaac | 8 Apr 2008 03:18
Picon
Favicon

Re: Google Summer of Code

On Tue, 8 Apr 2008, Gael Varoquaux apparently wrote:
> Why Gnuplot and not Matplotlib? Matplotlib is Python, and 
> thereforr much easier to integrate. The Python scientific 
> community strongly encourages users to use MatPlotLib. 

I strongly agree!!
I would add that since discovering Matplotlib,
I almost never use gnuplot.

However, note that Gnuplot.py allows cross-platform control
of gnuplot binaries.

Cheers,
Alan Isaac

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Register now and save $200. Hurry, offer ends at 11:59 p.m., 
Monday, April 7! Use priority code J8TLD2. 
http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
Permalink | Reply | 0 comments |
headers
SourceForge.net | 9 Apr 2008 21:47
Picon
Favicon

[ docutils-Bugs-1938891 ] ``inline literal text`` creates span class pre for each word

Bugs item #1938891, was opened at 2008-04-09 15:47
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=422030&aid=1938891&group_id=38414

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: None
Group: None
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Jeff Kowalczyk (jfkw)
Assigned to: Nobody/Anonymous (nobody)
Summary: ``inline literal text`` creates span class pre for each word

Initial Comment:
One of the principals of Plone has voiced concerns about some aspects of docutils reStructuredText to HTML rendering.

http://article.gmane.org/gmane.comp.web.zope.plone.documentation/1498
http://plope.com/Members/chrism/why_rst#comments #3

The particular instance cited:

``inline literal text``

generates:
(Continue reading)

Permalink | Reply | 0 comments |
headers
Nicolas Girard | 22 Apr 2008 19:49
Favicon

[ANN]: Tevisa 0.5 released

Dear people,

I'm happy to announce the first public (pre)release of Tevisa.

Tevisa_ converts reStructuredText documents into pdf presentations using the 
Powerdot_ LaTeX class.

Logically this program could have been called rst2powerdot ; hopefully you 
will forgive me for getting somewhat tired of the rst2* prefix.
The name *Tevisa* comes from 'tévisa' which means 'to show' in the `Myéné 
language`_.

.. _Tevisa: http://code.google.com/p/tevisa/
.. _Powerdot: 
http://www.ctan.org/tex-archive/help/Catalogue/entries/powerdot.html
.. _Myéné language: http://en.wikipedia.org/wiki/Myene_language

This is actually a pre-release announcement I'm submitting to this sole 
mailing-list. Indeed, I would be *very* glad if some of you could review my 
code, test the program and discuss the implementation decisions I made, 
before diffusing Tevisa to a wider audience.

Here follow some quick usage notes.

Installation::

  svn checkout http://tevisa.googlecode.com/svn/trunk/ tevisa
  cd tevisa
  python setup.py build
  sudo python setup.py install
(Continue reading)

Permalink | Reply | 0 comments |
headers
Jeff Anderson | 23 Apr 2008 20:43
Gravatar

Math Support Proposal

Hello,

I'm not a developer of docutils, but I've become a heavy user of reST 
and docutils. I use it for note taking at school. I one day decided to 
try to use latex math syntax and extend my note taking with reST to 
physics and math classes.

I've read about, and tried just about every hack, sandbox, and patch
that I can get my hands on to get cross-output format math.

In doing this, I think I have an idea that combines the advantages of 
all the approaches I've seen.

I think my idea fits well with the docutils design philosophy.

Representing equations in reST:

Math in reST will use latex math syntax.

To denote that I am giving reST an equation, I will simply use a
directive or role based on what type of math environment I want. The XML
side of docutils could be extended to include a tag that denoted an
equation to maximize the portability between output formats.

Potential Syntax Examples:

.. displaymath::

	e = mc^2
	\frac{1}{2} \times \frac{\pi}{e}
(Continue reading)

Permalink | Reply | 10 comments |
headers
Alan Isaac | 23 Apr 2008 21:25
Picon
Favicon

Re: Math Support Proposal

On Wed, 23 Apr 2008, Jeff Anderson wrote: 
> I've read about, and tried just about every hack, sandbox, and patch 
> that I can get my hands on to get cross-output format math 

I have had good experience with Jens Jørgen Mortensen's 
stuff in the sandbox:
<URL:http://docutils.sourceforge.net/sandbox/jensj/latex_math/tools/>
I would love to see some of your ideas as extensions of his 
work.  Hopefully you two would collaborate.

Cheers,
Alan Isaac

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Don't miss this year's exciting event. There's still time to save $100. 
Use priority code J8TL2D2. 
http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
Permalink | Reply | 9 comments |
headers
Beni Cherniavsky | 26 Apr 2008 22:03
Gravatar

Self-documenting errors (was: Re: [Docutils-users] docutils for windows)

[moving to the develop list, since I want to discuss petty
implementation questions and it's no longer informative to the OP]

2008/4/24, David Goodger <goodger <at> python.org>:
> On Thu, Apr 24, 2008 at 10:39 AM, Kaushal Shriyan
>  <kaushalshriyan <at> gmail.com> wrote:
> > I am getting
>  >
>  > C:\>docutils\tools\rst2html.py mysqlmasslavdocs.txt mysqlkrs.html
>  > mysqlmasslavdocs.txt:95: (WARNING/2) Literal block ends without a blank
> > line; unexpected unindent.
>  ...
>
>  Literal blocks must be indented relative to the line containing the "::".
>  http://docutils.sourceforge.net/docs/user/rst/quickref.html#literal-blocks
>  http://docutils.sourceforge.net/docs/user/rst/quickstart.html#preformatting-code-samples
>  http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#literal-blocks
>
It'd be best if docutils itself could detect FAQ issues and point
people at the relevant places in the documentation.  This is an
example of a situation which can easily be detected: it's not just any
unexpected unindent, it's an unindent right after the ``::`` -- which
very probably indicates that the user misunderstood the syntax of
literal blocks.

So I'm going to implement an extended message for this case.  (I'm too
lazy for a directed effort to add such messages in all possible
places, but one message at a time will also eventually help.)

Points I want to get advice on:
(Continue reading)

Permalink | Reply | 0 comments |

Gmane