[Matplotlib-devel] Call notes 29 Jan

[Antony Lee]

Screenshot just for the record: left is "out-of-the-box" vim with no
customizations (vim -u NONE + :syntax on; which already has syntax
highlighting out of the box for python blocks); right is my setup (using
vim-restructuredtext HEAD).
I agree that the very slow edit-compile cycle for sphinx is less than
optimal.  If you are just working on the rst part of a single file, you can
sort-of get away with rst2html (ships with docutils, bound to `:make` on my
vim setup), which will spew out tons of errors because it doesn't know any
sphinx constructs, but will still let you check the basic markup part.  You
can also check docstrings that way by just processing the docstring in a
separate file with rst2html.
Antony

2018-01-31 15:15 GMT-08:00 Jody Klymak <jklymak at uvic.ca>:

>
>
> > On 31 Jan 2018, at 15:07, Antony Lee <antony.lee at berkeley.edu> wrote:
> >
> > 2. any specific points about "python authoring less than desirable" for
> rst?  what functionalities would be desirable?
>
> I think all that was meant was that you can’t easily syntax highlight
> python in rst in most editors (not to start a vi/emacs thread ;-))
>
> Personal opinion:  I can’t write/compile an rst snippet in a reasonable
> timeframe:  I’m not smart enough to write anything correctly the first
> time, so I prefer to hack.  My computer is pretty good, but it takes 12
> minutes to compile the docs, even if I make one small change.  If there
> were a way to compile one file at a time, or if the doc build were smart
> enough to keep track of what has changed and what hasn’t it’d make editing
> in rst a lot easier.
>
> Cheers,  Jody
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/matplotlib-devel/attachments/20180131/48bc1c0f/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot_20180131_152655.png
Type: image/png
Size: 590193 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/matplotlib-devel/attachments/20180131/48bc1c0f/attachment-0001.png>