[SciPy-Dev] mono space text in document editor.

[David Goldsmith]

On Fri, Jun 11, 2010 at 9:07 AM, Vincent Davis <vincent at vincentdavis.net>wrote:

> On Fri, Jun 11, 2010 at 4:25 AM, Pauli Virtanen <pav at iki.fi> wrote:
> > Thu, 10 Jun 2010 21:50:02 -0600, Vincent Davis wrote:
> >> It seems that the text in the document editor is not a mono space text.
> >> Can this be changed?
> >
> > What text?
> On this page for example.
> http://docs.scipy.org/scipy/docs/scipy.constants.codata.precision/edit/
> When you edit the text it is not monospace and there is no 75 char guide.
> This makes both staying within the 75 char limit


Just err on the side of being too short (i.e., if in doubt, break the line).


> and getting the rst
> syntax correct difficult. (for example putting "-" under a word to get
> bold font.)


**<text>** gives us bold font.  ("-" under a word makes it a section
heading; only Parameters, Returns, Other parameters, Raises, See also,
Notes, References, and Examples, starting in the first column and on a line
by themselves, should have "-" under them.)


> I could use an external editor and copy paste.
>

Actually, nominally, that _is_ what we'd prefer writer/editors to do:

(from http://docs.scipy.org/numpy/Front%20Page/#roles-reviewing) "**It is
best to grab the whole existing page [from the Edit window, not the View
window], or a template, edit it on your computer, return [and] check that
nobody else has edited first, and then upload your document. Please do not
edit incrementally, unless making trivial changes like fixing markup or
reformatting."

(Full disclosure: I "cheat," but since you brought it up, I figured I should
emphasize that what you state is the preferred modus operendi.)

DG

See attached images for you don't know what I mean.
>
> Thanks
> Vincent
>
>
>
> >
> > The text in the edit window is monospace. The output should not be made
> > monospaced; it is intended for Sphinx, and plain text should be variable
> > spaced.
> >
> > --
> > Pauli Virtanen
> >
> > _______________________________________________
> > SciPy-Dev mailing list
> > SciPy-Dev at scipy.org
> > http://mail.scipy.org/mailman/listinfo/scipy-dev
> >
>
> _______________________________________________
> SciPy-Dev mailing list
> SciPy-Dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev
>
>


-- 
Mathematician: noun, someone who disavows certainty when their uncertainty
set is non-empty, even if that set has measure zero.

Hope: noun, that delusive spirit which escaped Pandora's jar and, with her
lies, prevents mankind from committing a general suicide.  (As interpreted
by Robert Graves)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scipy-dev/attachments/20100611/30c244ad/attachment.html>